Re: jdom 2.0 with generics

Author Login • Post Reply

Hi all.

I'm working on making the code available again. There are the usual issues, on my home server, etc.

On a more immediate level though, the code I have is based what's now old JDOM code (1.1). I did my changes a while ago. See the 'JDom and Java5' thread(s) here:

http://www.jdom.org/pipermail/jdom-interest/2008-February/thread.html

Then again, not much was changed between 1.1 and now.

I have re-instated the git.tuis.net website..... Here's the original mail I wrote, with the updated URL's. Note, I don't have a git-server running any more, but the code is available using the http url....

Rolf

==================================

Hi All.

I have ported JDom to use Java constructs throughout the code. I have taken great pains to make the ported library as similar to the existing one as possible. In fact, I believe that, in 99% of the cases, you will probably be able to take the Java5 version and simply recompile your code against the new Jar and have no problems.

At the same time, the code does a full implementation of Generics, removes encumbrances required to support old Java versions (Java1.2, etc.), and generally spruces up some of the ways that some things are done.

The porting has necessitated the rewrite of a number of core sections of code (like ContentList), but there are performance improvements in there too.

Obviously this has been an individual effort with all the pitfalls of 'single-mindedness' in there too. Any criticisms of the code will be welcomed as the intention is to get a good result.

I believe all the nice things in Java5 are now available, especially those using generics where all the methods return correctly typed data like such that constructs like:

   Element root = document.getRootElement();
   for (Element child : root.getChildren()) {
       // do something with element child....
   }

are now possible.

At this stage, the work is done, and I am just trying to determine how much interest there is in such a port.

I have set up an 'unreliable' server (it is my computer at home on a residential cable-modem....) at git.tuis.net where you can:

browse a full repository of the three core JDom projects (jdom, jdom-test, and jdom-contrib):
http://git.tuis.net/

read a README I put together:
http://git.tuis.net/jdom/README.Java5.txt

Download the actual source code (zipped or not):
http://git.tuis.net/jdom/src/
http://git.tuis.net/jdom/jdom.src.tar.gz

Download the actual jar:
http://git.tuis.net/jdom/jdom.jar

Review the API Docs:
http://git.tuis.net/jdom/apidocs/

Those wanting to access the repositories in git format can do so, or those with CVS can access the same repository using the (git-based) CVS proxies:

Thus, if you want to get a hold of the repositories, you can, using git:



Or, using (slower) http protocol:

git clone http://git.tuis.net/git/jdom.git
git clone http://git.tuis.net/git/jdom-contrib.git
git clone http://git.tuis.net/git/jdom-test.git



Depending on the levels of interest in this there will probably be the requirement to migrate these repositories to a more reliable server, etc. We'll cross that bridge if we get to it.

Rolf

On 22/07/2011 9:26 AM, Noel Grandin wrote:

Hi

Rolf - How about modifying the package name to be org.jdom2 ? That should make the people who want a new package name so as not to step on old code happy.
And can you put the code somewhere accessible?

Thomas - how would you like to receive changes? As a diff patch?

Thanks, Noel Grandin

_______________________________________________
To control your jdom-interest membership:
http://www.jdom.org/mailman/options/jdom-interest/youraddr@(protected)

Re: [jdom-interest] jdom 2.0 with generics

Rolf Lear

2011-07-22