Packaging Your Application

Overview

When packaging and deploying your J2EE application you must declare the resource reference used in your code in your application deployment descriptor and map that resource reference to a resource. In addition, you need to package the Web service interface classes with your application.

Declaring the resource reference

You must declare the resource reference used in your code in your application deployment descriptor, web.xml, by adding a resource-ref tag. See Example 3.2.

Example 3.2. Declaring the resource reference

<resource-ref>
     <res-ref-name>eis/CXFConnectionFactory</res-ref-name>
     <res-type>org.apache.cxf.jca.outbound.CXFConnectionFactory</res-type>
     <res-auth>Container</res-auth>
</resource-ref>

Mapping the resource reference

You must map the resource reference used in your code to the resource. How you do this is dependent on the application server that you are using. For example, if you are using WebSphere you can use the WebSphere Administrative Console to map the resource reference to the resource while deploying the FUSE Services Framework JCA Connector. See Deploying FUSE Services Framework JCA Connector and the WebSphere documentation for details.

Packaging details

When packaging your application, include the Java classes that are generated by the wsdl2java tool and any other classes that are associated with your application. You can include the service's WSDL file, however, this is not necessary (see the description of wsdlURL in Usage pattern.

For example, the outbound sample application is packaged in a WAR file as follows:

WEB-INF/classes — includes the application Java class files, the Java classes that are generated from the WSDL file.
WEB-INF/classes/wsdl — WSDL file.
WEB-INF/lib — includes a common.jar file that contains the DemoServletBase.class file, which the sample application extends.

Please refer to the J2EE specification and your J2EE vendor documentation for more information on application packaging.