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 a specified registered Event Listener.

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.