Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 Overview

• Introduction to Oracle Communication and Mobility Server
  • New in this Release
• Application Development in OCMS
  • SIP Servlet API
    • Parlay X Web Service Interface
    • Presence Web Services
  • Oracle Communication and Mobility Server Development Tools

2 SIP Servlets

• Introduction to SIP Servlets
• The SIP Container
  • Servlet Context
  • SIP Application Sessions
  • Protocol Sessions
  • Transactions
  • Servlets
    • Increased Servlet Modularity
    • Renaming SAR Files for the JBoss Application Server
  • Listeners
• SIP Servlets and SIP Applications
• SIP Servlet Environment
  • Servlet Mapping
• Classes and Methods
  • Request and Response Handling Methods
    • Messages
    • Requests
    • Responses
    • Content
    • Manipulating SIP headers
    • SipURI
    • Address
    • SIP Details
  • Storing Data as Session Attributes
  • Adding Configuration Parameters
• Configuring SIP Applications in sip.xml
  • Setting and Accessing Global Init Parameters
  • Configuring Application Sessions
  • Defining a Servlet
  • Defining the Servlet Mapping
    • Creating Rules Using the Request Object Structure
    • Conditions
    • Examples
• SIP Servlets in OCMS
  • Handling Initial Requests
  • Implementation Decisions
    • Protocol Sessions
    • Extended doRequest Methods
    • Asynchronous Send
  • Multi-Threading
  • Sip Servlet API Javadoc
  • External Access to SIP Servlets
  • OCMS Authentication and Login Modules

3 Advanced SIP Servlet Configuration

• Using the appId Parameter to Set Addresses for SIP Applications
  • Configuring the appId Parameter
    • Adding Deployed Applications to the SipUriList Attribute
• Configuring Application Security

4 Programming Guidelines

• Introduction
• Marking Applications as Distributable
• Storing Data in Application Sessions
• Avoiding Static Data
• Avoiding Blocking Calls
• Invalidating the SipApplicationSession and SIPSession
• Monitoring the Memory Usage
• Avoiding Storing Shared Resources in Sessions
• Avoiding Creating Threads
• Creating B2BUA Applications

5 Building a SIP Servlet Application

• Prerequisites
• SIP Application Development Process
• Creating a New Dynamic Web Project with SIP Support
• Importing an Existing Project
• Importing Example Projects
  • Importing the Basic Response SIP Application Example Project
  • Importing the Call Forward SIP Application Example Project
  • Importing the Message Sender SIP/Web Converged Application Example Project
  • Importing the Proxy/Registrar Example Project
  • Importing the Third Party Call Control Example Project
• Deploying a SIP Application to OCMS
• Testing an Application
  • Changing the Logging Level
  • Viewing the System Log File
  • Starting the OCMS Server in Eclipse
  • Testing a Third Party Call Control Servlet

6 OCMS Parlay X Web Services

• Introduction
• Installing the Web Services
• Installing the Aggregation Proxy
• Configuring Web Services with the Aggregation Proxy
• Presence Web Services Interface Descriptions
• Using the Presence Web Services Interfaces
  • Interface: PresenceConsumer, Operation: subscribePresence
    • Code Example
  • Interface: PresenceConsumer, Operation: getUserPresence
    • Code Example
  • Interface PresenceSupplier, Operation: publish and Oracle Specific "Unpublish"
    • Code Example
  • Interface: PresenceSupplier, Operation: getOpenSubscriptions
    • Code Example
  • Interface: PresenceSupplier, Operation: updateSubscriptionAuthorization
    • Code Example
  • Interface: PresenceSupplier, Operation: getMyWatchers
    • Code Example
  • Interface: PresenceSupplier, Operation: getSubscribedAttributes
    • Code Example
  • Interface: PresenceSupplier, Operation: blockSubscription
    • Code Example
• OCMS Parlay X Presence Custom Error Codes

A Oracle Diameter Java APIs

• Diameter Java Base Protocol API
  • Base Protocol Diameter Java Interface
    • Diameter Factory
    • Diameter Stack
    • Diameter Application
    • Diameter Transport
    • Diameter AVPs
    • Diameter Session
    • Diameter Event
    • Diameter Exception
• 3GPP/Rf Diameter Java API
  • 3GPP/Rf Diameter Java Interface
    • Rf Provider
    • Rf Listener
    • Rf Message Factory
    • Rf Events
    • Rf Application Options
    • Rf Application FSM
• 3GPP/Ro DIAMETER JAVA API
  • 3GPP/Ro DIAMETER JAVA INTERFACE
    • Ro Provider
    • Ro Listener
    • Ro Message Factory
    • 3GPP/Ro Dictionary
    • Ro Events
    • Ro Application Options
    • Ro Application FSM
• 3GPP/Sh Diameter Java API
  • 3GPP/Sh Diameter Java Interface
    • Sh Provider
    • Sh Listener
    • Sh Message Factory
  • 3GPP/Sh Dictionary
  • Sh Events
  • Sh Application Options
• Diameter Application Example
  • Accounting Call Flow
    • Application initialization
    • Accounting Diameter message exchange
    • Cleaning

B Programming Oracle Diameter Applications

• IP and Routes Configuration
  • Creating a Diameter Stack
  • Binding to Local Transport Addresses
  • Configuring Routes and Binding to Diameter Peers
  • Realm State Availability
• Counters Management
  • MBeans Management Interface
  • Managing a Diameter Application with MBeans
    • Registering the Diameter MBeans
    • Using jconsole to Monitor Diameter Applications
• Dictionary
  • Dictionary Composition
    • dictionary Element
    • vendor Element
    • application Element
    • command Element
    • returnCode Element
    • avp Element
    • type Element
    • enum Element
    • grouped Element
  • Dictionary Extension
• Tracing and Logging Mechanism

C Accounting Event API

• Introduction
• logEvent(SipServletRequest req, Map<Object, Object> additional) Method
• logEvent(SipServletResponse resp, Map<Object, Object> additional) Method
• logEvent(Map <Object, Object> event, String category) Method
• Event Processing in Log4j

Index