com.google.i18n.phonenumbers.prefixmapper

Class PhonePrefixMap

java.lang.Object

com.google.i18n.phonenumbers.prefixmapper.PhonePrefixMap

All Implemented Interfaces:

Externalizable, Serializable

public class PhonePrefixMap
extends Object
implements Externalizable

A utility that maps phone number prefixes to a description string, which may be, for example, the geographical area the prefix covers.

Author:

Shaopeng Jia

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
PhonePrefixMap() Creates an empty PhonePrefixMap.

Method Summary

Methods

Modifier and Type	Method and Description
String	lookup(Phonenumber.PhoneNumber number) As per lookup(long), but receives the number as a PhoneNumber instead of a long.
void	readExternal(ObjectInput objectInput) Supports Java Serialization.
void	readPhonePrefixMap(SortedMap<Integer,String> sortedPhonePrefixMap) Creates an PhonePrefixMap initialized with sortedPhonePrefixMap.
String	toString() Dumps the mappings contained in the phone prefix map.
void	writeExternal(ObjectOutput objectOutput) Supports Java Serialization.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

PhonePrefixMap

public PhonePrefixMap()

Creates an empty PhonePrefixMap. The default constructor is necessary for implementing Externalizable. The empty map could later be populated by readPhonePrefixMap(java.util.SortedMap) or readExternal(java.io.ObjectInput).

Method Detail

readPhonePrefixMap

public void readPhonePrefixMap(SortedMap<Integer,String> sortedPhonePrefixMap)

Creates an PhonePrefixMap initialized with sortedPhonePrefixMap. Note that the underlying implementation of this method is expensive thus should not be called by time-critical applications.

Parameters:

sortedPhonePrefixMap - a map from phone number prefixes to descriptions of those prefixes sorted in ascending order of the phone number prefixes as integers.

readExternal

public void readExternal(ObjectInput objectInput)
                  throws IOException

Supports Java Serialization.

Specified by:

readExternal in interface Externalizable

Throws:

IOException

writeExternal

public void writeExternal(ObjectOutput objectOutput)
                   throws IOException

Supports Java Serialization.

Specified by:

writeExternal in interface Externalizable

Throws:

IOException

lookup

public String lookup(Phonenumber.PhoneNumber number)

As per lookup(long), but receives the number as a PhoneNumber instead of a long.

Parameters:

number - the phone number to look up

Returns:

the description corresponding to the prefix that best matches this phone number

toString

public String toString()

Dumps the mappings contained in the phone prefix map.

Overrides:

toString in class Object