tomcat解析(十四)web.xml解析

最新推荐文章于 2023-07-07 16:36:46 发布

holly2k

最新推荐文章于 2023-07-07 16:36:46 发布

阅读量1.9k

点赞数

分类专栏： tomcat 文章标签： tomcat wrapper parameters servlet object string

本文链接：https://blog.csdn.net/holly2k/article/details/5282654

版权

tomcat 专栏收录该内容

20 篇文章 2 订阅

订阅专栏

对于web.xml文件的解析所使用的Rule为WebRuleSet类,查看其addRuleInstances可得知其设置的具体Rule内容,如下:
    /** * <p>Add the set of Rule instances defined in this RuleSet to the * specified <code>Digester</code> instance, associating them with * our namespace URI (if any). This method should only be called * by a Digester instance.</p> * * @param digester Digester instance to which the new Rule instances * should be added. */ public void addRuleInstances(Digester digester) { sessionConfig = new SetSessionConfig(); jspConfig = new SetJspConfig(); loginConfig = new SetLoginConfig(); digester.addRule(prefix + "web-app", new SetPublicIdRule("setPublicId")); digester.addRule(prefix + "web-app", new IgnoreAnnotationsRule()); digester.addCallMethod(prefix + "web-app/context-param", "addParameter", 2); digester.addCallParam(prefix + "web-app/context-param/param-name", 0); digester.addCallParam(prefix + "web-app/context-param/param-value", 1); digester.addCallMethod(prefix + "web-app/display-name", "setDisplayName", 0); digester.addRule(prefix + "web-app/distributable", new SetDistributableRule()); digester.addObjectCreate(prefix + "web-app/ejb-local-ref", "org.apache.catalina.deploy.ContextLocalEjb"); digester.addRule(prefix + "web-app/ejb-local-ref", new SetNextNamingRule("addLocalEjb"<mce:script type="text/javascript" src="http://hi.images.csdn.net/js/blog/tiny_mce/themes/advanced/langs/zh.js" mce_src="http://hi.images.csdn.net/js/blog/tiny_mce/themes/advanced/langs/zh.js"></mce:script><mce:script type="text/javascript" src="http://hi.images.csdn.net/js/blog/tiny_mce/plugins/syntaxhl/langs/zh.js" mce_src="http://hi.images.csdn.net/js/blog/tiny_mce/plugins/syntaxhl/langs/zh.js"></mce:script>, "org.apache.catalina.deploy.ContextLocalEjb")); digester.addCallMethod(prefix + "web-app/ejb-local-ref/description", "setDescription", 0); digester.addCallMethod(prefix + "web-app/ejb-local-ref/ejb-link", "setLink", 0); digester.addCallMethod(prefix + "web-app/ejb-local-ref/ejb-ref-name", "setName", 0); digester.addCallMethod(prefix + "web-app/ejb-local-ref/ejb-ref-type", "setType", 0); digester.addCallMethod(prefix + "web-app/ejb-local-ref/local", "setLocal", 0); digester.addCallMethod(prefix + "web-app/ejb-local-ref/local-home", "setHome", 0); digester.addObjectCreate(prefix + "web-app/ejb-ref", "org.apache.catalina.deploy.ContextEjb"); digester.addRule(prefix + "web-app/ejb-ref", new SetNextNamingRule("addEjb", "org.apache.catalina.deploy.ContextEjb")); digester.addCallMethod(prefix + "web-app/ejb-ref/description", "setDescription", 0); digester.addCallMethod(prefix + "web-app/ejb-ref/ejb-link", "setLink", 0); digester.addCallMethod(prefix + "web-app/ejb-ref/ejb-ref-name", "setName", 0); digester.addCallMethod(prefix + "web-app/ejb-ref/ejb-ref-type", "setType", 0); digester.addCallMethod(prefix + "web-app/ejb-ref/home", "setHome", 0); digester.addCallMethod(prefix + "web-app/ejb-ref/remote", "setRemote", 0); digester.addObjectCreate(prefix + "web-app/env-entry", "org.apache.catalina.deploy.ContextEnvironment"); digester.addRule(prefix + "web-app/env-entry", new SetNextNamingRule("addEnvironment", "org.apache.catalina.deploy.ContextEnvironment")); digester.addCallMethod(prefix + "web-app/env-entry/description", "setDescription", 0); digester.addCallMethod(prefix + "web-app/env-entry/env-entry-name", "setName", 0); digester.addCallMethod(prefix + "web-app/env-entry/env-entry-type", "setType", 0); digester.addCallMethod(prefix + "web-app/env-entry/env-entry-value", "setValue", 0); digester.addObjectCreate(prefix + "web-app/error-page", "org.apache.catalina.deploy.ErrorPage"); digester.addSetNext(prefix + "web-app/error-page", "addErrorPage", "org.apache.catalina.deploy.ErrorPage"); digester.addCallMethod(prefix + "web-app/error-page/error-code", "setErrorCode", 0); digester.addCallMethod(prefix + "web-app/error-page/exception-type", "setExceptionType", 0); digester.addCallMethod(prefix + "web-app/error-page/location", "setLocation", 0); digester.addObjectCreate(prefix + "web-app/filter", "org.apache.catalina.deploy.FilterDef"); digester.addSetNext(prefix + "web-app/filter", "addFilterDef", "org.apache.catalina.deploy.FilterDef"); digester.addCallMethod(prefix + "web-app/filter/description", "setDescription", 0); digester.addCallMethod(prefix + "web-app/filter/display-name", "setDisplayName", 0); digester.addCallMethod(prefix + "web-app/filter/filter-class", "setFilterClass", 0); digester.addCallMethod(prefix + "web-app/filter/filter-name", "setFilterName", 0); digester.addCallMethod(prefix + "web-app/filter/large-icon", "setLargeIcon", 0); digester.addCallMethod(prefix + "web-app/filter/small-icon", "setSmallIcon", 0); digester.addCallMethod(prefix + "web-app/filter/init-param", "addInitParameter", 2); digester.addCallParam(prefix + "web-app/filter/init-param/param-name", 0); digester.addCallParam(prefix + "web-app/filter/init-param/param-value", 1); digester.addObjectCreate(prefix + "web-app/filter-mapping", "org.apache.catalina.deploy.FilterMap"); digester.addSetNext(prefix + "web-app/filter-mapping", "addFilterMap", "org.apache.catalina.deploy.FilterMap"); digester.addCallMethod(prefix + "web-app/filter-mapping/filter-name", "setFilterName", 0); digester.addCallMethod(prefix + "web-app/filter-mapping/servlet-name", "addServletName", 0); digester.addCallMethod(prefix + "web-app/filter-mapping/url-pattern", "addURLPattern", 0); digester.addCallMethod(prefix + "web-app/filter-mapping/dispatcher", "setDispatcher", 0); digester.addCallMethod(prefix + "web-app/listener/listener-class", "addApplicationListener", 0); digester.addRule(prefix + "web-app/jsp-config", jspConfig); digester.addCallMethod(prefix + "web-app/jsp-config/jsp-property-group/url-pattern", "addJspMapping", 0); digester.addRule(prefix + "web-app/login-config", loginConfig); digester.addObjectCreate(prefix + "web-app/login-config", "org.apache.catalina.deploy.LoginConfig"); digester.addSetNext(prefix + "web-app/login-config", "setLoginConfig", "org.apache.catalina.deploy.LoginConfig"); digester.addCallMethod(prefix + "web-app/login-config/auth-method", "setAuthMethod", 0); digester.addCallMethod(prefix + "web-app/login-config/realm-name", "setRealmName", 0); digester.addCallMethod(prefix + "web-app/login-config/form-login-config/form-error-page", "setErrorPage", 0); digester.addCallMethod(prefix + "web-app/login-config/form-login-config/form-login-page", "setLoginPage", 0); digester.addCallMethod(prefix + "web-app/mime-mapping", "addMimeMapping", 2); digester.addCallParam(prefix + "web-app/mime-mapping/extension", 0); digester.addCallParam(prefix + "web-app/mime-mapping/mime-type", 1); digester.addObjectCreate(prefix + "web-app/resource-env-ref", "org.apache.catalina.deploy.ContextResourceEnvRef"); digester.addRule(prefix + "web-app/resource-env-ref", new SetNextNamingRule("addResourceEnvRef", "org.apache.catalina.deploy.ContextResourceEnvRef")); digester.addCallMethod(prefix + "web-app/resource-env-ref/resource-env-ref-name", "setName", 0); digester.addCallMethod(prefix + "web-app/resource-env-ref/resource-env-ref-type", "setType", 0); digester.addObjectCreate(prefix + "web-app/message-destination", "org.apache.catalina.deploy.MessageDestination"); digester.addSetNext(prefix + "web-app/message-destination", "addMessageDestination", "org.apache.catalina.deploy.MessageDestination"); digester.addCallMethod(prefix + "web-app/message-destination/description", "setDescription", 0); digester.addCallMethod(prefix + "web-app/message-destination/display-name", "setDisplayName", 0); digester.addCallMethod(prefix + "web-app/message-destination/icon/large-icon", "setLargeIcon", 0); digester.addCallMethod(prefix + "web-app/message-destination/icon/small-icon", "setSmallIcon", 0); digester.addCallMethod(prefix + "web-app/message-destination/message-destination-name", "setName", 0); digester.addObjectCreate(prefix + "web-app/message-destination-ref", "org.apache.catalina.deploy.MessageDestinationRef"); digester.addSetNext(prefix + "web-app/message-destination-ref", "addMessageDestinationRef", "org.apache.catalina.deploy.MessageDestinationRef"); digester.addCallMethod(prefix + "web-app/message-destination-ref/description", "setDescription", 0); digester.addCallMethod(prefix + "web-app/message-destination-ref/message-destination-link", "setLink", 0); digester.addCallMethod(prefix + "web-app/message-destination-ref/message-destination-ref-name", "setName", 0); digester.addCallMethod(prefix + "web-app/message-destination-ref/message-destination-type", "setType", 0); digester.addCallMethod(prefix + "web-app/message-destination-ref/message-destination-usage", "setUsage", 0); digester.addObjectCreate(prefix + "web-app/resource-ref", "org.apache.catalina.deploy.ContextResource"); digester.addRule(prefix + "web-app/resource-ref", new SetNextNamingRule("addResource", "org.apache.catalina.deploy.ContextResource")); digester.addCallMethod(prefix + "web-app/resource-ref/description", "setDescription", 0); digester.addCallMethod(prefix + "web-app/resource-ref/res-auth", "setAuth", 0); digester.addCallMethod(prefix + "web-app/resource-ref/res-ref-name", "setName", 0); digester.addCallMethod(prefix + "web-app/resource-ref/res-sharing-scope", "setScope", 0); digester.addCallMethod(prefix + "web-app/resource-ref/res-type", "setType", 0); digester.addObjectCreate(prefix + "web-app/security-constraint", "org.apache.catalina.deploy.SecurityConstraint"); digester.addSetNext(prefix + "web-app/security-constraint", "addConstraint", "org.apache.catalina.deploy.SecurityConstraint"); digester.addRule(prefix + "web-app/security-constraint/auth-constraint", new SetAuthConstraintRule()); digester.addCallMethod(prefix + "web-app/security-constraint/auth-constraint/role-name", "addAuthRole", 0); digester.addCallMethod(prefix + "web-app/security-constraint/display-name", "setDisplayName", 0); digester.addCallMethod(prefix + "web-app/security-constraint/user-data-constraint/transport-guarantee", "setUserConstraint", 0); digester.addObjectCreate(prefix + "web-app/security-constraint/web-resource-collection", "org.apache.catalina.deploy.SecurityCollection"); digester.addSetNext(prefix + "web-app/security-constraint/web-resource-collection", "addCollection", "org.apache.catalina.deploy.SecurityCollection"); digester.addCallMethod(prefix + "web-app/security-constraint/web-resource-collection/http-method", "addMethod", 0); digester.addCallMethod(prefix + "web-app/security-constraint/web-resource-collection/url-pattern", "addPattern", 0); digester.addCallMethod(prefix + "web-app/security-constraint/web-resource-collection/web-resource-name", "setName", 0); digester.addCallMethod(prefix + "web-app/security-role/role-name", "addSecurityRole", 0); digester.addObjectCreate(prefix + "web-app/service-ref", "org.apache.catalina.deploy.ContextService"); digester.addRule(prefix + "web-app/service-ref", new SetNextNamingRule("addService", "org.apache.catalina.deploy.ContextService")); digester.addCallMethod(prefix + "web-app/service-ref/description", "setDescription", 0); digester.addCallMethod(prefix + "web-app/service-ref/display-name", "setDisplayname", 0); digester.addCallMethod(prefix + "web-app/service-ref/icon", "setIcon", 0); digester.addCallMethod(prefix + "web-app/service-ref/service-ref-name", "setName", 0); digester.addCallMethod(prefix + "web-app/service-ref/service-interface", "setType", 0); digester.addCallMethod(prefix + "web-app/service-ref/wsdl-file", "setWsdlfile", 0); digester.addCallMethod(prefix + "web-app/service-ref/jaxrpc-mapping-file", "setJaxrpcmappingfile", 0); digester.addRule(prefix + "web-app/service-ref/service-qname", new ServiceQnameRule()); digester.addRule(prefix + "web-app/service-ref/port-component-ref", new CallMethodMultiRule("addPortcomponent", 2, 1)); digester.addCallParam(prefix + "web-app/service-ref/port-component-ref/service-endpoint-interface", 0); digester.addRule(prefix + "web-app/service-ref/port-component-ref/port-component-link", new CallParamMultiRule(1)); digester.addObjectCreate(prefix + "web-app/service-ref/handler", "org.apache.catalina.deploy.ContextHandler"); digester.addRule(prefix + "web-app/service-ref/handler", new SetNextRule("addHandler", "org.apache.catalina.deploy.ContextHandler")); digester.addCallMethod(prefix + "web-app/service-ref/handler/handler-name", "setName", 0); digester.addCallMethod(prefix + "web-app/service-ref/handler/handler-class", "setHandlerclass", 0); digester.addCallMethod(prefix + "web-app/service-ref/handler/init-param", "setProperty", 2); digester.addCallParam(prefix + "web-app/service-ref/handler/init-param/param-name", 0); digester.addCallParam(prefix + "web-app/service-ref/handler/init-param/param-value", 1); digester.addRule(prefix + "web-app/service-ref/handler/soap-header", new SoapHeaderRule()); digester.addCallMethod(prefix + "web-app/service-ref/handler/soap-role", "addSoapRole", 0); digester.addCallMethod(prefix + "web-app/service-ref/handler/port-name", "addPortName", 0); digester.addRule(prefix + "web-app/servlet", new WrapperCreateRule()); digester.addSetNext(prefix + "web-app/servlet", "addChild", "org.apache.catalina.Container"); digester.addCallMethod(prefix + "web-app/servlet/init-param", "addInitParameter", 2); digester.addCallParam(prefix + "web-app/servlet/init-param/param-name", 0); digester.addCallParam(prefix + "web-app/servlet/init-param/param-value", 1); digester.addCallMethod(prefix + "web-app/servlet/jsp-file", "setJspFile", 0); digester.addCallMethod(prefix + "web-app/servlet/load-on-startup", "setLoadOnStartupString", 0); digester.addCallMethod(prefix + "web-app/servlet/run-as/role-name", "setRunAs", 0); digester.addRule(prefix + "web-app/servlet/security-role-ref", new SecurityRoleRefCreateRule()); digester.addCallMethod( prefix + "web-app/servlet/security-role-ref/role-link", "setLink", 0); digester.addCallMethod( prefix + "web-app/servlet/security-role-ref/role-name", "setName", 0); digester.addCallMethod(prefix + "web-app/servlet/servlet-class", "setServletClass", 0); digester.addCallMethod(prefix + "web-app/servlet/servlet-name", "setName", 0); digester.addRule(prefix + "web-app/servlet-mapping", new CallMethodMultiRule("addServletMapping", 2, 0)); digester.addCallParam(prefix + "web-app/servlet-mapping/servlet-name", 1); digester.addRule(prefix + "web-app/servlet-mapping/url-pattern", new CallParamMultiRule(0)); digester.addRule(prefix + "web-app/session-config", sessionConfig); digester.addCallMethod(prefix + "web-app/session-config/session-timeout", "setSessionTimeout", 1, new Class[] { Integer.TYPE }); digester.addCallParam(prefix + "web-app/session-config/session-timeout", 0); digester.addCallMethod(prefix + "web-app/taglib", "addTaglib", 2); digester.addCallParam(prefix + "web-app/taglib/taglib-location", 1); digester.addCallParam(prefix + "web-app/taglib/taglib-uri", 0); digester.addCallMethod(prefix + "web-app/welcome-file-list/welcome-file", "addWelcomeFile", 0); digester.addCallMethod(prefix + "web-app/locale-encoding-mapping-list/locale-encoding-mapping", "addLocaleEncodingMappingParameter", 2); digester.addCallParam(prefix + "web-app/locale-encoding-mapping-list/locale-encoding-mapping/locale", 0); digester.addCallParam(prefix + "web-app/locale-encoding-mapping-list/locale-encoding-mapping/encoding", 1); }
    在解析之前该Digester将StandardContext实例push到Stack里,因此解析完的所有对象均会放到该Context里或其子对象里
1. 设置context-param,如下:
   digester.addCallMethod(prefix + "web-app/context-param", "addParameter", 2); digester.addCallParam(prefix + "web-app/context-param/param-name", 0); digester.addCallParam(prefix + "web-app/context-param/param-value", 1);
其中需要注意的是addCallMethod方法加入了CallMethodRule类,该类是用于对位于栈顶的对象调用方法的,一般需要给出调用方法时参数的个数,参数的类型都是String类型
当参数个数为空时,将以标签体内容做为参数,如果参数个数不为空,则还需要继续添加设置个数的Rule,如上
2.EJB的调用,如下:
    digester.addObjectCreate(prefix + "web-app/ejb-local-ref", "org.apache.catalina.deploy.ContextLocalEjb"); digester.addRule(prefix + "web-app/ejb-local-ref", new SetNextNamingRule("addLocalEjb", "org.apache.catalina.deploy.ContextLocalEjb")); digester.addCallMethod(prefix + "web-app/ejb-local-ref/description", "setDescription", 0); digester.addCallMethod(prefix + "web-app/ejb-local-ref/ejb-link", "setLink", 0); digester.addCallMethod(prefix + "web-app/ejb-local-ref/ejb-ref-name", "setName", 0); digester.addCallMethod(prefix + "web-app/ejb-local-ref/ejb-ref-type", "setType", 0); digester.addCallMethod(prefix + "web-app/ejb-local-ref/local", "setLocal", 0); digester.addCallMethod(prefix + "web-app/ejb-local-ref/local-home", "setHome", 0); digester.addObjectCreate(prefix + "web-app/ejb-ref", "org.apache.catalina.deploy.ContextEjb"); digester.addRule(prefix + "web-app/ejb-ref", new SetNextNamingRule("addEjb", "org.apache.catalina.deploy.ContextEjb")); digester.addCallMethod(prefix + "web-app/ejb-ref/description", "setDescription", 0); digester.addCallMethod(prefix + "web-app/ejb-ref/ejb-link", "setLink", 0); digester.addCallMethod(prefix + "web-app/ejb-ref/ejb-ref-name", "setName", 0); digester.addCallMethod(prefix + "web-app/ejb-ref/ejb-ref-type", "setType", 0); digester.addCallMethod(prefix + "web-app/ejb-ref/home", "setHome", 0); digester.addCallMethod(prefix + "web-app/ejb-ref/remote", "setRemote", 0);
尽管TOMCAT不是一个EJB容器,但依然有支持其对EJB的调用,那应该是必然的吧,不然就太OUT了
3.设置本Context将使用的Name Context相关的信息,如下
    digester.addObjectCreate(prefix + "web-app/env-entry", "org.apache.catalina.deploy.ContextEnvironment"); digester.addRule(prefix + "web-app/env-entry", new SetNextNamingRule("addEnvironment", "org.apache.catalina.deploy.ContextEnvironment")); digester.addCallMethod(prefix + "web-app/env-entry/description", "setDescription", 0); digester.addCallMethod(prefix + "web-app/env-entry/env-entry-name", "setName", 0); digester.addCallMethod(prefix + "web-app/env-entry/env-entry-type", "setType", 0); digester.addCallMethod(prefix + "web-app/env-entry/env-entry-value", "setValue", 0);
这里将构建org.apache.catalina.deploy.ContextEnvironment对象,放入到StandardContext所持有的namingResources对象里
4.Filter配置
    digester.addObjectCreate(prefix + "web-app/filter", "org.apache.catalina.deploy.FilterDef"); digester.addSetNext(prefix + "web-app/filter", "addFilterDef", "org.apache.catalina.deploy.FilterDef"); digester.addCallMethod(prefix + "web-app/filter/description", "setDescription", 0); digester.addCallMethod(prefix + "web-app/filter/display-name", "setDisplayName", 0); digester.addCallMethod(prefix + "web-app/filter/filter-class", "setFilterClass", 0); digester.addCallMethod(prefix + "web-app/filter/filter-name", "setFilterName", 0); digester.addCallMethod(prefix + "web-app/filter/large-icon", "setLargeIcon", 0); digester.addCallMethod(prefix + "web-app/filter/small-icon", "setSmallIcon", 0); digester.addCallMethod(prefix + "web-app/filter/init-param", "addInitParameter", 2); digester.addCallParam(prefix + "web-app/filter/init-param/param-name", 0); digester.addCallParam(prefix + "web-app/filter/init-param/param-value", 1); digester.addObjectCreate(prefix + "web-app/filter-mapping", "org.apache.catalina.deploy.FilterMap"); digester.addSetNext(prefix + "web-app/filter-mapping", "addFilterMap", "org.apache.catalina.deploy.FilterMap"); digester.addCallMethod(prefix + "web-app/filter-mapping/filter-name", "setFilterName", 0); digester.addCallMethod(prefix + "web-app/filter-mapping/servlet-name", "addServletName", 0); digester.addCallMethod(prefix + "web-app/filter-mapping/url-pattern", "addURLPattern", 0); digester.addCallMethod(prefix + "web-app/filter-mapping/dispatcher", "setDispatcher", 0);
可以看到
    digester.addSetNext(prefix + "web-app/filter", "addFilterDef", "org.apache.catalina.deploy.FilterDef");
这里将调用StandardContext.addFilterDef方法,内容如下:
   /** * Add a filter definition to this Context. * * @param filterDef The filter definition to be added */ public void addFilterDef(FilterDef filterDef) { synchronized (filterDefs) { filterDefs.put(filterDef.getFilterName(), filterDef); } fireContainerEvent("addFilterDef", filterDef); }
filterDefs为一个HashMap,参数filterDef需要有FilterName,我们可以看到该名字是要在web.xml配置的,但调用这个方法的时候名字做了配置没呢?我们看到上面有一段如下的代码:
   digester.addCallMethod(prefix + "web-app/filter/filter-name", "setFilterName", 0);
这里便设置了FilterName,但这语句是在addSetNext后加入的,到底是在addFilterDef方法调用之前还是之后运行呢?当然是之后运行的啦,因为addSetNext是在结束标签的时候执行该方法的,因此其实该方法是在解析</Filter>时才执行的,当然也在setFilterName之后执行的,这个机制真的是太厉害了,也不知当时tomcat的工程师花了多长时间想到这个的:)
另一个值得称道的地方在这
   digester.addCallMethod(prefix + "web-app/filter/init-param", "addInitParameter", 2); digester.addCallParam(prefix + "web-app/filter/init-param/param-name", 0); digester.addCallParam(prefix + "web-app/filter/init-param/param-value", 1);
当要设置<init-param>或<context-param>,便会这样处理,开始的时候设置一个两个参数的CallMethodRule,该RULE的begin方法会产生一个长度为2的参数数组,放到栈里,如下
    /** * Construct a "call method" rule with the specified method name. The * parameter types (if any) default to java.lang.String. * * @param methodName Method name of the parent method to call * @param paramCount The number of parameters to collect, or * zero for a single argument from the body of this element. */ public CallMethodRule(String methodName, int paramCount) { this(0, methodName, paramCount); } /** * Process the start of this element. * * @param attributes The attribute list for this element */ public void begin(Attributes attributes) throws Exception { // Push an array to capture the parameter values if necessary if (paramCount > 0) { Object parameters[] = new Object[paramCount]; for (int i = 0; i < parameters.length; i++) { parameters[i] = null; } digester.pushParams(parameters); } }
    body方法如下,这个主要是设置了参数个数为0的,要用标签体内容做为参数
   /** * Process the body text of this element. * * @param bodyText The body text of this element */ public void body(String bodyText) throws Exception { if (paramCount == 0) { this.bodyText = bodyText.trim(); } }

    end方法如下:
   /** * Process the end of this element. */ public void end() throws Exception { // Retrieve or construct the parameter values array Object parameters[] = null; if (paramCount > 0) { parameters = (Object[]) digester.popParams(); if (digester.log.isTraceEnabled()) { for (int i=0,size=parameters.length;i<size;i++) { digester.log.trace("[CallMethodRule](" + i + ")" + parameters[i]) ; } } // In the case where the parameter for the method // is taken from an attribute, and that attribute // isn't actually defined in the source XML file, // skip the method call if (paramCount == 1 && parameters[0] == null) { return; } } else if (paramTypes != null && paramTypes.length != 0) { // In the case where the parameter for the method // is taken from the body text, but there is no // body text included in the source XML file, // skip the method call if (bodyText == null) { return; } parameters = new Object[1]; parameters[0] = bodyText; if (paramTypes.length == 0) { paramTypes = new Class[1]; paramTypes[0] = "abc".getClass(); } } // Construct the parameter values array we will need // We only do the conversion if the param value is a String and // the specified paramType is not String. Object paramValues[] = new Object[paramTypes.length]; for (int i = 0; i < paramTypes.length; i++) { // convert nulls and convert stringy parameters // for non-stringy param types if( parameters[i] == null || (parameters[i] instanceof String && !String.class.isAssignableFrom(paramTypes[i]))) { paramValues[i] = IntrospectionUtils.convert((String) parameters[i], paramTypes[i]); } else { paramValues[i] = parameters[i]; } } // Determine the target object for the method call Object target; if (targetOffset >= 0) { target = digester.peek(targetOffset); } else { target = digester.peek( digester.getCount() + targetOffset ); } if (target == null) { StringBuffer sb = new StringBuffer(); sb.append("[CallMethodRule]{"); sb.append(digester.match); sb.append("} Call target is null ("); sb.append("targetOffset="); sb.append(targetOffset); sb.append(",stackdepth="); sb.append(digester.getCount()); sb.append(")"); throw new org.xml.sax.SAXException(sb.toString()); } // Invoke the required method on the top object if (digester.log.isDebugEnabled()) { StringBuffer sb = new StringBuffer("[CallMethodRule]{"); sb.append(digester.match); sb.append("} Call "); sb.append(target.getClass().getName()); sb.append("."); sb.append(methodName); sb.append("("); for (int i = 0; i < paramValues.length; i++) { if (i > 0) { sb.append(","); } if (paramValues[i] == null) { sb.append("null"); } else { sb.append(paramValues[i].toString()); } sb.append("/"); if (paramTypes[i] == null) { sb.append("null"); } else { sb.append(paramTypes[i].getName()); } } sb.append(")"); digester.log.debug(sb.toString()); } Object result = IntrospectionUtils.callMethodN(target, methodName, paramValues, paramTypes); processMethodCallResult(result); }
    如果参数个数大于0,则使用栈顶的参数数组;如果个数为0,则新产生长度为1的参数数组,并将值设置为标签体内容,最后调用目标上(参数数组之前放入栈的对象)的相应方法.
有趣的地方有两点:
1.如果设置了个数大于0,则后续需要再加RULE设置参数的值,通过给出参数索引来对具体的参数赋值.
2.调用目标方法时是使用反射机制实现的,反射机制调用对象上方法刚好使用的是参数数组,与这个实现不谋而合
    与Filter一致,剩余的部分还有加入<filter-mapping>
5.设置Lintener的相关信息
digester.addCallMethod(prefix + "web-app/listener/listener-class", "addApplicationListener", 0);
        略过,后续再讲
6.设置jsp-config
digester.addRule(prefix + "web-app/jsp-config", jspConfig); digester.addCallMethod(prefix + "web-app/jsp-config/jsp-property-group/url-pattern", "addJspMapping", 0);
不太常用,略过
7.设置用户使用系统的角色及权限控制
   digester.addObjectCreate(prefix + "web-app/login-config", "org.apache.catalina.deploy.LoginConfig"); digester.addSetNext(prefix + "web-app/login-config", "setLoginConfig", "org.apache.catalina.deploy.LoginConfig"); digester.addCallMethod(prefix + "web-app/login-config/auth-method", "setAuthMethod", 0); digester.addCallMethod(prefix + "web-app/login-config/realm-name", "setRealmName", 0); digester.addCallMethod(prefix + "web-app/login-config/form-login-config/form-error-page", "setErrorPage", 0); digester.addCallMethod(prefix + "web-app/login-config/form-login-config/form-login-page", "setLoginPage", 0);
产生了LoginConfig类,并设置到StandardContext的loginConfig对象里
.....
     digester.addObjectCreate(prefix + "web-app/security-constraint", "org.apache.catalina.deploy.SecurityConstraint"); digester.addSetNext(prefix + "web-app/security-constraint", "addConstraint", "org.apache.catalina.deploy.SecurityConstraint"); digester.addRule(prefix + "web-app/security-constraint/auth-constraint", new SetAuthConstraintRule()); digester.addCallMethod(prefix + "web-app/security-constraint/auth-constraint/role-name", "addAuthRole", 0); digester.addCallMethod(prefix + "web-app/security-constraint/display-name", "setDisplayName", 0); digester.addCallMethod(prefix + "web-app/security-constraint/user-data-constraint/transport-guarantee", "setUserConstraint", 0); digester.addObjectCreate(prefix + "web-app/security-constraint/web-resource-collection", "org.apache.catalina.deploy.SecurityCollection"); digester.addSetNext(prefix + "web-app/security-constraint/web-resource-collection", "addCollection", "org.apache.catalina.deploy.SecurityCollection"); digester.addCallMethod(prefix + "web-app/security-constraint/web-resource-collection/http-method", "addMethod", 0); digester.addCallMethod(prefix + "web-app/security-constraint/web-resource-collection/url-pattern", "addPattern", 0); digester.addCallMethod(prefix + "web-app/security-constraint/web-resource-collection/web-resource-name", "setName", 0); digester.addCallMethod(prefix + "web-app/security-role/role-name", "addSecurityRole", 0);
产生了SecurityConstraint对象,设置到StandardContext的SecurityConstraint数组
产生了SecurityCollection对象,代表的是一组权限被保护的路径对象,它将被放入到SecurityConstraint所持有的SecurityCollection数组
6.设置将调用到的web service
    digester.addObjectCreate(prefix + "web-app/service-ref", "org.apache.catalina.deploy.ContextService"); digester.addRule(prefix + "web-app/service-ref", new SetNextNamingRule("addService", "org.apache.catalina.deploy.ContextService")); digester.addCallMethod(prefix + "web-app/service-ref/description", "setDescription", 0); digester.addCallMethod(prefix + "web-app/service-ref/display-name", "setDisplayname", 0); digester.addCallMethod(prefix + "web-app/service-ref/icon", "setIcon", 0); digester.addCallMethod(prefix + "web-app/service-ref/service-ref-name", "setName", 0); digester.addCallMethod(prefix + "web-app/service-ref/service-interface", "setType", 0); digester.addCallMethod(prefix + "web-app/service-ref/wsdl-file", "setWsdlfile", 0); digester.addCallMethod(prefix + "web-app/service-ref/jaxrpc-mapping-file", "setJaxrpcmappingfile", 0); digester.addRule(prefix + "web-app/service-ref/service-qname", new ServiceQnameRule()); digester.addRule(prefix + "web-app/service-ref/port-component-ref", new CallMethodMultiRule("addPortcomponent", 2, 1)); digester.addCallParam(prefix + "web-app/service-ref/port-component-ref/service-endpoint-interface", 0); digester.addRule(prefix + "web-app/service-ref/port-component-ref/port-component-link", new CallParamMultiRule(1)); digester.addObjectCreate(prefix + "web-app/service-ref/handler", "org.apache.catalina.deploy.ContextHandler"); digester.addRule(prefix + "web-app/service-ref/handler", new SetNextRule("addHandler", "org.apache.catalina.deploy.ContextHandler")); digester.addCallMethod(prefix + "web-app/service-ref/handler/handler-name", "setName", 0); digester.addCallMethod(prefix + "web-app/service-ref/handler/handler-class", "setHandlerclass", 0); digester.addCallMethod(prefix + "web-app/service-ref/handler/init-param", "setProperty", 2); digester.addCallParam(prefix + "web-app/service-ref/handler/init-param/param-name", 0); digester.addCallParam(prefix + "web-app/service-ref/handler/init-param/param-value", 1); digester.addRule(prefix + "web-app/service-ref/handler/soap-header", new SoapHeaderRule()); digester.addCallMethod(prefix + "web-app/service-ref/handler/soap-role", "addSoapRole", 0); digester.addCallMethod(prefix + "web-app/service-ref/handler/port-name", "addPortName", 0);
7.servlet的设置
    digester.addRule(prefix + "web-app/servlet", new WrapperCreateRule()); digester.addSetNext(prefix + "web-app/servlet", "addChild", "org.apache.catalina.Container"); digester.addCallMethod(prefix + "web-app/servlet/init-param", "addInitParameter", 2); digester.addCallParam(prefix + "web-app/servlet/init-param/param-name", 0); digester.addCallParam(prefix + "web-app/servlet/init-param/param-value", 1); digester.addCallMethod(prefix + "web-app/servlet/jsp-file", "setJspFile", 0); digester.addCallMethod(prefix + "web-app/servlet/load-on-startup", "setLoadOnStartupString", 0); digester.addCallMethod(prefix + "web-app/servlet/run-as/role-name", "setRunAs", 0); digester.addRule(prefix + "web-app/servlet/security-role-ref", new SecurityRoleRefCreateRule()); digester.addCallMethod( prefix + "web-app/servlet/security-role-ref/role-link", "setLink", 0); digester.addCallMethod( prefix + "web-app/servlet/security-role-ref/role-name", "setName", 0); digester.addCallMethod(prefix + "web-app/servlet/servlet-class", "setServletClass", 0); digester.addCallMethod(prefix + "web-app/servlet/servlet-name", "setName", 0); digester.addRule(prefix + "web-app/servlet-mapping", new CallMethodMultiRule("addServletMapping", 2, 0)); digester.addCallParam(prefix + "web-app/servlet-mapping/servlet-name", 1); digester.addRule(prefix + "web-app/servlet-mapping/url-pattern", new CallParamMultiRule(0));
WrapperCreateRule将调用context.createWrapper方法,该方法将产生StandardWrapper对象,并为其设置应有的监听器,该类构造器如下:
       /** * Create a new StandardWrapper component with the default basic Valve. */ public StandardWrapper() { super(); swValve=new StandardWrapperValve(); pipeline.setBasic(swValve); broadcaster = new NotificationBroadcasterSupport(); if (restrictedServlets == null) { restrictedServlets = new Properties(); try { InputStream is = this.getClass().getClassLoader().getResourceAsStream ("org/apache/catalina/core/RestrictedServlets.properties"); if (is != null) { restrictedServlets.load(is); } else { log.error(sm.getString("standardWrapper.restrictedServletsResource")); } } catch (IOException e) { log.error(sm.getString("standardWrapper.restrictedServletsResource"), e); } } }
之后有调用StandardWrapper.addInitParameter加入初始化参数,设置jspFile,load-on-startup,run-as,servlet-class
接着将调用StandardContext.addServletMapping设置servletMapping,该方法如下:
   /** * Add a new servlet mapping, replacing any existing mapping for * the specified pattern. * * @param pattern URL pattern to be mapped * @param name Name of the corresponding servlet to execute * @param jspWildCard true if name identifies the JspServlet * and pattern contains a wildcard; false otherwise * * @exception IllegalArgumentException if the specified servlet name * is not known to this Context */ public void addServletMapping(String pattern, String name, boolean jspWildCard) { // Validate the proposed mapping if (findChild(name) == null) throw new IllegalArgumentException (sm.getString("standardContext.servletMap.name", name)); pattern = adjustURLPattern(RequestUtil.URLDecode(pattern)); if (!validateURLPattern(pattern)) throw new IllegalArgumentException (sm.getString("standardContext.servletMap.pattern", pattern)); // Add this mapping to our registered set synchronized (servletMappingsLock) { String name2 = (String) servletMappings.get(pattern); if (name2 != null) { // Don't allow more than one servlet on the same pattern Wrapper wrapper = (Wrapper) findChild(name2); wrapper.removeMapping(pattern); mapper.removeWrapper(pattern); } servletMappings.put(pattern, name); } Wrapper wrapper = (Wrapper) findChild(name); wrapper.addMapping(pattern); // Update context mapper mapper.addWrapper(pattern, wrapper, jspWildCard); fireContainerEvent("addServletMapping", pattern); }
    参数name即为所配置的servlet-name,首先校验一下该servlet是否进行了配置findChild(name),没有进行配置则直接退出,接着对配置的url-pattern进行一些转义,接着一段查看是否该pattern已有对应的servlet配置,如果有的话只让最新的servlet对应该pattern,// Don't allow more than one servlet on the same pattern
    调用wrapper.addMapping(String pattern),再更新Context的Mapper,该对象将用于与客户端请求进行匹配来确定由哪一个servlet处理该请求.addMapping方法如下:
    public void addWrapper(String path, Object wrapper, boolean jspWildCard) { addWrapper(context, path, wrapper, jspWildCard); }
        最令人难以忘怀的是这里的context并不是前面的StandardContext实例,而是一个Mapper类挂有的一个对象属性,被雷到,我们再看一下这个方法里面
        /** * Adds a wrapper to the given context. * * @param context The context to which to add the wrapper * @param path Wrapper mapping * @param wrapper The Wrapper object * @param jspWildCard true if the wrapper corresponds to the JspServlet * and the mapping path contains a wildcard; false otherwise */ protected void addWrapper(Context context, String path, Object wrapper, boolean jspWildCard) { synchronized (context) { Wrapper newWrapper = new Wrapper(); newWrapper.object = wrapper; newWrapper.jspWildCard = jspWildCard; if (path.endsWith("/*")) { // Wildcard wrapper newWrapper.name = path.substring(0, path.length() - 2); Wrapper[] oldWrappers = context.wildcardWrappers; Wrapper[] newWrappers = new Wrapper[oldWrappers.length + 1]; if (insertMap(oldWrappers, newWrappers, newWrapper)) { context.wildcardWrappers = newWrappers; int slashCount = slashCount(newWrapper.name); if (slashCount > context.nesting) { context.nesting = slashCount; } } } else if (path.startsWith("*.")) { // Extension wrapper newWrapper.name = path.substring(2); Wrapper[] oldWrappers = context.extensionWrappers; Wrapper[] newWrappers = new Wrapper[oldWrappers.length + 1]; if (insertMap(oldWrappers, newWrappers, newWrapper)) { context.extensionWrappers = newWrappers; } } else if (path.equals("/")) { // Default wrapper newWrapper.name = ""; context.defaultWrapper = newWrapper; } else { // Exact wrapper newWrapper.name = path; Wrapper[] oldWrappers = context.exactWrappers; Wrapper[] newWrappers = new Wrapper[oldWrappers.length + 1]; if (insertMap(oldWrappers, newWrappers, newWrapper)) { context.exactWrappers = newWrappers; } } } }
    new Wrapper()语句实例化的竟然不是如StandardWrapper,而是一个Mapper内部类,又被雷到;为何要在Mapper类里新增这么两个名字与前面对象父类一样的名字,除了扰乱别人的视线外是否还有其它意图,暂不得其解啊,可能需要我们后续在讲如何查找客户请求所对应的servlet才能搞明白吧:)
最后调用addChild将产生的StandardWrapper对象加入到StandardContext里