Support of Publishing framework is implemented through a new class loader, ClassPathLoader. ClassPathLoader has been tested with Cocoon, SOAP, Xerces, Xalan but it can be used with most Java libraries.

Functions:

• Serving and caching library classes and resources - like regular class loaders
• Caching servlet instances such as org.apache.soap.server.http.RPCRouterServlet for SOAP
• Returning resources from archives with getResourceAsStreamFromArchive method

Version 1.0.4 introduces a mapping mechanism similar to <servlet-mapping>. Why don't we support standard web.xml for Presentation archives and ClassPathLoader libraries?

We could support <servlet-mapping> and <servlet-name>/<servlet-class> without too much effort. <init-param> has more impact. We need to give access to initialization parameters through ServletConfig.getInitParameter; therefore we have to implement our own implementation of Servlet objects or reuse the Application implementation. In the first case we significantly increase the footprint of PageBox. The second option compromizes portability and raises legal issues with commercial products.

We consider the first option but for the moment we only provide a simple mappping using a property file.

E:/cocoonSupport/InputSource.jar;E:/cocoonSupport/lib/xerces_1_2.jar;E:/cocoonSupport/lib/turbine-pool.jar; E:/cocoonSupport/lib/w3c.jar;E:/cocoonSupport/lib/bsf.jar;E:/cocoonSupport/lib/xalan_1_2_D02.jar; E:/cocoonSupport/lib/fop_0_15_0.jar;E:/cocoonSupport/CocoonPatch.jar;E:/cocoonSupport/lib/cocoon.jar; E:/cocoonSupport/lib/xml.jar;E:/jaf-1.0.1/activation.jar;E:/javamail-1.2/mail.jar; E:/soap-2_1/lib/soap.jar;E:/cocoonSupport/loopback.jar;E:/cocoonSupport/cocoonSupport.jar

ClassPath contains the list of the libraries loaded by ClassPathLoader, separated by the OS-dependent path separator.

For Cocoon 1.8,2 we need the following libraries in that order:

• xerces_1_2.jar
• turbine-pool.jar
• w3c.jar
• bsf.jar
• xalan_1_2_D02.jar
• fop_0_15_0.jar
• cocoon.jar

For Apache SOAP 2.1, we need the following libraries in that order:

• activation.jar
• mail.jar
• soap.jar

In case of Cocoon, all needed (and supported) libraries are included in Cocoon package.

In case of Soap, you can use the Cocoon Xerces but you need to download JavaMail and JavaBeans Activation Framework (JAF). We used JavaMail 1.2 and JAF 1.0.1 in our tests. Note that if you use SOAP in SMTP mode, you need additional JavaMail archive.

As you can see we need large set of libraries with potential incompatibilities - which is good news for ClassPathLoader as it allows to run different sets of libraries in the same JVM :-)

We also need to add Xerces and Cocoon patches, InputSource.jar and CocoonPatch.jar. They are described in components. Patches must be put in front of the patched archives.

Eventually we need to add Network process archive, named cocoonSupport.jar. On the example, we also added loopback.jar that contains HTTP and SOAP loopback Web services - for demo purpose we invoke ourself -.

PageboxMapping contains the path of a property file like this:

.xml=org.apache.cocoon.Cocoon
rpcrouter=org.apache.soap.server.http.RPCRouterServlet
messagerouter=org.apache.soap.server.http.MessageRouterServlet
loopbackHTTP=loopback.loopbackServlet

When the key starts with a dot (.), then it is considered as a suffix. We write here every URL ending with .xml must be served by org.apache.cocoon.Cocoon. The example means the same as <url-pattern>*.xml</url-pattern>

When the key doesn't start with a dot, then it is considered as the last part of URL. We write .../rpcrouter must be served by org.apache.soap.server.http.RPCRouterServlet.

Cocoon parameters are specified in a cocoon.properties file. For the support of our processors you simply need to add two lines in cocoon.properties:

You must register loopbackSOAP with the following command:

java org.apache.soap.server.ServiceManagerClient
rpcrouter_url deploy DeploymentDescriptor.xml

<?xml version="1.0"?> <isd:service xmlns:isd="http://xml.apache.org/xml-soap/deployment"
    id="urn:loopbackSOAP">
  <isd:provider type="java"
    scope="Request"
    methods="getDocument">
    <isd:java class="loopback.loopbackSOAP"/>
  </isd:provider>
  <isd:faultListener>org.apache.soap.server.DOMFaultListener</isd:faultListener>
</isd:service>