SV: [jdom-interest] Announcing JDOM b10-rc1

Per Norrman pernorrman at
Sat Feb 14 16:49:15 PST 2004


som feedback (late in the game ...)

I have seen the Parent/Child stuff in CVS but never actually looked at 
the changes and consequences in detail. Until now.

To me, the Parent/Child/Container/Content/whatever stuff is really of no

practical use. Over the years (four, isn't it?) I've acquired a certain
coding style, which is now suddenly subliminally altered. There was once
a vision,
an interface-less vision, which is now blurred. Funny thing, when I
study my 
collective JDOM code, I never seem to treat a Document node the same as
Element node! In fact 99.99% (or close) of my processing is concerned
with either an 
Element, an Attribute or a Text node. I think there isn't enough
to justify a Parent abstraction, at least not in the practical cases.

I really think these changes are going to make more harm than good,
the (long) history of the API.

As an experiment, I took the beta-10 code and applied it to an older
project, started 
with beta-7 and where beta-9 worked OK. This code does some really
intricate navigation inside a rather large, validated, document.
Element#getParent() not being an Element 
really blowed that piece of code away!! 

As for the method names, getChildren/getChildElements, etc: this issue
is of minor
importance, considering the modern IDEs (as long as the behaviour is
the same).
For the record, I would prefer getChildElements (or even
childElements--the JavaBeans
naming standard is overused).

I think this is my point: Stick with the initial vision, follow through
with the 
consequences. You are never going to achieve the perfect API**. Skip

Two other issues, perhaps on a smaller scale:

*) Did you consider the change I proposed to XMLOutputter?

*) Why can't I *get* the current Format from XMLOutputter?

Or maybe this is the "Quest for the Holy API".  We are are all going to
be arrested
on a Scottish moor for believing in an ephemeral computational vision,
thus being a 
threat to the IT society as a virtual impossibility ....


> -----Ursprungligt meddelande-----
> Från: jdom-interest-admin at 
> [mailto:jdom-interest-admin at] För Jason Hunter
> Skickat: den 6 februari 2004 10:09
> Till: jdom-interest at
> Ämne: [jdom-interest] Announcing JDOM b10-rc1
> Good news!
> After today's work I'm proud to report there are NO known API changes 
> required before our 1.0 release.  What we have now is my best effort 
> at a 1.0 release API.
> We may still have bugs or inconsistencies, but the TODO is wiped clean
> of everything I personally deem important enough to stand in 
> the way of 
> a long, long, long awaited 1.0 release.
> My goal is to get us to a 1.0 release in the next 6 weeks. Here's my 
> plan.
> I've posted on a Beta10 Release Candidate #1.  It's built 
> from the very latest CVS source.  You can get it at
> I'd like people who are using b9 to download this and see how things 
> work.  Please double check everything's still prim and proper and 
> performant.  The code passes all the jdom-test cases, but they don't 
> have great coverage (although they did help me find a bug earlier 
> tonight).  Subclassers: I'm especially interested in hearing your 
> feedback since we restricted a lot of visibilities.
> Then I'd like people who've been involved in the API design to 
> thoroughly scour the new Javadocs (online also at 
>  Do all the new structures make sense?
> Is everything consistent?
> Once we're satisfied this b10-rc1 code and interface is correct (in 
> perhaps one to two weeks), we'll ship the formal Beta10.  After that, 
> we'll get started on the 1.0 Release Candidates.  The first 1.0-rc1 
> will be Beta10 minus the deprecated methods.  (We need to ship 1.0 
> without any deprecations.)  We'll try to spread the word to everyone
> that 1.0 is 
> coming and make sure people test their code against it.  We'll have a 
> month to iron out any issues.
> Throughout this process, API corrections will be more important than 
> code corrections.  I'm happy to ship a 1.0.1 with code fixes, but I 
> want the 1.0 API as solid as possible.  We've done a bunch of
> changes since 
> b9, so there's a lot to review.
> Sound good?  When we ship 1.0, I'll collect all those beers.  :-)
> -jh-
> _______________________________________________
> To control your jdom-interest membership: 
uraddr at

More information about the jdom-interest mailing list