JCC
v0.9.2

jain.application.services.jcp
Interface JcpAddress

All Known Subinterfaces:
JccAddress

public interface JcpAddress

An JcpAddress object represents what we commonly think of as a "telephone number".

Introduction

An address uniquely identifies a communication endpoint--physical or logical. Its string representation is obtained by the method getName().

Address objects may be classified into two categories: local and remote. A "Local" Address is one physically or administratively serviced by the existing Provider. Conversely, a "Remote" address is not served by this Provider. A remote Address may not have the full visibility or control capabilities of a local address. (By impaired visibility, we mean connection states involving this address may not be as finely discriminated; by impaired control, we mean that not all the connection's methods involving this address may be functional.) Note that applications never explicitly create new Address objects.

Address and Call Objects

Address objects are related to Call objects via the Connection object. The Connection object has a state which describes the current relationship between the Call and the Address. Each Address object may be part of more than one telephone call, and in each case, is represented by a separate Connection object.

An Address is associated with a Call until the Connection moves into the JcpConnection.DISCONNECTED state.


Method Summary
 java.lang.String getName()
          Returns the string representation of the JcpAddress.
 JcpProvider getProvider()
          Retrieves the Jcpprovider handling this address object.
 

Method Detail

getName

public java.lang.String getName()
Returns the string representation of the JcpAddress. Note that each JcpAddress possesses a unique string representation within a given JcpProvider.
Returns:
the "unique" string representation of this JcpAddress.

getProvider

public JcpProvider getProvider()
Retrieves the Jcpprovider handling this address object. This JcpProvider object is valid throughout the lifetime of the JcpAddress and does not change once the JcpAddress is created.
Returns:
JcpProvider object managing this call.

JCC
v0.9.2

29 Oct 2000
If you have any comments or queries, please mail them to jcc@research.telcordia.com


Copyright-2000 Sun Microsystems