|
Oracle© Fusion Middleware Java API Reference for Oracle ADF Faces 11g Release 1 (11.1.1.7.0) E10684-08 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object
oracle.adf.view.rich.remote.RemoteApplication
public class RemoteApplication
This is a reference to a remote web application. The URI provided is expected to reference the remote web application which contains the RemoteRegion filter. Additionally, if this application already has an established SessionId, that should be stored here so that subsequent requests to the server will reuse the same session. <p/> The RemoteApplicationInstance
class is used to keep track of all of the information needed for each instance whereas this class is for information about the configured producer as a whole. <p/> Instances of this class are returned from the getRemoteApplication(URI)
factory method. Using this method ensures that, for a particular uri, you will get the correct RemoteApplication object, complete with information about the current session. Most applications will only need to retrieve one of these objects the first time they connect to the server. Once a RemoteApplicationInstance has been returned from a valid RemoteApplicationResponse
, then that object should be used to make subsequent requests.
RemoteApplicationInstance
, Serialized FormConstructor Summary | |
---|---|
protected |
RemoteApplication(java.net.URI uri) Called by RemoteApplication if a getRemoteApplication(URI) is called outside of a Faces environment. |
Method Summary | |
---|---|
boolean |
equals(java.lang.Object object) Determines whether these classes are equal |
protected java.util.concurrent.locks.ReentrantLock |
getLock() Returns the lock for this object. |
static RemoteApplication |
getRemoteApplication(java.net.URI uri) Returns a RemoteApplicationObject for the provided URI. |
CookieWrapper |
getSessionCookie() Returns the 'JSESSIONID' cookie. |
java.lang.String |
getSessionId() Returns the session id, if any, for this producer. |
java.net.URI |
getURI() Returns the URI for this producer endpoint. |
int |
hashCode() Computes the class's hashcode. |
void |
invalidate() Invalidate this RemoteApplication. |
protected void |
setSessionCookie(CookieWrapper sessionCookie) Sets the sessionCookie for the object. |
protected void |
setSessionId(java.lang.String sessionId) Sets the sessionId for the object. |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
protected RemoteApplication(java.net.URI uri)
getRemoteApplication(URI)
is called outside of a Faces environment.
uri
- the context URI for this remote applicationjava.lang.NullPointerException
- is uri is null
Method Detail |
---|
public static final RemoteApplication getRemoteApplication(java.net.URI uri)
uri
- the URL for the remote connectionRemoteApplication
object for the current URIpublic java.net.URI getURI()
public java.lang.String getSessionId()
null
until a session is established on the remote server. The value of this field will be the same as HttpSession.getId()
on the producer.null
if one has not yet been establishedpublic CookieWrapper getSessionCookie()
getSessionId()
, however while J2EE defines a cookie to track the JSESSIONID, it does not guarentee that the value of HttpSession.getId()
and the value of the tracking cookie are the same. In the past some containers like WebSphere have been known to make these values different, particularly on clustering environments.null
if one has not yet been establishedpublic void invalidate()
RemoteApplicationUtils.invalidate(RemoteApplication)
on the current RemoteApplication
. Please note that if this method is called on a RemoteApplicationInstance
then only the subsession will be invalidated as per the documentation in RemoteApplicationUtils
.RemoteApplicationUtils.invalidate(RemoteApplication)}
public boolean equals(java.lang.Object object)
equals
in class java.lang.Object
object
-public int hashCode()
hashCode
in class java.lang.Object
protected void setSessionId(java.lang.String sessionId)
sessionId
-protected void setSessionCookie(CookieWrapper sessionCookie)
sessionCookie
-protected java.util.concurrent.locks.ReentrantLock getLock()
|
Oracle© Fusion Middleware Java API Reference for Oracle ADF Faces 11g Release 1 (11.1.1.7.0) E10684-08 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |