OpenScape
V3.2, Revision 044 20100322

com.siemens.symphonia.bcom.bcommon.external
Interface PublicAddress

All Superinterfaces:
ComEndpoint, EndpointAddress
All Known Subinterfaces:
PublicAddressInternal
All Known Implementing Classes:
PublicAddressImpl, PublicAddressInternalImpl

public interface PublicAddress
extends EndpointAddress

Describes in detail the characteristics of a public address.

A worlwide unique public address for voice communication consists of the following parts as defined by ECMA standards:

The normalized number (returned by getNormalizedNumber) is built as follows: +<Country Code><Area Code><Location Code><Extension Number>


Field Summary
 
Fields inherited from interface com.siemens.symphonia.bcom.bcommon.external.EndpointAddress
TON_GLOBAL_NUMBER, TON_INVALID_NUMBER, TON_PASS_THRU_NUMBER, TON_PRIVATE_NUMBER
 
Method Summary
 java.lang.String getAreaCode()
          Extract Area Code from normalized number.
 java.lang.String getCountryCode()
          Extract Country Code from normalized number.
 java.lang.String getExtensionNumber()
          Extract Extension Number from normalized number.
 java.lang.String getLocationCode()
          Extract Location Code from normalized number.
 int getNumberOfOverlapDigits()
          Overlap between Location Code and Extension Number.
 
Methods inherited from interface com.siemens.symphonia.bcom.bcommon.external.EndpointAddress
getNormalizedNumber, getTypeOfNumber
 

Method Detail

getCountryCode

java.lang.String getCountryCode()
Extract Country Code from normalized number.

The Country Code is given without any international prefix or any syntactical enrichments.
Examples: "1" is the Country Code of U.S.A. or "49" is the Country Code of Germany.

Remark:
Country Codes are assigned by ITU-T to countries and can therefore be used to identify the country a phone number belongs to.

Returns:
Sequence of digits composing the Country Code.

getAreaCode

java.lang.String getAreaCode()
Extract Area Code from normalized number.

Example: "408" is the Area Code of the city San Jose in U.S.A.

Returns:
null if Area Code is not known
Sequence of digits composing the Area Code otherwise.

getLocationCode

java.lang.String getLocationCode()
Extract Location Code from normalized number.

The number's part assigned to a company doesn't follow a general rule. It differs from country to country or even from carrier to carrier.

Returns:
null if Location Code is not known
Sequence of digits composing the Location Code otherwise.

getNumberOfOverlapDigits

int getNumberOfOverlapDigits()
Overlap between Location Code and Extension Number.

In some countries (e.g. U.S.A.) the Extension Number has a fixed length. If a company needs more phone numbers than this fixed length allows multiple Location Codes must be assigned.
To reach a certain station inside the company it is now not sufficient to dial the extension. The last digits of the Location Code must be added to get a phone number which is unique inside the company.
The Overlap defines the number of digits needed from the Location Code to build an unique number (inside the company).

Example:
A station in the headquarter of Boca Raton (U.S.A.) has the following public number:

The global number (GNF) of this station is +15619231802 and the extension number inside the company is 31802. I.e. the digit 3 is not part of the extension in the context of the global number, but must be dialed inside the company to make the Extension Number unique (inside the company).

Returns:
0 if the Overlap feature is not used.
<>0 specifies the number of overlapping digits.

getExtensionNumber

java.lang.String getExtensionNumber()
Extract Extension Number from normalized number.

The number to be dialed inside a company to reach a certain station (which is located inside the company).

Returns:
Sequence of digits composing the Extension Number.

OpenScape
V3.2, Revision 044 20100322

Copyright (c) 2007 Siemens Enterprise Communications, Germany
All rights reserved.

This software is the confidential and proprietary information of Siemens Enterprise Communications, Germany