org.springframework.core.io: public interface: ResourceLoader

org.springframework.core.io
public interface: ResourceLoader [javadoc | source]

All Known Implementing Classes:
FileSystemXmlApplicationContext, AbstractRefreshableApplicationContext, WebApplicationContext, ClassPathXmlApplicationContext, ServletContextResourcePatternResolver, AbstractRefreshablePortletApplicationContext, PortletContextResourcePatternResolver, XmlPortletApplicationContext, ConfigurableApplicationContext, XmlWebApplicationContext, GenericWebApplicationContext, AbstractRefreshableWebApplicationContext, GenericApplicationContext, DefaultResourceLoader, AbstractRefreshableConfigApplicationContext, AbstractXmlApplicationContext, StaticApplicationContext, ApplicationContext, PortletContextResourceLoader, ResourceAdapterApplicationContext, FileSystemResourceLoader, ServletContextResourceLoader, StaticWebApplicationContext, ConfigurablePortletApplicationContext, PathMatchingResourcePatternResolver, ResourcePatternResolver, AbstractApplicationContext, StaticPortletApplicationContext, ConfigurableWebApplicationContext

Strategy interface for loading resources (e.. class path or file system resources). An org.springframework.context.ApplicationContext is required to provide this functionality, plus extended org.springframework.core.io.support.ResourcePatternResolver support.

DefaultResourceLoader is a standalone implementation that is usable outside an ApplicationContext, also used by ResourceEditor .

Bean properties of type Resource and Resource array can be populated from Strings when running in an ApplicationContext, using the particular context's resource loading strategy.

Also see:

Resource

org.springframework.core.io.support.ResourcePatternResolver

org.springframework.context.ApplicationContext

org.springframework.context.ResourceLoaderAware

author: Juergen - Hoeller

since: 10.03.2004 -

Field Summary
String	CLASSPATH_URL_PREFIX	Pseudo URL prefix for loading from the class path: "classpath:"

Method from org.springframework.core.io.ResourceLoader Summary:
getClassLoader, getResource

Method from org.springframework.core.io.ResourceLoader Detail:
public ClassLoader getClassLoader() Expose the ClassLoader used by this ResourceLoader. Clients which need to access the ClassLoader directly can do so in a uniform manner with the ResourceLoader, rather than relying on the thread context ClassLoader.
public Resource getResource(String location) Return a Resource handle for the specified resource. The handle should always be a reusable resource descriptor, allowing for multiple Resource#getInputStream() calls. Must support fully qualified URLs, e.g. "file:C:/test.dat". Must support classpath pseudo-URLs, e.g. "classpath:test.dat". Should support relative file paths, e.g. "WEB-INF/test.dat". (This will be implementation-specific, typically provided by an ApplicationContext implementation.) Note that a Resource handle does not imply an existing resource; you need to invoke Resource#exists to check for existence.

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

 public ClassLoader getClassLoader()Expose the ClassLoader used by this ResourceLoader.
Clients which need to access the ClassLoader directly can do so
in a uniform manner with the ResourceLoader, rather than relying
on the thread context ClassLoader.

 public Resource getResource(String location)Return a Resource handle for the specified resource.
The handle should always be a reusable resource descriptor,
allowing for multiple Resource#getInputStream()  calls.

Must support fully qualified URLs, e.g. "file:C:/test.dat".
Must support classpath pseudo-URLs, e.g. "classpath:test.dat".
Should support relative file paths, e.g. "WEB-INF/test.dat".
(This will be implementation-specific, typically provided by an
ApplicationContext implementation.)

Note that a Resource handle does not imply an existing resource;
you need to invoke Resource#exists  to check for existence.