Apache Geronimo v3.0 Documentation: Developing application clients

This tutorial walks you through configuring, developing and deploying an application client with Eclipse and Geronimo. It is organized in the following sections:

When you create an application client project to be running on Geronimo in Eclipse, module IDs of both client-environment and its server-environment should be specified in the deployment plan. By default, GEP will append ClientSide to name of the application client as its artifact ID. Likewise, ServerSide is appened for server-environment.

Here is a sample deployment plan created by GEP.

geronimo-application-client.xml

<?xml version="1.0" encoding="UTF-8"?>
<client:application-client xmlns:app="http://geronimo.apache.org/xml/ns/j2ee/application-2.0" xmlns:client="http://geronimo.apache.org/xml/ns/j2ee/application-client-2.0" 
xmlns:conn="http://geronimo.apache.org/xml/ns/j2ee/connector-1.2" xmlns:dep="http://geronimo.apache.org/xml/ns/deployment-1.2" 
xmlns:ejb="http://openejb.apache.org/xml/ns/openejb-jar-2.2" xmlns:log="http://geronimo.apache.org/xml/ns/loginconfig-2.0" 
xmlns:name="http://geronimo.apache.org/xml/ns/naming-1.2" xmlns:pers="http://java.sun.com/xml/ns/persistence" 
xmlns:pkgen="http://openejb.apache.org/xml/ns/pkgen-2.1" xmlns:sec="http://geronimo.apache.org/xml/ns/security-2.0" 
xmlns:web="http://geronimo.apache.org/xml/ns/j2ee/web-2.0.1">
    <dep:client-environment>
        <dep:moduleId>
            <dep:groupId>default</dep:groupId>
            <dep:artifactId>testApplicationClientSide</dep:artifactId>
            <dep:version>1.0</dep:version>
            <dep:type>car</dep:type>
        </dep:moduleId>
    </dep:client-environment>
    <dep:server-environment>
        <dep:moduleId>
            <dep:groupId>default</dep:groupId>
            <dep:artifactId>testApplicationServerSide</dep:artifactId>
            <dep:version>1.0</dep:version>
            <dep:type>car</dep:type>
        </dep:moduleId>
    </dep:server-environment>
</client:application-client>