4-22 Getting Started With JAX-RPC Web Services for Oracle WebLogic Server
4.9.4 Specifying that Operations Run Inside of a Transaction
When a client application invokes a WebLogic Web service operation, the operation invocation takes place outside the context of a transaction, by default. If you want the
operation to run inside a transaction, specify the weblogic.jws.Transactional annotation in your JWS file, and set the boolean value attribute to true, as shown in
the following example relevant code shown in bold:
package examples.webservices.transactional; import javax.jws.WebMethod;
import javax.jws.WebService; import weblogic.jws.WLHttpTransport;
import weblogic.jws.Transactional; WebServicename=TransactionPojoPortType,
serviceName=TransactionPojoService, targetNamespace=http:example.org
WLHttpTransportcontextPath=transactionsPojo, serviceUri=TransactionPojoService,
portName=TransactionPojoPort This JWS file forms the basis of simple WebLogic
Web Service with a single operation: sayHello. The operation executes as part of a transaction.
public class TransactionPojoImpl { WebMethod
Transactionalvalue=true public String sayHelloString message {
System.out.printlnsayHello: + message; return Here is the message: + message + ;
} }
If you want all operations of a Web service to run inside of a transaction, specify the Transactional
annotation at the class-level. If you want only a subset of the operations to be transactional, specify the annotation at the method-level. If there is a
conflict, the method-level value overrides the class-level. See weblogic.jws.Transactional in the Oracle Fusion Middleware WebLogic Web Services
Reference for Oracle WebLogic Server for information about additional attributes.
4.9.5 Getting the HttpServletRequestResponse Object
If your Web service uses HTTP as its transport protocol, you can use the weblogic.wsee.connection.transport.servlet.HttpTransportUtils
API in the Oracle Fusion Middleware Oracle WebLogic Server API Referenceto get the javax.servlet.http.HttpServletRequest
and javax.servlet.http.HttpServletResponse
objects from the JAX-RPC ServletEndpointContext
object, as shown in the following example relevant code shown in bold and explained after the example:
package examples.webservices.http_transport_utils; import javax.xml.rpc.server.ServiceLifecycle;
import javax.xml.rpc.server.ServletEndpointContext; import javax.xml.rpc.ServiceException;
import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse;
import javax.jws.WebMethod; import javax.jws.WebService;
Programming the JWS File 4-23
import weblogic.jws.WLHttpTransport; import weblogic.wsee.connection.transport.servlet.HttpTransportUtils;
WebServicename=HttpTransportUtilsPortType, serviceName=HttpTransportUtilsService,
targetNamespace=http:example.org WLHttpTransportcontextPath=servlet, serviceUri=HttpTransportUtils,
portName=HttpTransportUtilsPort public class HttpTransportUtilsImpl implements ServiceLifecycle {
private ServletEndpointContext wsctx = null; public void initObject context throws ServiceException {
System.out.printlnServletEndpointContext inited...; wsctx = ServletEndpointContextcontext;
} public void destroy {
System.out.printlnServletEndpointContext destroyed...; wsctx = null;
}
WebMethod public String getServletRequestAndResponse {
HttpServletRequest request = HttpTransportUtils.getHttpServletRequestwsctx.getMessageContext;
HttpServletResponse response = HttpTransportUtils.getHttpServletResponsewsctx.getMessageContext;
System.out.printlnHttpTransportUtils API used successfully.; return HttpTransportUtils API used successfully;
} }
The important parts of the preceding example are as follows:
■
Import the required JAX-RPC and Servlet classes: import javax.xml.rpc.server.ServiceLifecycle;
import javax.xml.rpc.server.ServletEndpointContext; import javax.xml.rpc.ServiceException;
import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse;
■
Import the WebLogic HttpTransportUtils class: import weblogic.wsee.connection.transport.servlet.HttpTransportUtils;
■
Because you will be querying the JAX-RPC message context, your JWS file must explicitly implement ServiceLifecycle:
public class HttpTransportUtilsImpl implements ServiceLifecycle
■
Create a variable of data type ServletEndpointContext: private ServletEndpointContext wsctx = null;
■
Because the JWS file implements ServiceLifecycle, you must also implement the init and destroy lifecycle methods:
public void initObject context throws ServiceException { System.out.printlnServletEndpointContext inited...;
wsctx = ServletEndpointContextcontext; }
public void destroy { System.out.printlnServletEndpointContext destroyed...;
wsctx = null; }
4-24 Getting Started With JAX-RPC Web Services for Oracle WebLogic Server
■
Finally, in the method that implements the Web service operation, use the ServletEndpointContext
object to get the HttpServletRequest and HttpServletResponse
objects: HttpServletRequest request =
HttpTransportUtils.getHttpServletRequestwsctx.getMessageContext; HttpServletResponse response =
HttpTransportUtils.getHttpServletResponsewsctx.getMessageContext;
4.10 JWS Programming Best Practices
