Learn how to configure the resources required to support advanced web services and SOAP over JMS in Oracle WebLogic Server Multitenant (MT) using WebLogic Scripting Tool (WLST) scripts. Also, the specific configurations that are required when using web services in a WebLogic Server MT environment.
This chapter includes the following sections:
WebLogic Server includes two WLST scripts that provide the ability to configure the resources required for certain JAX-WS web service features in a WebLogic Server MT environment.
wlsws-advanced-jaxws-mt-config.py
: Configures advanced JAX-WS web services including asynchronous messaging, web services reliable messaging, message buffering, web services atomic transactions, and security using WS-SecureConversation.
wlsws-soapjms-mt-config.py
: Configures SOAP over JMS transport.
Both scripts are located in the oracle_home
/oracle_common/webservices/bin/
directory, where oracle_home
is the directory that you specified as Oracle home when you installed WebLogic Server.
Follow these main steps to configure web service resources in a WebLogic Server MT environment.
SOAP over JMS supports both queues and topics as the JMS destination type. The type that you use is determined by the application. When using a uniform distributed topic as the request destination for SOAP over JMS in a WebLogic Server MT environment, you must use a partitioned uniform distributed topic.
In WebLogic JMS, you can configure distributed topics as replicated distributed topics or partitioned distributed topics. While replicated distributed topics work with topicMessageDistributionMode
settings of Compatibility
, One-Copy-Per-Server
, or One-Copy-Per-Application
, partitioned distributed topics work only with One-Copy-Per-Server
or One-Copy-Per-Application
.
To configure a partitioned uniform distributed topic for SOAP over JMS in WebLogic Server MT, configure the @JMSTransportService
annotation, and set the topicMessageDistributionMode
configuration property on the activationConfig
property to One-Copy-Per-Server
or One-Copy-Per-Application
. The Compatibility
value is not supported for partitioned distribution topics.
For example:
@JMSTransportService(targetService="poNotifyService" , destinationName="com.oracle.webservices.jms.SoapJmsRequestTopic" , destinationType=JMSDestinationType.TOPIC , activationConfig = "topicMessagesDistributionMode=One-Copy-Per-Application" , jndiURL = "t3://@wls-server@"
See Using SOAP Over JMS Transport in Developing JAX-WS Web Services for Oracle WebLogic Server.
Note:
You must configure the JMS topic before deploying the SOAP over JMS application using the partitioned distributed topic. See Configuring Partitioned Distributed Topics in Administering JMS Resources for Oracle WebLogic Server.
storeUserConfig in WLST Command Reference for WebLogic Server
Creating and Configuring Servlets in Developing Web Applications, Servlets, and JSPs for Oracle WebLogic Server