在web.xml中我们除了配置actionservlet还配置了一些初始化参数信息,首先我们看第一个config参数,这里配置的是/web-inf/struts-config.xml,因为要下面传递一个这样一个配置信息,这个xml文件名是struts1标准的名字,所以这里这个初始化信息完全可以删除,如果不用这个标准名称这里就必须要在这里配置。现在我们配置的是标准名字,所以我们可以删除,这是为什么呢?这里要看actionservlet源代码才可以。
从图片上我们能看到actionservlet中已经写好了默认的config信息了,就是标准名字。所以这里删除也是可以的。
在看下面的debug和detail参数,这两个参数信息是有关日志信息级别的设置,主要关于解析配置文件/web-inf/struts-config.xml级别的初始化参数。这里这两个参数可以完全去掉也不影响。
最后还有一个load-on-startup配置,这个是初始化servlet级别的初始化信息,这个参数如果大于等于0就是说明在服务器一启动就把servlet初始化,也就是调用actionservlet的init方法,这个也可以到actionservlet的源代码中去查找。
当actionservlet初始化的时候就会读取/web-inf/struts-config.xml信息到内存中,读到内存是以什么样的形式展现的呢?我们现在可以看一下以前博客的那个mvc实例,那里面读取配置文件中的信息是以actionmapping的形式展现的。另外servlet-mapping的配置就不讲解了,这个都知道就是匹配url路径的,当遇到url-pattern的路径时候就会实例化actionservlet。
通过这篇文章我们知道了当我们请求的时候actionservlet是怎样实例化的,也知道为什么我们要配置web.xml信息了。那么我们为什么要配置/web-inf/struts-config.xml文件,actionservlet是如何传递请求的,如何和actionform、actionmapping、action等交互的最终完成用户请求的呢?
我们先从actionservlet源代码的init方法开始。因为actionservlet就是一个servlet,它也是具有典型的那几个方法init、doget、dopost等方法。既然是初始化,那么我们就要看init方法。init方法的源代码如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
|
/** * <p>initialize this servlet. most of the processing has been factored into * support methods so that you can overrideparticular functionality at a * fairly granular level.</p> * * @exception servletexception if we cannotconfigure ourselves correctly */ publicvoidinit() throwsservletexception { // wraps the entire initialization in a try/catch tobetter handle // unexpected exceptions and errors to provide better feedback // to the developer try { initinternal(); initother(); initservlet(); getservletcontext().setattribute(globals.action_servlet_key, this ); initmoduleconfigfactory(); // initialize modules as needed moduleconfig moduleconfig =initmoduleconfig( "" , config); initmodulemessageresources(moduleconfig); initmoduledatasources(moduleconfig); initmoduleplugins(moduleconfig); moduleconfig.freeze(); enumeration names =getservletconfig().getinitparameternames(); while (names.hasmoreelements()) { string name = (string)namesnextelement(); if (!name.startswith( "config/" )) { continue ; } string prefix =name.substring( 6 ); moduleconfig = initmoduleconfig (prefix,getservletconfig().getinitparameter(name)); initmodulemessageresources(moduleconfig); initmoduledatasources(moduleconfig); initmoduleplugins(moduleconfig); moduleconfig.freeze(); } this .initmoduleprefixes( this .getservletcontext()); thisdestroyconfigdigester(); } catch (unavailableexception ex) { throw ex; } catch (throwable t) { // the follow error message is not retrieved from internal message // resources as they may not have been able to have been // initialized logerror( "unable to initialize struts actionservlet due to an " + "unexpected exception or error thrown, so marking the " + "servlet as unavailable. mostlikely, this is due to an " + "incorrect or missing library dependency." , t); throw new unavailableexception(t.getmessage()); } } |
在解释这段代码的流程和意思之前,有必要说一句,就是当我们在eclipse里面看代码的时候,尤其是看一段生疏的很长的代码的时候,希望能够经常使用ctrl键(多余的不解释)。
下面开始讲解这段代码的流程和具体每一步的含义,如果有不正确的地方,希望指正。
首先映入眼帘的是initinternal()方法。这个方法的实现代码是:
代码段一:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
/** * <p>initialize our internal messageresourcesbundle</p> * * @exception servletexception if we cannotinitialize these resources */ protectedvoidinitinternal() throwsservletexception { // :fixme: document unavailableexception try { internal = messageresourcesgetmessageresources(internalname); } catch (missingresourceexception e) { log.error( "cannot load internal resources from '" + internalname+ "'" , e); throw new unavailableexception ( "cannot load internal resources from '" + internalname+ "'" ); } } |
代码段二:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
/** * create and return an instance of <code>messageresources</code> for the * created by the default <code>messageresourcesfactory</code>. * * @param config configuration parameterfor this message bundle. */ publicsynchronizedstaticmessageresources getmessageresources(string config) { if (defaultfactory == null ) { defaultfactory =messageresourcesfactory.createfactory(); } return defaultfactory.createresources(config); } |
代码段三:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
/** * create and return a <code>messageresourcesfactory</code> instance ofthe * appropriate class, which can be used tocreate customized * <code>messageresources</code>instances if no such factory can be * created, return <code>null</code> instead */ publicstaticmessageresourcesfactory createfactory(){ // construct a new instance of the specified factory class try { if (clazz == null ) clazz = requestutils.applicationclass(factoryclass); messageresourcesfactory factory = (messageresourcesfactory) clazz.newinstance(); return (factory); } catch (throwable t) { log.error( "messageresourcesfactory.createfactory" ,t); return ( null ); } } |
这个方法的具体作用就是初始化messageresources,具体实现是工厂模式,首先判断defaultfactory是否存在,不存在则创建工厂,defaultfactory = messageresourcesfactory.createfactory(),在通过工厂创建资源类defaultfactory.createresources(config);存在则直接创建资源类。
initother()的方法,主要是初始化其它的配置,获取我们自己的struts-config配置文件的路径,而它的默认路径就是web-inf/struts-config.xml,另外这个方法还会注册一些转换类的。具体源代码是:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
|
/** * <p>initialize other global characteristics ofthe controller servlet</p> * * @exception servletexception if we cannotinitialize these resources */ protectedvoidinitother() throwsservletexception { string value = null ; value =getservletconfig().getinitparameter( "config" ); if (value != null ) { config = value; } // backwards compatibility for form beans of java wrapper classes // set to true for strict struts 0 compatibility value =getservletconfig().getinitparameter( "convertnull" ); if ( "true" .equalsignorecase(value) || "yes" .equalsignorecase(value) || "on" .equalsignorecase(value) || "y" .equalsignorecase(value) || "1" .equalsignorecase(value)) { convertnull = true ; } if (convertnull) { convertutils.deregister(); convertutils.register( new bigdecimalconverter( null ), bigdecimal. class ); convertutils.register( new bigintegerconverter( null ), biginteger. class ); convertutils.register( new booleanconverter( null ), boolean . class ); convertutils.register( new byteconverter( null ), byte . class ); convertutils.register( new characterconverter( null ), character. class ); convertutils.register( new doubleconverter( null ), double . class ); convertutils.register( new floatconverter( null ), float . class ); convertutils.register( new integerconverter( null ), integer. class ); convertutils.register( new longconverter( null ), long . class ); convertutils.register( new shortconverter( null ), short . class ); } } |
initservlet()方法是利用digester读取web.xml文件并且放到servletcontext中。具体实现源代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
/** * <p>initialize the servlet mapping under which our controller servlet * is being accessed. this will be used in the <code>&html:form></code> * tag to generate correct destination urls for form submissions.</p> * * @throws servletexception if error happens while scanning web.xml */ protected void initservlet() throws servletexception { // remember our servlet name this .servletname = getservletconfig().getservletname(); // prepare a digester to scan the web application deployment descriptor digester digester = new digester(); digester.push( this ); digester.setnamespaceaware( true ); digester.setvalidating( false ); // register our local copy of the dtds that we can find for ( int i = 0 ; i < registrations.length; i += 2 ) { url url = this .getclass().getresource(registrations[i+ 1 ]); if (url != null ) { digester.register(registrations[i], url.tostring()); } } // configure the processing rules that we need digester.addcallmethod( "web-app/servlet-mapping" , "addservletmapping" , 2 ); digester.addcallparam( "web-app/servlet-mapping/servlet-name" , 0 ); digester.addcallparam( "web-app/servlet-mapping/url-pattern" , 1 ); // process the web application deployment descriptor if (log.isdebugenabled()) { log.debug( "scanning web.xml for controller servlet mapping" ); } inputstream input = getservletcontext().getresourceasstream( "/web-inf/web.xml" ); if (input == null ) { log.error(internal.getmessage( "configwebxml" )); throw new servletexception(internal.getmessage( "configwebxml" )); } try { digester.parse(input); } catch (ioexception e) { log.error(internal.getmessage( "configwebxml" ), e); throw new servletexception(e); } catch (saxexception e) { log.error(internal.getmessage( "configwebxml" ), e); throw new servletexception(e); } finally { try { input.close(); } catch (ioexception e) { log.error(internal.getmessage( "configwebxml" ), e); throw new servletexception(e); } } // record a servlet context attribute (if appropriate) if (log.isdebugenabled()) { logdebug( "mapping for servlet '" + servletname + "' = '" + servletmapping + "'" ); } if (servletmapping != null ) { getservletcontext().setattribute(globals.servlet_key, servletmapping); } } |
首先说在说之前还是先讲init方法的具体实现代码写出来以便大家方便阅读和理解。
init源代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
|
public void init() throws servletexception { try { //初始化资源类 initinternal(); //注册转换类 initother(); //利用digester读取webxml文件并且将其放到servletcontext中 initservlet(); getservletcontext().setattribute(globals.action_servlet_key, this ); initmoduleconfigfactory(); moduleconfig moduleconfig = initmoduleconfig( "" , config); initmodulemessageresources(moduleconfig); initmoduledatasources(moduleconfig); initmoduleplugins(moduleconfig); moduleconfig.freeze(); enumeration names = getservletconfig().getinitparameternames(); while (names.hasmoreelements()) { string name = (string) names.nextelement(); if (!name.startswith( "config/" )) { continue ; } string prefix = name.substring( 6 ); moduleconfig = initmoduleconfig (prefix, getservletconfig()getinitparameter(name)); initmodulemessageresources(moduleconfig); initmoduledatasources(moduleconfig); initmoduleplugins(moduleconfig); moduleconfig.freeze(); } this .initmoduleprefixes( this .getservletcontext()); this .destroyconfigdigester(); } catch (unavailableexception ex) { throw ex; } catch (throwable t) { log.error( "unable to initialize struts actionservlet due to an " + "unexpected exception or error thrown, so marking the " + "servlet as unavailable most likely, this is due to an " + "incorrect or missing library dependency" , t); throw new unavailableexception(t.getmessage()); } } |
getservletcontext().setattribute(globals.action_servlet_key,this);这句话是将actionservlet实例将以globals.action_servlet_key作为key存入servletcontext中。
这里的globals.action_servlet_key在actionservlet已经给出了声明:
1
|
public static final string action_servlet_key= "org.apache.struts.action.action_servlet" ; |
接下来initmoduleconfigfactory()方法,这个方法主要的作用是解析在web.xml中configfactory的text值。如果configfactory有配置,则将设置moduleconfigfactory中得factoryclass值,否则默认得为efaultmoduleconfigfactory。该方法其实宗旨是让开发人员自己开发出moduleconfigfactory,从而得到自己所需要的moduleconfig类。因为我们的实例中没有配置这个参数信息,所以我们这里的实例是要defalutmodelconfigfactory了。
代码段一:
1
2
3
4
5
6
|
protected voidinitmoduleconfigfactory(){ string configfactory =getservletconfig().getinitparameter( "configfactory" ); if (configfactory != null ) { moduleconfigfactory.setfactoryclass(configfactory); } } |
代码段二:
1
2
3
4
|
public static void setfactoryclass(string factoryclass) { moduleconfigfactory.factoryclass = factoryclass; moduleconfigfactory.clazz = null ; } |
代码段三:
1
2
3
|
protected static string factoryclass = "org.apache.struts.config.impl.defaultmoduleconfigfactory" ; } |
moduleconfig moduleconfig =initmoduleconfig("", config)方法是非常重要的,initmoduleconfig方法给strits-config里面的属性初始化后放入moduleconfig对象里面去,放到moduleconfig对象里面去便于以后操作更快,因为它是文件流。
具体实现代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
|
protected moduleconfig initmoduleconfig(stringprefix, string paths) throws servletexception { // :fixme: document unavailableexception? (doesn't actually throw anything) if (log.isdebugenabled()) { log.debug( "initializing module path '" + prefix + "' configuration from '" + paths + "'" ); } // parse the configuration for this module moduleconfigfactory factoryobject= moduleconfigfactory.createfactory(); moduleconfig config =factoryobject.createmoduleconfig(prefix); // configure the digester instance we will use digester digester =initconfigdigester(); // process each specified resource path while (paths.length() > 0 ) { digester.push(config); string path = null ; int comma = paths.indexof( ',' ); if (comma >= 0 ) { path =paths.substring( 0 , comma).trim(); paths =paths.substring(comma + 1 ); } else { path = pathstrim(); paths = "" ; } if (pathlength() < 1 ){ break ; } this .parsemoduleconfigfile(digester,path); } getservletcontext().setattribute( globals.module_key +config.getprefix(), config); // force creation and registration of dynaactionformclass instances // for all dynamic form beans we wil be using formbeanconfig fbs[] =config.findformbeanconfigs(); for ( int i = 0 ; i < fbs.length; i++) { if (fbs[i].getdynamic()) { fbs[i].getdynaactionformclass(); } } return config; } |
这里有必要解析一下这段代码。首先得到继承moduleconfigfactory的实现类,如果在initmoduleconfigfactory()中能设置factoryclass属性,则能生成客户化得factory,否则得到得是默认得defaultmoduleconfigfactory类,该工厂得到moduleconfigimpl类。然后调用initconfigdigester()该方法为解析配置文件做准备,初始化digest类(具体digest的初始化实现就不讲解)。最后返回moduleconfig,而这时的moduleconfig里面封装了所有的struts-config.xml中的信息。
最后的几个方法就简单说一下就行,不是非常难理解:
initmodulemessageresources(moduleconfig)方法是通过moduleconfig中的配置文件信息,创建messageresource对象.
initmoduledatasources(moduleconfig)方法是通过moduleconfig中的配置文件信息,创建datasource对象. initmoduleplugins(moduleconfig)加载并初始化默认应用模块的所有插件的。
moduleconfig.freeze()是将配置文件中的各个对象,设置成已配置状态.
最后我们看到了,下面还有一段同上面代码的循环代码,这段代码的主要意思就是当默认子应用模块被成功初始化后,如果应用还包括其他子应用模块,将重复流程,分别对其他子应用模块进行初始化。这个也是很好理解的。
到此为止actionservlet就init完成。