lib/jetty/org/eclipse/jetty/util/resource/URLResource.java

   1 //
   2 //  ========================================================================
   3 //  Copyright (c) 1995-2014 Mort Bay Consulting Pty. Ltd.
   4 //  ------------------------------------------------------------------------
   5 //  All rights reserved. This program and the accompanying materials
   6 //  are made available under the terms of the Eclipse Public License v1.0
   7 //  and Apache License v2.0 which accompanies this distribution.
   8 //
   9 //      The Eclipse Public License is available at
  10 //      http://www.eclipse.org/legal/epl-v10.html
  11 //
  12 //      The Apache License v2.0 is available at
  13 //      http://www.opensource.org/licenses/apache2.0.php
  14 //
  15 //  You may elect to redistribute this code under either of these licenses.
  16 //  ========================================================================
  17 //
  18
  19 package org.eclipse.jetty.util.resource;
  20
  21 import java.io.File;
  22 import java.io.IOException;
  23 import java.io.InputStream;
  24 import java.net.MalformedURLException;
  25 import java.net.URL;
  26 import java.net.URLConnection;
  27 import java.nio.channels.ReadableByteChannel;
  28 import java.security.Permission;
  29
  30 import org.eclipse.jetty.util.URIUtil;
  31 import org.eclipse.jetty.util.log.Log;
  32 import org.eclipse.jetty.util.log.Logger;
  33
  34 /* ------------------------------------------------------------ */
  35 /** Abstract resource class.
  36  */
  37 public class URLResource extends Resource
  38 {
  39     private static final Logger LOG = Log.getLogger(URLResource.class);
  40     protected final URL _url;
  41     protected final String _urlString;
  42
  43     protected URLConnection _connection;
  44     protected InputStream _in=null;
  45     transient boolean _useCaches = Resource.__defaultUseCaches;
  46
  47     /* ------------------------------------------------------------ */
  48     protected URLResource(URL url, URLConnection connection)
  49     {
  50         _url = url;
  51         _urlString=_url.toExternalForm();
  52         _connection=connection;
  53     }
  54
  55     /* ------------------------------------------------------------ */
  56     protected URLResource (URL url, URLConnection connection, boolean useCaches)
  57     {
  58         this (url, connection);
  59         _useCaches = useCaches;
  60     }
  61
  62     /* ------------------------------------------------------------ */
  63     protected synchronized boolean checkConnection()
  64     {
  65         if (_connection==null)
  66         {
  67             try{
  68                 _connection=_url.openConnection();
  69                 _connection.setUseCaches(_useCaches);
  70             }
  71             catch(IOException e)
  72             {
  73                 LOG.ignore(e);
  74             }
  75         }
  76         return _connection!=null;
  77     }
  78
  79     /* ------------------------------------------------------------ */
  80     /** Release any resources held by the resource.
  81      */
  82     @Override
  83     public synchronized void close()
  84     {
  85         if (_in!=null)
  86         {
  87             try{_in.close();}catch(IOException e){LOG.ignore(e);}
  88             _in=null;
  89         }
  90
  91         if (_connection!=null)
  92             _connection=null;
  93     }
  94
  95     /* ------------------------------------------------------------ */
  96     /**
  97      * Returns true if the represented resource exists.
  98      */
  99     @Override
 100     public boolean exists()
 101     {
 102         try
 103         {
 104             synchronized(this)
 105             {
 106                 if (checkConnection() && _in==null )
 107                     _in = _connection.getInputStream();
 108             }
 109         }
 110         catch (IOException e)
 111         {
 112             LOG.ignore(e);
 113         }
 114         return _in!=null;
 115     }
 116
 117     /* ------------------------------------------------------------ */
 118     /**
 119      * Returns true if the represented resource is a container/directory.
 120      * If the resource is not a file, resources ending with "/" are
 121      * considered directories.
 122      */
 123     @Override
 124     public boolean isDirectory()
 125     {
 126         return exists() && _urlString.endsWith("/");
 127     }
 128
 129
 130     /* ------------------------------------------------------------ */
 131     /**
 132      * Returns the last modified time
 133      */
 134     @Override
 135     public long lastModified()
 136     {
 137         if (checkConnection())
 138             return _connection.getLastModified();
 139         return -1;
 140     }
 141
 142
 143     /* ------------------------------------------------------------ */
 144     /**
 145      * Return the length of the resource
 146      */
 147     @Override
 148     public long length()
 149     {
 150         if (checkConnection())
 151             return _connection.getContentLength();
 152         return -1;
 153     }
 154
 155     /* ------------------------------------------------------------ */
 156     /**
 157      * Returns an URL representing the given resource
 158      */
 159     @Override
 160     public URL getURL()
 161     {
 162         return _url;
 163     }
 164
 165     /* ------------------------------------------------------------ */
 166     /**
 167      * Returns an File representing the given resource or NULL if this
 168      * is not possible.
 169      */
 170     @Override
 171     public File getFile()
 172         throws IOException
 173     {
 174         // Try the permission hack
 175         if (checkConnection())
 176         {
 177             Permission perm = _connection.getPermission();
 178             if (perm instanceof java.io.FilePermission)
 179                 return new File(perm.getName());
 180         }
 181
 182         // Try the URL file arg
 183         try {return new File(_url.getFile());}
 184         catch(Exception e) {LOG.ignore(e);}
 185
 186         // Don't know the file
 187         return null;
 188     }
 189
 190     /* ------------------------------------------------------------ */
 191     /**
 192      * Returns the name of the resource
 193      */
 194     @Override
 195     public String getName()
 196     {
 197         return _url.toExternalForm();
 198     }
 199
 200     /* ------------------------------------------------------------ */
 201     /**
 202      * Returns an input stream to the resource
 203      */
 204     @Override
 205     public synchronized InputStream getInputStream()
 206         throws java.io.IOException
 207     {
 208         if (!checkConnection())
 209             throw new IOException( "Invalid resource");
 210
 211         try
 212         {
 213             if( _in != null)
 214             {
 215                 InputStream in = _in;
 216                 _in=null;
 217                 return in;
 218             }
 219             return _connection.getInputStream();
 220         }
 221         finally
 222         {
 223             _connection=null;
 224         }
 225     }
 226
 227     /* ------------------------------------------------------------ */
 228     @Override
 229     public ReadableByteChannel getReadableByteChannel() throws IOException
 230     {
 231         return null;
 232     }
 233
 234     /* ------------------------------------------------------------ */
 235     /**
 236      * Deletes the given resource
 237      */
 238     @Override
 239     public boolean delete()
 240         throws SecurityException
 241     {
 242         throw new SecurityException( "Delete not supported");
 243     }
 244
 245     /* ------------------------------------------------------------ */
 246     /**
 247      * Rename the given resource
 248      */
 249     @Override
 250     public boolean renameTo( Resource dest)
 251         throws SecurityException
 252     {
 253         throw new SecurityException( "RenameTo not supported");
 254     }
 255
 256     /* ------------------------------------------------------------ */
 257     /**
 258      * Returns a list of resource names contained in the given resource
 259      */
 260     @Override
 261     public String[] list()
 262     {
 263         return null;
 264     }
 265
 266     /* ------------------------------------------------------------ */
 267     /**
 268      * Returns the resource contained inside the current resource with the
 269      * given name
 270      */
 271     @Override
 272     public Resource addPath(String path)
 273         throws IOException,MalformedURLException
 274     {
 275         if (path==null)
 276             return null;
 277
 278         path = URIUtil.canonicalPath(path);
 279
 280         return newResource(URIUtil.addPaths(_url.toExternalForm(),path));
 281     }
 282
 283     /* ------------------------------------------------------------ */
 284     @Override
 285     public String toString()
 286     {
 287         return _urlString;
 288     }
 289
 290     /* ------------------------------------------------------------ */
 291     @Override
 292     public int hashCode()
 293     {
 294         return _urlString.hashCode();
 295     }
 296
 297     /* ------------------------------------------------------------ */
 298     @Override
 299     public boolean equals( Object o)
 300     {
 301         return o instanceof URLResource && _urlString.equals(((URLResource)o)._urlString);
 302     }
 303
 304     /* ------------------------------------------------------------ */
 305     public boolean getUseCaches ()
 306     {
 307         return _useCaches;
 308     }
 309
 310     /* ------------------------------------------------------------ */
 311     @Override
 312     public boolean isContainedIn (Resource containingResource) throws MalformedURLException
 313     {
 314         return false;
 315     }
 316 }