content: /*
   * Copyright (C) 2009 The Android Open Source Project
   *
   * 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.android.vcard;
  
  import com.android.vcard.exception.VCardException;
  
  import java.io.IOException;
  import java.io.InputStream;
  import java.util.Arrays;
  import java.util.Collections;
  import java.util.HashSet;
  import java.util.Set;
  
  /**
   * </p>
   * vCard parser for vCard 2.1. See the specification for more detail about the spec itself.
   * </p>
   * <p>
   * The spec is written in 1996, and currently various types of "vCard 2.1" exist.
   * To handle real the world vCard formats appropriately and effectively, this class does not
   * obey with strict vCard 2.1.
   * In stead, not only vCard spec but also real world vCard is considered.
   * </p>
   * e.g. A lot of devices and softwares let vCard importer/exporter to use
   * the PNG format to determine the type of image, while it is not allowed in
   * the original specification. As of 2010, we can see even the FLV format
   * (possible in Japanese mobile phones).
   * </p>
   */
  public final class VCardParser_V21 extends VCardParser {
      /**
       * A unmodifiable Set storing the property names available in the vCard 2.1 specification.
       */
      /* package */ static final Set<String> sKnownPropertyNameSet =
              Collections.unmodifiableSet(new HashSet<String>(
                      Arrays.asList("BEGIN", "END", "LOGO", "PHOTO", "LABEL", "FN", "TITLE", "SOUND",
                              "VERSION", "TEL", "EMAIL", "TZ", "GEO", "NOTE", "URL",
                              "BDAY", "ROLE", "REV", "UID", "KEY", "MAILER")));
  
      /**
       * A unmodifiable Set storing the types known in vCard 2.1.
       */
      /* package */ static final Set<String> sKnownTypeSet =
              Collections.unmodifiableSet(new HashSet<String>(
                      Arrays.asList("DOM", "INTL", "POSTAL", "PARCEL", "HOME", "WORK",
                              "PREF", "VOICE", "FAX", "MSG", "CELL", "PAGER", "BBS",
                              "MODEM", "CAR", "ISDN", "VIDEO", "AOL", "APPLELINK",
                              "ATTMAIL", "CIS", "EWORLD", "INTERNET", "IBMMAIL",
                              "MCIMAIL", "POWERSHARE", "PRODIGY", "TLX", "X400", "GIF",
                              "CGM", "WMF", "BMP", "MET", "PMB", "DIB", "PICT", "TIFF",
                              "PDF", "PS", "JPEG", "QTIME", "MPEG", "MPEG2", "AVI",
                              "WAVE", "AIFF", "PCM", "X509", "PGP")));
  
      /**
       * A unmodifiable Set storing the values for the type "VALUE", available in the vCard 2.1.
       */
      /* package */ static final Set<String> sKnownValueSet =
              Collections.unmodifiableSet(new HashSet<String>(
                      Arrays.asList("INLINE", "URL", "CONTENT-ID", "CID")));
  
      /**
       * <p>
       * A unmodifiable Set storing the values for the type "ENCODING", available in the vCard 2.1.
       * </p>
       * <p>
       * Though vCard 2.1 specification does not allow "B" encoding, some data may have it.
       * We allow it for safety.
       * </p>
       */
      /* package */ static final Set<String> sAvailableEncoding =
          Collections.unmodifiableSet(new HashSet<String>(
                  Arrays.asList(VCardConstants.PARAM_ENCODING_7BIT,
                          VCardConstants.PARAM_ENCODING_8BIT,
                          VCardConstants.PARAM_ENCODING_QP,
                          VCardConstants.PARAM_ENCODING_BASE64,
                          VCardConstants.PARAM_ENCODING_B)));
  
      private final VCardParserImpl_V21 mVCardParserImpl;
  
      public VCardParser_V21() {
          mVCardParserImpl = new VCardParserImpl_V21();
      }
  
      public VCardParser_V21(int vcardType) {
          mVCardParserImpl = new VCardParserImpl_V21(vcardType);
      }
  
      @Override
      public void addInterpreter(VCardInterpreter interpreter) {
          mVCardParserImpl.addInterpreter(interpreter);
      }
  
      @Override
      public void parse(InputStream is) throws IOException, VCardException {
          mVCardParserImpl.parse(is);
      }
  
      @Override
      public void parseOne(InputStream is) throws IOException, VCardException {
          mVCardParserImpl.parseOne(is);
      }
  
      @Override
      public void cancel() {
          mVCardParserImpl.cancel();
      }
  }
  