首页 > 代码库 > Spring源码分析——资源访问利器Resource之接口和抽象类分析

Spring源码分析——资源访问利器Resource之接口和抽象类分析

  从今天开始,一步步走上源码分析的路。刚开始肯定要从简单着手。我们先从Java发展史上最强大的框架——Spring、、、旗下的资源抽象接口Resource开始吧。

  我看了好多分析Spring源码的,每每一开始就是Spring IOC、AOP、BeanFactory这样的Spring典型模块,实在看厌了,这些暂且留到以后。我的想法是,分析就分析别人没分析过的,或者以不同的角度来分析别人分析过的。

  可能很多用了Spring多年的程序员对Resource都了解有限,毕竟访问资源一般是搭建web工程框架的时候的事情。不过了解它也是非常有好处的。

  这个接口的作用是可以让我们更方便操纵底层资源。因为JDK操纵底层资源基本就是 java.net.URL 、java.io.File 、java.util.Properties这些。取资源基本是根据绝对路径或当前类的相对路径来取。从类路径或Web容器上下文中获取资源的时候也不方便。Resource接口提供了更强大的访问底层资源的能力。

  废话不多说,看源码之前先来看一下Resource的类结构。

一、类结构

一、Resource接口

  如图,Resouce接口并不是一个根接口,它继承了一个简单的父接口 InputStreamSource,这个接口只有一个方法,用以返回一个输入流:

InputStream getInputStream() throws IOException;

  来,直接上Resource接口的源码,中文是我根据英文注释自己翻译的,如下:

public interface Resource extends InputStreamSource {    boolean exists();      //  资源是否存在    boolean isReadable();  //  资源是否可读    boolean isOpen();      //  资源所代表的句柄是否被一个stream打开了    URL getURL() throws IOException;   //  返回资源的URL的句柄    URI getURI() throws IOException;   //  返回资源的URI的句柄    File getFile() throws IOException; //  返回资源的File的句柄    long contentLength() throws IOException;   //  资源内容的长度    long lastModified() throws IOException;    //  资源最后的修改时间    Resource createRelative(String relativePath) throws IOException;   //根据资源的相对路径创建新资源    String getFilename();  //  资源的文件名    String getDescription();   //资源的描述}

   这个没什么好说的,继续!

 

二、抽象类AbstractResource

  对于任何的接口而言,这个直接抽象类是重中之重,里面浓缩了接口的大部分公共实现。翻译后如下:

public abstract class AbstractResource implements Resource {    public boolean exists() {  //判断文件是否存在,若判断过程产生异常(因为会调用SecurityManager来判断),就关闭对应的流        try {            return getFile().exists();        }        catch (IOException ex) {            try {                InputStream is = getInputStream();  //getInputStream()方法会被子类重写,                is.close();                return true;            }            catch (Throwable isEx) {                return false;               }        }    }    public boolean isReadable() {  //  直接返回true,可读        return true;    }    public boolean isOpen() {  //  直接返回false,未被打开        return false;    }    public URL getURL() throws IOException {        //  留给子类重写        throw new FileNotFoundException(getDescription() + " cannot be resolved to URL");    }    public URI getURI() throws IOException {   //返回url        URL url = getURL();        try {            return ResourceUtils.toURI(url);     //将url格式化后返回        }        catch (URISyntaxException ex) {            throw new NestedIOException("Invalid URI [" + url + "]", ex);        }    }    public File getFile() throws IOException {     //  留给子类重写        throw new FileNotFoundException(getDescription() + " cannot be resolved to absolute file path");    }    // 这个资源内容长度实际就是资源的字节长度,通过全部读取一遍来判断。这个方法调用起来很占资源啊!    public long contentLength() throws IOException {           InputStream is = this.getInputStream();        Assert.state(is != null, "resource input stream must not be null");   //断言        try {            long size = 0;            byte[] buf = new byte[255];            int read;            while((read = is.read(buf)) != -1) {                size += read;            }            return size;        }        finally {            try {                is.close();            }            catch (IOException ex) {            }        }    }    public long lastModified() throws IOException {    // 返回资源的最后修改时间        long lastModified = getFileForLastModifiedCheck().lastModified();        if (lastModified == 0L) {            throw new FileNotFoundException(getDescription() +                    " cannot be resolved in the file system for resolving its last-modified timestamp");        }        return lastModified;    }    // 这是Resource接口所没有的方法,注释的意思是“返回文件,给时间戳检查”,要求子类重写...    protected File getFileForLastModifiedCheck() throws IOException {        return getFile();    }    public Resource createRelative(String relativePath) throws IOException {   //  留给子类重写        throw new FileNotFoundException("Cannot create a relative resource for " + getDescription());    }    public String getFilename() {  //  默认返回空(假设资源没有文件名),除非子类重写        return null;    }    @Override    public String toString() {     //  toString返回文件描述        return getDescription();    }    @Override    public boolean equals(Object obj) {    //  equals比较的就是2个资源描述是否一样        return (obj == this ||            (obj instanceof Resource && ((Resource) obj).getDescription().equals(getDescription())));    }    @Override    public int hashCode() {    //  返回资源描述的HashCode        return getDescription().hashCode();       }}

 

结论:

  1、增加了一个方法,protected File getFileForLastModifiedCheck() throws IOException,要求子类实现,如果子类未实现,那么直接返回资源文件。这个方法的具体作用,后面再看实现类。

  2、方法 contentLength() ,是一个很比较重量级的方法,它通过将资源全部读取一遍来判断资源的字节数。255字节的缓冲数组来读取。子类一般会重写。(调整一下缓冲数组的大小?)

  3、getDescription() 是这个抽象类唯一没有实现的接口方法,留给子类去实现,资源文件默认的equals()、hashCode() 都通过这个来判断。

  4、InputStreamSource这个祖先接口的唯一方法 getInputStream()也没有被实现,留给子类。

 

三、Resource的子接口ContextResource和WritableResource

  这两个接口继承于Resource,拥有Resource的全部方法。其中,ContextResource接口增加了一个方法:

String getPathWithinContext(); //  返回上下文内的路径  

  这个方法使得它的实现类有了返回当前上下文路径的能力。

 

  WritableResource接口增加了2个方法:

    boolean isWritable();  //  是否可写    OutputStream getOutputStream() throws IOException; //返回资源的写入流

  这个方法使得它的实现类拥有了写资源的能力。

 

   PS:框架感觉大都是这样,不难,设计模式也运用的不多。却有一种大巧不工、重剑无锋的感觉,因为代码运用真的非常简练。

    分析源码,很大程度上也锻炼了自己的英文文档阅读能力。共勉。

 

Spring源码分析——资源访问利器Resource之接口和抽象类分析