JAINTM MGCP API (DRAFT FOR PUBLIC REVIEW) - Version 0.9 - 16 NOVEMBER 2000

JAIN MGCP API

Standard Java Interface to the Media Gateway Control Protocol (MGCP)

DRAFT FOR PUBLIC REVIEW

This document provides an overview of the JAINTM Media Gateway Control Protocol (MGCP) API, which is part of the JAIN 1.0 Specification.

See:
          Description

Packages
jain.protocol.ip This package contains the JAIN IP Factory, which is the central creation point for all high-level proprietary JAIN IP objects.
jain.protocol.ip.mgcp This package contains the main interfaces for representing JAIN MGCP protocol stacks and JAIN MGCP Providers and Listeners and the definition of classes and exceptions needed to send and receive MGCP commands and responses.
jain.protocol.ip.mgcp.message This package contains the Event classes needed to represent JAIN MGCP command and response primitives.
jain.protocol.ip.mgcp.message.parms This package contains the classes that define the parameters used by the JAIN MGCP command and response primitives.
jain.protocol.ip.mgcp.pkg This package contains the classes that define MGCP events and MGCP package names.

 

This document provides an overview of the JAINTM Media Gateway Control Protocol (MGCP) API, which is part of the JAIN 1.0 Specification. JAIN is a set of Integrated Network APIs for the JavaTM platform. This document is not intended as a tutorial on the JAIN MGCP API. Readers should have a good understanding of MGCP and should be comfortable with reading API specifications expressed in the form you see now. The JAIN MGCP API is intended to be implementable from the specification by any party who has access to the specification.


The JAIN MGCP API Specification Requirements Specification

The Requirements Specification provides a high-level overview of JAIN and of the JAIN MGCP API Specification, and explains the JAIN architecture, the Media Gateway Control Protocol, and the functionality provided by each of the requirements defined within the document.


Overview of JAIN MGCP API

The implementation of this API focuses around the JainMgcpListener and JainMgcpProvider interfaces. A JAIN MGCP Listener could be any MGCP User application that implements the JainMgcpListener interface. The application would use a JAIN MGCP Provider to send MGCP command primitives into the MGCP stack and to receive MGCP response primitives from the MGCP stack.

The JainMgcpProvider interface defines the methods required to send MGCP command and response primitives. This interface also defines the methods required to maintain a list of Event Listeners. An implementation of this interface would listen for MGCP messages from the stack and forward these messages as Events to all registered JainMgcpListeners.

An object that implements the JainMgcpProvider interface (a JAIN MGCP Provider) could be vendor-specific and would act as a proxy for the MGCP stack. Zero or more Event Listeners could register with a JAIN MGCP Provider; however, in practice, it is expected that at most one such Listener will be registered with a given JAIN MGCP Provider. The JAIN MGCP API provides the ability to limit the number of Event Listeners that may register with a JAIN MGCP Provider simultaneously.


JAINTM MGCP API (DRAFT FOR PUBLIC REVIEW) - Version 0.9 - 16 NOVEMBER 2000

Copyright © 2000 Sun Microsystems, Inc.