This tutorial will demonstrate on the usage of Eclipse XML tools to generated Geronimo specific deployment plans.
To run this tutorial, as a minimum you will be required to have installed the following prerequisite software.
- Sun JDK 5.0+ (J2SE 1.5)
- Eclipse 3.4.1 (Eclipse Ganymede SR1 distribution)
- Apache Geronimo v2.2
Details on installing eclipse are provided in the Development environment section. This tutorial is organized in the following sections:
This tutorial will take you with the following steps:
Configuring Eclipse for geronimo schema
- Geronimo schema can be found <GERONIMO_HOME>/schema. Copy all these schema to a folder say geronimoschema.
- Add the following XML catalog file to this folder and zip it. This will give you
geronimoschema.zip
geronimoXmlCatalog.xmlcatalog<?xml version="1.0" encoding="UTF-8"?> <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"> <uri name="http://geronimo.apache.org/xml/ns/attributes-1.2" uri="platform:/resource/geronimoschema/attributes-1.2.xsd"/> <uri name="http://geronimo.apache.org/xml/ns/j2ee/application-2.0" uri="platform:/resource/geronimoschema/geronimo-application-2.0.xsd"/> <uri name="http://geronimo.apache.org/xml/ns/j2ee/application-client-2.0" uri="platform:/resource/geronimoschema/geronimo-application-client-2.0.xsd"/> <uri name="http://geronimo.apache.org/xml/ns/j2ee/connector-1.2" uri="platform:/resource/geronimoschema/geronimo-connector-1.2.xsd"/> <uri name="http://geronimo.apache.org/xml/ns/credentialstore-1.0" uri="platform:/resource/geronimoschema/geronimo-credential-store-1.0.xsd"/> <uri name="http://geronimo.apache.org/xml/ns/deployment/javabean-1.0" uri="platform:/resource/geronimoschema/geronimo-javabean-xmlattribute-1.0.xsd"/> <uri name="http://geronimo.apache.org/xml/ns/j2ee/web/jetty-2.0.2" uri="platform:/resource/geronimoschema/geronimo-jetty-2.0.2.xsd"/> <uri name="http://geronimo.apache.org/xml/ns/web/jetty/config-1.0.1" uri="platform:/resource/geronimoschema/geronimo-jetty-config-1.0.1.xsd"/> <uri name="http://geronimo.apache.org/xml/ns/loginconfig-2.0" uri="platform:/resource/geronimoschema/geronimo-login-config-2.0.xsd"/> <uri name="http://geronimo.apache.org/xml/ns/deployment-1.2" uri="platform:/resource/geronimoschema/geronimo-module-1.2.xsd"/> <uri name="http://geronimo.apache.org/xml/ns/naming-1.2" uri="platform:/resource/geronimoschema/geronimo-naming-1.2.xsd"/> <uri name="http://geronimo.apache.org/xml/ns/j2ee/ejb/openejb-2.0" uri="platform:/resource/geronimoschema/geronimo-openejb-2.0.xsd"/> <uri name="http://geronimo.apache.org/xml/ns/security-1.2" uri="platform:/resource/geronimoschema/geronimo-security-1.2.xsd"/> <uri name="http://geronimo.apache.org/xml/ns/security-2.0" uri="platform:/resource/geronimoschema/geronimo-security-2.0.xsd"/> <uri name="http://geronimo.apache.org/xml/ns/subject-info-1.0" uri="platform:/resource/geronimoschema/geronimo-subject-info-1.0.xsd"/> <uri name="http://geronimo.apache.org/xml/ns/j2ee/web/tomcat-2.0.1" uri="platform:/resource/geronimoschema/geronimo-tomcat-2.0.1.xsd"/> <uri name="http://geronimo.apache.org/xml/ns/web/tomcat/config-1.0" uri="platform:/resource/geronimoschema/geronimo-tomcat-config-1.0.xsd"/> <uri name="http://geronimo.apache.org/xml/ns/j2ee/web-2.0.1" uri="platform:/resource/geronimoschema/geronimo-web-2.0.1.xsd"/> <uri name="http://openejb.apache.org/xml/ns/openejb-jar-2.2" uri="platform:/resource/geronimoschema/openejb-jar-2.2.xsd"/> <uri name="http://geronimo.apache.org/xml/ns/plugins-1.3" uri="platform:/resource/geronimoschema/plugins-1.3.xsd"/> </catalog>
- Launch Eclipse and select New->Project as shown in the figure.
- On the next screen select General->Project. Select Next.
- Name the project as geronimoschema and Select Finish.
- Under Project explorer right click on geronimoschema project and select Import. Then select General->Archive File. Select Next.
- On the next screen Browse to
geronimoschema.zip
created in step #2. Once done select Finish.
- Under the geronimoschema project you can see all the schema definitions.
- Next select Window->Preferences from Eclipse menu.
- On the next window select XML->XML Catalog. Select User Specified Entries and click Add.
- On the next window click the icon beside Location and select workspace.
- Select GeronimoSchema.xmlcatalog. Select OK.
- Specify the key, for example, geronimoschema.
- On the next screen you can see geronimoschema listed.
Using the configuration in application development
- For the next steps we will consider the Stateless Session Bean project.
- Consider the Few More Configurations section in the above tutorial where you have to add a dependency element for database pool.
- In StatelessSessionEJB select ejbModule->META-INF->openejb-jar.xml. Right click and select Open With->XML Editor.
- Once you have the openejb-jar.xml select Design tab.
- You can edit the fields by double clicking against each fields.
- Once done open the source tab you can see the dependency element added to openejb-jar.xml.
This completes the illustration of using Eclipse xml tools for Apache Geronimo.