[Geoserver-devel] Geoserver-specific geotools source?

GeoServer GeoServer Developer
1

Quick question from a starting developer: I checked out the Geoserver 1.5.x
code from CVS as described in the documentation, built it, ran it, read it,
and everything is fine. During the build process, Maven downloaded the WARs
of Geoserver's special version of Geotools (2.3.5-SNAPSHOT). I'd like to have
the source to that in my project as well. How do I do that? Do I need to
check it out separately, and if so from where and into where?

Note: I'm still interested in the complex data store stuff, but I've been hit
with a bit of a case of musical deadlines so I'm opting for a quick hack
first so that I'll have something to show.

Lourens

--
ir. Lourens Veen University of Amsterdam - IBED
Nieuwe Achtergracht 166
Scientific Software Engineer 1018 WV Amsterdam, The Netherlands
EcoGRID-GAN t: +31 20-5257453 f: +31 20-5257431

2

Lourens Veen ha scritto:

Quick question from a starting developer: I checked out the Geoserver 1.5.x code from CVS as described in the documentation, built it, ran it, read it, and everything is fine. During the build process, Maven downloaded the WARs of Geoserver's special version of Geotools (2.3.5-SNAPSHOT). I'd like to have the source to that in my project as well. How do I do that? Do I need to check it out separately, and if so from where and into where?

Each GeoServer branch works against an associated GeoTools branch.
This is because GeoServer is heavily dependent on GeoTools, so most
of bug fixes or feature enhancement end up involving GeoTools
modifications as well.

GeoServer 1.5.x is based on GeoTools 2.3.x that you can check out from here:
http://svn.geotools.org/geotools/branches/2.3.x/

Hope this helps
Cheers
Andrea

3

If you are using eclipse, another thing you can do is use the
-DdownloadSources=true flag when you run mvn eclipse:eclipse. This will
grab the sources as well and allow you navigate them in eclipse.

But be warned that this takes a while because it downloads sources for
all dependencies, not just geotools. Might be something you want to run
over night.

Anyways I have found this a useful way to automatically link to the
sources of dependent libraries without having to checkout and build them.

-Justin

Lourens Veen wrote:

Quick question from a starting developer: I checked out the Geoserver 1.5.x
code from CVS as described in the documentation, built it, ran it, read it,
and everything is fine. During the build process, Maven downloaded the WARs
of Geoserver's special version of Geotools (2.3.5-SNAPSHOT). I'd like to have
the source to that in my project as well. How do I do that? Do I need to
check it out separately, and if so from where and into where?

Note: I'm still interested in the complex data store stuff, but I've been hit
with a bit of a case of musical deadlines so I'm opting for a quick hack
first so that I'll have something to show.

Lourens

--
Justin Deoliveira
The Open Planning Project
http://topp.openplans.org

4

Justin Deoliveira ha scritto:

If you are using eclipse, another thing you can do is use the
-DdownloadSources=true flag when you run mvn eclipse:eclipse. This will
grab the sources as well and allow you navigate them in eclipse.

So this means we are deploying 2.3.x jars again along with
the continuum builds?
Cheers
Andrea

5

I believe it is refractions who is deploying 2.3 snapshots. We deploy
2.4 and trunk.

Andrea Aime wrote:

Justin Deoliveira ha scritto:

If you are using eclipse, another thing you can do is use the
-DdownloadSources=true flag when you run mvn eclipse:eclipse. This will
grab the sources as well and allow you navigate them in eclipse.

So this means we are deploying 2.3.x jars again along with
the continuum builds?
Cheers
Andrea

!DSPAM:4007,4718d0f2315486491211187!

--
Justin Deoliveira
The Open Planning Project
http://topp.openplans.org

6

On Friday 19 October 2007 17:41:37 Justin Deoliveira wrote:

If you are using eclipse, another thing you can do is use the
-DdownloadSources=true flag when you run mvn eclipse:eclipse. This will
grab the sources as well and allow you navigate them in eclipse.

I did that, and it did download the source jars, but if I add the Geoserver
projects to Eclipse, it only shows the Geoserver stuff, not the Geotools
things. I can't import the Geotools projects from those jars either. I'm not
sure if I can step into them in the debugger, but they don't show up among
the projects. I'm currently just reading through the source, trying to get a
grip on the whole thing.

But be warned that this takes a while because it downloads sources for
all dependencies, not just geotools. Might be something you want to run
over night.

Been there, done that :).

Anyways I have found this a useful way to automatically link to the
sources of dependent libraries without having to checkout and build them.

Definitely. But you will have to do the latter if you want to change that
source.

On Friday 19 October 2007 12:22:53 Andrea Aime wrote:

Lourens Veen ha scritto:
> Quick question from a starting developer: I checked out the Geoserver
> 1.5.x code from CVS as described in the documentation, built it, ran it,
> read it, and everything is fine. During the build process, Maven
> downloaded the WARs of Geoserver's special version of Geotools
> (2.3.5-SNAPSHOT). I'd like to have the source to that in my project as
> well. How do I do that? Do I need to check it out separately, and if so
> from where and into where?

Each GeoServer branch works against an associated GeoTools branch.
This is because GeoServer is heavily dependent on GeoTools, so most
of bug fixes or feature enhancement end up involving GeoTools
modifications as well.

GeoServer 1.5.x is based on GeoTools 2.3.x that you can check out from
here: http://svn.geotools.org/geotools/branches/2.3.x/

Ah, thanks. I checked that out, wrestled my JDK into supporting JAI and
JAI-ImageIO, and got the whole thing to compile. I'm trying to import the
projects into my Eclipse workspace, but the only projects I get are
export-wizzard and foss4g, and those only seem to contain a demo.

Should I be importing these as a library? What am I missing?

Lourens

--
ir. Lourens Veen Universiteit van Amsterdam - IBED
Nieuwe Achtergracht 166
Wetenschappelijk Programmeur 1018 WV Amsterdam, The Netherlands
EcoGRID-GAN tel: 020-5257453 fax: 020-5257431

7

Hi Lourens,

Indeed what i describe will not allow you to edit the geootols source
from eclipse, just browse it. This is how I set up my development
environment when i want to develop with both geosrever and geotools.

1. Import goeserver projects into eclipse with mvn eclipse:eclipse
2. Import geotools projects into eclipse with eclipse:eclipse

Note at this point the GeoServer projects are not compiling directly
against the geotools ones, geoserver is still referencing geotools from
the local maven repository.

So when i need to make a geotools change:

1. Make the code change in eclipse:
2. from the command line run "mvn clean install" on the geotools module
i changed
3. In eclipse, do a "refresh" on any geoserver modules that depend on
the geotools module i changed.

Perhaps not an ideal setup but it works. Some other developers may have
a fancier setup than I.

There are probably things you could do like write a little script to
hack all the eclipse .classpath files to set up the dependencies in the
workspace... but i find this works well enough.

Hope that helps.

-Justin

Lourens Veen wrote:

On Friday 19 October 2007 17:41:37 Justin Deoliveira wrote:

If you are using eclipse, another thing you can do is use the
-DdownloadSources=true flag when you run mvn eclipse:eclipse. This will
grab the sources as well and allow you navigate them in eclipse.

I did that, and it did download the source jars, but if I add the Geoserver
projects to Eclipse, it only shows the Geoserver stuff, not the Geotools
things. I can't import the Geotools projects from those jars either. I'm not
sure if I can step into them in the debugger, but they don't show up among
the projects. I'm currently just reading through the source, trying to get a
grip on the whole thing.

But be warned that this takes a while because it downloads sources for
all dependencies, not just geotools. Might be something you want to run
over night.

Been there, done that :).

Anyways I have found this a useful way to automatically link to the
sources of dependent libraries without having to checkout and build them.

Definitely. But you will have to do the latter if you want to change that
source.

On Friday 19 October 2007 12:22:53 Andrea Aime wrote:

Lourens Veen ha scritto:

Quick question from a starting developer: I checked out the Geoserver
1.5.x code from CVS as described in the documentation, built it, ran it,
read it, and everything is fine. During the build process, Maven
downloaded the WARs of Geoserver's special version of Geotools
(2.3.5-SNAPSHOT). I'd like to have the source to that in my project as
well. How do I do that? Do I need to check it out separately, and if so
from where and into where?

Each GeoServer branch works against an associated GeoTools branch.
This is because GeoServer is heavily dependent on GeoTools, so most
of bug fixes or feature enhancement end up involving GeoTools
modifications as well.

GeoServer 1.5.x is based on GeoTools 2.3.x that you can check out from
here: http://svn.geotools.org/geotools/branches/2.3.x/

Ah, thanks. I checked that out, wrestled my JDK into supporting JAI and
JAI-ImageIO, and got the whole thing to compile. I'm trying to import the
projects into my Eclipse workspace, but the only projects I get are
export-wizzard and foss4g, and those only seem to contain a demo.

Should I be importing these as a library? What am I missing?

Lourens

--
Justin Deoliveira
The Open Planning Project
http://topp.openplans.org