Contents

Title and Copyright Information

Preface

• Audience
• Related Documents
• Documentation Accessibility

1 Overview of SIP Servlet Application Development

• What is a SIP Servlet?
• Differences from HTTP Servlets
  • Multiple Responses
  • Receiving Responses
  • Proxy Functions
  • Message Body
    • Servlet Request
    • Servlet Response
    • SipServletMessage
  • Role of a Servlet Container
    • Application Management
    • SIP Messaging
    • Utility Functions
      • SIP Session, Application Session
      • SIP Factory
      • Proxy

2 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

3 Requirements and Best Practices for SIP Applications

• Overview of Developing Distributed Applications for 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
• Session Expiration Best Practices
• Observe Best Practices for Java EE Applications
• Optimizing Memory Utilization or Performance for a Standalone Domain

4 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

5 Composing SIP Applications

• Application Composition Model
• Using the Default Application Router
• Configuring a Custom Application Router
• Session Key-Based Request Targeting
• API to Set Transport Parameter on Record-Route Header
• Setting Content in SIP Responses

6 Developing Converged Applications

• Overview of Converged Applications
• Assembling and Packaging a Converged Application
• Working with SIP and HTTP Sessions
  • Modifying the SipApplicationSession
    • Synchronous Access
    • Asynchronous Access
• Using the Converged Application Example

7 Developing Custom Profile Service Providers

• Overview of the Profile Service API
• Implementing Profile Service API Methods
• Configuring and Packaging Profile Providers
  • Mapping Profile Requests to Profile Providers
• Configuring Profile Providers Using the Administration Console

8 Using Content Indirection in SIP Servlets

• Overview of Content Indirection
• Using the Content Indirection API
• Additional Information

9 Securing SIP Servlet Resources

• Overview of SIP Servlet Security
• Triggering SIP Response Codes
• Specifying the Security Realm
• Converged Application Server Role Mapping Features
• Using Implicit Role Assignment
• Assigning Roles Using security-role-assignment
  • Important Requirements
  • 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

10 Developing SIP Servlets Using Eclipse

• Overview
  • SIP Servlet Organization
• Setting Up the Development Environment
  • Creating a 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

11 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

12 Generating SNMP Traps from Application Code

• Overview
• Requirement for Accessing SipServletSnmpTrapRuntimeMBean
• Obtaining a Reference to SipServletSnmpTrapRuntimeMBean
• Generating an SNMP Trap