/*
 * CDDL HEADER START
 *
 * The contents of this file are subject to the terms of the
 * Common Development and Distribution License, Version 1.0 only
 * (the "License").  You may not use this file except in compliance
 * with the License.
 *
 * You can obtain a copy of the license at
 * trunk/opends/resource/legal-notices/OpenDS.LICENSE
 * or https://OpenDS.dev.java.net/OpenDS.LICENSE.
 * See the License for the specific language governing permissions
 * and limitations under the License.
 *
 * When distributing Covered Code, include this CDDL HEADER in each
 * file and include the License file at
 * trunk/opends/resource/legal-notices/OpenDS.LICENSE.  If applicable,
 * add the following below this CDDL HEADER, with the fields enclosed
 * by brackets "[]" replaced with your own identifying information:
 *      Portions Copyright [yyyy] [name of copyright owner]
 *
 * CDDL HEADER END
 *
 *
 *      Copyright 2006-2008 Sun Microsystems, Inc.
 */

package org.opends.sdk.asn1;



import java.io.InputStream;
import java.io.OutputStream;

import org.opends.sdk.ByteSequence;
import org.opends.sdk.ByteSequenceReader;
import org.opends.sdk.ByteString;
import org.opends.sdk.ByteStringBuilder;

import com.sun.opends.sdk.util.ByteSequenceOutputStream;


/**
 * This class contains various static factory methods for creating ASN.1
 * readers and writers.
 *
 * @see ASN1Reader
 * @see ASN1Writer
 */
public final class ASN1
{

  /**
   * Returns an ASN.1 reader whose source is the provided byte array and
   * having an unlimited maximum BER element size.
   *
   * @param array
   *          The byte array to use.
   * @return The new ASN.1 reader.
   */
  public static ASN1Reader getReader(byte[] array)
  {
    return getReader(array, 0);
  }



  /**
   * Returns an ASN.1 reader whose source is the provided byte array and
   * having a user defined maximum BER element size.
   *
   * @param array
   *          The byte array to use.
   * @param maxElementSize
   *          The maximum BER element size, or {@code 0} to indicate
   *          that there is no limit.
   * @return The new ASN.1 reader.
   */
  public static ASN1Reader getReader(byte[] array, int maxElementSize)
  {
    return getReader(ByteString.wrap(array), maxElementSize);
  }



  /**
   * Returns an ASN.1 reader whose source is the provided byte sequence
   * and having an unlimited maximum BER element size.
   *
   * @param sequence
   *          The byte sequence to use.
   * @return The new ASN.1 reader.
   */
  public static ASN1Reader getReader(ByteSequence sequence)
  {
    return getReader(sequence, 0);
  }



  /**
   * Returns an ASN.1 reader whose source is the provided byte sequence
   * and having a user defined maximum BER element size.
   *
   * @param sequence
   *          The byte sequence to use.
   * @param maxElementSize
   *          The maximum BER element size, or {@code 0} to indicate
   *          that there is no limit.
   * @return The new ASN.1 reader.
   */
  public static ASN1Reader getReader(ByteSequence sequence,
      int maxElementSize)
  {
    return new ASN1ByteSequenceReader(sequence.asReader(),
        maxElementSize);
  }



  /**
   * Returns an ASN.1 reader whose source is the provided byte sequence
   * reader and having an unlimited maximum BER element size.
   *
   * @param reader
   *          The byte sequence reader to use.
   * @return The new ASN.1 reader.
   */
  public static ASN1Reader getReader(ByteSequenceReader reader)
  {
    return getReader(reader, 0);
  }



  /**
   * Returns an ASN.1 reader whose source is the provided byte sequence
   * reader and having a user defined maximum BER element size.
   *
   * @param reader
   *          The byte sequence reader to use.
   * @param maxElementSize
   *          The maximum BER element size, or {@code 0} to indicate
   *          that there is no limit.
   * @return The new ASN.1 reader.
   */
  public static ASN1Reader getReader(ByteSequenceReader reader,
      int maxElementSize)
  {
    return new ASN1ByteSequenceReader(reader, maxElementSize);
  }



  /**
   * Returns an ASN.1 reader whose source is the provided input stream
   * and having an unlimited maximum BER element size.
   *
   * @param stream
   *          The input stream to use.
   * @return The new ASN.1 reader.
   */
  public static ASN1Reader getReader(InputStream stream)
  {
    return getReader(stream, 0);
  }



  /**
   * Returns an ASN.1 reader whose source is the provided input stream
   * and having a user defined maximum BER element size.
   *
   * @param stream
   *          The input stream to use.
   * @param maxElementSize
   *          The maximum BER element size, or {@code 0} to indicate
   *          that there is no limit.
   * @return The new ASN.1 reader.
   */
  public static ASN1Reader getReader(InputStream stream,
      int maxElementSize)
  {
    return new ASN1InputStreamReader(stream, maxElementSize);
  }



  /**
   * Returns an ASN.1 writer whose destination is the provided byte
   * string builder.
   *
   * @param builder
   *          The byte string builder to use.
   * @return The new ASN.1 writer.
   */
  public static ASN1Writer getWriter(ByteStringBuilder builder)
  {
    ByteSequenceOutputStream outputStream =
        new ByteSequenceOutputStream(builder);
    return getWriter(outputStream);
  }



  /**
   * Returns an ASN.1 writer whose destination is the provided output
   * stream.
   *
   * @param stream
   *          The output stream to use.
   * @return The new ASN.1 writer.
   */
  public static ASN1Writer getWriter(OutputStream stream)
  {
    return new ASN1OutputStreamWriter(stream);
  }



  // Prevent instantiation.
  private ASN1()
  {
    // Nothing to do.
  }
}