[sword-devel] I want to port the API to Java

Troy A. Griffitts sword-devel@crosswire.org
Wed, 05 Dec 2001 13:55:25 -0700

Hey guys.  Just to clear up a few things:

	jsword is indeed all of java code related to sword.  It included out
jsp support classes, but also includes the beginnings of a port of the
entire api.  You can check it out like any other cvs module from our cvs
server with the module name jsword.

	There probably are a number of classes that are half complete.  I
copied the c++ classes from the api about 2 years ago and started a
fairly direct port, changing only to standard java method names and
constructs, but leaving the functionality for each class intact.

	jsword currently requires the jgl container api.  The current, standard
java container library is not extensive enough to contain a multimap
equivelant of the c++ stl.  The primary difference between a map and
multimap is that a multimap has the ability to iterate thru duplicate
key values, whereas a map does not allow duplicate key values.

	I remember stopping at versekey.cpp.  I wanted to rewrite versekey.cpp
internals in c++ anyway and didn't want to port poor code :)  Never
rewrote it. :)

	I also have been meaning to get the project B drivers into the jsword
library.  I would love for us to work together.  I think our main issue
is that project B probably doesn't want to give up their interface, and
I feel a crosswire port of our api should probably be similar to our c++
api, so developers can switch between both worlds easily and have all
the same concepts available to them.

	Let me know what you guys think.  I don't remember the state of
things.  I believe just the Managers (reading installed module sets,
etc.) are working, as we use them extensively on the website.

	Please spend some time reviewing the jsword cvs module and let me know
how bad of shape it's in and I'd be happy to help you out with more
direction and information!  This is exciting!  I would love to see you
guys make an awesome java framework for java developers!

	In Him,

Mike Dougherty wrote:
> On Wed, 2001-12-05 at 09:12, Daniel Glassey wrote:
> > On 5 Dec 2001 at 8:29, Mike Dougherty sent forth the message:
> >
> > > On Wed, 2001-12-05 at 04:52, Darrell Burk wrote:
> > > > I've just recently learned about the Sword project, and I can't say how glad I am that there is a project that I can be personally involved in that is getting free online Bibles out to people!
> > > >
> > > > Anyway, I'm interested in doing a Java port of the Sword API. It's premature to think about it now, but I think I'd like to do a Java GUI after the port...
> > > >
> > > > Where can I get the information I'll need to port the API? Also, is there already work on this in progress, and if so could they use help?
> > >
> > > I would also like to see a Java port of this software. I actually read
> > > about a mysterious project called JSword (which I assumed was a Java
> > > port), but when I asked the list about it no body provided any
> > > information about it.
> > >
> > > Maybe between the two of us we can get something going?
> >
> > Hi, sorry no-one replied to your earlier message Mike. JSword is actually the cvs module for the
> > jsps on the website not the sword API. There's been talk before about porting it to Java but I
> > don't think anyone has got very far yet (I'm sure someone will correct me if I'm wrong)
> > It would be great to see something though :)
> >
> > In the sword CVS is the API documentation doc/api-documentation/
> > That and the developers page http://www.crosswire.org/sword/develop/index.jsp
> > are a good place to start, and post any questions to the list.
> >
> > hth,
> > Daniel
> >
> Daniel: Thanks for replying and clearing up my misunderstanding about
> JSword.
> Actually, I misspoke a little. I did get a reply in regards to Java and
> Sword but it was in reference to another project called Project B (also
> on SourceForge). Project B has a complete (or what appeared to be
> complete) Java library for reading Sword modules.
> It occurs to me that maybe there could be a combination of efforts. But
> I don't know if either project would be open to such an idea.
> /mike
> --
> ******************************************
>  Mike Dougherty -- Java Software Engineer
> ******************************************
>  Woman:      "Is Yoo-Hoo hyphenated?"
>  Yogi Berra: "No, ma'am, its not even carbonated."