Deployment Descriptor File

Each web service class requires its own deployment descriptor file (services.xml). The build automatically generates a suitable deployment descriptor for the defaults as per Inbound Web Service Properties - ws_inbound.xml. The format and contents of the services.xml are defined by Axis2; see the Apache Axis2 Configuration Guide (http://axis.apache.org/axis2/java/core/docs/axis2config.html) for more information.

To provide a custom services.xml file we suggest you start with the generated copy that you will find in the build/svr/wsc2/<service_name> directory after an initial build of the web services WAR/EAR file. This is illustrated in Getting Started. Place your custom services.xml file in your components/custom/axis/<service_name> directory (usually under source control). (See Deployment Descriptor File - services.xml for details of the contents of this file.) During the build the services.xml files are packaged into the web services WAR file (webservices2.war) as per Axis2 requirements; that is, using this file system structure: WEB-INF/services/<service_name>/META-INF/services.xml (see the Apache Axis2 User's Guide - Building Services http://axis.apache.org/axis2/java/core/docs/userguide-buildingservices.html).