Developing Converged Applications 2-3
2.3.1 Modifying the SipApplicationSession
When using a replicated domain, WebLogic Server automatically provides concurrency control when a SIP Servlet modifies a SipApplicationSession object.
In other words, when a SIP Servlet modifies the SipApplicationSession object, the SIP container automatically locks other applications from modifying the object at
the same time.
Non-SIP applications, such as HTTP Servlets, must themselves ensure that the application call state is locked before modifying it. This is also required if a single SIP
Servlet needs to modify other call state objects, such as when a conferencing Servlet joins multiple calls.
To help application developers manage concurrent access to the application session object, WebLogic Server extends the standard SipApplicationSession object with
com.bea.wcp.sip.WlssSipApplicationSession, and adds two interfaces, com.bea.wcp.sip.WlssAction and com.bea.wcp.sip.WlssAsynchronous
Action, to encapsulate tasks performed to modify the session. When these APIs are
Table 2–1 Deprecated com.bea.wcp.util.Sessions Methods
Deprecated Method in com.bea.wcp.util.Sessions
Replacement Method Description
getApplicationSession javax.servlet.sip.SipSessionsUtil.
getApplicationSession Obtains the
SipApplicationSession object with a specified session ID.
getApplicationSessionsByCallId None. Obtains an Iterator of
SipApplicationSession objects associated with the specified call ID.
createHttpSession None.
Applications can instead cast an HttpSession into
ConvergedHttpSession. setApplicationSession
javax.servlet.sip.ConvergedHttpSession. getApplicationSession
Associates an HTTP session with an existing SipApplicationSession.
removeApplicationSession None.
Removes an HTTP session from an existing SipApplicationSession.
getEncodeURL javax.servlet.sip.ConvergedHttpSession.
encodeURL Encodes an HTTP URL with the
jsessionid of an existing HTTP session object.
Note: The com.bea.wcp.util.Sessions API is provided only
for backward compatibility. Use the SIP Servlet APIs for all new development. Converged applications that mix the
com.bea.wcp.util.Sessions API and JSR 289 convergence APIs are not supported.
Specifically, the deprecated Sessions.getApplicationSessionsByCallIdString
callId method cannot be used with v1.1 SIP Servlets that use the session key-based targeting method for associating an initial request
with an existing SipApplicationSession object. See Section 15.11.2 in the SIP Servlet Specification v1.1
http:jcp.orgenjsrdetail?id=289 for more
information about this targeting mechanism.
2-4 Oracle WebLogic Server SIP Container Developer’s Guide
used, the SIP container ensures that all business logic contained within the WlssAction and WlssAsynchronousAction object is executed on a locked copy of the
associated SipApplicationSession instance. The sections that follow describe each interface.
2.3.1.1 Synchronous Access
Applications that read and update a session attribute in a transactional and synchronous manner must use the WlssAction API. WlssAction obtains an explicit
lock on the session for the duration of the action. Example 2–1
shows an example of using this API.
Example 2–1 Example Code using WlssAction API
final SipApplicationSession appSession = ...; WlssSipApplicationSession wlssAppSession = WlssSipApplicationSession appSession;
wlssAppSession.doActionnew WlssAction { public Object run throws Exception {
Add all business logic here. appSession.setAttributecounter, latestCounterValue;
sipSession.setAttributecurrentState, latestAppState; The SIP container ensures that the run method is invoked
while the application session is locked. return null;
} };
Because the WlssAction API obtains an exclusive lock on the associated session, deadlocks can occur if you attempt to modify other application session attributes
within the action.
2.3.1.2 Asynchronous Access
Applications that update a different SipApplicationSession while in the context of a locked SipApplicationSession can perform asynchronous updates using the
WlssAsynchronousAction API. This API reduces contention when multiple applications might need to update attributes in the same SipApplicationSession at the
same time.
Example 2–2 shows an example of using this API.
To compile applications using this API, you must include MIDDLEWARE_ HOMEserverlibwlsswlssapi.jar, and MIDDLEWARE_
HOMEserverlibwlsssipservlet.jar.
Example 2–2 Example Code using WlssAsynchronousAction API
SipApplicationSession sas1 = req.getSipApplicationSession; SipApplicationSession1 is already locked by the container
Obtain another SipApplicationSession to schedule work on it WlssSipApplicationSession wlssSipAppSession =
SipSessionsUtil.getApplicationSessionByIdconferenceAppSessionId; The work is done on the application session asynchronously
appSession.doAsynchronousActionnew WlssAsynchronousAction { Serializable runSipApplicationSession appSession {
Add all business logic here. int counter = appSession.getAttributecounter;
++ counter; appSession.setAttributecounter, counter;
return null; }
};
Kategori