{scrollbar}

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.3.1.1 (Eclipse Classic package of Europa distribution), which is platform specific
• Apache Geronimo v2.1.3

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

1. Geronimo schema can be found <GERONIMO_HOME>/schema. Copy all these schema to a folder say geronimoschema.
2. Add the following XML catalog file to this folder and zip it. This will give you geronimoschema.zip

   Code Block
   title 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>

3. Launch Eclipse and select New->Project as shown in the figure.
   
   
   Image Added
   
   
   
4. On the next screen select General->Project. Select Next.
   
   
   Image Added
   
   
   
5. Name the project as geronimoschema and Select Finish.
   
   
   Image Added
   
   
   
6. Under Project explorer right click on geronimoschema project and select Import.
   
   
   Image Added
   
   
   
7. Select General->Archive File. Select Next.
   
   
   Image Added
   
   
   
8. On the next screen Browse to geronimoschema.zip created in step #2.
   
   
   Image Added
   
   
   
9. Once done select Finish.
   
   
   Image Added
   
   
   
10. Under the geronimoschema project you can see all the schema definitions.
    
    
    Image Added
    
    
    
11. Next select Window->Preferences from Eclipse menu.
    
    
    Image Added
    
    
    
12. On the next window select Web and XML->XML Catalog. Select Advanced.
    
    
    Image Added
    
    
    
13. On the next window select GeronimoSchema.xmlcatalog. Select Ok.
    
    
    Image Added
    
    
    
14. On the next screen expand User Specified Entries and you can see all the geronimo specific schema definitions. Select Ok.
    
    
    Image Added

Using the configuration in application development

1. For the next steps we will consider the Stateless Session Bean project.
2. Consider the Few More Configurations section in the above tutorial where you have to add a dependency element for database pool.
3. In StatelessSessionEJB select ejbModule->META-INF->openejb-jar.xml. Right click and select Open With->XML Editor.
   
   
   Image Added
   
   
   
4. Once you have the openejb-jar.xml select Design tab.
   
   
   Image Added
   
   
   
5. Right click and select *Add Child->dependencies.
   
   
   Image Added
   
   
   
6. Right click on sys:dependencies select Add Child->dependency.
   
   
   Image Added
   
   
   
7. Right click on sys:dependency select Add Child->groupId.
   
   
   Image Added
   
   
   
8. You can edit the fields by double clicking against each fields.
   
   
   Image Added
   
   
   
9. Once done open the source tab you can see the dependency element added to openejb-jar.xml.
   
   
   Image Added
   
   
   

This completes the illustration of using Eclipse xml tools for Apache Geronimo.