Deploying JAX-WS and JAX-RS Applications

You can deploy JAX-WS and JAX-RS services in a running Carbon instance by bundling them in a CXF application. Generally, the folder structure of a CXF application is as follows.

HellowService.war
    WEB-INF/
        web.xml
        cxf-servlet.xml
        wsdl
        lib/
        classes/
    META-INF/
        webapp-classloading.xml

However, this can change depending on your service. Please see the Webapp ClassLoading page for adding webapp-classloading.xml. It's a custom file implemented by WSO2 to give flexibility in classloading. You must have this file to deploy JAX-WS and JAX-RS applications because CXF runtime is not visible to the webapps by default.

Follow the instructions below to deploy your CXF application.

1. Log on to the product's Management Console and select "JAX-WS/JAX-RS” under “Applications” -> “Add” in the left pane.

2. The "Upload JAX-WS/JAX-RS Applications" page appears. Select your .war file and click "Upload". For example,

You can click the plus ‘+’ sign button to upload multiple Webapps at the same time.

3. If the file is uploaded successfully, a message appears prompting you to refresh the page. Click OK.

If the deployment is not successful, the application will be listed in a Faulty JAX-WS/JAX-RS Application link. You can click the link to view the errors.

4. Refresh the "Running Applications" page in the product's Management Console to view the newly-added application listed.

Instead of using the management console, you can manually place your JAX-WS/JAX-RS .war files to <PRODUCT_HOME>/repository/deployment/server/jaxwebapps directory.

Testing the JAX-WS/JAX-RS Application

Follow the instructions below to test your CXF application.

1. Log on to the product's Management Console and select "List" under menu "Applications".

2. The "Running Applications" page appears. Click on the "Find Services" link associated with a given JAX-WS/JAX-RS application.

3. A list of SOAP and RESTful services deployed through your application will be opened in a separate browser window.

For example,

You can use the WSDL URLs of the services and try those services using the  Try-It tool which can be found under Tools/Try-It menu.