/* * Copyright (C) 2010 The Libphonenumber Authors * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.google.i18n.phonenumbers; import com.google.i18n.phonenumbers.nano.Phonemetadata.NumberFormat; import com.google.i18n.phonenumbers.nano.Phonemetadata.PhoneMetadata; import com.google.i18n.phonenumbers.nano.Phonemetadata.PhoneMetadataCollection; import com.google.i18n.phonenumbers.nano.Phonemetadata.PhoneNumberDesc; import java.io.BufferedWriter; import java.io.FileWriter; import java.io.IOException; import java.util.Formatter; import java.util.List; import java.util.Map; /** * Tool to convert phone number metadata from the XML format to JSON format. * * @author Nikolaos Trogkanis */ public class BuildMetadataJsonFromXml extends Command { private static final String NAMESPACE = "i18n.phonenumbers.metadata"; private static final String HELP_MESSAGE = "Usage:\n" + "BuildMetadataJsonFromXml []\n" + "\n" + "where:\n" + " inputFile The input file containing phone number metadata in XML format.\n" + " outputFile The output file to contain phone number metadata in JSON format.\n" + " liteBuild Whether to generate the lite-version of the metadata (default:\n" + " false). When set to true certain metadata will be omitted.\n" + " At this moment, example numbers information is omitted.\n" + "\n" + "Example command line invocation:\n" + "BuildMetadataJsonFromXml PhoneNumberMetadata.xml metadatalite.js true\n"; private static final String FILE_OVERVIEW = "/**\n" + " * @fileoverview Generated metadata for file\n" + " * %s\n" + " * @author Nikolaos Trogkanis\n" + " */\n\n"; private static final String COUNTRY_CODE_TO_REGION_CODE_MAP_COMMENT = "/**\n" + " * A mapping from a country calling code to the region codes which denote the\n" + " * region represented by that country calling code. In the case of multiple\n" + " * countries sharing a calling code, such as the NANPA regions, the one\n" + " * indicated with \"isMainCountryForCode\" in the metadata should be first.\n" + " * @type {!Object.>}\n" + " */\n"; private static final String COUNTRY_TO_METADATA_COMMENT = "/**\n" + " * A mapping from a region code to the PhoneMetadata for that region.\n" + " * @type {!Object.}\n" + " */\n"; private static final int COPYRIGHT_YEAR = 2010; @Override public String getCommandName() { return "BuildMetadataJsonFromXml"; } @Override public boolean start() { String[] args = getArgs(); if (args.length != 3 && args.length != 4) { System.err.println(HELP_MESSAGE); return false; } String inputFile = args[1]; String outputFile = args[2]; boolean liteBuild = args.length > 3 && args[3].equals("true"); try { PhoneMetadataCollection metadataCollection = BuildMetadataFromXml.buildPhoneMetadataCollection(inputFile, liteBuild); Map> countryCodeToRegionCodeMap = BuildMetadataFromXml.buildCountryCodeToRegionCodeMap(metadataCollection); BufferedWriter writer = new BufferedWriter(new FileWriter(outputFile)); CopyrightNotice.writeTo(writer, COPYRIGHT_YEAR, true); Formatter formatter = new Formatter(writer); formatter.format(FILE_OVERVIEW, inputFile); writer.write("goog.provide('" + NAMESPACE + "');\n\n"); writer.write(COUNTRY_CODE_TO_REGION_CODE_MAP_COMMENT); writer.write(NAMESPACE + ".countryCodeToRegionCodeMap = "); writeCountryCodeToRegionCodeMap(countryCodeToRegionCodeMap, writer); writer.write(";\n\n"); writer.write(COUNTRY_TO_METADATA_COMMENT); writer.write(NAMESPACE + ".countryToMetadata = "); writeCountryToMetadataMap(metadataCollection, writer); writer.write(";\n"); writer.flush(); writer.close(); formatter.close(); } catch (Exception e) { e.printStackTrace(); return false; } return true; } // Writes a PhoneMetadataCollection in JSON format. private static void writeCountryToMetadataMap(PhoneMetadataCollection metadataCollection, BufferedWriter writer) throws IOException { writer.write("{\n"); boolean isFirstTimeInLoop = true; for (PhoneMetadata metadata : metadataCollection.metadata) { if (isFirstTimeInLoop) { isFirstTimeInLoop = false; } else { writer.write(","); } String key = metadata.id; // For non-geographical country calling codes (e.g. +800), use the country calling codes // instead of the region code as key in the map. if (key.equals("001")) { key = Integer.toString(metadata.countryCode); } JSArrayBuilder jsArrayBuilder = new JSArrayBuilder(); toJsArray(metadata, jsArrayBuilder); writer.write("\""); writer.write(key); writer.write("\":"); writer.write(jsArrayBuilder.toString()); } writer.write("}"); } // Writes a Map> in JSON format. private static void writeCountryCodeToRegionCodeMap( Map> countryCodeToRegionCodeMap, BufferedWriter writer) throws IOException { writer.write("{\n"); boolean isFirstTimeInLoop = true; for (Map.Entry> entry : countryCodeToRegionCodeMap.entrySet()) { if (isFirstTimeInLoop) { isFirstTimeInLoop = false; } else { writer.write(","); } writer.write(Integer.toString(entry.getKey())); writer.write(":"); JSArrayBuilder jsArrayBuilder = new JSArrayBuilder(); jsArrayBuilder.beginArray(); jsArrayBuilder.appendIterator(entry.getValue().iterator()); jsArrayBuilder.endArray(); writer.write(jsArrayBuilder.toString()); } writer.write("}"); } // Converts NumberFormat to JSArray. private static void toJsArray(NumberFormat format, JSArrayBuilder jsArrayBuilder) { jsArrayBuilder.beginArray(); // missing 0 jsArrayBuilder.append(null); // required string pattern = 1; jsArrayBuilder.append(format.pattern); // required string format = 2; jsArrayBuilder.append(format.format); // repeated string leading_digits_pattern = 3; int leadingDigitsPatternSize = format.leadingDigitsPattern.length; if (leadingDigitsPatternSize > 0) { jsArrayBuilder.beginArray(); for (int i = 0; i < leadingDigitsPatternSize; i++) { jsArrayBuilder.append(format.leadingDigitsPattern[i]); } jsArrayBuilder.endArray(); } else { jsArrayBuilder.append(null); } // optional string national_prefix_formatting_rule = 4; if (!format.nationalPrefixFormattingRule.equals("")) { jsArrayBuilder.append(format.nationalPrefixFormattingRule); } else { jsArrayBuilder.append(null); } // optional string domestic_carrier_code_formatting_rule = 5; if (!format.domesticCarrierCodeFormattingRule.equals("")) { jsArrayBuilder.append(format.domesticCarrierCodeFormattingRule); } else { jsArrayBuilder.append(null); } // optional bool national_prefix_optional_when_formatting = 6; if (format.nationalPrefixOptionalWhenFormatting) { jsArrayBuilder.append(format.nationalPrefixOptionalWhenFormatting); } else { jsArrayBuilder.append(null); } jsArrayBuilder.endArray(); } // Converts PhoneNumberDesc to JSArray. private static void toJsArray(PhoneNumberDesc desc, JSArrayBuilder jsArrayBuilder) { if (desc == null) { // Some descriptions are optional; in these cases we just append null and return if they are // absent. jsArrayBuilder.append(null); return; } jsArrayBuilder.beginArray(); // missing 0 jsArrayBuilder.append(null); // missing 1 jsArrayBuilder.append(null); // optional string national_number_pattern = 2; if (!desc.nationalNumberPattern.equals("")) { jsArrayBuilder.append(desc.nationalNumberPattern); } else { jsArrayBuilder.append(null); } // optional string possible_number_pattern = 3; if (!desc.possibleNumberPattern.equals("")) { jsArrayBuilder.append(desc.possibleNumberPattern); } else { jsArrayBuilder.append(null); } // missing 4 jsArrayBuilder.append(null); // missing 5 jsArrayBuilder.append(null); // optional string example_number = 6; if (!desc.exampleNumber.equals("")) { jsArrayBuilder.append(desc.exampleNumber); } else { jsArrayBuilder.append(null); } jsArrayBuilder.endArray(); } // Converts PhoneMetadata to JSArray. private static void toJsArray(PhoneMetadata metadata, JSArrayBuilder jsArrayBuilder) { jsArrayBuilder.beginArray(); // missing 0 jsArrayBuilder.append(null); // optional PhoneNumberDesc general_desc = 1; toJsArray(metadata.generalDesc, jsArrayBuilder); // optional PhoneNumberDesc fixed_line = 2; toJsArray(metadata.fixedLine, jsArrayBuilder); // optional PhoneNumberDesc mobile = 3; toJsArray(metadata.mobile, jsArrayBuilder); // optional PhoneNumberDesc toll_free = 4; toJsArray(metadata.tollFree, jsArrayBuilder); // optional PhoneNumberDesc premium_rate = 5; toJsArray(metadata.premiumRate, jsArrayBuilder); // optional PhoneNumberDesc shared_cost = 6; toJsArray(metadata.sharedCost, jsArrayBuilder); // optional PhoneNumberDesc personal_number = 7; toJsArray(metadata.personalNumber, jsArrayBuilder); // optional PhoneNumberDesc voip = 8; toJsArray(metadata.voip, jsArrayBuilder); // required string id = 9; jsArrayBuilder.append(metadata.id); // optional int32 country_code = 10; if (metadata.countryCode != 0) { jsArrayBuilder.append(metadata.countryCode); } else { jsArrayBuilder.append(null); } // optional string international_prefix = 11; if (!metadata.internationalPrefix.equals("")) { jsArrayBuilder.append(metadata.internationalPrefix); } else { jsArrayBuilder.append(null); } // optional string national_prefix = 12; if (!metadata.nationalPrefix.equals("")) { jsArrayBuilder.append(metadata.nationalPrefix); } else { jsArrayBuilder.append(null); } // optional string preferred_extn_prefix = 13; if (!metadata.preferredExtnPrefix.equals("")) { jsArrayBuilder.append(metadata.preferredExtnPrefix); } else { jsArrayBuilder.append(null); } // missing 14 jsArrayBuilder.append(null); // optional string national_prefix_for_parsing = 15; if (!metadata.nationalPrefixForParsing.equals("")) { jsArrayBuilder.append(metadata.nationalPrefixForParsing); } else { jsArrayBuilder.append(null); } // optional string national_prefix_transform_rule = 16; if (!metadata.nationalPrefixTransformRule.equals("")) { jsArrayBuilder.append(metadata.nationalPrefixTransformRule); } else { jsArrayBuilder.append(null); } // optional string preferred_international_prefix = 17; if (!metadata.preferredInternationalPrefix.equals("")) { jsArrayBuilder.append(metadata.preferredInternationalPrefix); } else { jsArrayBuilder.append(null); } // optional bool same_mobile_and_fixed_line_pattern = 18 [default=false]; if (metadata.sameMobileAndFixedLinePattern) { jsArrayBuilder.append(1); } else { jsArrayBuilder.append(null); } // repeated NumberFormat number_format = 19; int numberFormatSize = metadata.numberFormat.length; if (numberFormatSize > 0) { jsArrayBuilder.beginArray(); for (int i = 0; i < numberFormatSize; i++) { toJsArray(metadata.numberFormat[i], jsArrayBuilder); } jsArrayBuilder.endArray(); } else { jsArrayBuilder.append(null); } // repeated NumberFormat intl_number_format = 20; int intlNumberFormatSize = metadata.intlNumberFormat.length; if (intlNumberFormatSize > 0) { jsArrayBuilder.beginArray(); for (int i = 0; i < intlNumberFormatSize; i++) { toJsArray(metadata.intlNumberFormat[i], jsArrayBuilder); } jsArrayBuilder.endArray(); } else { jsArrayBuilder.append(null); } // optional PhoneNumberDesc pager = 21; toJsArray(metadata.pager, jsArrayBuilder); // optional bool main_country_for_code = 22 [default=false]; if (metadata.mainCountryForCode) { jsArrayBuilder.append(1); } else { jsArrayBuilder.append(null); } // optional string leading_digits = 23; if (!metadata.leadingDigits.equals("")) { jsArrayBuilder.append(metadata.leadingDigits); } else { jsArrayBuilder.append(null); } // optional PhoneNumberDesc no_international_dialling = 24; toJsArray(metadata.noInternationalDialling, jsArrayBuilder); // optional PhoneNumberDesc uan = 25; toJsArray(metadata.uan, jsArrayBuilder); // optional bool leading_zero_possible = 26 [default=false]; if (metadata.leadingZeroPossible) { jsArrayBuilder.append(1); } else { jsArrayBuilder.append(null); } // optional PhoneNumberDesc emergency = 27; toJsArray(metadata.emergency, jsArrayBuilder); // optional PhoneNumberDesc voicemail = 28; toJsArray(metadata.voicemail, jsArrayBuilder); // Fields 29-31 are omitted due to space increase. // optional PhoneNumberDesc short_code = 29; // optional PhoneNumberDesc standard_rate = 30; // optional PhoneNumberDesc carrier_specific = 31; // optional bool mobile_number_portable_region = 32 [default=false]; // Omit since the JS API doesn't expose this data. // Note: Need to add null for each of the above fields when a subsequent // field is being populated. jsArrayBuilder.endArray(); } }