org.springframework.core.io: public class: DefaultResourceLoader

org.springframework.core.io
public class: DefaultResourceLoader [javadoc | source]

java.lang.Object
   org.springframework.core.io.DefaultResourceLoader

All Implemented Interfaces:
ResourceLoader

Direct Known Subclasses:
XmlWebApplicationContext, StaticApplicationContext, ClassPathXmlApplicationContext, FileSystemResourceLoader, GenericApplicationContext, AbstractXmlApplicationContext, GenericWebApplicationContext, ResourceAdapterApplicationContext, AbstractRefreshableWebApplicationContext, FileSystemXmlApplicationContext, AbstractRefreshableConfigApplicationContext, StaticPortletApplicationContext, StaticWebApplicationContext, AbstractApplicationContext, PortletContextResourceLoader, AbstractRefreshableApplicationContext, AbstractRefreshablePortletApplicationContext, ServletContextResourceLoader, XmlPortletApplicationContext

Default implementation of the ResourceLoader interface. Used by ResourceEditor , and serves as base class for org.springframework.context.support.AbstractApplicationContext . Can also be used standalone.

Will return a UrlResource if the location value is a URL, and a ClassPathResource if it is a non-URL path or a "classpath:" pseudo-URL.

Also see:

FileSystemResourceLoader

org.springframework.context.support.ClassPathXmlApplicationContext

author: Juergen - Hoeller

since: 10.03.2004 -

Constructor:

Constructor:
public DefaultResourceLoader() { this.classLoader = ClassUtils.getDefaultClassLoader(); } Create a new DefaultResourceLoader. ClassLoader access will happen using the thread context class loader at the time of this ResourceLoader's initialization. Also see: java.lang.Thread#getContextClassLoader()
public DefaultResourceLoader(ClassLoader classLoader) { this.classLoader = classLoader; } Create a new DefaultResourceLoader. Parameters: `classLoader` - the ClassLoader to load class path resources with, or `null` for using the thread context class loader at the time of actual resource access

 public DefaultResourceLoader() {
		this.classLoader = ClassUtils.getDefaultClassLoader();
}

Create a new DefaultResourceLoader.

ClassLoader access will happen using the thread context class loader at the time of this ResourceLoader's initialization.

Also see:

java.lang.Thread#getContextClassLoader()

 public DefaultResourceLoader(ClassLoader classLoader) {
		this.classLoader = classLoader;
}

Create a new DefaultResourceLoader.

Parameters:

classLoader - the ClassLoader to load class path resources with, or null for using the thread context class loader at the time of actual resource access

Method from org.springframework.core.io.DefaultResourceLoader Summary:
getClassLoader, getResource, getResourceByPath, setClassLoader

Methods from java.lang.Object:
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from org.springframework.core.io.DefaultResourceLoader Detail:
public ClassLoader getClassLoader() { return this.classLoader; } Return the ClassLoader to load class path resources with, or `null` if using the thread context class loader on actual access (applying to the thread that constructs the ClassPathResource object). Will get passed to ClassPathResource's constructor for all ClassPathResource objects created by this resource loader.
public Resource getResource(String location) { Assert.notNull(location, "Location must not be null"); if (location.startsWith(CLASSPATH_URL_PREFIX)) { return new ClassPathResource(location.substring(CLASSPATH_URL_PREFIX.length()), getClassLoader()); } else { try { // Try to parse the location as a URL... URL url = new URL(location); return new UrlResource(url); } catch (MalformedURLException ex) { // No URL - > resolve as resource path. return getResourceByPath(location); } } }
protected Resource getResourceByPath(String path) { return new ClassPathContextResource(path, getClassLoader()); } Return a Resource handle for the resource at the given path. The default implementation supports class path locations. This should be appropriate for standalone implementations but can be overridden, e.g. for implementations targeted at a Servlet container.
public void setClassLoader(ClassLoader classLoader) { this.classLoader = classLoader; } Specify the ClassLoader to load class path resources with, or `null` for using the thread context class loader at the time of actual resource access. The default is that ClassLoader access will happen using the thread context class loader at the time of this ResourceLoader's initialization.

Method from org.springframework.core.io.DefaultResourceLoader Detail:

 public ClassLoader getClassLoader() {
		return this.classLoader;
}

null

Will get passed to ClassPathResource's constructor for all ClassPathResource objects created by this resource loader.

 public Resource getResource(String location) {
		Assert.notNull(location, "Location must not be null");
		if (location.startsWith(CLASSPATH_URL_PREFIX)) {
			return new ClassPathResource(location.substring(CLASSPATH_URL_PREFIX.length()), getClassLoader());
		}
		else {
			try {
				// Try to parse the location as a URL...
				URL url = new URL(location);
				return new UrlResource(url);
			}
			catch (MalformedURLException ex) {
				// No URL - > resolve as resource path.
				return getResourceByPath(location);
			}
		}
}

 protected Resource getResourceByPath(String path) {
		return new ClassPathContextResource(path, getClassLoader());
}

The default implementation supports class path locations. This should be appropriate for standalone implementations but can be overridden, e.g. for implementations targeted at a Servlet container.

 public  void setClassLoader(ClassLoader classLoader) {
		this.classLoader = classLoader;
}

null

The default is that ClassLoader access will happen using the thread context class loader at the time of this ResourceLoader's initialization.