Developing SIP Applications

Overview of SIP Servlets

What is a SIP Servlet?

Differences from HTTP Servlets

Multiple Responses

Receiving Responses

Proxy Functions

Message Body

ServletRequest

ServletResponse

SipServletMessage

Roles of a Servlet Container

Application Management

SIP Messaging

Utility Functions

SIP Session, Application Session

SIP Factory

Proxy

Porting Existing Applications to Oracle Communications Converged Application Server

Application Router and Legacy Application Composition

SipSession and SipApplicationSession Not Serializable

SipServletResponse.setCharacterEncoding() API Change

Transactional Restrictions for SipServletRequest and SipServletResponse

Immutable Parameters for New Parameterable Interface

Stateless Transaction Proxies Deprecated

Backward-Compatibility Mode for v1.0 Deployments

Validation Warnings for v1.0 Servlet Deployments

Modifying Committed Messages

Path Header as System Header

SipServletResponse.createPrack() Exception

Proxy.proxyTo() Exceptions

Changes to Proxy Branch Timers

Deprecated APIs

SNMP MIB Changes

Renamed Diagnostic Monitors and Actions

Requirements and Best Practices for SIP Applications

Overview of Developing Distributed Applications for Oracle Communications Converged Application Server

Applications Must Not Create Threads

Servlets Must Be Non-Blocking

Store all Application Data in the Session

All Session Data Must Be Serializable

Use setAttribute() to Modify Session Data in “No-Call” Scope

send() Calls Are Buffered

Mark SIP Servlets as Distributable

Use SipApplicationSessionActivationListener Sparingly

Observe Best Practices for Java EE Applications

Using Compact and Long Header Formats for SIP Messages

Overview of Header Format APIs and Configuration

Summary of Compact Headers

Assigning Header Formats with WlssSipServletMessage

Summary of API and Configuration Behavior

Composing SIP Applications

Application Composition Model

Using the Default Application Router

Configuring a Custom Application Router

Session Key-Based Request Targeting

Developing Converged Applications

Overview of Converged Applications

Assembling and Packaging a Converged Application

Working with SIP and HTTP Sessions

Modifying the SipApplicationSession

Using the Converged Application Example

Developing Custom Profile Providers

Overview of the Profile Service API

Implementing Profile API Methods

Configuring and Packaging Profile Providers

Mapping Profile Requests to Profile Providers

Configuring Profile Providers Using the Administration Console

Using Content Indirection in SIP Servlets

Overview of Content Indirection

Using the Content Indirection API

Additional Information

Securing SIP Servlet Resources

Overview of SIP Servlet Security

Oracle Communications Converged Application Server Role Mapping Features

Using Implicit Role Assignment

Assigning Roles Using security-role-assignment

Important Requirement for Oracle Communications Converged Application Server

Assigning Roles at Deployment Time

Dynamically Assigning Roles Using the Administration Console

Assigning run-as Roles

Role Assignment Precedence for SIP Servlet Roles

Debugging Security Features

weblogic.xml Deployment Descriptor Reference

Developing SIP Servlets Using Eclipse

Overview

SIP Servlet Organization

Setting Up the Development Environment

Creating a Oracle Communications Converged Application Server Domain

Configure the Default Eclipse JVM

Creating a New Eclipse Project

Creating an Ant Build File

Building and Deploying the Project

Debugging SIP Servlets

Enabling Message Logging

Overview

Enabling Message Logging

Specifying a Predefined Logging Level

Customizing Log Records

Specifying Content Types for Unencrypted Logging

Example Message Log Configuration and Output

Configuring Log File Rotation

Generating SNMP Traps from Application Code

Overview

Requirement for Accessing SipServletSnmpTrapRuntimeMBean

Obtaining a Reference to SipServletSnmpTrapRuntimeMBean

Generating a SNMP Trap