Spring 架構文檔之核心技術—— Resource

Resource

Resource 接口定義

public interface Resource extends InputStreamSource {
    /**
     * 傳回此資源的 URL 句柄
     */
    URL getURL() throws IOException;

    /**
     * 傳回此資源的 URI 句柄
     */
    URI getURI() throws IOException;

    /**
     * 傳回此資源的 File 句柄
     */
    File getFile() throws IOException;

    /**
     * 建立此資源的關聯資源
     */
    Resource createRelative(String relativePath) throws IOException;
}

public interface InputStreamSource {
    /**
     * 傳回底層資源内容的 InputStream
     */
    InputStream getInputStream() throws IOException;
}           

内置 Resource 實作者

• UrlResource —— 封裝 java.net.URL，用于通路通過URL通路的任何對象，例如

  file:

  、

  http:

  ftp:

  等
• ClassPathResource —— 使用線程上下文類加載器、給定的類加載器或給定的類從類路徑加載資源。如

  classpath:

• FileSystemResource —— 從檔案系統加載資源
• ServletContextResource —— 從 Web 應用根目錄的相對路徑中加載資源，支援 URL、流、File（資源位于檔案系統）通路
• InputStreamResource —— 在沒有特定的資源實作時使用
• ByteArrayResource —— 從任何給定的位元組數組加載資源

ResourceLoader

• 傳回資源類型确認

//對于 ClassPathXmlApplicationContext， 傳回 ClassPathResource
//對于 FileSystemXmlApplicationContext， 傳回 FileSystemResource
//對于 WebApplicationContext， 傳回 ServletContextResource
Resource template = ctx.getResource("some/resource/path/myTemplate.txt");

//指定 classpath:，傳回 ClassPathResource
Resource template = ctx.getResource("classpath:some/resource/path/myTemplate.txt");

//指定 file:、http:，傳回 UrlResource
Resource template = ctx.getResource("file:///some/resource/path/myTemplate.txt");
Resource template = ctx.getResource("https://myhost.com/resource/path/myTemplate.txt");
           

與 ApplicationContext 協作

ApplicationContext ctx = new ClassPathXmlApplicationContext("conf/appContext.xml");

//注意：FileSystemXmlApplicationContext 強制将 FileSystemResource 路徑當作相對路徑
ApplicationContext ctx = new FileSystemXmlApplicationContext("conf/appContext.xml");

//如要使用絕對路徑，推薦使用 file: 形式的 UrlResource
ApplicationContext ctx = new FileSystemXmlApplicationContext("file:///conf/context.xml");