|
Oracle | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface JwsContext
Provides access to container services that support web services
(JWS files). Represents the execution context of the web service.
Methods in this interface can be used to access out-of-band data for
communication with other web service architectures and to manage
conversations.
For more information on building web services, see
Accessing Runtime Information about a Web Service Using the JwsContext.
Method Summary | |
---|---|
void |
finishConversation()
Marks the current conversation instance as requiring removal after the currently executing method or event handler returns. |
Principal |
getCallerPrincipal()
Returns the security principal associated with the current method invocation if authentication was performed. |
long |
getCurrentAge()
Returns the conversation's current age (in seconds). |
long |
getCurrentIdleTime()
Gets the number of seconds since the last client request, or since the conversation's maximum idle time was reset. |
Element[] |
getInputHeaders()
Returns the SOAP headers that arrived with the current method invocation message. |
Logger |
getLogger(String name)
Deprecated. use java.util.logging |
long |
getMaxAge()
Gets the time representing the longest the conversation may remain active before finishing. |
long |
getMaxIdleTime()
Gets the number of seconds that the conversation can remain idle before finishing due to client inactivity. |
MessageContext |
getMessageContext()
Return the message context currently being processed. |
Protocol |
getProtocol()
Gets the protocol of the current request. |
ServiceHandle |
getService()
Returns a ServiceHandle instance for the currently active service instance. |
boolean |
getUnderstoodInputHeaders()
Returns the value most recently set by a call to |
boolean |
isCallerInRole(String roleName)
Returns true if the authenticated principal is within the specified security role. |
boolean |
isFinished()
Returns whether or not this conversation instance has had finish() called on it (indicating that code has requested termination of this conversation instance). |
void |
resetIdleTime()
Resets the timer measuring the number of seconds since the last activity for the current conversation. |
void |
setMaxAge(Date date)
Sets a new maximum age for the conversation to an absolute Date. |
void |
setMaxAge(String duration)
Sets a conversation's maximum age by specifying a duration as a string. |
void |
setMaxIdleTime(long seconds)
Sets the number of seconds that the conversation can remain idle before finishing due to client inactivity. |
void |
setMaxIdleTime(String duration)
Sets the number of seconds (as a String) that the conversation can remain idle before finishing due to client inactivity. |
void |
setOutputHeaders(Element[] headers)
Set the SOAP headers to be sent with outgoing messages to the client. |
void |
setUnderstoodInputHeaders(boolean understood)
Indicates whether input headers were understood. |
Method Detail |
---|
boolean isFinished()
true
if the conversation has finished;
false
if it hasn't.void finishConversation()
@conversation phase="finish"
tag.
void setMaxAge(Date date) throws IllegalStateException, IllegalArgumentException
date
- The time after which the conversation should finish; null
to disable the age timeout.
IllegalStateException
- if the method is called from a service
instance that is not conversational.
IllegalArgumentException
- If this method has passed
an illegal or inappropriate argument.void setMaxAge(String duration) throws IllegalStateException, IllegalArgumentException
duration
- The period after which the conversation will finish.
IllegalStateException
- if the method is called from a
service instance that is not conversational.
IllegalArgumentException
- If this method has passed
an illegal or inappropriate argument.long getMaxAge() throws IllegalStateException
IllegalStateException
- if the method is called from a
service instance that is not conversational.long getCurrentAge() throws IllegalStateException
IllegalStateException
- If the method is called
from a service instance that is not conversational.void resetIdleTime() throws IllegalStateException
IllegalStateException
- if the method is called from a service
instance that is not conversational.void setMaxIdleTime(long seconds) throws IllegalStateException, IllegalArgumentException
setMaxIdleTime
or
setMaxIdleTime
method.
resetIdleTime
method is called.
seconds
- The number of seconds the conversation can remain
idle before it will expire.
IllegalStateException
- if the method is called from a
service instance that is not conversational.
IllegalArgumentException
- If this method has passed
an illegal or inappropriate argument.void setMaxIdleTime(String duration) throws IllegalStateException, IllegalArgumentException
setMaxIdleTime
or
setMaxIdleTime
method.
resetIdleTime
method is called.
duration
- The number of seconds the conversation can remain
idle before it will expire.
IllegalStateException
- if the method is called from a
service instance that is not conversational.
IllegalArgumentException
- If this method has passed
an illegal or inappropriate argument.long getMaxIdleTime() throws IllegalStateException
IllegalStateException
- if the method is called from a
service instance that is not conversational.long getCurrentIdleTime() throws IllegalStateException
IllegalStateException
- if the method is called from a
service instance that is not conversational.Principal getCallerPrincipal()
boolean isCallerInRole(String roleName)
roleName
- The name of the security role against which
to check the authenticated principal.
true
if the principal is within the specified security
role; false
if they are not.ServiceHandle getService()
@Deprecated Logger getLogger(String name)
name
- The name of the category by which log
messages should be grouped.
Element[] getInputHeaders()
void setUnderstoodInputHeaders(boolean understood)
true
,
then a SOAP fault will be generated.
understood
- true
to indicate that "mustUnderstand"
headers were understood; false
to indicate they weren't.boolean getUnderstoodInputHeaders()
false
if
JwsContext.setUnderstoodInputHeaders() has not been called.void setOutputHeaders(Element[] headers)
headers
- An array of org.w3c.dom.Element objects
containing valid SOAP headers.Protocol getProtocol()
MessageContext getMessageContext()
|
Documentation is available at http://download.oracle.com/docs/cd/E12839_01/web.1111 Copyright 1996,2009, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. Part Number E13941-01 Oracle WebLogic Server 10.3.1 API Reference |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |