Spring中資源的加載ResourceLoader

Spring中資源的加載是定義在ResourceLoader接口中的,它跟前面提到的抽象資源的關係以下:
圖 9. Context 和 Resource 的類關係圖

ResourceLoader的源碼java

[java]  view plain  copy
  1. public interface ResourceLoader {  
  2.   
  3.     /** Pseudo URL prefix for loading from the class path: "classpath:" */  
  4.     String CLASSPATH_URL_PREFIX = ResourceUtils.CLASSPATH_URL_PREFIX;  
  5.       
  6.     Resource getResource(String location);  
  7.   
  8.     ClassLoader getClassLoader();  
  9.   
  10. }  

咱們發現,其實ResourceLoader接口只提供了classpath前綴的支持。而classpath*的前綴支持是在它的子接口ResourcePatternResolver中。

[java]  view plain  copy
  1. public interface ResourcePatternResolver extends ResourceLoader {  
  2.   
  3.     /** 
  4.      * Pseudo URL prefix for all matching resources from the class path: "classpath*:" 
  5.      * This differs from ResourceLoader's classpath URL prefix in that it 
  6.      * retrieves all matching resources for a given name (e.g. "/beans.xml"), 
  7.      * for example in the root of all deployed JAR files. 
  8.      * @see org.springframework.core.io.ResourceLoader#CLASSPATH_URL_PREFIX 
  9.      */  
  10.     String CLASSPATH_ALL_URL_PREFIX = "classpath*:";  
  11.   
  12.       
  13.     Resource[] getResources(String locationPattern) throws IOException;  
  14.   
  15. }  

   經過2個接口的源碼對比,咱們發現ResourceLoader提供 classpath下單資源文件的載入,而 ResourcePatternResolver提供了多資源文件的載入。

  ResourcePatternResolver有一個實現類:PathMatchingResourcePatternResolver,那咱們直奔主題,查看PathMatchingResourcePatternResolver的getResources()spring

[java]  view plain  copy
  1. public Resource[] getResources(String locationPattern) throws IOException {  
  2.         Assert.notNull(locationPattern, "Location pattern must not be null");  
  3.         //是否以classpath*開頭  
  4.         if (locationPattern.startsWith(CLASSPATH_ALL_URL_PREFIX)) {  
  5.             //是否包含?或者*  
  6.             if (getPathMatcher().isPattern(locationPattern.substring(CLASSPATH_ALL_URL_PREFIX.length()))) {  
  7.                 // a class path resource pattern  
  8.                 return findPathMatchingResources(locationPattern);  
  9.             }  
  10.             else {  
  11.                 // all class path resources with the given name  
  12.                 return findAllClassPathResources(locationPattern.substring(CLASSPATH_ALL_URL_PREFIX.length()));  
  13.             }  
  14.         }  
  15.         else {  
  16.             // Only look for a pattern after a prefix here  
  17.             // (to not get fooled by a pattern symbol in a strange prefix).  
  18.             int prefixEnd = locationPattern.indexOf(":") + 1;  
  19.             //是否包含?或者*  
  20.             if (getPathMatcher().isPattern(locationPattern.substring(prefixEnd))) {  
  21.                 // a file pattern  
  22.                 return findPathMatchingResources(locationPattern);  
  23.             }  
  24.             else {  
  25.                 // a single resource with the given name  
  26.                 return new Resource[] {getResourceLoader().getResource(locationPattern)};  
  27.             }  
  28.         }  
  29.     }  

由此咱們能夠看出在加載配置文件時,以是不是以classpath*開頭分爲2大類處理場景,每大類在又根據路徑中是否包括通配符分爲2小類進行處理,

處理的流程圖以下:app


從上圖看,整個加載資源的場景有三條處理流程ide

  • 以classpath*開頭,但路徑不包含通配符的
             讓咱們來看看findAllClassPathResources是怎麼處理的
[java]  view plain  copy
  1. protected Resource[] findAllClassPathResources(String location) throws IOException {  
  2.     String path = location;  
  3.     if (path.startsWith("/")) {  
  4.         path = path.substring(1);  
  5.     }  
  6.     Enumeration<URL> resourceUrls = getClassLoader().getResources(path);  
  7.     Set<Resource> result = new LinkedHashSet<Resource>(16);  
  8.     while (resourceUrls.hasMoreElements()) {  
  9.         URL url = resourceUrls.nextElement();  
  10.         result.add(convertClassLoaderURL(url));  
  11.     }  
  12.     return result.toArray(new Resource[result.size()]);  
  13. }  

    咱們能夠看到,最關鍵的一句代碼是:Enumeration<URL> resourceUrls = getClassLoader().getResources(path); 
[java]  view plain  copy
  1.     public ClassLoader getClassLoader() {  
  2.         return getResourceLoader().getClassLoader();  
  3.     }  
  4.   
  5.   
  6. public ResourceLoader getResourceLoader() {  
  7.         return this.resourceLoader;  
  8.     }  
  9.   
  10. //默認狀況下  
  11. public PathMatchingResourcePatternResolver() {  
  12.         this.resourceLoader = new DefaultResourceLoader();  
  13.     }  
其實上面這3個方法不是最關鍵的,之因此貼出來,是讓你們清楚整個調用鏈,其實這種狀況最關鍵的代碼在於ClassLoader的getResources()方法。那麼咱們一樣跟進去,看看源碼
[java]  view plain  copy
  1. public Enumeration<URL> getResources(String name) throws IOException {  
  2. Enumeration[] tmp = new Enumeration[2];  
  3. if (parent != null) {  
  4.     tmp[0] = parent.getResources(name);  
  5. else {  
  6.     tmp[0] = getBootstrapResources(name);  
  7. }  
  8. tmp[1] = findResources(name);  
  9.   
  10. return new CompoundEnumeration(tmp);  
  11.    }  
是否是一目瞭然了?當前類加載器,若是存在父加載器,則向上迭代獲取資源, 所以能加到jar包裏面的資源文件。

  • 不以classpath*開頭,且路徑不包含通配符的
處理邏輯以下           
[java]  view plain  copy
  1. return new Resource[] {getResourceLoader().getResource(locationPattern)};  
上面咱們已經貼過getResourceLoader()的邏輯了, 即默認是DefaultResourceLoader(),那咱們進去看看getResouce()的實現
[java]  view plain  copy
  1. public Resource getResource(String location) {  
  2.     Assert.notNull(location, "Location must not be null");  
  3.     if (location.startsWith(CLASSPATH_URL_PREFIX)) {  
  4.         return new ClassPathResource(location.substring(CLASSPATH_URL_PREFIX.length()), getClassLoader());  
  5.     }  
  6.     else {  
  7.         try {  
  8.             // Try to parse the location as a URL...  
  9.             URL url = new URL(location);  
  10.             return new UrlResource(url);  
  11.         }  
  12.         catch (MalformedURLException ex) {  
  13.             // No URL -> resolve as resource path.  
  14.             return getResourceByPath(location);  
  15.         }  
  16.     }  
  17. }  

其實很簡單,若是以classpath開頭,則建立爲一個ClassPathResource,不然則試圖以URL的方式加載資源,建立一個UrlResource.
  • 路徑包含通配符的
             這種狀況是最複雜的,涉及到層層遞歸,那我把加了註釋的代碼發出來你們看一下,其實主要的思想就是
1.先獲取目錄,加載目錄裏面的全部資源
2.在全部資源裏面進行查找匹配,找出咱們須要的資源
[java]  view plain  copy
  1. protected Resource[] findPathMatchingResources(String locationPattern) throws IOException {  
  2.         //拿到能肯定的目錄,即拿到不包括通配符的能肯定的路徑  好比classpath*:/aaa/bbb/spring-*.xml 則返回classpath*:/aaa/bbb/                                     //若是是classpath*:/aaa/*/spring-*.xml,則返回 classpath*:/aaa/  
  3.         String rootDirPath = determineRootDir(locationPattern);  
  4.         //獲得spring-*.xml  
  5.         String subPattern = locationPattern.substring(rootDirPath.length());  
  6.         //遞歸加載全部的根目錄資源,要注意的是遞歸的時候又得考慮classpath,與classpath*的狀況,並且還得考慮根路徑中是否又包含通配符,參考上面那張流程圖  
  7.         Resource[] rootDirResources = getResources(rootDirPath);  
  8.         Set<Resource> result = new LinkedHashSet<Resource>(16);  
  9.         //將根目錄全部資源中全部匹配咱們須要的資源(如spring-*)加載result中  
  10.         for (Resource rootDirResource : rootDirResources) {  
  11.             rootDirResource = resolveRootDirResource(rootDirResource);  
  12.             if (isJarResource(rootDirResource)) {  
  13.                 result.addAll(doFindPathMatchingJarResources(rootDirResource, subPattern));  
  14.             }  
  15.             else if (rootDirResource.getURL().getProtocol().startsWith(ResourceUtils.URL_PROTOCOL_VFS)) {  
  16.                 result.addAll(VfsResourceMatchingDelegate.findMatchingResources(rootDirResource, subPattern, getPathMatcher()));  
  17.             }  
  18.             else {  
  19.                 result.addAll(doFindPathMatchingFileResources(rootDirResource, subPattern));  
  20.             }  
  21.         }  
  22.         if (logger.isDebugEnabled()) {  
  23.             logger.debug("Resolved location pattern [" + locationPattern + "] to resources " + result);  
  24.         }  
  25.         return result.toArray(new Resource[result.size()]);  
  26.     }  

值得註解一下的是determineRootDir()方法的做用,是肯定根目錄,這個根目錄必須是一個能肯定的路徑,不會包含通配符。若是classpath*:aa/bb*/spring-*.xml,獲得的將是classpath*:aa/  能夠看下他的源碼

[java]  view plain  copy
  1. protected String determineRootDir(String location) {  
  2.     int prefixEnd = location.indexOf(":") + 1;  
  3.     int rootDirEnd = location.length();  
  4.     while (rootDirEnd > prefixEnd && getPathMatcher().isPattern(location.substring(prefixEnd, rootDirEnd))) {  
  5.         rootDirEnd = location.lastIndexOf('/', rootDirEnd - 2) + 1;  
  6.     }  
  7.     if (rootDirEnd == 0) {  
  8.         rootDirEnd = prefixEnd;  
  9.     }  
  10.     return location.substring(0, rootDirEnd);  
  11. }  




分析到這,結合測試咱們能夠總結一下:
1.不管是classpath仍是classpath*均可以加載整個classpath下(包括jar包裏面)的資源文件。
2.classpath只會返回第一個匹配的資源,查找路徑是優先在項目中存在資源文件,再查找jar包。
3.文件名字包含通配符資源(若是spring-*.xml,spring*.xml),   若是根目錄爲"", classpath加載不到任何資源, 而classpath*則能夠加載到classpath中 能夠匹配的目錄中的資源,可是不能加載到jar包中的資源
    
       第1,2點比較好表理解,你們能夠自行測試,第三點表述有點繞,舉個例,如今有資源文件結構以下:


classpath:notice*.txt                                                               加載不到資源
classpath*:notice*.txt                                                            加載到resource根目錄下notice.txt
classpath:META-INF/notice*.txt                                          加載到META-INF下的一個資源(classpath是加載到匹配的第一個資源,就算刪除classpath下的notice.txt,他仍然能夠                                                                                                  加載jar包中的notice.txt)
classpath:META-*/notice*.txt                                              加載不到任何資源
classpath*:META-INF/notice*.txt                                        加載到classpath以及全部jar包中META-INF目錄下以notice開頭的txt文件
classpath*:META-*/notice*.txt                                             只能加載到classpath下 META-INF目錄的notice.txt




相關文章
相關標籤/搜索