frameworks/base/core/java/com/google/android/mms/pdu/CharacterSets.java

   1 /*
   2  * Copyright (C) 2007 Esmertec AG.
   3  * Copyright (C) 2007 The Android Open Source Project
   4  *
   5  * Licensed under the Apache License, Version 2.0 (the "License");
   6  * you may not use this file except in compliance with the License.
   7  * You may obtain a copy of the License at
   8  *
   9  *      http://www.apache.org/licenses/LICENSE-2.0
  10  *
  11  * Unless required by applicable law or agreed to in writing, software
  12  * distributed under the License is distributed on an "AS IS" BASIS,
  13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14  * See the License for the specific language governing permissions and
  15  * limitations under the License.
  16  */
  17
  18 package com.google.android.mms.pdu;
  19
  20 import java.io.UnsupportedEncodingException;
  21 import java.util.HashMap;
  22
  23 public class CharacterSets {
  24     /**
  25      * IANA assigned MIB enum numbers.
  26      *
  27      * From wap-230-wsp-20010705-a.pdf
  28      * Any-charset = <Octet 128>
  29      * Equivalent to the special RFC2616 charset value "*"
  30      */
  31     public static final int ANY_CHARSET = 0x00;
  32     public static final int US_ASCII    = 0x03;
  33     public static final int ISO_8859_1  = 0x04;
  34     public static final int ISO_8859_2  = 0x05;
  35     public static final int ISO_8859_3  = 0x06;
  36     public static final int ISO_8859_4  = 0x07;
  37     public static final int ISO_8859_5  = 0x08;
  38     public static final int ISO_8859_6  = 0x09;
  39     public static final int ISO_8859_7  = 0x0A;
  40     public static final int ISO_8859_8  = 0x0B;
  41     public static final int ISO_8859_9  = 0x0C;
  42     public static final int SHIFT_JIS   = 0x11;
  43     public static final int UTF_8       = 0x6A;
  44     public static final int BIG5        = 0x07EA;
  45     public static final int UCS2        = 0x03E8;
  46     public static final int UTF_16      = 0x03F7;
  47
  48     /**
  49      * If the encoding of given data is unsupported, use UTF_8 to decode it.
  50      */
  51     public static final int DEFAULT_CHARSET = UTF_8;
  52
  53     /**
  54      * Array of MIB enum numbers.
  55      */
  56     private static final int[] MIBENUM_NUMBERS = {
  57         ANY_CHARSET,
  58         US_ASCII,
  59         ISO_8859_1,
  60         ISO_8859_2,
  61         ISO_8859_3,
  62         ISO_8859_4,
  63         ISO_8859_5,
  64         ISO_8859_6,
  65         ISO_8859_7,
  66         ISO_8859_8,
  67         ISO_8859_9,
  68         SHIFT_JIS,
  69         UTF_8,
  70         BIG5,
  71         UCS2,
  72         UTF_16,
  73     };
  74
  75     /**
  76      * The Well-known-charset Mime name.
  77      */
  78     public static final String MIMENAME_ANY_CHARSET = "*";
  79     public static final String MIMENAME_US_ASCII    = "us-ascii";
  80     public static final String MIMENAME_ISO_8859_1  = "iso-8859-1";
  81     public static final String MIMENAME_ISO_8859_2  = "iso-8859-2";
  82     public static final String MIMENAME_ISO_8859_3  = "iso-8859-3";
  83     public static final String MIMENAME_ISO_8859_4  = "iso-8859-4";
  84     public static final String MIMENAME_ISO_8859_5  = "iso-8859-5";
  85     public static final String MIMENAME_ISO_8859_6  = "iso-8859-6";
  86     public static final String MIMENAME_ISO_8859_7  = "iso-8859-7";
  87     public static final String MIMENAME_ISO_8859_8  = "iso-8859-8";
  88     public static final String MIMENAME_ISO_8859_9  = "iso-8859-9";
  89     public static final String MIMENAME_SHIFT_JIS   = "shift_JIS";
  90     public static final String MIMENAME_UTF_8       = "utf-8";
  91     public static final String MIMENAME_BIG5        = "big5";
  92     public static final String MIMENAME_UCS2        = "iso-10646-ucs-2";
  93     public static final String MIMENAME_UTF_16      = "utf-16";
  94
  95     public static final String DEFAULT_CHARSET_NAME = MIMENAME_UTF_8;
  96
  97     /**
  98      * Array of the names of character sets.
  99      */
 100     private static final String[] MIME_NAMES = {
 101         MIMENAME_ANY_CHARSET,
 102         MIMENAME_US_ASCII,
 103         MIMENAME_ISO_8859_1,
 104         MIMENAME_ISO_8859_2,
 105         MIMENAME_ISO_8859_3,
 106         MIMENAME_ISO_8859_4,
 107         MIMENAME_ISO_8859_5,
 108         MIMENAME_ISO_8859_6,
 109         MIMENAME_ISO_8859_7,
 110         MIMENAME_ISO_8859_8,
 111         MIMENAME_ISO_8859_9,
 112         MIMENAME_SHIFT_JIS,
 113         MIMENAME_UTF_8,
 114         MIMENAME_BIG5,
 115         MIMENAME_UCS2,
 116         MIMENAME_UTF_16,
 117     };
 118
 119     private static final HashMap<Integer, String> MIBENUM_TO_NAME_MAP;
 120     private static final HashMap<String, Integer> NAME_TO_MIBENUM_MAP;
 121
 122     static {
 123         // Create the HashMaps.
 124         MIBENUM_TO_NAME_MAP = new HashMap<Integer, String>();
 125         NAME_TO_MIBENUM_MAP = new HashMap<String, Integer>();
 126         assert(MIBENUM_NUMBERS.length == MIME_NAMES.length);
 127         int count = MIBENUM_NUMBERS.length - 1;
 128         for(int i = 0; i <= count; i++) {
 129             MIBENUM_TO_NAME_MAP.put(MIBENUM_NUMBERS[i], MIME_NAMES[i]);
 130             NAME_TO_MIBENUM_MAP.put(MIME_NAMES[i], MIBENUM_NUMBERS[i]);
 131         }
 132     }
 133
 134     private CharacterSets() {} // Non-instantiatable
 135
 136     /**
 137      * Map an MIBEnum number to the name of the charset which this number
 138      * is assigned to by IANA.
 139      *
 140      * @param mibEnumValue An IANA assigned MIBEnum number.
 141      * @return The name string of the charset.
 142      * @throws UnsupportedEncodingException
 143      */
 144     public static String getMimeName(int mibEnumValue)
 145             throws UnsupportedEncodingException {
 146         String name = MIBENUM_TO_NAME_MAP.get(mibEnumValue);
 147         if (name == null) {
 148             throw new UnsupportedEncodingException();
 149         }
 150         return name;
 151     }
 152
 153     /**
 154      * Map a well-known charset name to its assigned MIBEnum number.
 155      *
 156      * @param mimeName The charset name.
 157      * @return The MIBEnum number assigned by IANA for this charset.
 158      * @throws UnsupportedEncodingException
 159      */
 160     public static int getMibEnumValue(String mimeName)
 161             throws UnsupportedEncodingException {
 162         if(null == mimeName) {
 163             return -1;
 164         }
 165
 166         Integer mibEnumValue = NAME_TO_MIBENUM_MAP.get(mimeName);
 167         if (mibEnumValue == null) {
 168             throw new UnsupportedEncodingException();
 169         }
 170         return mibEnumValue;
 171     }
 172 }