JAX-WS
v2.1

javax.xml.ws
Interface WebServiceContext


public interface WebServiceContext

A WebServiceContext makes it possible for a web service endpoint implementation class to access message context and security information relative to a request being served. Typically a WebServiceContext is injected into an endpoint implementation class using the Resource annotation.

Since:
JAX-WS 2.0
See Also:
javax.annotation.Resource

Method Summary
 W3CEndpointReference getEndpointReference()
          Returns the W3CEndpointReference for this endpoint.
<T extends EndpointReference>
T
getEndpointReference(java.lang.Class<T> clazz)
          Returns the EndpointReference associated with this endpoint.
 MessageContext getMessageContext()
          Returns the MessageContext for the request being served at the time this method is called.
 java.security.Principal getUserPrincipal()
          Returns the Principal that identifies the sender of the request currently being serviced.
 boolean isUserInRole(java.lang.String role)
          Returns a boolean indicating whether the authenticated user is included in the specified logical role.
 

Method Detail

getMessageContext

MessageContext getMessageContext()
Returns the MessageContext for the request being served at the time this method is called. Only properties with APPLICATION scope will be visible to the application.

Returns:
MessageContext The message context.
Throws:
java.lang.IllegalStateException - This exception is thrown if the method is called while no request is being serviced.
See Also:
MessageContext, MessageContext.Scope, IllegalStateException

getUserPrincipal

java.security.Principal getUserPrincipal()
Returns the Principal that identifies the sender of the request currently being serviced. If the sender has not been authenticated, the method returns null.

Returns:
Principal The principal object.
Throws:
java.lang.IllegalStateException - This exception is thrown if the method is called while no request is being serviced.
See Also:
Principal, IllegalStateException

isUserInRole

boolean isUserInRole(java.lang.String role)
Returns a boolean indicating whether the authenticated user is included in the specified logical role. If the user has not been authenticated, the method returns false.

Parameters:
role - A String specifying the name of the role
Returns:
a boolean indicating whether the sender of the request belongs to a given role
Throws:
java.lang.IllegalStateException - This exception is thrown if the method is called while no request is being serviced.

getEndpointReference

W3CEndpointReference getEndpointReference()
Returns the W3CEndpointReference for this endpoint.

The returned EndpointReference must contain the embedded WSDL in the wsa:Metadata element if there is an associated WSDL. It must also contain wsaw:ServiceName elements and the wsaw:EndpointName attribute on the wsaw:ServiceName. The wsaw:InterfaceName may also be present.

Returns:
W3CEndpointReference of this instance.
Throws:
java.lang.IllegalStateException - This exception is thrown if the method is called while no request is being serviced.
Since:
JAX-WS 2.1

getEndpointReference

<T extends EndpointReference> T getEndpointReference(java.lang.Class<T> clazz)
Returns the EndpointReference associated with this endpoint.

The returned EndpointReference must contain the embedded WSDL in the wsa:Metadata element if the endpoint has a WSDL. It must also contain wsaw:ServiceName elements and the wsaw:EndpointName attribute on the wsaw:ServiceName. The wsaw:InterfaceName may also be present.

Returns:
EndpointReference of type clazz of this instance.
Throws:
java.lang.IllegalStateException - This exception is thrown if the method is called while no request is being serviced.
Since:
JAX-WS 2.1

JAX-WS
v2.1


Comments to: jsr224-spec-comments@sun.com
More information at: http://java.sun.com/xml/jax-ws

Copyright © 2006 by Sun Microsystems, Inc., 4150 Network Circle,
Santa Clara, California 95054, U.S.A. All Rights Reserved.