Oracle Server E10293-02 Manual de usuario

Oracle® Communication and Mobility ServerDeveloper’s Guide Release 10.1.3 E10293-02August 2007

xTTY Access to Oracle Support ServicesOracle provides dedicated Text Telephone (TTY) access to Oracle Support Services within the United States of Ame

logEvent(SipServletRequest req, Map<Object, Object> additional) MethodC-2 Oracle Communication and Mobility Server Developer’s GuideExample C–1

logEvent(Map <Object, Object> event, String category) MethodAccounting Event API C-3logEvent(SipServletResponse resp, Map<Object, Object>

Event Processing in Log4jC-4 Oracle Communication and Mobility Server Developer’s GuideThe isEnabled method returns true only if the Log4j filter is c

Event Processing in Log4jAccounting Event API C-5Event FilteringBy uncommenting or commenting categories in the Log4j configuration file (log4j.xml),

Event Processing in Log4jC-6 Oracle Communication and Mobility Server Developer’s Guide <param name="MaxBackupIndex" value="10"

Index-1IndexAAccounting API, C-4Accounting Event API, C-1Aggregation Proxy, 6-2appId, 3-1Application Routerconfiguring, 3-1applications, 2-5default, 2

Index-2Log4j, C-4event filtering, C-5event formatting and destination, C-5event logging attributes, C-5event processing, C-4logEvent method, C-2loggin

Index-3servlet context, 2-2servlet mapping, 2-7servlets, 2-4sessionconfiguration values, 2-5session attributes, 2-12shared resources, 4-2SIP, 2-5appli

Index-4

Overview 1-11Overview This chapter describes application development for the Oracle Communication and Mobility Server (OCMS) in the following section

Application Development in OCMS1-2 Oracle Communication and Mobility Server Developer’s GuideApplication Development in OCMSThe OCMS environment enab

Application Development in OCMSOverview 1-3Figure 1–1 OCMS SCE Application Development Support

Application Development in OCMS1-4 Oracle Communication and Mobility Server Developer’s Guide

SIP Servlets 2-12SIP ServletsThis chapter provides an overview of SIP Servlets and the SIP Servlet API (as described in JSR-116) in the following sec

The SIP Container2-2 Oracle Communication and Mobility Server Developer’s GuideThe SIP ContainerThis section describes the SIP Container (Figure 2–1)

The SIP ContainerSIP Servlets 2-3SIP Application SessionsWhile an application may involve several types of servlet sessions (for example, SIP and HTT

The SIP Container2-4 Oracle Communication and Mobility Server Developer’s GuideServletsEach servlet defined in the deployment descriptor has one inst

SIP Servlet EnvironmentSIP Servlets 2-5SIP Servlets and SIP ApplicationsA SIP application is a J2EE-compliant application accessed over the SIP proto

Oracle Communication and Mobility Server Developer’s Guide Release 10.1.3E10293-02Copyright © 2006, 2007, Oracle. All rights reserved.The Programs (w

SIP Servlet Environment2-6 Oracle Communication and Mobility Server Developer’s Guided. The servlets are created and initiated with the init paramete

Classes and MethodsSIP Servlets 2-7Servlet MappingA SIP application can contain one or more SIP Servlets. When the SIP container receives SIP request

Classes and Methods2-8 Oracle Communication and Mobility Server Developer’s GuideOutside of the service method, the doRequest() and doResponse() are

Classes and MethodsSIP Servlets 2-9A SIP request consists of the following: Request line Headers Empty line Message bodyAll parts of the SIP requ

Classes and Methods2-10 Oracle Communication and Mobility Server Developer’s Guidemethod that returns an iterator of the SIP headers of the message.

Classes and MethodsSIP Servlets 2-11Example 2–3 Accessing Parameters in SipURI// Create a SipURI, set the port, the lr, and the transport// protocol

Classes and Methods2-12 Oracle Communication and Mobility Server Developer’s Guide Dialog-related information such as tags, contacts, and CSeq in th

Configuring SIP Applications in sip.xmlSIP Servlets 2-13Configuring SIP Applications in sip.xmlSIP servlets must be declared in the application’s dep

Configuring SIP Applications in sip.xml2-14 Oracle Communication and Mobility Server Developer’s GuideDefining a ServletThe <servlet> element d

Configuring SIP Applications in sip.xmlSIP Servlets 2-15Creating Rules Using the Request Object StructureThe request object model enables you to defi

iiiContentsPreface ...

Configuring SIP Applications in sip.xml2-16 Oracle Communication and Mobility Server Developer’s GuideConditionsTable 2–1 lists the operators.Table 2

Configuring SIP Applications in sip.xmlSIP Servlets 2-17Table 2–3 describes the variable values.The following example evaluates to false.<pattern&

SIP Servlets in OCMS2-18 Oracle Communication and Mobility Server Developer’s Guideto false as does the whole rule while the three conditions are all

SIP Servlets in OCMSSIP Servlets 2-19– Servlet 1 matches all requests. All of these applications have been deployed into the SIP container, but no de

SIP Servlets in OCMS2-20 Oracle Communication and Mobility Server Developer’s GuideProtocol SessionsThe SIP Servlet specification infers that other p

SIP Servlets in OCMSSIP Servlets 2-21OCMS Authentication and Login ModulesOCMS provides Digest Access Authentication against the users, user roles, a

SIP Servlets in OCMS2-22 Oracle Communication and Mobility Server Developer’s Guide

Advanced SIP Servlet Configuration 3-13Advanced SIP Servlet ConfigurationThis chapter describes advanced topics related to SIP servlets through the f

Using the appId Parameter to Set Addresses for SIP Applications3-2 Oracle Communication and Mobility Server Developer’s GuideExample 3–1, illustrates

Using the appId Parameter to Set Addresses for SIP ApplicationsAdvanced SIP Servlet Configuration 3-3Figure 3–1 Setting the Application Routing for

ivSetting and Accessing Global Init Parameters... 2-13Configuring Applicat

Configuring Application Security3-4 Oracle Communication and Mobility Server Developer’s GuideConfiguring Application SecurityThe deployment descript

Configuring Application SecurityAdvanced SIP Servlet Configuration 3-5If a SIP client sends a REGISTER request to a server as illustrated in Example

Configuring Application Security3-6 Oracle Communication and Mobility Server Developer’s Guide

Programming Guidelines 4-14Programming GuidelinesThis chapter describes programming guidelines for SIP Servlet applications in the following sections

Storing Data in Application Sessions4-2 Oracle Communication and Mobility Server Developer’s GuideStoring Data in Application SessionsAll data that m

Creating B2BUA ApplicationsProgramming Guidelines 4-3It will clone the request with the following modifications: The From header field of the new re

Creating B2BUA Applications4-4 Oracle Communication and Mobility Server Developer’s Guide

Building a SIP Servlet Application 5-15Building a SIP Servlet ApplicationThis chapter illustrates how to build a SIP Servlet application through OCMS

SIP Application Development Process5-2 Oracle Communication and Mobility Server Developer’s GuideRefer to Oracle Communication and Mobility Server In

Importing an Existing ProjectBuilding a SIP Servlet Application 5-37. Test your applicationa. Deploy the application to the application server.b. Tes

vImporting the Third Party Call Control Example Project ... 5-6Deploying a SIP Application

Importing Example Projects5-4 Oracle Communication and Mobility Server Developer’s GuideA new Java Project is created in the Package Explorer. Access

Importing Example ProjectsBuilding a SIP Servlet Application 5-5Figure 5–1 OCMS SCE Example ProjectsImporting the Basic Response SIP Application Exa

Importing Example Projects5-6 Oracle Communication and Mobility Server Developer’s Guide3. Import the example SIP servlet project by selecting File,

Deploying a SIP Application to OCMSBuilding a SIP Servlet Application 5-7A new Java Project is created in the Package Explorer. Access the Package Ex

Testing an Application5-8 Oracle Communication and Mobility Server Developer’s Guide2. Right-click the server in the Servers view and select Publish

Testing an ApplicationBuilding a SIP Servlet Application 5-9Testing a Third Party Call Control ServletTo test an application, open a Web browser and

Testing an Application5-10 Oracle Communication and Mobility Server Developer’s Guide

OCMS Parlay X Web Services 6-16OCMS Parlay X Web Services This chapter describes OCMS support for the Parlay X 2.0 Presence Web services interfaces f

Installing the Web Services6-2 Oracle Communication and Mobility Server Developer’s GuideInstalling the Web ServicesThe Web services are packaged as

Using the Presence Web Services InterfacesOCMS Parlay X Web Services 6-3Using the Presence Web Services InterfacesThis section describes how to use e

viRf Provider... A-5

Using the Presence Web Services Interfaces6-4 Oracle Communication and Mobility Server Developer’s Guide// These inputs are required but not used.Sim

Using the Presence Web Services InterfacesOCMS Parlay X Web Services 6-5Interface PresenceSupplier, Operation: publish and Oracle Specific "Unpu

Using the Presence Web Services Interfaces6-6 Oracle Communication and Mobility Server Developer’s Guide// should be used as device note.other1.setNa

OCMS Parlay X Presence Custom Error CodesOCMS Parlay X Web Services 6-7Interface: PresenceSupplier, Operation: getSubscribedAttributesThis operation

OCMS Parlay X Presence Custom Error Codes6-8 Oracle Communication and Mobility Server Developer’s Guide

Oracle Diameter Java APIs A-1AOracle Diameter Java APIsThis appendix describes the Oracle Diameter Java APIs in the following sections: "Diamete

Diameter Java Base Protocol APIA-2 Oracle Communication and Mobility Server Developer’s GuideOn its upper side, the Diameter Base Protocol library, pr

Diameter Java Base Protocol APIOracle Diameter Java APIs A-3Base Protocol Diameter Java InterfaceThe Diameter Java API is composed of several interfac

Diameter Java Base Protocol APIA-4 Oracle Communication and Mobility Server Developer’s GuideThe DiameterMessage interface represents a Diameter Messa

3GPP/Rf Diameter Java APIOracle Diameter Java APIs A-53GPP/Rf Diameter Java APIThis section defines a Java API for the 3GPP [TS 32.299] Rf Interface o

viiavp Element ... B-7

3GPP/Rf Diameter Java APIA-6 Oracle Communication and Mobility Server Developer’s Guide int Accounting-Record-Number,

3GPP/Rf Diameter Java APIOracle Diameter Java APIs A-7Raise Events To send an accounting event to the Diameter stack, user has to call the accounting

3GPP/Rf Diameter Java APIA-8 Oracle Communication and Mobility Server Developer’s Guide SUPERVISION_TIMER_DURATION INTERIM_INTERVAL REALTIME_REQUIR

3GPP/Ro DIAMETER JAVA APIOracle Diameter Java APIs A-9RECORD or STOP_RECORD. The reception of an accounting request message including an Accounting-Re

3GPP/Ro DIAMETER JAVA APIA-10 Oracle Communication and Mobility Server Developer’s GuideRo ListenerThe DiameterRoListener interface processes accounti

3GPP/Ro DIAMETER JAVA APIOracle Diameter Java APIs A-11 Credit-Control-Answer (CCA)The first following method creates a basic CCA (with only mandator

3GPP/Ro DIAMETER JAVA APIA-12 Oracle Communication and Mobility Server Developer’s Guide DiameterServiceEvent(Object, DiameterSession, int): This eve

3GPP/Ro DIAMETER JAVA APIOracle Diameter Java APIs A-13 TX_TIMER_DURATION TRA_TIMER_DURATION CCFH ENABLE_INVALID_COMMAND ENABLE_SND_MISSING_AVPRo

3GPP/Sh Diameter Java APIA-14 Oracle Communication and Mobility Server Developer’s GuideCCA(EVENT_REQUEST) stands for Credit-Control-Answer message wi

3GPP/Sh Diameter Java APIOracle Diameter Java APIs A-15The Properties parameter specifies the features that will be handled by this Sh provider. This

viii

3GPP/Sh Diameter Java APIA-16 Oracle Communication and Mobility Server Developer’s GuideDiameterMessage createPushNotificationAnswer(String resultCod

Diameter Application ExampleOracle Diameter Java APIs A-17Sh Application OptionsThese options specify the features handled by the accounting Applicati

Diameter Application ExampleA-18 Oracle Communication and Mobility Server Developer’s GuideThe network element (acting as client) sends an Accounting-

Diameter Application ExampleOracle Diameter Java APIs A-19Figure A–5 Rf Provider Creation3. Create my Rf Provider, an instance of DiameterRfProvider,

Diameter Application ExampleA-20 Oracle Communication and Mobility Server Developer’s GuideFigure A–7 Routes and Listening Points Creation6. Create a

Diameter Application ExampleOracle Diameter Java APIs A-21Figure A–9 ACR Reception10.Create a client diameter session, an instance of DiameterSession,

Diameter Application ExampleA-22 Oracle Communication and Mobility Server Developer’s GuideFigure A–11 ACA Reception15. Send the created Accounting-An

Programming Oracle Diameter Applications B-1BProgramming Oracle Diameter ApplicationsThis appendix describes programming Oracle Diameter applications

IP and Routes ConfigurationB-2 Oracle Communication and Mobility Server Developer’s GuideString localURI = "aaa://server.realm.domain.com:41001&q

Counters ManagementProgramming Oracle Diameter Applications B-3and application ID. Since the route is not available, the application is not able to ex

ixPrefaceThis preface contains the following topics: Audience Documentation Accessibility Related Documents ConventionsAudienceThis guide is inten

Counters ManagementB-4 Oracle Communication and Mobility Server Developer’s GuideManaging a Diameter Application with MBeansA Diameter Application can

DictionaryProgramming Oracle Diameter Applications B-5And then select the application's JVM from the local list. The Diameter MBeans should be vi

DictionaryB-6 Oracle Communication and Mobility Server Developer’s GuideThe <application> attributes are:1. The application id attribute is the

DictionaryProgramming Oracle Diameter Applications B-7Example B–7 Defining the <returnCode> Element<dictionary> <vendor id="1

DictionaryB-8 Oracle Communication and Mobility Server Developer’s Guide "UNSIGNED32" "UNSIGNED64" "FLOAT32" "F

DictionaryProgramming Oracle Diameter Applications B-9Example B–10 Defining the <enum> Element<dictionary> <vendor id="10415&

Tracing and Logging MechanismB-10 Oracle Communication and Mobility Server Developer’s Guide " <vendor id=\"10415\" name=\"3G

Tracing and Logging MechanismProgramming Oracle Diameter Applications B-11 // ... } public void trace (String file, int line, int ma

Tracing and Logging MechanismB-12 Oracle Communication and Mobility Server Developer’s Guide

Accounting Event API C-1CAccounting Event APIThis appendix describes the OCMS Accounting Event API, in the following sections: Introduction logEvent