|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
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.
Resource
Method Summary | ||
---|---|---|
|
getEndpointReference(java.lang.Class<T> clazz,
org.w3c.dom.Element... referenceParameters)
Returns the EndpointReference associated with
this endpoint. |
|
EndpointReference |
getEndpointReference(org.w3c.dom.Element... referenceParameters)
Returns the EndpointReference for 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 |
---|
MessageContext getMessageContext()
MessageContext
for the request being served
at the time this method is called. Only properties with
APPLICATION scope will be visible to the application.
IllegalStateException
- This exception is thrown
if the method is called while no request is
being serviced.MessageContext
,
MessageContext.Scope
,
IllegalStateException
java.security.Principal getUserPrincipal()
null
.
IllegalStateException
- This exception is thrown
if the method is called while no request is
being serviced.Principal
,
IllegalStateException
boolean isUserInRole(java.lang.String role)
role
- A String
specifying the name of the role
boolean
indicating whether
the sender of the request belongs to a given role
IllegalStateException
- This exception is thrown
if the method is called while no request is
being serviced.EndpointReference getEndpointReference(org.w3c.dom.Element... referenceParameters)
EndpointReference
for this
endpoint.
If the Binding
for this bindingProvider
is
either SOAP1.1/HTTP or SOAP1.2/HTTP, then a
W3CEndpointReference
MUST be returned.
referenceParameters
- Reference parameters to be associated with the
returned EndpointReference
instance.
WebServiceContext
.
If the returned EndpointReference
is of type
W3CEndpointReference
then it MUST contain the
the specified referenceParameters
.
IllegalStateException
- This exception is thrown
if the method is called while no request is
being serviced.W3CEndpointReference
<T extends EndpointReference> T getEndpointReference(java.lang.Class<T> clazz, org.w3c.dom.Element... referenceParameters)
EndpointReference
associated with
this endpoint.
clazz
- The type of EndpointReference
that
MUST be returned.referenceParameters
- Reference parameters to be associated with the
returned EndpointReference
instance.
clazz
of the endpoint
associated with this WebServiceContext
instance.
If the returned EndpointReference
is of type
W3CEndpointReference
then it MUST contain the
the specified referenceParameters
.
IllegalStateException
- This exception is thrown
if the method is called while no request is
being serviced.
WebServiceException
- If the clazz
type of
EndpointReference
is not supported.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 2009-2011, Oracle Corporation and/or its affiliates. All Rights Reserved. Use is subject to license terms.
Generated on 10-February-2011 12:41