spring源碼研究之IoC容器在web容器中初始化過程前段時間在公司做了一個項目,項目用了spring框架實現(xiàn),WEB容器是Tomct 5，雖然說把項目做完了，但是一直對spring的IoC容器在web容器如何啟動和起作用的并不清楚。所以就抽時間看一下spring的源代碼，借此了解它的原理。 我們知道，對于使用Spring的web應(yīng)用，無須手動創(chuàng)建Spring容器，而是通過配置文件，聲明式的創(chuàng)建Spring容器。因此在Web應(yīng)用中創(chuàng)建Spring容器有如下兩種方式： 1. 直接在web.xml文件中配置創(chuàng)建Spring容器。 2. 利用第三方MVC框架的擴展點，創(chuàng)建Spring容器。 其實第一種方式是更加常見。為了讓Spring容器隨Web應(yīng)用的啟動而啟動，有如下兩種方式： 1. 利用ServletContextListener實現(xiàn)。 2. 利用load-on-startup Servlet實現(xiàn)。 Spring提供ServletContextListener的一個實現(xiàn)類ContextLoaderListener,該類可以作為Listener 使用，它會在創(chuàng)建時自動查找WEB-INF下的applicationContext.xml文件，因此，如果只有一個配置文件，并且文件名為applicationContext.xml，則只需在web.xml文件中增加以下配置片段就可以了。
Java代碼
<listener> <listener-class> org.springframework.web.context.ContextLoaderListener </listener-class> </listener> 如果有多個配置文件需要載入，則考慮使用<context-param...>元素來確定配置文件的文件名。ContextLoaderListener加載時，會查找名為contentConfigLocation的初始化參數(shù)。因此，配置<context-param...>時就指定參數(shù)名為contextConfigLocation。 帶多個配置文件的web.xml文件如下：
S代碼
<context-param> <param-name>contextLoaderListener</param-name> <param-value> WEB-INF/*.xml, classpath:spring/*.xml </param-value> </context-param> S代碼
<listener> <listener-class> org.springframework.web.context.ContextLoaderListener </listener-class> </listener> 多個配置文件之間用“,”隔開。
下面我們來看它的具體實現(xiàn)過程是怎樣的，首先我們從ContextLoaderListener入手，它的代碼如下：
Java代碼
public class ContextLoaderListener implements ServletContextListener
{
private ContextLoader contextLoader;
/**
* 這個方法就是用來初始化web application context的
*/
public void contextInitialized(ServletContextEvent event)
{
this.contextLoader = createContextLoader();
this.contextLoader.initWebApplicationContext(event.getServletContext());
}
/**
* 創(chuàng)建一個contextLoader.
* @return the new ContextLoader
*/
protected ContextLoader createContextLoader()
{
return new ContextLoader();
}
................
}
我們看到初始化web application context的時候，首先通過new ContextLoader()創(chuàng)建一個contextLoader， new ContextLoader()具體做了什么事呢？ContextLoader的代碼片段：
Java代碼
static {
try {
// 這里創(chuàng)建一個ClassPathResource對象,載入ContextLoader.properties,用于創(chuàng)建對應(yīng)的ApplicationContext容器
// 這個文件跟ContextLoader類在同一個目錄下,文件內(nèi)容如:
// org.springframework.web.context.WebApplicationContext=org.springframework.web.context.support.XmlWebApplicationContext
// 如此說來,spring默認初始化的是XmlWebApplicationContext
ClassPathResource resource = new ClassPathResource(DEFAULT_STRATEGIES_PATH, ContextLoader.class);
// 得到一個Properties對象,后面根據(jù)類名來創(chuàng)建ApplicationContext容器
defaultStrategies = PropertiesLoaderUtils.loadProperties(resource);
}
catch (IOException ex) {
throw new IllegalStateException("Could not load 'ContextLoader.properties': " + ex.getMessage());
}
}
代碼注釋里面已經(jīng)說得很清楚了，很容易理解吧？嘿嘿...... 再下來我們再看一下initWebApplicationContext方法的實現(xiàn)過程：
Java代碼
public WebApplicationContext initWebApplicationContext(ServletContext servletContext)
throws IllegalStateException, BeansException {
// 從servletContext中獲取ApplicationContext容器;如果已經(jīng)存在,則提示初始化容器失敗,檢查web.xml文件中是否定義有多個容器加載器
// ServletContext接口的簡述：public interface ServletContext
// 定義了一系列方法用于與相應(yīng)的servlet容器通信，比如：獲得文件的MIME類型，分派請求，或者是向日志文件寫日志等。
// 每一個web-app只能有一個ServletContext，web-app可以是一個放置有web application 文件的文件夾，也可以是一個.war的文件。
// ServletContext對象包含在ServletConfig對象之中，ServletConfig對象在servlet初始化時提供servlet對象。
if (servletContext.getAttribute(WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE) != null) {
throw new IllegalStateException(
"Cannot initialize context because there is already a root application context present - " +
"check whether you have multiple ContextLoader* definitions in your web.xml!");
}
servletContext.log("Initializing Spring root WebApplicationContext");
if (logger.isInfoEnabled()) {
logger.info("Root WebApplicationContext: initialization started");
}
long startTime = System.currentTimeMillis();
try {
// Determine parent for root web application context, if any.
// 獲取父容器
ApplicationContext parent = loadParentContext(servletContext);
// Store context in local instance variable, to guarantee that
// it is available on ServletContext shutdown.
// 創(chuàng)建ApplicationContext容器
this.context = createWebApplicationContext(servletContext, parent);
// 把容器放入到servletContext中
servletContext.setAttribute(WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE, this.context);
if (logger.isDebugEnabled()) {
logger.debug("Published root WebApplicationContext as ServletContext attribute with name [" +
WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE + "]");
}
if (logger.isInfoEnabled()) {
long elapsedTime = System.currentTimeMillis() - startTime;
logger.info("Root WebApplicationContext: initialization completed in " + elapsedTime + " ms");
}
return this.context;
}
catch (RuntimeException ex) {
logger.error("Context initialization failed", ex);
servletContext.setAttribute(WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE, ex);
throw ex;
}
catch (Error err) {
logger.error("Context initialization failed", err);
servletContext.setAttribute(WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE, err);
throw err;
}
}
從上面的代碼可以看出，我們創(chuàng)建好的applicationContext容器會放在servletContext中。servletContext是什么 呢？ 在web容器中，通過ServletContext為Spring的IOC容器提供宿主環(huán)境，對應(yīng)的建立起一個IOC容器的體系。其中，首先需要建立的是根上下文，這個上下文持有的對象可以有業(yè)務(wù)對象，數(shù)據(jù)存取對象，資源，事物管理器等各種中間層對象。在這個上下文的基礎(chǔ)上，和web MVC相關(guān)還會有一個上下文來保存控制器之類的MVC對象，這樣就構(gòu)成了一個層次化的上下文結(jié)構(gòu)。 從initWebApplicationContext中可以看到真正創(chuàng)建applicationContext容器是由createWebApplicationContext方法來實現(xiàn)的，它的代碼如下：
Java代碼
protected WebApplicationContext createWebApplicationContext(
ServletContext servletContext, ApplicationContext parent) throws BeansException
{
// 首先決定要創(chuàng)建的applicationContext容器的類
Class contextClass = determineContextClass(servletContext);
// 如果獲取到的類不是ConfigurableWebApplicationContext類型的,則創(chuàng)建容器失敗,所以這里創(chuàng)建的容器必須是ConfigurableWebApplicationContext類型的
if (!ConfigurableWebApplicationContext.class.isAssignableFrom(contextClass))
{
throw new ApplicationContextException("Custom context class [" + contextClass.getName() +
"] is not of type [" + ConfigurableWebApplicationContext.class.getName() + "]");
}
// 實例化spring容器
ConfigurableWebApplicationContext wac =
(ConfigurableWebApplicationContext) BeanUtils.instantiateClass(contextClass);
wac.setParent(parent);
wac.setServletContext(servletContext);
// 獲取contextConfigLocation初始化參數(shù),該參數(shù)記錄的是需要載入的多個配置文件(即定義bean的配置文件)
String configLocation = servletContext.getInitParameter(CONFIG_LOCATION_PARAM);
if (configLocation != null)
{
wac.setConfigLocations(StringUtils.tokenizeToStringArray(configLocation,
ConfigurableWebApplicationContext.CONFIG_LOCATION_DELIMITERS));
}
wac.refresh();
return wac;
}
createWebApplicationContext方法實現(xiàn)步驟為： 1. 首先決定要創(chuàng)建的applicationContext容器的類 但它是如何決定要創(chuàng)建的容器類呢？我們看一下determineContextClass方法：
Java代碼
protected Class determineContextClass(ServletContext servletContext) throws ApplicationContextException
{
// 從web.xml中獲取需要初始化的容器的類名
String contextClassName = servletContext.getInitParameter(CONTEXT_CLASS_PARAM);
// 如果獲取到的類名不為空,則創(chuàng)建該容器的Class對象
if (contextClassName != null)
{
try {
return ClassUtils.forName(contextClassName);
}
catch (ClassNotFoundException ex) {
throw new ApplicationContextException(
"Failed to load custom context class [" + contextClassName + "]", ex);
}
}
// 否則創(chuàng)建默認的容器的Class對象,即:org.springframework.web.context.support.XmlWebApplicationContext
// 在創(chuàng)建ContextLoader時,defaultStrategies = PropertiesLoaderUtils.loadProperties(resource);這句代碼已經(jīng)準備好默認的容器類
else
{
contextClassName = defaultStrategies.getProperty(WebApplicationContext.class.getName());
try
{
return ClassUtils.forName(contextClassName);
}
catch (ClassNotFoundException ex)
{
throw new ApplicationContextException(
"Failed to load default context class [" + contextClassName + "]", ex);
}
}
}
該方法首先判斷從web.xml文件的初始化參數(shù)CONTEXT_CLASS_PARAM(的定義為public static final String CONTEXT_CLASS_PARAM = "contextClass";)獲取的的類名是否存在，如果存在，則容器的Class；否則返回默認的 Class。如何獲取默認的容器Class，注意看創(chuàng)建contextLoader時的代碼注釋就知道了。 由此看來，spring不僅有默認的applicationContext的容器類，還允許我們自定義applicationContext容器類，不過Spring不建義我們自定義applicationContext容器類。
好了，這就是spring的IoC容器在web容器如何啟動和起作用的全部過程。細心的朋友可以看出創(chuàng)建applicationContext容器的同時會初始化配置文件中定義的bean類，createWebApplicationContext方法中的wac.refresh();這段代碼就是用來初始化配置文件中定義的bean類的。它具體的實現(xiàn)過程現(xiàn)在還沒完全搞清楚，等搞清楚了再跟大家分享！ |
|
|
