// Helper method to get the region code for a given phone number, from a list of possible region
// codes. If the list contains more than one region, the first region for which the number is
// valid is returned.
private String getRegionCodeForShortNumberFromRegionList(PhoneNumber number,
List <String> regionCodes)
{
if (regionCodes.size() == 0)
{
return(null);
}
else if (regionCodes.size() == 1)
{
return(regionCodes.get(0));
}
String nationalNumber = phoneUtil.getNationalSignificantNumber(number);
foreach (String regionCode in regionCodes)
{
PhoneMetadata phoneMetadata = MetadataManager.getShortNumberMetadataForRegion(regionCode);
if (phoneMetadata != null &&
phoneUtil.isNumberMatchingDesc(nationalNumber, phoneMetadata.getShortCode()))
{
// The number is valid for this region.
return(regionCode);
}
}
return(null);
}
/**
* Tests whether a short number matches a valid pattern. Note that this doesn't verify the number
* is actually in use, which is impossible to tell by just looking at the number itself.
*
* @param shortNumber the short number to check as a string
* @param regionDialingFrom the region from which the number is dialed
* @return whether the short number matches a valid pattern
*/
public boolean isValidShortNumber(String shortNumber, String regionDialingFrom)
{
PhoneMetadata phoneMetadata =
MetadataManager.getShortNumberMetadataForRegion(regionDialingFrom);
if (phoneMetadata == null)
{
return(false);
}
PhoneNumberDesc generalDesc = phoneMetadata.getGeneralDesc();
if (!generalDesc.hasNationalNumberPattern() ||
!phoneUtil.isNumberMatchingDesc(shortNumber, generalDesc))
{
return(false);
}
PhoneNumberDesc shortNumberDesc = phoneMetadata.getShortCode();
if (!shortNumberDesc.hasNationalNumberPattern())
{
logger.log(Level.WARNING, "No short code national number pattern found for region: " +
regionDialingFrom);
return(false);
}
return(phoneUtil.isNumberMatchingDesc(shortNumber, shortNumberDesc));
}
/**
* Gets a valid short number for the specified region.
*
* @param regionCode the region for which an example short number is needed
* @return a valid short number for the specified region. Returns an empty string when the
* metadata does not contain such information.
*/
// @VisibleForTesting
internal String getExampleShortNumber(String regionCode)
{
PhoneMetadata phoneMetadata = MetadataManager.getShortNumberMetadataForRegion(regionCode);
if (phoneMetadata == null)
{
return("");
}
PhoneNumberDesc desc = phoneMetadata.getShortCode();
if (desc.hasExampleNumber())
{
return(desc.getExampleNumber());
}
return("");
}
