source: trunk/gcc/libjava/java/net/URLConnection.java@ 3951

// URLConnection.java - Superclass of all communications links between
//                      an application and a URL.

/* Copyright (C) 1999, 2000  Free Software Foundation

   This file is part of libgcj.

This software is copyrighted work licensed under the terms of the
Libgcj License.  Please consult the file "LIBGCJ_LICENSE" for
details.  */

package java.net;

import java.io.*;
import java.text.ParsePosition;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Locale;
import java.util.Hashtable;
import java.util.Map;
import java.util.StringTokenizer;
import java.security.Permission;
import java.security.AllPermission;
import gnu.gcj.io.MimeTypes;

/**
 * @author Warren Levy <[email protected]>
 * @date March 5, 1999.
 */

/**
 * Written using on-line Java Platform 1.2 API Specification, as well
 * as "The Java Class Libraries", 2nd edition (Addison-Wesley, 1998).
 * Status:  One guessContentTypeFrom... methods not implemented.
 *    getContent method assumes content type from response; see comment there.
 */

public abstract class URLConnection
{
  protected URL url;
  protected boolean doInput = true;
  protected boolean doOutput = false;
  protected boolean allowUserInteraction;
  protected boolean useCaches;
  protected long ifModifiedSince = 0L;
  protected boolean connected = false;
  private static boolean defaultAllowUserInteraction = false;
  private static boolean defaultUseCaches = true;
  private static FileNameMap fileNameMap;  // Set by the URLConnection subclass.
  private static ContentHandlerFactory factory;
  private static ContentHandler contentHandler;
  private static Hashtable handlers = new Hashtable();
  private static Locale locale; 
  private static SimpleDateFormat dateFormat1, dateFormat2, dateFormat3;
  private static boolean dateformats_initialized = false;

  /**
   * Creates a URL connection to a given URL. A real connection is not made.
   * Use #connect to do this.
   *
   * @param url The Object to create the URL connection to
   *
   * @see URLConnection:connect
   */
  protected URLConnection(URL url)
  {
    this.url = url;
    allowUserInteraction = defaultAllowUserInteraction;
    useCaches = defaultUseCaches;
  }

  /**
   * Creates a real connection to the object references by the URL given
   * to the constructor
   *
   * @exception IOException If an error occurs
   */
  public abstract void connect() throws IOException;

  /**
   * Returns ths URL to the object.
   */
  public URL getURL()
  {
    return url;
  }

  /**
   * Returns the value of the content-length header field
   */
  public int getContentLength()
  {
    return getHeaderFieldInt("content-length", -1);
  }

  /**
   * Returns the value of the content-type header field
   */
  public String getContentType()
  {
    return getHeaderField("content-type");
  }

  /**
   * Returns the value of the content-encoding header field
   */
  public String getContentEncoding()
  {
    return getHeaderField("content-encoding");
  }

  /**
   * Returns the value of the expires header field
   */
  public long getExpiration()
  {
    return getHeaderFieldDate("expiration", 0L);
  }

  /**
   * Returns the value of the date header field
   */
  public long getDate()
  {
    return getHeaderFieldDate("date", 0L);
  }

  /**
   * Returns the value of the last-modified header field
   */
  public long getLastModified()
  {
    return getHeaderFieldDate("last-modified", 0L);
  }

  /**
   * Returns the value of the n-th header field
   *
   * @param num The number of the header field
   */
  public String getHeaderField(int num)
  {
    // Subclasses for specific protocols override this.
    return null;
  }

  /**
   * Returns the value of the header filed specified by name
   *
   * @param name The name of the header field
   */
  public String getHeaderField(String name)
  {
    // Subclasses for specific protocols override this.
    return null;
  }

  /**
   * Returns a map of all sent header fields
   * 
   * @since 1.4
   */
  public Map getHeaderFields()
  {
    // Subclasses for specific protocols override this.
    return null;
  }

  /**
   * Returns the value of the header filed name as int.
   *
   * @param name The name of the header field
   * @param val The default value
   *
   * @return Returns the value of the header filed or the default value
   * if the field is missing or malformed
   */
  public int getHeaderFieldInt(String name, int val)
  {
    String str = getHeaderField(name);
    try
      {
        if (str != null)
          val = Integer.parseInt(str);
      }
    catch (NumberFormatException e)
      {
        ; // Do nothing; val is the default.
      }
    return val;
  }

  /**
   * Returns the value of a header field parsed as date. The result is then
   * number of milliseconds since January 1st, 1970 GMT.
   *
   * @param name The name of the header field