Java Web Services in a Nutshell

Name

ServletEndpointContext

Synopsis

public interface ServletEndpointContext {
// Public Instance Methods
    public abstract javax.servlet.http.HttpSession getHttpSession(  );
    public abstract javax.xml.rpc.handler.MessageContext getMessageContext(  ); 
    public abstract javax.servlet.ServletContext getServletContext(  ); 
    public abstract java.security.Principal getUserPrincipal(  ); 
}

A servlet container that provides a server-side implementation of JAX-RPC must create an object of type ServletEndpointContext and pass it to the init( ) method of any service that declares that it implements the ServiceLifecyle interface. The service class typically stores the object passed to it, and uses it to obtain context information as necessary during the invocation of its service endpoint interface methods.

The getServletContext( ) method returns the ServletContext for the web application of which the web service implementation is a part. The ServletContext provides methods that allow the service to access initialization parameters, delegate service implementation to other servlets or JSPs, and so on. This is the only method that returns a meaningful value if called outside of a service endpoint interface method (e.g., in init( )).

The getHttpSession( ) method returns the HttpSession object that corresponds to the active session maintained by the hosting web container for the client invoking a remote service endpoint interface method, or null if the client is not in a session with the server. A JAX-RPC client ...