2 ~ Licensed to the Apache Software Foundation (ASF) under one
3 ~ or more contributor license agreements. See the NOTICE file
4 ~ distributed with this work for additional information
5 ~ regarding copyright ownership. The ASF licenses this file
6 ~ to you under the Apache License, Version 2.0 (the
7 ~ "License"); you may not use this file except in compliance
8 ~ with the License. You may obtain a copy of the License at
10 ~ http://www.apache.org/licenses/LICENSE-2.0
12 ~ Unless required by applicable law or agreed to in writing,
13 ~ software distributed under the License is distributed on an
14 ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 ~ KIND, either express or implied. See the License for the
16 ~ specific language governing permissions and limitations
20 <axisconfig name="AxisJava2.0">
21 <!-- ================================================= -->
23 <!-- ================================================= -->
24 <parameter name="hotdeployment">true</parameter>
25 <parameter name="hotupdate">false</parameter>
26 <parameter name="enableMTOM">false</parameter>
27 <parameter name="enableSwA">false</parameter>
29 <!--Uncomment if you want to enable file caching for attachments -->
30 <!--parameter name="cacheAttachments">true</parameter>
31 <parameter name="attachmentDIR"></parameter>
32 <parameter name="sizeThreshold">4000</parameter-->
34 <parameter name="EnableChildFirstClassLoading">false</parameter>
37 The exposeServiceMetadata parameter decides whether the metadata (WSDL, schema, policy) of
38 the services deployed on Axis2 should be visible when ?wsdl, ?wsdl2, ?xsd, ?policy requests
40 This parameter can be defined in the axi2.xml file, in which case this will be applicable
41 globally, or in the services.xml files, in which case, it will be applicable to the
42 Service groups and/or services, depending on the level at which the parameter is declared.
43 This value of this parameter defaults to true.
45 <parameter name="exposeServiceMetadata">true</parameter>
48 <!--Uncomment if you want to plugin your own attachments lifecycle implementation -->
49 <!--<attachmentsLifecycleManager class="org.apache.axiom.attachments.lifecycle.impl.LifecycleManagerImpl"/>-->
52 <!--Uncomment if you want to enable the reduction of the in-memory cache of WSDL definitions -->
53 <!--In some server environments, the available memory heap is limited and can fill up under load -->
54 <!--Since in-memory copies of WSDL definitions can be large, some steps can be taken-->
55 <!--to reduce the memory needed for the cached WSDL definitions. -->
56 <!--parameter name="reduceWSDLMemoryCache">true</parameter-->
58 <!--This will give out the timout of the configuration contexts, in milliseconds-->
59 <parameter name="ConfigContextTimeoutInterval">30000</parameter>
61 <!--During a fault, stack trace can be sent with the fault message. The following flag will control -->
63 <parameter name="sendStacktraceDetailsWithFaults">false</parameter>
65 <!--If there aren't any information available to find out the fault reason, we set the message of the exception-->
66 <!--as the faultreason/Reason. But when a fault is thrown from a service or some where, it will be -->
67 <!--wrapped by different levels. Due to this the initial exception message can be lost. If this flag-->
68 <!--is set, then Axis2 tries to get the first exception and set its message as the faultreason/Reason.-->
69 <parameter name="DrillDownToRootCauseForFaultReason">false</parameter>
71 <parameter name="userName">admin</parameter>
72 <parameter name="password">axis2</parameter>
74 <!--To override repository/services you need to uncomment following parameter and value SHOULD be absolute file path.-->
75 <!--ServicesDirectory only works on the following cases-->
76 <!---File based configurator and in that case the value should be a file URL (http:// not allowed)-->
77 <!---When creating URL Based configurator with URL file:// -->
78 <!--- War based configurator with expanded case , -->
80 <!--All the other scenarios it will be ignored.-->
81 <!--<parameter name="ServicesDirectory">service</parameter>-->
82 <!--To override repository/modules you need to uncomment following parameter and value SHOULD be absolute file path-->
83 <!--<parameter name="ModulesDirectory">modules</parameter>-->
86 <!--Following params will set the proper context paths for invocations. All the endpoints will have a commons context-->
87 <!--root which can configured using the following contextRoot parameter-->
88 <!--<parameter name="contextRoot">axis2</parameter>-->
90 <!--Our HTTP endpoints can handle both REST and SOAP. Following parameters can be used to distinguiush those endpoints-->
91 <!--In case of a servlet, if you change this you have to manually change the settings of your servlet container to map this -->
92 <!--context path to proper Axis2 servlets-->
93 <!--<parameter name="servicePath">services</parameter>-->
94 <!--<parameter name="restPath">rest</parameter>-->
96 <!-- Following parameter will completely disable REST handling in Axis2-->
97 <parameter name="disableREST" locked="false">false</parameter>
99 <!-- Following parameter will suppress generation of SOAP 1.2 bindings in auto-generated WSDL files -->
100 <parameter name="disableSOAP12" locked="true">false</parameter>
102 <!--POJO deployer , this will alow users to drop .class file and make that into a service-->
103 <deployer extension=".class" directory="pojo" class="org.apache.axis2.deployment.POJODeployer"/>
104 <deployer extension=".jar" directory="servicejars"
105 class="org.apache.axis2.jaxws.framework.JAXWSDeployer"/>
106 <deployer extension=".jar" directory="transports"
107 class="org.apache.axis2.deployment.TransportDeployer"/>
109 <!--CORBA deployer , this will alow users to invoke remote CORBA services through Axis2-->
110 <!--<deployer extension=".xml" directory="corba" class="org.apache.axis2.corba.deployer.CorbaDeployer"/>-->
112 <!--<deployer extension=".jsa" directory="rmiservices" class="org.apache.axis2.rmi.deploy.RMIServiceDeployer"/>-->
115 <!-- Following parameter will set the host name for the epr-->
116 <!--<parameter name="hostname" locked="true">myhost.com</parameter>-->
118 <!-- If you have a front end host which exposes this webservice using a different public URL -->
119 <!-- use this parameter to override autodetected url -->
120 <!--<parameter name="httpFrontendHostUrl">https://someotherhost/context</parameter>-->
122 <!--By default, JAXWS services are created by reading annotations. WSDL and schema are generated-->
123 <!--using a separate WSDL generator only when ?wsdl is called. Therefore, even if you engage-->
124 <!--policies etc.. to AxisService, it doesn't appear in the WSDL. By setting the following property-->
125 <!--to true, you can create the AxisService using the generated WSDL and remove the need for a-->
126 <!--WSDL generator. When ?wsdl is called, WSDL is generated in the normal way.-->
127 <parameter name="useGeneratedWSDLinJAXWS">false</parameter>
129 <!-- The way of adding listener to the system-->
130 <!-- <listener class="org.apache.axis2.ObserverIMPL">-->
131 <!-- <parameter name="RSS_URL">http://127.0.0.1/rss</parameter>-->
134 <threadContextMigrators>
135 <threadContextMigrator listId="JAXWS-ThreadContextMigrator-List"
136 class="org.apache.axis2.jaxws.addressing.migrator.EndpointContextMapMigrator"/>
137 </threadContextMigrators>
139 <!-- ================================================= -->
140 <!-- Message Receivers -->
141 <!-- ================================================= -->
142 <!--This is the default MessageReceiver for the system , if you want to have MessageReceivers for -->
143 <!--all the other MEP implement it and add the correct entry to here , so that you can refer from-->
144 <!--any operation -->
145 <!--Note : You can override this for a particular service by adding the same element with your requirement-->
147 <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only"
148 class="org.apache.axis2.receivers.RawXMLINOnlyMessageReceiver"/>
149 <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
150 class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>
151 <messageReceiver mep="http://www.w3.org/2006/01/wsdl/in-only"
152 class="org.apache.axis2.receivers.RawXMLINOnlyMessageReceiver"/>
153 <messageReceiver mep="http://www.w3.org/2006/01/wsdl/in-out"
154 class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>
155 <messageReceiver mep="http://www.w3.org/ns/wsdl/in-only"
156 class="org.apache.axis2.receivers.RawXMLINOnlyMessageReceiver"/>
157 <messageReceiver mep="http://www.w3.org/ns/wsdl/in-out"
158 class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>
161 <!-- ================================================= -->
162 <!-- Message Formatter -->
163 <!-- ================================================= -->
164 <!--Following content type to message formatter mapping can be used to implement support for different message -->
165 <!--format serialization in Axis2. These message formats are expected to be resolved based on the content type. -->
167 <messageFormatter contentType="application/x-www-form-urlencoded"
168 class="org.apache.axis2.transport.http.XFormURLEncodedFormatter"/>
169 <messageFormatter contentType="multipart/form-data"
170 class="org.apache.axis2.transport.http.MultipartFormDataFormatter"/>
171 <messageFormatter contentType="application/xml"
172 class="org.apache.axis2.transport.http.ApplicationXMLFormatter"/>
173 <messageFormatter contentType="text/xml"
174 class="org.apache.axis2.transport.http.SOAPMessageFormatter"/>
175 <messageFormatter contentType="application/soap+xml"
176 class="org.apache.axis2.transport.http.SOAPMessageFormatter"/>
179 <!-- ================================================= -->
180 <!-- Message Builders -->
181 <!-- ================================================= -->
182 <!--Following content type to builder mapping can be used to implement support for different message -->
183 <!--formats in Axis2. These message formats are expected to be resolved based on the content type. -->
185 <messageBuilder contentType="application/xml"
186 class="org.apache.axis2.builder.ApplicationXMLBuilder"/>
187 <messageBuilder contentType="application/x-www-form-urlencoded"
188 class="org.apache.axis2.builder.XFormURLEncodedBuilder"/>
189 <messageBuilder contentType="multipart/form-data"
190 class="org.apache.axis2.builder.MultipartFormDataBuilder"/>
193 <!-- ================================================= -->
194 <!-- Transport Ins -->
195 <!-- ================================================= -->
196 <transportReceiver name="http"
197 class="org.apache.axis2.transport.http.SimpleHTTPServer">
198 <parameter name="port">8080</parameter>
199 <!-- Here is the complete list of supported parameters (see example settings further below):
200 port: the port to listen on (default 6060)
201 hostname: if non-null, url prefix used in reply-to endpoint references (default null)
202 originServer: value of http Server header in outgoing messages (default "Simple-Server/1.1")
203 requestTimeout: value in millis of time that requests can wait for data (default 20000)
204 requestTcpNoDelay: true to maximize performance and minimize latency (default true)
205 false to minimize bandwidth consumption by combining segments
206 requestCoreThreadPoolSize: number of threads available for request processing (unless queue fills up) (default 25)
207 requestMaxThreadPoolSize: number of threads available for request processing if queue fills up (default 150)
208 note that default queue never fills up: see HttpFactory
209 threadKeepAliveTime: time to keep threads in excess of core size alive while inactive (default 180)
210 note that no such threads can exist with default unbounded request queue
211 threadKeepAliveTimeUnit: TimeUnit of value in threadKeepAliveTime (default SECONDS) (default SECONDS)
213 <!-- <parameter name="hostname">http://www.myApp.com/ws</parameter> -->
214 <!-- <parameter name="originServer">My-Server/1.1</parameter> -->
215 <!-- <parameter name="requestTimeout">10000</parameter> -->
216 <!-- <parameter name="requestTcpNoDelay">false</parameter> -->
217 <!-- <parameter name="requestCoreThreadPoolSize">50</parameter> -->
218 <!-- <parameter name="requestMaxThreadPoolSize">100</parameter> -->
219 <!-- <parameter name="threadKeepAliveTime">240000</parameter> -->
220 <!-- <parameter name="threadKeepAliveTimeUnit">MILLISECONDS</parameter> -->
223 <!-- This is where you'd put custom transports. See the transports project -->
224 <!-- for more. http://ws.apache.org/commons/transport -->
226 <!-- ================================================= -->
227 <!-- Transport Outs -->
228 <!-- ================================================= -->
230 <transportSender name="local"
231 class="org.apache.axis2.transport.local.LocalTransportSender"/>
232 <transportSender name="http"
233 class="org.apache.axis2.transport.http.CommonsHTTPTransportSender">
234 <parameter name="PROTOCOL">HTTP/1.1</parameter>
235 <parameter name="Transfer-Encoding">chunked</parameter>
237 <!-- If following is set to 'true', optional action part of the Content-Type will not be added to the SOAP 1.2 messages -->
238 <!-- <parameter name="OmitSOAP12Action">true</parameter> -->
241 <transportSender name="https"
242 class="org.apache.axis2.transport.http.CommonsHTTPTransportSender">
243 <parameter name="PROTOCOL">HTTP/1.1</parameter>
244 <parameter name="Transfer-Encoding">chunked</parameter>
247 <!-- Please enable this if you need the java transport -->
248 <!-- <transportSender name="java"
249 class="org.apache.axis2.transport.java.JavaTransportSender"/> -->
251 <!-- ================================================= -->
252 <!-- Global Modules -->
253 <!-- ================================================= -->
254 <!-- Comment this to disable Addressing -->
255 <module ref="addressing"/>
257 <!--Configuring module , providing parameters for modules whether they refer or not-->
258 <!--<moduleConfig name="addressing">-->
259 <!--<parameter name="addressingPara">N/A</parameter>-->
260 <!--</moduleConfig>-->
262 <!-- ================================================= -->
264 <!-- ================================================= -->
266 To enable clustering for this node, set the value of "enable" attribute of the "clustering"
267 element to "true". The initialization of a node in the cluster is handled by the class
268 corresponding to the "class" attribute of the "clustering" element. It is also responsible for
269 getting this node to join the cluster.
271 <clustering class="org.apache.axis2.clustering.tribes.TribesClusteringAgent" enable="false">
274 This parameter indicates whether the cluster has to be automatically initalized
275 when the AxisConfiguration is built. If set to "true" the initialization will not be
276 done at that stage, and some other party will have to explictly initialize the cluster.
278 <parameter name="AvoidInitiation">true</parameter>
281 The membership scheme used in this setup. The only values supported at the moment are
282 "multicast" and "wka"
284 1. multicast - membership is automatically discovered using multicasting
285 2. wka - Well-Known Address based multicasting. Membership is discovered with the help
286 of one or more nodes running at a Well-Known Address. New members joining a
287 cluster will first connect to a well-known node, register with the well-known node
288 and get the membership list from it. When new members join, one of the well-known
289 nodes will notify the others in the group. When a member leaves the cluster or
290 is deemed to have left the cluster, it will be detected by the Group Membership
291 Service (GMS) using a TCP ping mechanism.
293 <parameter name="membershipScheme">multicast</parameter>
296 The clustering domain/group. Nodes in the same group will belong to the same multicast
297 domain. There will not be interference between nodes in different groups.
299 <parameter name="domain">wso2.carbon.domain</parameter>
302 When a Web service request is received, and processed, before the response is sent to the
303 client, should we update the states of all members in the cluster? If the value of
304 this parameter is set to "true", the response to the client will be sent only after
305 all the members have been updated. Obviously, this can be time consuming. In some cases,
306 such this overhead may not be acceptable, in which case the value of this parameter
307 should be set to "false"
309 <parameter name="synchronizeAll">true</parameter>
312 The maximum number of times we need to retry to send a message to a particular node
313 before giving up and considering that node to be faulty
315 <parameter name="maxRetries">10</parameter>
317 <!-- The multicast address to be used -->
318 <parameter name="mcastAddress">228.0.0.4</parameter>
320 <!-- The multicast port to be used -->
321 <parameter name="mcastPort">45564</parameter>
323 <!-- The frequency of sending membership multicast messages (in ms) -->
324 <parameter name="mcastFrequency">500</parameter>
326 <!-- The time interval within which if a member does not respond, the member will be
327 deemed to have left the group (in ms)
329 <parameter name="memberDropTime">3000</parameter>
332 The IP address of the network interface to which the multicasting has to be bound to.
333 Multicasting would be done using this interface.
335 <parameter name="mcastBindAddress">127.0.0.1</parameter>
337 <!-- The host name or IP address of this member -->
338 <parameter name="localMemberHost">127.0.0.1</parameter>
341 The TCP port used by this member. This is the port through which other nodes will
344 <parameter name="localMemberPort">4000</parameter>
347 Preserve message ordering. This will be done according to sender order.
349 <parameter name="preserveMessageOrder">true</parameter>
352 Maintain atmost-once message processing semantics
354 <parameter name="atmostOnceMessageSemantics">true</parameter>
357 Properties specific to this member
359 <parameter name="properties">
360 <property name="backendServerURL" value="https://${hostName}:${httpsPort}/services/"/>
361 <property name="mgtConsoleURL" value="https://${hostName}:${httpsPort}/"/>
365 The list of static or well-known members. These entries will only be valid if the
366 "membershipScheme" above is set to "wka"
370 <hostName>127.0.0.1</hostName>
374 <hostName>127.0.0.1</hostName>
380 Enable the groupManagement entry if you need to run this node as a cluster manager.
381 Multiple application domains with different GroupManagementAgent implementations
382 can be defined in this section.
384 <groupManagement enable="false">
385 <applicationDomain name="apache.axis2.application.domain"
386 description="Axis2 group"
387 agent="org.apache.axis2.clustering.management.DefaultGroupManagementAgent"/>
391 This interface is responsible for handling management of a specific node in the cluster
392 The "enable" attribute indicates whether Node management has been enabled
394 <nodeManager class="org.apache.axis2.clustering.management.DefaultNodeManager"
398 This interface is responsible for handling state replication. The property changes in
399 the Axis2 context hierarchy in this node, are propagated to all other nodes in the cluster.
401 The "excludes" patterns can be used to specify the prefixes (e.g. local_*) or
402 suffixes (e.g. *_local) of the properties to be excluded from replication. The pattern
403 "*" indicates that all properties in a particular context should not be replicated.
405 The "enable" attribute indicates whether context replication has been enabled
407 <stateManager class="org.apache.axis2.clustering.state.DefaultStateManager"
411 <exclude name="local_*"/>
412 <exclude name="LOCAL_*"/>
414 <context class="org.apache.axis2.context.ConfigurationContext">
415 <exclude name="local_*"/>
417 <context class="org.apache.axis2.context.ServiceGroupContext">
418 <exclude name="local_*"/>
420 <context class="org.apache.axis2.context.ServiceContext">
421 <exclude name="local_*"/>
427 <!-- ================================================= -->
429 <!-- ================================================= -->
430 <phaseOrder type="InFlow">
431 <!-- System predefined phases -->
432 <phase name="Transport">
433 <handler name="RequestURIBasedDispatcher"
434 class="org.apache.axis2.dispatchers.RequestURIBasedDispatcher">
435 <order phase="Transport"/>
437 <handler name="SOAPActionBasedDispatcher"
438 class="org.apache.axis2.dispatchers.SOAPActionBasedDispatcher">
439 <order phase="Transport"/>
442 <phase name="Addressing">
443 <handler name="AddressingBasedDispatcher"
444 class="org.apache.axis2.dispatchers.AddressingBasedDispatcher">
445 <order phase="Addressing"/>
448 <phase name="Security"/>
449 <phase name="PreDispatch"/>
450 <phase name="Dispatch" class="org.apache.axis2.engine.DispatchPhase">
451 <handler name="RequestURIBasedDispatcher"
452 class="org.apache.axis2.dispatchers.RequestURIBasedDispatcher"/>
453 <handler name="SOAPActionBasedDispatcher"
454 class="org.apache.axis2.dispatchers.SOAPActionBasedDispatcher"/>
455 <handler name="RequestURIOperationDispatcher"
456 class="org.apache.axis2.dispatchers.RequestURIOperationDispatcher"/>
457 <handler name="SOAPMessageBodyBasedDispatcher"
458 class="org.apache.axis2.dispatchers.SOAPMessageBodyBasedDispatcher"/>
459 <handler name="HTTPLocationBasedDispatcher"
460 class="org.apache.axis2.dispatchers.HTTPLocationBasedDispatcher"/>
461 <handler name="GenericProviderDispatcher"
462 class="org.apache.axis2.jaxws.dispatchers.GenericProviderDispatcher"/>
463 <handler name="MustUnderstandValidationDispatcher"
464 class="org.apache.axis2.jaxws.dispatchers.MustUnderstandValidationDispatcher"/>
466 <phase name="RMPhase"/>
467 <!-- System predefined phases -->
468 <!-- After Postdispatch phase module author or service author can add any phase he want -->
469 <phase name="OperationInPhase">
470 <handler name="MustUnderstandChecker"
471 class="org.apache.axis2.jaxws.dispatchers.MustUnderstandChecker">
472 <order phase="OperationInPhase"/>
475 <phase name="soapmonitorPhase"/>
477 <phaseOrder type="OutFlow">
478 <!-- user can add his own phases to this area -->
479 <phase name="soapmonitorPhase"/>
480 <phase name="OperationOutPhase"/>
481 <!--system predefined phase-->
482 <!--these phase will run irrespective of the service-->
483 <phase name="RMPhase"/>
484 <phase name="PolicyDetermination"/>
485 <phase name="MessageOut"/>
486 <phase name="Security"/>
488 <phaseOrder type="InFaultFlow">
489 <phase name="Addressing">
490 <handler name="AddressingBasedDispatcher"
491 class="org.apache.axis2.dispatchers.AddressingBasedDispatcher">
492 <order phase="Addressing"/>
495 <phase name="Security"/>
496 <phase name="PreDispatch"/>
497 <phase name="Dispatch" class="org.apache.axis2.engine.DispatchPhase">
498 <handler name="RequestURIBasedDispatcher"
499 class="org.apache.axis2.dispatchers.RequestURIBasedDispatcher"/>
500 <handler name="SOAPActionBasedDispatcher"
501 class="org.apache.axis2.dispatchers.SOAPActionBasedDispatcher"/>
502 <handler name="RequestURIOperationDispatcher"
503 class="org.apache.axis2.dispatchers.RequestURIOperationDispatcher"/>
504 <handler name="SOAPMessageBodyBasedDispatcher"
505 class="org.apache.axis2.dispatchers.SOAPMessageBodyBasedDispatcher"/>
506 <handler name="HTTPLocationBasedDispatcher"
507 class="org.apache.axis2.dispatchers.HTTPLocationBasedDispatcher"/>
508 <handler name="GenericProviderDispatcher"
509 class="org.apache.axis2.jaxws.dispatchers.GenericProviderDispatcher"/>
510 <handler name="MustUnderstandValidationDispatcher"
511 class="org.apache.axis2.jaxws.dispatchers.MustUnderstandValidationDispatcher"/>
513 <phase name="RMPhase"/>
514 <!-- user can add his own phases to this area -->
515 <phase name="OperationInFaultPhase"/>
516 <phase name="soapmonitorPhase"/>
518 <phaseOrder type="OutFaultFlow">
519 <!-- user can add his own phases to this area -->
520 <phase name="soapmonitorPhase"/>
521 <phase name="OperationOutFaultPhase"/>
522 <phase name="RMPhase"/>
523 <phase name="PolicyDetermination"/>
524 <phase name="MessageOut"/>
525 <phase name="Security"/>