Slashdot Mirror


Apache Jakarta Commons

Simon P. Chappell writes "This is a hard review to write because I feel that I should be biased in favour of this book. I was one of the original reviewers of the book proposal. I read it and said "Yes, they'll be lining up around the block for a book like this!" Well, maybe those weren't my exact words, but I did offer my endorsement. After all, the Jakarta project of the Apache Software Foundation has an excellent reputation for quality Java code products and the Commons is quite the supply of diamonds in the rough. What could go wrong?" Read on for the rest of Chappell's review to find out. Apache Jakarta Commons - Reusable Java Components author Will Iverson pages 338 (8 page index) publisher Prentice Hall rating 4 reviewer Simon P. Chappell ISBN 0131478303 summary There are other books about the Jakarta Commons; buy one of those instead.

What's To Like

The book takes the reader on a journey through the Jakarta Commons. The Commons is like a massive utility library of Java code. Much of the code has been promoted out of the other Jakarta projects as it became more useful. One of the first such components was the Digester, which is a component to initialise a Java object from the contents of an XML configuration file. Very useful, originally from Struts and now used extensively by other Jakarta projects.

As the subject matter for a book, the Commons seems like a natural winner (I guess I have to say that!). There are so many components in the Commons that a guide to their types and usage does need to be available for developers.

Naturally, the book has a website to accompany it.

What's To Consider

Where to begin? I was actually surprised to find that I did not care for this book. The last review I wrote was for Mr. Iverson's very good Hibernate book. That was well written and structured. Unfortunately, this book feels kind of thrown together. The lack of care shows in the cramped layout and typesetting, the over-abundance of UML diagrams (a few here and there are great, but this felt like padding), code examples that can only be described as under-whelming and an approach that feels like an annotated telephone directory.

Despite the lack of quality of the primary chapters, they only actually account for the first 199 pages of the book. This is actually a very reasonable number of pages for a book, especially when you consider that classics like the first edition of Kernighan and Ritchie's "The C Programming Language" weighed in at about 220 pages. Sadly, the book then goes on for another 125 pages churning out what looks like repackaged JavaDoc for each of the major classes in the commons. You may like this, but it annoys the beans out of me and it'll reduce the score on one of my reviews faster than the Linux community can debunk a SCO IP infringement claim.

Summary

I really wanted to like this book. But it feels like someone was cranking the handle on a cash machine and thought that if they printed stuff about Jakarta, that the geeks would obediently buy it. Not this time. There are other books about the Jakarta Commons; buy one of those."

You could purchase Apache Jakarta Commons - Reusable Java Components from bn.com. Slashdot welcomes readers' book reviews -- to see your own review here, read the book review guidelines, then visit the submission page.

89 comments

  1. Interesting pricing by AKAImBatman · · Score: 4, Informative

    If you go through the Barnes & Noble link for the book, you'll find that the book costs $31.99 for the unwashed masses, and $28.79 for the "B&N members". What Barnes and Noble isn't telling their members is that they are still paying more than if they went to Amazon! Even with an associate laden link, you can still get the book off of Amazon for a mere $26.39! And no membership hassles to mess with!

    From an Amazon review:
    Note that this 325-page book is really a 201-page book. Appendix A is the entire API of the Commons lang project - word for word.

    Am I the only one who gets annoyed at how computer books have devolved into hardcopies of auto-generated online documentation? Am I the only one who remembers books that cover the intangables of coding (e.g. theory of operation, correct methodology for usage, cool coding and hardware tricks, etc.) rather than the "instruction manual for dummies" books? Bah, I say! I don't know which is scarier: the current trend in books, or the fact that the review I'm citing gave the book 4 out of 5 stars.

    Of course, I'll probably get in trouble with my fellow authors for saying this. (Sorry guys, but I just don't like 90% of the books being printed.)

    1. Re:Interesting pricing by DogDude · · Score: 1, Insightful

      Well, thank god you can save $2.40! People like you are the reason we have Wal-Mart: a rush to the lowest price with no consideration for any other factor in your purchase. Oh, and I happen to get my books at 75% of the retail price: from an independent local bookstore that actually contributes to my community.

      --
      I don't respond to AC's.
    2. Re:Interesting pricing by Reignking · · Score: 1

      What Barnes and Noble isn't telling their members is that they are still paying more than if they went to Amazon!

      Wow. That is stunning.

      --
      One man's Funny is another man's Offtopic.
    3. Re:Interesting pricing by AKAImBatman · · Score: 1

      from an independent local bookstore that actually contributes to my community

      Okay, I'll bite. How does B&N contribute to your community? Are you referring to this link? If you agree with their charity work and think they should be rewarded for it, then by all means follow the Barnes and Noble link. Personally, I'm none to happy with stores that require "memberships" to get special deals, but to each their own.

    4. Re:Interesting pricing by grahamlee · · Score: 2, Insightful

      The first time I really got annoyed by this sort of thing was back when I was learning NeXTSTEP programming. Their developer reference docs were largely a hardcopy set of API regurgitations, but this was OK because they were well indexed (as they bloody well should have been, I expect they were just printouts of the NeXT Librarian format online documentation). I also don't mind this because for really ploughing through a book, I still prefer dead tree to online format[*]. However, the printed documentation for the compiler/linker/debugger toolset was just a troff-formatted pretty version of the GNU manpages (remember this was back when RMS didn't mind man too much). That really annoyed me. They were badly indexed, containing the same information as a manpage in the same linear style and without the utility of a content search.

      [*]This is why I own a number of books in both online (for quick reference) and hardcopy (for actually studying) formats, even though the online version is free (c.f. Numerical Recipes, the X manuals, some of the Perl books etc.)

    5. Re:Interesting pricing by Anonymous Coward · · Score: 1, Insightful

      Trolling for dollars!

    6. Re:Interesting pricing by jazman_777 · · Score: 1
      Well, thank god you can save $2.40! People like you are the reason we have Wal-Mart: a rush to the lowest price with no consideration for any other factor in your purchase.

      Is B&N better than Amazon? How? Also, there are independent booksellers still around? Or are they just money-laundering fronts for Borders / B&N?

      --
      Slashdot: Failed Car Analogies. Amateur Lawyering. Anecdote Battles.
    7. Re:Interesting pricing by TrappedByMyself · · Score: 3, Informative

      Or get it even cheaper at Bookpool for $25.50

      --

      Help me take back Slashdot. When did 'News for Nerds' become 'FUD and Conspiracy Theories for Extremist Nutjobs'?
    8. Re:Interesting pricing by Anonymous Coward · · Score: 0

      Of course, the mods somehow can't see through that ruse, modding him as Informative and Interesting.

    9. Re:Interesting pricing by AKAImBatman · · Score: 1

      There you go. Mod parent up.

      (And don't bother modding up my original post. I gave fair warning of the associates link, but I mostly just being a smartass. Feel free to mod it down if you like.)

    10. Re:Interesting pricing by Anonymous Coward · · Score: 0

      just being a smartass

      Smart? No.

      Ass? Absolutely.

    11. Re:Interesting pricing by the_rev_matt · · Score: 3, Funny

      You shouldn't be worried about the 4 star rating. It's out of 10.

      --
      this is getting old and so are you

      blog

    12. Re:Interesting pricing by AKAImBatman · · Score: 1

      Will someone please reverse the Troll mod on the parent? His point is his own and he should *not* be punished for it. My original post is far more deserving of a Troll mod than DogDude's.

      Man alive, who do we have modding these days?

    13. Re:Interesting pricing by MrP-(at+work) · · Score: 1

      "Or are they just money-laundering fronts for Borders / B&N?"

      Isn't Borders part of Amazon.com?

      --
      [an error occurred while processing this directive]
    14. Re:Interesting pricing by flibuste · · Score: 1

      Am I the only one who gets annoyed at how computer books have devolved into hardcopies of auto-generated online documentation? Am I the only one who remembers books that cover the intangables of coding (e.g. theory of operation, correct methodology for usage, cool coding and hardware tricks, etc.) rather than the "instruction manual for dummies" books?

      No! I'm with you and that is the main reason why I rarely buy books about programming. 75% of the content can be found online, and really, I do not need the 1101th iteration of "Hello World" in [insert your preferred language name here].
      I always feel like I spent money and killed trees for no reason when I see that half a book is filled with obvious lines of code, or a printout of the API.

      For Jakarta Commons, just type "jakarta" in the address bar of Firefox or "commons" and chances are you'll find what you want faster than browsing through a book index. More than faster, it's an entirely free solution!

      Really, the practice of pitching code in a book just shows that the author has nothing to say and has to fill blank pages, or cannot explain a point in clear human language. Hence he should not be writting a book.

    15. Re:Interesting pricing by AKAImBatman · · Score: 1

      Isn't Borders part of Amazon.com?

      Actually, Borders made a deal with Amazon whereby Amazon would handle their online business. Which (in English) means that Amazon was allowed to license the Border's name on a royalty basis.

      Here is a link to a news story on the subject. (Mods: This is an example of an informative post.) No, there are no associates links embedded in that link. (Mods: This is a joke. It may optionally be modded as "Funny" *if you laughed*.)

      (Mods: Don't bother to mod up this post. The "VOID" across it means that it is an example intended for demonstration purposes only. Yes, that's another joke. Ha ha. Funny. Rolling on the floor. Yeash, I really need to get over this cold.)

    16. Re:Interesting pricing by DrSkwid · · Score: 1

      if the western govts stopped freaking out about cannabis then there wouldn't need to be so many dead trees.


      Hemp produces more pulp per acre than timber on a sustainable basis, and can be used for every quality of paper.

      Guess what sort of paper the Declaration of Independence is written on.

      --
      There are places where the networks are not touching,and there are places where they are-Boeing's Lori Gunter
    17. Re:Interesting pricing by Anonymous Coward · · Score: 0
      Or get it even cheaper at Bookpool for $25.50
      Well, that's without shipping and tax. At Bookpool, with the cheapest shipping option it's $28.31 for my zip code and I'm not sure if they have a tax. Via PriceGrabber.com, it looks like Overstock.com is the cheapest - $27.34 including tax and shipping. Serioulsy folks, PriceGrabber.com is great for comparison shopping - at least on books!
    18. Re:Interesting pricing by Anonymous Coward · · Score: 0

      No joke, Slashdot reviews are usually rated out of ten. T'was remiss of the viewer not to explicitise.

    19. Re:Interesting pricing by Anonymous Coward · · Score: 0

      Um... old paper?

      Do I win a prize?!

    20. Re:Interesting pricing by jc42 · · Score: 2, Interesting

      Hemp produces more pulp per acre than timber on a sustainable basis, and can be used for every quality of paper.

      A couple of years ago, there was a book written on the history of the US drug laws. I've forgotten the book's (or author's) name, but he documented an interesting "coincidence": The campaign to outlaw cannabis/marijuana/hemp was basically done by the Hearsts. They owned a large amount of land that was mostly pulpwood farms. Just before the anti-marijuana campaign started, a new hemp-to-paper process was patented that produced paper at half the cost of the cheapest wood-based process. This essentially made the Hearts' pulpwood farms useless. They responded by bankrolling the anti-drug campaign, including lobbying Congress to include the Evil Weed in the list of drugs.

      It never did make sense that such a mild euphoric would cause such a wildly off-scale response, until someone dug up the above history. Then it all made sense.

      Pulpwood farming is still an industry in the US. And it's almost all big corporate farms. We know the attitude of the current Congress towards corporations, of course. So we can't expect any serious change in the drug laws any time soon. Not unless some major hemp growers start making a lot of campaign contributions.

      A number of articles have been published recently discussing the statistics showing that most of the increase in drug arrests in the US over the past 15 years or so has been for marijuana. Some of these articles have mentioned that hemp is potentially a serious threat to big American tree-farming interests. But the articles I've read haven't actually explained the connection.

      --
      Those who do study history are doomed to stand helplessly by while everyone else repeats it.
    21. Re:Interesting pricing by Mold · · Score: 1

      That's rather interesting. Although I don't find that the banning of any euphoric drug is odd.

      Euphoria is dangerous! Secretly banned in the US!

      We have the right to the pursuit of happiness, not happiness. The goverment thinks that if we find it, we'll revolt. Down with the man!

      Or something. I forgot where this was going.

    22. Re:Interesting pricing by pyite · · Score: 1

      And for other books, B&N is cheaper than Amazon regardless of membership. So what's your point, the fact that the prices have a distribution that averages to the same thing on the whole?

      --

      "Nature doesn't care how smart you are. You can still be wrong." - Richard Feynman

    23. Re:Interesting pricing by Iffy+Bonzoolie · · Score: 1

      I dunno, having a huge library-sized bookstore with couches and a cafe to hang around in is pretty cool. It was a favorite spot for a girl I really liked in high school and I to hang out at. I'm all for independent business, but most of the tiny independent bookshops that I've been in have no selection, no food or drink allowed, and sort of smell funny, anyway.

      -If

      --
      Run a pencil-and-paper RPG campaign with your far-off friends: Gametable!
    24. Re:Interesting pricing by AKAImBatman · · Score: 1

      Actually, I'm generally happier with Borders. Borders has all the same features as B&N, but their selection is usually better, and they give you a good price without pressing the membership thing.

      Of course, it shouldn't be *too* suprising, as Borders is just the large version of Walden Books (one of the few awesome bookstores). :-)

  2. So.... by Anonymous Coward · · Score: 0, Funny

    ....it's shite then?

    1. Re:So.... by Anonymous Coward · · Score: 0

      Isn't all of Jakarta?

      Hani Thinks So

  3. Content-free review by winkydink · · Score: 3, Insightful

    This has to be among the worst booke reviews I have ever seen on Slashdot. And that's saying something. Most reviewers take the time to give you some detail. An indication of whether or not this book is for you. This just seems like a shameless whoring to get affiliate credit with B&N under the guise of a book review.

    --

    "I'd rather be a lightning rod than a seismometer." -Ken Kesey

    1. Re:Content-free review by ch-chuck · · Score: 2, Funny

      The above review of the book review was, altho short and concise, informative and to the point. Altho the conspiracy theory nature of the final remark went perhaps a little too far, considering the off-the-cuff source and likelyhood of going for 'first-post' status, it is worth at least an 'interesting' moderation.

      --
      try { do() || do_not(); } catch (JediException err) { yoda(err); }
    2. Re:Content-free review by mooingyak · · Score: 1

      If he's just looking for the credit, it seems an odd tactic to can the book...

      --
      William of Ockham had no beard. The most likely explanation is that it was chewed off by squirrels every morning.
    3. Re:Content-free review by Anonymous Coward · · Score: 0
      This has to be among the worst booke reviews I have ever seen on Slashdot.

      ... you must be new here?

      On a lighter note, I think the review is nicely in line with the book. It sounds like a stinker (and yeah, this time I even RTFA!).

    4. Re:Content-free review by harrkev · · Score: 4, Insightful
      This just seems like a shameless whoring to get affiliate credit with B&N under the guise of a book review.
      I might be inclined to agree with you had he actualy said that the book was worth buying, which he didn't. As it is, an affiliate link does not bother me.
      --
      "-1 Troll" is the apparently the same as "-1 I disagree with you."
    5. Re:Content-free review by Ziviyr · · Score: 2, Funny

      Indeed, at first I endorsed this review, but upon reviewing said review, I found I did not like it.

      This review definitely feels kinda thrown together.

      --

      Someone set us up the bomb, so shine we are!
    6. Re:Content-free review by msuzio · · Score: 1

      Right, because I always make sure not to recommend books I want people to buy.

  4. HowTo: How To Deal With A Shitty Book: by Neil+Blender · · Score: 5, Insightful

    Stop reading it the minute you realize it's shit.

    1. Re:HowTo: How To Deal With A Shitty Book: by Anonymous Coward · · Score: 0

      That's right - if your first gut feeling is that the book is shit, don't keep an open mind!

  5. Review, or Oscar acceptance? by lheal · · Score: 3, Informative

    Next time, spend less effort writing about your own involvement and more time on that of the authors of the book.

    --
    Raise your children as if you were teaching them to raise your grandchildren, because you are.
    1. Re:Review, or Oscar acceptance? by Titusdot+Groan · · Score: 1

      I think the reviewers involvement is very apropos here -- he's panning it. Kind of a reverse ad hominem.

    2. Re:Review, or Oscar acceptance? by Anonymous Coward · · Score: 0

      What's your problem? His mention of his involvement was brief, and it wasn't thrown in for glamour but rather to make a point about the subject matter.

  6. Associate-free link by Anonymous Coward · · Score: 2, Informative

    Even with an associate laden link, you can still get the book off of Amazon for a mere $26.39! And no membership hassles to mess with!

    Or you can use the non-associate link to prevent datadino's flagrant commission-whoring.

  7. How To Deal With A Shitty Book Review by smackjer · · Score: 0, Redundant

    See parent post.

    --

    This is my sig. There are many like it, but this one is mine.
  8. Hey! buy the Jakarta Commons Cookbook by BigTimOBrien · · Score: 5, Insightful

    :-)

    I wrote a book on the Jakarta Commons - The Jakarta Commons Cookbook, and, from what I hear people like it. Really, you should read it, I tried to stay as far away from reference as possible and pack it full of useful recipes.

    --
    ------ Tim O'Brien
    1. Re:Hey! buy the Jakarta Commons Cookbook by greg1104 · · Score: 5, Informative

      Amazingly, this bit of self-promotion is actually more useful than the review. Tim O'Brien's book is my favorite on this subject and it's far, far better than the Will Iverson title. I particularly like how well it covers some of the extremely useful but not well documented APIs like the HttpClient, there are far more readable, usable examples that cover the kind of real-world issues you run into the minute you try to use that API than any other source I know of.

      Larne Pekowsky: "Apache Jakarta and Beyond: A Java Programmer's Introduction" is also a decent title in this area, albeit a bit too broad to really do that good of a job on any topic. Even a 600 page book can't cover things like Eclipse or Ant in a chapter.

      I have all three books on my Safari bookshelf right now; only O'Brien's is staying once I can remove the other two. The Iverson and Pekowsky titles have some interesting sections worth looking at once, while "Jakarta Commons Cookbook" I always want to keep around for reference, in the same fashion I already rely on the similarly useful "Java Cookbook".

    2. Re:Hey! buy the Jakarta Commons Cookbook by tigersha · · Score: 0, Flamebait

      Yeah, and I pasted a code example from that goddamn book and guess what, IT DID NOT WORK. It was not tested. Bye bye book. Fortunately I read it on Safari.

      --
      The dangers of excessive individualism are nothing compared to the oppressiveness of excessive collectivism
    3. Re:Hey! buy the Jakarta Commons Cookbook by Anonymous Coward · · Score: 0

      Thankyou for your informative post.
      The world is a better place because of you.

    4. Re:Hey! buy the Jakarta Commons Cookbook by Anonymous Coward · · Score: 0

      I installed Linux a weekend ago on a laptop.

      The wireless card did not work; fortunately I didn't bin it there and then.

    5. Re:Hey! buy the Jakarta Commons Cookbook by tigersha · · Score: 1

      You don't get it. I paid money for a book which had an example in it which was not tested by the user. It cost me some hours of work to figure out what the problem was. The book I bought specifically to solve that one particular problem. It was a total waste of my time and money.

      Your Linux problem an be fixed. The book 8my copy of it) cannot since it is not trustworthy because the friggin author did not check his code examples (the one in question was obviously sucked out of his thumb because it looks like something similar he assumed it is the same).

      --
      The dangers of excessive individualism are nothing compared to the oppressiveness of excessive collectivism
    6. Re:Hey! buy the Jakarta Commons Cookbook by rjshields · · Score: 2, Interesting

      I love cookbooks because they show you creative ways to use the library to solve real problems. The code snippets given get you up and running with a library almost immediately, as you have a working piece of code to use as a starting point for solving your own problem. Contrast that with writing code against a new library from scratch and you'll find a great learning aid and time saver.

      If I want to read the API docs, I'll go to the Jakarta Commons website and read them. I don't want to waste money and trees on API docs used to pad out a book!

      I haven't read the Jakarta Commons Cookbook yet, but it's on my reading list.

      --
      In this world nothing is certain but death, taxes and flawed car analogies.
    7. Re:Hey! buy the Jakarta Commons Cookbook by symbiontnet · · Score: 2, Informative

      I would recommend everyone to O'Brien's Commons Cookbook. It is concise and to the point, (as a good cookbook title should be), with lots of good summaries and examples.

      He gives just enough attention to a topic to give the intelligent reader the gist, as well as a jumping-off point for further investigation into the specific commons sub-project.

      I was familiar with and actively used several commons components before, but this book introduced me to many I was not even aware of (or was aware of but didn't completely understand what it would be useful for). Also gave me ideas for how to easily integrate new commons packages into new projects under design for a tighter and more efficient architecture.

      Go get it now...

  9. Re:(OT) Request: Help From Moderators by Anonymous Coward · · Score: 0

    Well, you're a bad troll and you've been modded down, isn't this what you wanted?

  10. Why might it be better than the free docs? by Soong · · Score: 3, Insightful

    I think that's the first question any book like this would have to answer. Free and reasonably comprehensive documentation is included right along with all of these libraries. Why pay for anything more?

    The answer is likely to be in tutorials or teaching narrative. I bought the OpenGL Guide for that to learn OpenGL because the API was a nasty maze to navigate otherwise. I don't think Jakarta Commons have that problem and I don't expect I'll be buying a book about them.

    --
    Start Running Better Polls
    1. Re:Why might it be better than the free docs? by tedgyz · · Score: 1

      Ummmm. Have you tried using the org.apache.commons.collections.functors package? Not completely obvious. There could be a whole book on that stuff.

      --
      "No matter where you go, there you are." -- Buckaroo Banzai
    2. Re:Why might it be better than the free docs? by EricTheGreen · · Score: 1

      A few of the packages could use a little bit of help on the documentation front. JXPath (at least for me) comes to mind quickly. Great package, just a bit hard to get the conceptual grasp around.

      Other packages (functors, for example), would probably benefit from much more extensive examples demonstrating their power and flexibility in providing elegant solutions for certain classes of problems.

      Neither of the above are best accomplished via the Javadocs--well-written, probing dissections of solution applications would be more useful.

  11. Do web logs count? by gosand · · Score: 1
    Stop reading it the minute you realize it's shit.

    Do you apply the same criteria to blogs? I guess not, or you wouldn't have posted...

    --

    My beliefs do not require that you agree with them.

  12. Re:(OT) Request: Help From Moderators by MynockGuano · · Score: 2, Funny

    This is like punch the monkey, Slashdot style.

    Please mod down these peo--WHACK
    Why don't you spend your mod poin--SMACK
    Can't you see that you're all being very unreaso--POW
    OMG WTF STOP IT YOU STUPID IDIO--THWACK

  13. whatever by fkamogee · · Score: 2, Insightful

    Call it a troll if you want, but this is what I really think.

    1) Commons is way overrated. A lot of the code is not great if you dig into it, and generally the components solve very small problems. Often, you're better off doing it yourself than adding a volatile dependency to your project.

    2) There are some worthwhile components in Commons, but that does not imply that that the same quality or usefulness can be assumed of the other components. Same goes for the rest of Jakarta. And the rest of ASF.

    3) Those Commons components that are good seemingly get used by everybody, resulting in versioning conflicts between your various third-party libraries. Which is fun because the API's are unstable, and because the project maintainers sometimes fail to maintain either compatibility or mutual exclusion between releases. This happened with the Collections component.

    4) Seriously, OP, you thought this would be a great book? What is there to offer in a book that's not online? And considering the instability of these packages, how long is that book going to be relevant?

    1. Re:whatever by the+MaD+HuNGaRIaN · · Score: 1

      Mod parent "Insightful"

      All four points are 100% true.

    2. Re: Whatever by SlightlyOldGuy · · Score: 2, Insightful

      So I should write all this stuff for myself? Really? No thanks. Some of the Commons components are annoying, but not as annoying as my done-under-deadline versions. If your stuff is so wonderful, perhaps you might consider contributing some of it? hm?

    3. Re:whatever by Anonymous Coward · · Score: 0

      1 + 3) definitely.

      2 + 4) fall into Captain Obvious territory.

    4. Re:whatever by Anonymous Coward · · Score: 0

      And I would like to add that their distribution scheme is TERRIBLE. There have been a couple jarkarta projects that I've tried out recently (mondrian being the most notorious in this respect), but they manage to fail to mention that they have dependencies on about a million commons codecs. I know it's not the codec's fault that the other projects don't mention which ones they use, but it IS their fault that they have difficult to navigate (none that I remember have a download-latest version link that actually links right to the file) and inconsistant webpages.

      And there are so bloody many of them! As I said, with mondrian it was run, look at exception's stack trace, go figure out which codec to download. Run, look at.... etc.

      The accessibility of them stinks. But I think I've made my point by now.

    5. Re:whatever by Anonymous Coward · · Score: 2, Insightful

      First, I'll declare my bias. I'm a maintainer for one of the commons projects.

      re (1): There are very few (if any) projects in commons that haven't taken at least 6 man-months of development time. If you do only want a very small piece of the functionality of one project, then maybe you're better off doing it yourself but generally I think reusing the existing code *does* provide significant time savings.

      re (2) Well, that's probably true of code anywhere. But code doesn't get into commons unless it's being used by some project.

      re (3)
      In order to improve software it is sometimes necessary to change APIs - but that only ever happens on major version changes (eg collections 2.x to collections 3.x). Commercial packages do the same thing. Yes, it can be a nuisance, particularly as the poster said when building a large project where multiple other components depend upon commons too. Suggestions for solutions to this issue are very welcome!

      Note that due to the APL license you are free to take the commons code, and put your own package names on it. That way, you get the commons code but with no version dependency issues. Of course you can't easily integrate fixes to the original package into your "forked" version. This still has to be better than writing the code yourself though (and don't forget those unit tests and javadoc!).

      re (4): Major number revisions of important commons components happens fairly rarely. And of course as the components get more mature it happens less. I can't see collections making a non-compatible change again for several years (if ever). And even in a major-number revision, only a small part of the API is likely to change. That's not going to obsolete either a book or a user's knowledge of the component.

    6. Re:whatever by Zeneris · · Score: 1

      Granted some of the Jakarta commons libraries are a bit lacking/annoying, poorly designed or pointless, but can be a good base for development once patched, even then it's still quicker than rolling all the code yourself.

      IMHO:

      I think commons-logging is pointless and wish it would die, Log4J was first, is still much better than JRE logging. commons-logging configuration is grossly inadequate for Log4J because it does not support Log4J XML config.

      I find the main Jakarta branch less annoying as I have not had to tweak code there e.g. regexp, oro, log4j.

      The Log4J methods debug, info, warn, error and fatal methods are not useful in serious code given that they are useless for logger wrappers and level checks are often done for expensive logging code. I would like to see finer logging levels added to allow better log tweaking e.g. for testing and varying live environments. I also find it naive and annoying that the Log4J only supports static config, so that only one root logger can be used in a JRE, this prevents the use of multiple loggers and filters are not a practical workaround e.g. I may want a separate logger for each website in Tomcat or for multiple programs (in a separate thread) in a JRE.

    7. Re:whatever by Anonymous Coward · · Score: 0

      I don't think you've understood commons-logging correctly. It's *not* a logging library, just a portable wrapper around other libraries. As such, it doesn't deal with configuration of those libs in any way at all (except for the trivial built-in SimpleLog implementation). When using commons-logging as a wrapper over log4j, you still configure log4j in the normal way - including using xml config files if you wish.

      commons-logging is optional when writing apps - yes, you can write direct to log4j if you want. But commons-logging is critical when writing libraries that other people will include in arbitrary applications. Such libs obviously can't write direct to log4j - because the app they are included as part of might use a different logging library. That's why commons components use commons-logging.

      Normally, if you want separate log4j config per webapp, you just select "child first" (aka parent-last) classloader lookup, and put log4j.jar in the webapp's lib directory. Done. You now have a separate root logger per webapp.

      Recent versions of log4j provide an alternative though - see the RepositorySelector feature.

      Or you can simply use the Hierarchy class directly in order to create your own private logger "tree" at any time. Of course you then can't use the static methods to get loggers (they return loggers from the default Hierarchy) but the solution to that is pretty obvious.

  14. Where's the review? by Augusto · · Score: 2, Insightful

    And what does rating (4) mean? (4 out of what?)

    What are the other books that are better? Why?

    What is the "Jakarta Commons"? I know what it is, but you'd think the review will explain this briefly and then say how the book failed or succeding at explaining them.

    I give this review a rating of "[".

    --

    - sigs are for wimps.
  15. Re:(OT) Request: Help From Moderators by Da+VinMan · · Score: 1

    That may be OT, but FWIW, that was frickin funny. :+)

    --
    Please mod this post only if you think others should/n't read this. I have enough ego^H^H^Hkarma. Thanks!
  16. Re:(OT) Request: Help From Moderators by maverick97008 · · Score: 1

    Hear, Hear! All these moderator directives are getting annoying. If we don't attempt to stop it all we will see eventually is meta-comments.

  17. That's what I did with this review. by Anonymous Coward · · Score: 0

    It made it seem even shorter.

  18. Pot-smoking PETAphile ahoy! by Anonymous Coward · · Score: 0

    Guess what sort of paper the Declaration of Independence is written on.

    Problem is, everyone knows that campaigners for the legalisation of hemp are really just potheads who want an excuse to smoke weed.

    BTW, I just noticed your sig, and I hate to break it to you, but the Declaration of Independence is printed on veal.

    I hope that ruined your day :-P

  19. FYI From The Author by will_iverson · · Score: 5, Informative

    I would just like to respond to the bit about "cash cow":

    1. The book itself is published under an open license - the material in the book will be available as a free electronic download in a few months.

    2. Yes, the last 125 pages *is* (for all intents and purposes) the printed javadoc. This was included at the request of the publisher, and it is valuable for some people.

    So... I don't know how negatively the review was influenced by the inclusion of the Apache material, but it is entirely above-board per the Apache license and essentially reciprocal - I'm giving the material in the book back to the community via a free license to download the material.

    Oh, and as an FYI, book writing is hardly a cash cow - I only wish. ;)

    If folks have any questions (e.g. why the delay in making the electronic version available? What is the state of affairs for tech book publishing? Why aren't you rich writing books yet?) let me know...

    Cheers & best wishes,

    -Will Iverson

    1. Re:FYI From The Author by Tore+S+B · · Score: 1

      Though I value that reply about as much as the fluff I keep accumulating in my navel, I do indeed wonder why the electronic version is delayed.

      --
      toresbe
    2. Re:FYI From The Author by n3bulous · · Score: 1

      Perhaps so that the publisher stands a chance to make *some* money? It's not like anyone other than a java geek will buy the book (ok, maybe the author's mom...), and geeks are more willing to just use what's freely available online.

      As the author stated, book writing is not a cash cow (at least that's what every author says...), especially when your market is so small and there are other options. However, I would like to know how much he got/gets for the book.

      --
      "The area of penetration will no doubt be sensitive." ~ Spock
    3. Re:FYI From The Author by Tore+S+B · · Score: 1

      Perhaps so that the publisher stands a chance to make *some* money? It's not like anyone other than a java geek will buy the book (ok, maybe the author's mom...), and geeks are more willing to just use what's freely available online.

      Well, the only reason to buy a book is that deadtreeware is easier to read and the human mind is more compatible with it. THere is a lot of documentation online, yet people still buy the book. K&R C is online, I bought the book.

      --
      toresbe
  20. good to hear no javadocs by steve_l · · Score: 2, Insightful

    I'm glad you dont have javadocs. Its a cheap way to make a bad book.

    more to the point, it dates so fast in the OSS world. Oreilly could get away with the original Java in a Nutshell book because the entire Java API was small enough to print, and because the API stayed frozen for two years.

    but any living OSS project has an API that evolves weekly; and point releases every few months. printed documentation just doesnt cut it here. Instead books have to focus on why and how to use library, not what the APIs are.

    I know that is actually harder, but the reader benefits, and so ultimately, the author and publisher.

    -steve

    (currently writing the second edition of Java Development with Ant)

    1. Re:good to hear no javadocs by bluGill · · Score: 1

      I like the nutshell books. I only have two monitors on my desk, and they have are full of windows. (testing here, /. there, code here (more like here there and everywhere), I don't have much free space. Except for /. (which isn't up often) I need all those windows.

      With nutshell books I have a good reference that I can place on my physical desk. Not everything I need is in them, but when I need a quick refresher on some syntax or library it is nice.

      I don't see the point in online nutshell types books, but they have a useful place on my desk.

  21. another interesting coincidence by willCode4Beer.com · · Score: 1

    Weren't the drug laws passed around the same time as the civil rights ammendment?
    Aren't the overwhelming majority of people convicted on drug charges African American?
    In many states convicted felons never regain the right to vote.

    I am not putting on the tinfoil hat here, I'm just pointing out an interesting coincidence.

    There are a lot of knowledgeble people here, I hope someone will point out a misconception or bad info (please).

    --
    ----- If communism is a system where the government owns business, what do you call a system where business owns govern
    1. Re:another interesting coincidence by jc42 · · Score: 1

      Weren't the drug laws passed around the same time as the civil rights ammendment?

      Nah; you're off by half a century. ;-)

      The original US anti-drug laws were passed in the 1920's. Before that, drugs like marijuana and opium were sold openly and legally.

      Actually, various kinds of "civil rights" laws (and amendments) date to nearly every decade of the country's history.

      The 13th Amendment, which outlawed slavery and involuntary servitude, dates from 1865, and was ratified. "Civil Rights Ammendment" usually refers to the 14th Amendment, was also ratified in 1868. Then there was the big Civil Rights Act of 1964.

      Needless to say, these legal documents didn't always have quite the effect that was intended. Thus, some historians point out that the 13th Amendment's "involuntary servitude" phrase was included to outlaw the military draft, but it didn't have that effect at all. And how laws are enforced (or ignored) means a lot more than what the laws say.

      --
      Those who do study history are doomed to stand helplessly by while everyone else repeats it.
  22. thanks by willCode4Beer.com · · Score: 1

    I don't know why I kept thinking these laws were passed around the late 50's. Maybe, I'm thinking old jazz scene.
    Of course, the Civil Rights Act was the one I meant.

    thank you for the clarification

    --
    ----- If communism is a system where the government owns business, what do you call a system where business owns govern
  23. Bullsh*t article by Anonymous Coward · · Score: 0

    As represented by the poor number of responses.
    Personally, I fell asleep half way through the summary.

    -10 points for posting drivel.

  24. yet another interesting coincidence by Sneftel · · Score: 1

    And at about the same time, President Kennedy was assassinated! Well, that's enough proof for me; the banning of pot was clearly a plot to kill trees, keep Blackie down, and shoot the president!

    --
    The opinions stated herein do not necessarily represent those of anybody at all. Deal with it.
  25. Jakarta Commons Online Bookshelf by gvix · · Score: 1

    Manning decided to publish my book in an online pdf format only, since Tim and the others beat me to the market. On the plus side, the book is available to read now, and you only need to buy the chapters that you are interested in rather than the whole book. The book *may* have future updates as well.

    I would appreciate if someone would do a review of it here. Since it is not sold on Amazon, I have only had very few feedback comments (all of them good :) ).

    Regards, Vikram Goyal

    Jakarta Commons Online Bookshelf: http://www.manning.com/goyal