前些日子看《深入理解javaweb开发》时,看到第一章java的io流,发觉自己对io流真的不是很熟悉。然后看了下JDK1.7中io包的一点点代码,又看了org.springframework.core.io包的一些类和组织方式,当作是学习吧。总结一下。
先挂下spring.core.io包的类图,其中接口是方框表示,抽象类带了abstract前缀,剩下那个两个框重贴的则代表实现类。没怎么划过类图,如果有好的画类图工具请推荐给我。
画得不好的地方就见谅了。注:以下源码匹配的是spring-core-4.1.6Release.jar里面的org.springframework.core.io包。
先看处于最上层的接口,叫InputStreamSource,里面只有一个抽象方法
接下是resources,这个接口我们一般都会用到,贴源码:
public interface Resource extends InputStreamSource { boolean exists();//文件是否存在 boolean isReadable();//是否可读 boolean isOpen();//资源是否被一个inputstream打开,如果已被打开,则不允许其他流再打开 URL getURL() throws IOException;//获取资源url路径,当不能以url描述时抛出ioException异常 URI getURI() throws IOException;//获取资源uri路径,当不能以url描述时抛出ioException异常 File getFile() throws IOException;//获取file,file在IO流中仅仅是一个指向作用 long contentLength() throws IOException;//资源的字节长度,可以拿来算资源的大小 long lastModified() throws IOException;//资源最后修改时间 Resource createRelative(String relativePath) throws IOException;//根据资源相对路径创建资源 String getFilename();//返回文件名 String getDescription();//资源描述 }
后面是abstractResource,这是个挺重要的类,主要是对resource接口的基本实现,
public abstract class AbstractResource implements Resource { @Override
public boolean exists() {
//看是否能在硬盘上找到
try {
return getFile().exists();
}
catch (IOException ex) {
// 试一下能不能打开输出流
try {
InputStream is = getInputStream();
is.close();
return true;
}
catch (Throwable isEx) {
return false;
}
}
} /**
* 一般都是可读的,所以默认方法是true
*/
@Override
public boolean isReadable() {
return true;
} /**
* 默认值是false,没有inputStream来读时的默认状态
*/
@Override
public boolean isOpen() {
return false;
} /**
* url这个属性一般只出现在web的IO资源中,网络resource需要override这个方法,其他类型资源敢访问这个方法,抛个异常给他
*/
@Override
public URL getURL() throws IOException {
throw new FileNotFoundException(getDescription() + " cannot be resolved to URL");
} @Override
public URI getURI() throws IOException {
URL url = getURL();
try {
//url可以转成uri,uri不能转url
return ResourceUtils.toURI(url);
}
catch (URISyntaxException ex) {
throw new NestedIOException("Invalid URI [" + url + "]", ex);
}
} /**
* JDK的File类都是返回绝对路径的File,当一个资源没有绝对路径时,抛个异常给它没毛病
*/
@Override
public File getFile() throws IOException {
throw new FileNotFoundException(getDescription() + " cannot be resolved to absolute file path");
} /**
* inputStream读取byte[]字节流,并返回该数组的长度,相当于把文件读了一次
*/
@Override
public long contentLength() throws IOException {
InputStream is = this.getInputStream();
//Assert应该是叫断言
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 {
//一定要在finally中关闭流
is.close();
}
catch (IOException ex) {
}
}
} /**
* 返回getFileForLastModifiedCheck().lastModified()的值,该职为0L,抛个异常给他没毛病
*/
@Override
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;
} /**
* 调用getFile方法
*/
protected File getFileForLastModifiedCheck() throws IOException {
return getFile();
} /**
* 直接假定相对资源创建不了,再抛个异常给他
*/
@Override
public Resource createRelative(String relativePath) throws IOException {
throw new FileNotFoundException("Cannot create a relative resource for " + getDescription());
} /**
* 又是一个假定,假定filename文件名为null
*/
@Override
public String getFilename() {
return null;
} /**
* 很简单,不解释
*/
@Override
public String toString() {
return getDescription();
} /**
* 判断两文件是否相等
*/
@Override
public boolean equals(Object obj) {
return (obj == this ||
(obj instanceof Resource && ((Resource) obj).getDescription().equals(getDescription())));
} /**
* 返回hashCode
*/
@Override
public int hashCode() {
return getDescription().hashCode();
} }
至于其他实现类其实都是在接口和抽象类的基础上去拓展,所以我并不是读得很仔细,先这样子吧。
小总结:其实为什么要分好几层去继承刚开始我是很不懂的,后面看了源代码和小伙伴的博文后便豁然开朗了。
1.resources是高度抽象的接口,里面是对所有资源文件的具体方法抽象,但是并不是每个资源都有这个抽象里面的所有方法,所以abstractResource对其进行了一般的实现,
对于一些并不是所有的Resources都会有方法,例如非网络资源没有url和uri属性,默认方法就直接抛异常了,简单粗暴。举个栗子,不是所有的动物都会游泳,一只猪想游泳,先抛个异常给猪接着先。
2.resources里面有isOpen(),isReadAble()接口,这是个小技巧吧,类似与模版方法模式的钩子方法,也是很值得我们学习的。