// ========================================================================
   // Copyright (c) 1996-2009 Mort Bay Consulting Pty. Ltd.
   // ------------------------------------------------------------------------
   // All rights reserved. This program and the accompanying materials
   // are made available under the terms of the Eclipse Public License v1.0
   // and Apache License v2.0 which accompanies this distribution.
   // The Eclipse Public License is available at 
   // http://www.eclipse.org/legal/epl-v10.html
   // The Apache License v2.0 is available at
  // http://www.opensource.org/licenses/apache2.0.php
  // You may elect to redistribute this code under either of these licenses. 
  // ========================================================================
  package org.eclipse.jetty.util.resource;
  
  import java.io.File;
  import java.io.IOException;
  import java.io.InputStream;
  import java.io.OutputStream;
  import java.net.MalformedURLException;
  import java.net.URL;
  import java.net.URLConnection;
  import java.security.Permission;
  
  import org.eclipse.jetty.util.URIUtil;
  import org.eclipse.jetty.util.log.Log;
  
  /* ------------------------------------------------------------ */
  /** Abstract resource class.
   */
  public class URLResource extends Resource
  {
      protected URL _url;
      protected String _urlString;
      
      protected URLConnection _connection;
      protected InputStream _in=null;
      transient boolean _useCaches = Resource.__defaultUseCaches;
      
      /* ------------------------------------------------------------ */
      protected URLResource(URL url, URLConnection connection)
      {
          _url = url;
          _urlString=_url.toString();
          _connection=connection;
      }
      
      /* ------------------------------------------------------------ */
      protected URLResource (URL url, URLConnection connection, boolean useCaches)
      {
          this (url, connection);
          _useCaches = useCaches;
      }
  
      /* ------------------------------------------------------------ */
      protected synchronized boolean checkConnection()
      {
          if (_connection==null)
          {
              try{
                  _connection=_url.openConnection();
                  _connection.setUseCaches(_useCaches);
              }
              catch(IOException e)
              {
                  Log.ignore(e);
              }
          }
          return _connection!=null;
      }
  
      /* ------------------------------------------------------------ */
      /** Release any resources held by the resource.
       */
      @Override
      public synchronized void release()
      {
          if (_in!=null)
          {
              try{_in.close();}catch(IOException e){Log.ignore(e);}
              _in=null;
          }
  
          if (_connection!=null)
              _connection=null;
      }
  
      /* ------------------------------------------------------------ */
      /**
       * Returns true if the represented resource exists.
       */
      @Override
      public boolean exists()
      {
          try
          {
              synchronized(this)
              {
                  if (checkConnection() && _in==null )
                      _in = _connection.getInputStream();
             }
         }
         catch (IOException e)
         {
             Log.ignore(e);
         }
         return _in!=null;
     }
 
     /* ------------------------------------------------------------ */
     /**
      * Returns true if the respresenetd resource is a container/directory.
      * If the resource is not a file, resources ending with "/" are
      * considered directories.
      */
     @Override
     public boolean isDirectory()
     {
         return exists() && _url.toString().endsWith("/");
     }
 
 
     /* ------------------------------------------------------------ */
     /**
      * Returns the last modified time
      */
     @Override
     public long lastModified()
     {
         if (checkConnection())
             return _connection.getLastModified();
         return -1;
     }
 
 
     /* ------------------------------------------------------------ */
     /**
      * Return the length of the resource
      */
     @Override
     public long length()
     {
         if (checkConnection())
             return _connection.getContentLength();
         return -1;
     }
 
     /* ------------------------------------------------------------ */
     /**
      * Returns an URL representing the given resource
      */
     @Override
     public URL getURL()
     {
         return _url;
     }
 
     /* ------------------------------------------------------------ */
     /**
      * Returns an File representing the given resource or NULL if this
      * is not possible.
      */
     @Override
     public File getFile()
         throws IOException
     {
         // Try the permission hack
         if (checkConnection())
         {
             Permission perm = _connection.getPermission();
             if (perm instanceof java.io.FilePermission)
                 return new File(perm.getName());
         }
 
         // Try the URL file arg
         try {return new File(_url.getFile());}
         catch(Exception e) {Log.ignore(e);}
 
         // Don't know the file
         return null;    
     }
 
     /* ------------------------------------------------------------ */
     /**
      * Returns the name of the resource
      */
     @Override
     public String getName()
     {
         return _url.toExternalForm();
     }
 
     /* ------------------------------------------------------------ */
     /**
      * Returns an input stream to the resource
      */
     @Override
     public synchronized InputStream getInputStream()
         throws java.io.IOException
     {
         if (!checkConnection())
             throw new IOException( "Invalid resource");
 
         try
         {    
             if( _in != null)
             {
                 InputStream in = _in;
                 _in=null;
                 return in;
             }
             return _connection.getInputStream();
         }
         finally
         {
             _connection=null;
         }
     }
 
 
     /* ------------------------------------------------------------ */
     /**
      * Returns an output stream to the resource
      */
     @Override
     public OutputStream getOutputStream()
         throws java.io.IOException, SecurityException
     {
         throw new IOException( "Output not supported");
     }
 
     /* ------------------------------------------------------------ */
     /**
      * Deletes the given resource
      */
     @Override
     public boolean delete()
         throws SecurityException
     {
         throw new SecurityException( "Delete not supported");
     }
 
     /* ------------------------------------------------------------ */
     /**
      * Rename the given resource
      */
     @Override
     public boolean renameTo( Resource dest)
         throws SecurityException
     {
         throw new SecurityException( "RenameTo not supported");
     }
 
     /* ------------------------------------------------------------ */
     /**
      * Returns a list of resource names contained in the given resource
      */
     @Override
     public String[] list()
     {
         return null;
     }
 
     /* ------------------------------------------------------------ */
     /**
      * Returns the resource contained inside the current resource with the
      * given name
      */
     @Override
     public Resource addPath(String path)
         throws IOException,MalformedURLException
     {
         if (path==null)
             return null;
 
         path = URIUtil.canonicalPath(path);
 
         return newResource(URIUtil.addPaths(_url.toExternalForm(),path));
     }
 
     /* ------------------------------------------------------------ */
     @Override
     public String toString()
     {
         return _urlString;
     }
 
     /* ------------------------------------------------------------ */
     @Override
     public int hashCode()
     {
         return _url.hashCode();
     }
     
     /* ------------------------------------------------------------ */
     @Override
     public boolean equals( Object o)
     {
         return o instanceof URLResource &&
             _url.equals(((URLResource)o)._url);
     }
 
     public boolean getUseCaches ()
     {
         return _useCaches;
     }
     
     @Override
     public boolean isContainedIn (Resource containingResource) throws MalformedURLException
     {
         return false; //TODO gregw check this!
     }
 }