Java tutorial
/* * Copyright (C) 2011 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. * * @author Shaopeng Jia */ package com.google.phonenumbers; import com.google.i18n.phonenumbers.AsYouTypeFormatter; import com.google.i18n.phonenumbers.NumberParseException; import com.google.i18n.phonenumbers.PhoneNumberToCarrierMapper; import com.google.i18n.phonenumbers.PhoneNumberToTimeZonesMapper; import com.google.i18n.phonenumbers.PhoneNumberUtil; import com.google.i18n.phonenumbers.PhoneNumberUtil.PhoneNumberFormat; import com.google.i18n.phonenumbers.PhoneNumberUtil.PhoneNumberType; import com.google.i18n.phonenumbers.Phonenumber.PhoneNumber; import com.google.i18n.phonenumbers.geocoding.PhoneNumberOfflineGeocoder; import org.apache.commons.fileupload.FileItemIterator; import org.apache.commons.fileupload.FileItemStream; import org.apache.commons.fileupload.FileUploadException; import org.apache.commons.fileupload.servlet.ServletFileUpload; import org.apache.commons.fileupload.util.Streams; import org.apache.commons.io.IOUtils; import java.io.IOException; import java.io.InputStream; import java.util.Locale; import java.util.StringTokenizer; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; /** * A servlet that accepts requests that contain strings representing a phone number and a default * country, and responds with results from parsing, validating and formatting the number. The * default country is a two-letter region code representing the country that we are expecting the * number to be from. */ @SuppressWarnings("serial") public class PhoneNumberParserServlet extends HttpServlet { private PhoneNumberUtil phoneUtil = PhoneNumberUtil.getInstance(); public void doPost(HttpServletRequest req, HttpServletResponse resp) throws IOException { String phoneNumber = null; String defaultCountry = null; String languageCode = "en"; // Default languageCode to English if nothing is entered. String regionCode = ""; String fileContents = null; ServletFileUpload upload = new ServletFileUpload(); upload.setSizeMax(50000); try { FileItemIterator iterator = upload.getItemIterator(req); while (iterator.hasNext()) { FileItemStream item = iterator.next(); InputStream in = item.openStream(); if (item.isFormField()) { String fieldName = item.getFieldName(); if (fieldName.equals("phoneNumber")) { phoneNumber = Streams.asString(in, "UTF-8"); } else if (fieldName.equals("defaultCountry")) { defaultCountry = Streams.asString(in).toUpperCase(); } else if (fieldName.equals("languageCode")) { String languageEntered = Streams.asString(in).toLowerCase(); if (languageEntered.length() > 0) { languageCode = languageEntered; } } else if (fieldName.equals("regionCode")) { regionCode = Streams.asString(in).toUpperCase(); } } else { try { fileContents = IOUtils.toString(in); } finally { IOUtils.closeQuietly(in); } } } } catch (FileUploadException e1) { e1.printStackTrace(); } StringBuilder output; if (fileContents.length() == 0) { output = getOutputForSingleNumber(phoneNumber, defaultCountry, languageCode, regionCode); resp.setContentType("text/html"); resp.setCharacterEncoding("UTF-8"); resp.getWriter().println("<html><head>"); resp.getWriter() .println("<link type=\"text/css\" rel=\"stylesheet\" href=\"/stylesheets/main.css\" />"); resp.getWriter().println("</head>"); resp.getWriter().println("<body>"); resp.getWriter().println("Phone Number entered: " + phoneNumber + "<br>"); resp.getWriter().println("defaultCountry entered: " + defaultCountry + "<br>"); resp.getWriter().println("Language entered: " + languageCode + (regionCode.length() == 0 ? "" : " (" + regionCode + ")" + "<br>")); } else { output = getOutputForFile(defaultCountry, fileContents); resp.setContentType("text/html"); } resp.getWriter().println(output); resp.getWriter().println("</body></html>"); } private StringBuilder getOutputForFile(String defaultCountry, String fileContents) { StringBuilder output = new StringBuilder(); output.append("<HTML><HEAD><TITLE>Results generated from phone numbers in the file provided:" + "</TITLE></HEAD><BODY>"); output.append("<TABLE align=center border=1>"); output.append("<TH align=center>ID</TH>"); output.append("<TH align=center>Raw phone number</TH>"); output.append("<TH align=center>Pretty formatting</TH>"); output.append("<TH align=center>International format</TH>"); int phoneNumberId = 0; StringTokenizer tokenizer = new StringTokenizer(fileContents, ","); while (tokenizer.hasMoreTokens()) { String numberStr = tokenizer.nextToken(); phoneNumberId++; output.append("<TR>"); output.append("<TD align=center>").append(phoneNumberId).append(" </TD> \n"); output.append("<TD align=center>").append(numberStr).append(" </TD> \n"); try { PhoneNumber number = phoneUtil.parseAndKeepRawInput(numberStr, defaultCountry); boolean isNumberValid = phoneUtil.isValidNumber(number); String prettyFormat = isNumberValid ? phoneUtil.formatInOriginalFormat(number, defaultCountry) : "invalid"; String internationalFormat = isNumberValid ? phoneUtil.format(number, PhoneNumberFormat.INTERNATIONAL) : "invalid"; output.append("<TD align=center>").append(prettyFormat).append(" </TD> \n"); output.append("<TD align=center>").append(internationalFormat).append(" </TD> \n"); } catch (NumberParseException e) { output.append("<TD align=center colspan=2>").append(e.toString()).append(" </TD> \n"); } output.append("</TR>"); } output.append("</BODY></HTML>"); return output; } private void appendLine(String title, String data, StringBuilder output) { output.append("<TR>"); output.append("<TH>").append(title).append("</TH>"); output.append("<TD>").append(data.length() > 0 ? data : " ").append("</TD>"); output.append("</TR>"); } /** * The defaultCountry here is used for parsing phoneNumber. The languageCode and regionCode are * used to specify the language used for displaying the area descriptions generated from phone * number geocoding. */ private StringBuilder getOutputForSingleNumber(String phoneNumber, String defaultCountry, String languageCode, String regionCode) { StringBuilder output = new StringBuilder(); try { PhoneNumber number = phoneUtil.parseAndKeepRawInput(phoneNumber, defaultCountry); output.append("<DIV>"); output.append("<TABLE border=1>"); output.append("<TR><TD colspan=2>Parsing Result</TD></TR>"); appendLine("country_code", Integer.toString(number.getCountryCode()), output); appendLine("national_number", Long.toString(number.getNationalNumber()), output); appendLine("extension", number.getExtension(), output); appendLine("country_code_source", number.getCountryCodeSource().toString(), output); appendLine("italian_leading_zero", Boolean.toString(number.isItalianLeadingZero()), output); appendLine("raw_input", number.getRawInput(), output); output.append("</TABLE>"); output.append("</DIV>"); boolean isPossible = phoneUtil.isPossibleNumber(number); boolean isNumberValid = phoneUtil.isValidNumber(number); PhoneNumberType numberType = phoneUtil.getNumberType(number); output.append("<DIV>"); output.append("<TABLE border=1>"); output.append("<TR><TD colspan=2>Validation Results</TD></TR>"); appendLine("Result from isPossibleNumber()", Boolean.toString(isPossible), output); if (!isPossible) { appendLine("Result from isPossibleNumberWithReason()", phoneUtil.isPossibleNumberWithReason(number).toString(), output); output.append("<TR><TD colspan=2>Note: numbers that are not possible have type " + "UNKNOWN, an unknown region, and are considered invalid.</TD></TR>"); } else { appendLine("Result from isValidNumber()", Boolean.toString(isNumberValid), output); if (isNumberValid) { if (!defaultCountry.isEmpty() && defaultCountry != "ZZ") { appendLine("Result from isValidNumberForRegion()", Boolean.toString(phoneUtil.isValidNumberForRegion(number, defaultCountry)), output); } } String region = phoneUtil.getRegionCodeForNumber(number); appendLine("Phone Number region", region == null ? "" : region, output); appendLine("Result from getNumberType()", numberType.toString(), output); } output.append("</TABLE>"); output.append("</DIV>"); output.append("<DIV>"); output.append("<TABLE border=1>"); output.append("<TR><TD colspan=2>Formatting Results</TD></TR>"); appendLine("E164 format", isNumberValid ? phoneUtil.format(number, PhoneNumberFormat.E164) : "invalid", output); appendLine("Original format", phoneUtil.formatInOriginalFormat(number, defaultCountry), output); appendLine("National format", phoneUtil.format(number, PhoneNumberFormat.NATIONAL), output); appendLine("International format", isNumberValid ? phoneUtil.format(number, PhoneNumberFormat.INTERNATIONAL) : "invalid", output); appendLine("Out-of-country format from US", isNumberValid ? phoneUtil.formatOutOfCountryCallingNumber(number, "US") : "invalid", output); appendLine("Out-of-country format from CH", isNumberValid ? phoneUtil.formatOutOfCountryCallingNumber(number, "CH") : "invalid", output); output.append("</TABLE>"); output.append("</DIV>"); AsYouTypeFormatter formatter = phoneUtil.getAsYouTypeFormatter(defaultCountry); int rawNumberLength = phoneNumber.length(); output.append("<DIV>"); output.append("<TABLE border=1>"); output.append("<TR><TD colspan=2>AsYouTypeFormatter Results</TD></TR>"); for (int i = 0; i < rawNumberLength; i++) { // Note this doesn't handle supplementary characters, but it shouldn't be a big deal as // there are no dial-pad characters in the supplementary range. char inputChar = phoneNumber.charAt(i); appendLine("Char entered: '" + inputChar + "' Output: ", formatter.inputDigit(inputChar), output); } output.append("</TABLE>"); output.append("</DIV>"); if (isNumberValid) { output.append("<DIV>"); output.append("<TABLE border=1>"); output.append("<TR><TD colspan=2>PhoneNumberOfflineGeocoder Results</TD></TR>"); appendLine("Location", PhoneNumberOfflineGeocoder.getInstance().getDescriptionForNumber(number, new Locale(languageCode, regionCode)), output); output.append("</TABLE>"); output.append("</DIV>"); output.append("<DIV>"); output.append("<TABLE border=1>"); output.append("<TR><TD colspan=2>PhoneNumberToTimeZonesMapper Results</TD></TR>"); appendLine("Time zone(s)", PhoneNumberToTimeZonesMapper.getInstance().getTimeZonesForNumber(number).toString(), output); output.append("</TABLE>"); output.append("</DIV>"); if (numberType == PhoneNumberType.MOBILE || numberType == PhoneNumberType.FIXED_LINE_OR_MOBILE || numberType == PhoneNumberType.PAGER) { output.append("<DIV>"); output.append("<TABLE border=1>"); output.append("<TR><TD colspan=2>PhoneNumberToCarrierMapper Results</TD></TR>"); appendLine("Carrier", PhoneNumberToCarrierMapper.getInstance().getNameForNumber(number, new Locale(languageCode, regionCode)), output); output.append("</TABLE>"); output.append("</DIV>"); } } } catch (NumberParseException e) { output.append(e.toString()); } return output; } }