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
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
Kommentare zu diesen Handbüchern