com.bstek.dorado.core.io

Interface Resource

All Known Subinterfaces:

RefreshableResource

All Known Implementing Classes:

AbstractResourceAdapter, DefaultRefreshableResource, DefaultResource, EmptyResource, FileResource, InputStreamResource

public interface Resource

资源描述对象的接口。

Since:

Feb 16, 2007

Author:

Benny Bao (mailto:benny.bao@bstek.com)

Method Summary

Methods

Modifier and Type	Method and Description
Resource	createRelative(java.lang.String relativePath) 根据本资源的相对路径创建一个新的资源描述对象。
boolean	exists() 返回该资源是否真实存在。
java.lang.String	getDescription() 返回该资源的描述信息，该信息可用于发生异常时的错误信息输出。 该方法也将被用于toString()方法的内部实现。
java.io.File	getFile() 返回该资源对应的文件对象。如果该资源不能映射到具体的文件将抛出IOException异常。
java.lang.String	getFilename() 返回该资源的文件名。此处的文件名是不包含文件路径的，例如："myfile.xml"。
java.io.InputStream	getInputStream() 返回该资源的InputStream。
java.lang.String	getPath() 返回原始的资源路径。
long	getTimestamp() 返回该资源的时间戳。 类似于文件的最后修改时间，对于classpath等类型的资源可能无法取得真正的资源时间戳，在这种情况下将返回0。
java.net.URL	getURL() 返回该资源的URL。如果该资源无法通过URL描述将抛出IOException异常。

Method Detail

getPath

java.lang.String getPath()

返回原始的资源路径。

exists

boolean exists()

返回该资源是否真实存在。

getTimestamp

long getTimestamp()
                  throws java.io.IOException

返回该资源的时间戳。 类似于文件的最后修改时间，对于classpath等类型的资源可能无法取得真正的资源时间戳，在这种情况下将返回0。

Throws:

java.io.IOException

getInputStream

java.io.InputStream getInputStream()
                                   throws java.io.IOException

返回该资源的InputStream。

Throws:

java.io.IOException

getURL

java.net.URL getURL()
                    throws java.io.IOException

返回该资源的URL。如果该资源无法通过URL描述将抛出IOException异常。

Throws:

java.io.IOException

getFile

java.io.File getFile()
                     throws java.io.IOException

返回该资源对应的文件对象。如果该资源不能映射到具体的文件将抛出IOException异常。

Throws:

java.io.IOException

createRelative

Resource createRelative(java.lang.String relativePath)
                        throws java.io.IOException

根据本资源的相对路径创建一个新的资源描述对象。

Parameters:

relativePath - 相对于本资源的相对路径

Returns:

新的资源描述对象

Throws:

java.io.IOException

getFilename

java.lang.String getFilename()

返回该资源的文件名。此处的文件名是不包含文件路径的，例如："myfile.xml"。

getDescription

java.lang.String getDescription()

返回该资源的描述信息，该信息可用于发生异常时的错误信息输出。
该方法也将被用于toString()方法的内部实现。

See Also:

Object.toString()