webx关键class

（1）MappingRuleService

负责映射关系转换，包括将url转化为target或target转化为url，target映射为模块等

（2）ExtensionMappingRule
1.作用
将url转化为target，或将target转换为url

2.原理
使用web-component-and-root定义的转换规则，对url进行转换

输入规则定义：

<mapping-rules:extension-rule id="extension.input">
<!-- 默认后缀 -->
<mapping extension="" to="" />

<!-- JSP -->
<mapping extension="jhtml" to="" />
<mapping extension="jsp" to="" />
<mapping extension="jspx" to="" />
<mapping extension="php" to="" />

<!-- Velocity -->
<mapping extension="htm" to="" />
<mapping extension="vhtml" to="" />
<mapping extension="vm" to="" />
</mapping-rules:extension-rule>

输出规则定义：

<mapping-rules:extension-rule id="extension.output">
<!-- 默认后缀 -->
<mapping extension="" to="htm" />

<!-- JSP -->
<mapping extension="jhtml" to="jhtml" />
<mapping extension="jsp" to="jhtml" />
<mapping extension="jspx" to="jhtml" />
<mapping extension="php" to="jhtml" />

<!-- Velocity -->
<mapping extension="htm" to="htm" />
<mapping extension="vhtml" to="htm" />
<mapping extension="vm" to="htm" />
</mapping-rules:extension-rule>

其中id表示不同的类型，比如extension.input表示输入，extension.output表示输出

子标签中的extension表示源后缀，to表示目标后缀

转换源码：

public String doMapping(String name) {
FileNameAndExtension names = getFileNameAndExtension(name, true);
String extension = names.getExtension(); // 可能为null

if (extension == null) {
extension = EMPTY_STRING;
} else {
extension = extension.toLowerCase();
}

// 如果映射规则存在，则替换后缀
if (extensionMappings.containsKey(extension)) {
String mapToExtension = extensionMappings.get(extension);

name = names.getFileName(); // 总不为null

// 如果以/结尾，就不加后缀。
if (name.length() == 0 || !StringUtil.contains(NAME_SEPARATOR, name.charAt(name.length() - 1))) {
// 如果获取的映射后缀不为空，则加上后缀
if (!StringUtil.isEmpty(mapToExtension)) {
name = name + EXTENSION_SEPARATOR + mapToExtension;
}
}
} else {
// 当后缀不在映射规则中，且后缀为空，则至返回除了后缀前面的部分
if (StringUtil.isEmpty(extension)) {
name = names.getFileName();
}
}

return name;
}

（3）DirectModuleMappingRule
1.作用
将target映射到module
比如http://localhost:8081/simple/say_hi.do，对应的target是simple/sayHi，对应到代码中就是simple->SayHi.java

2.原理
将url中的‘/’替换成‘.’，并去除后缀名即可

配置信息

<mapping-rules:direct-module-rule id="screen.notemplate" />

源码：

public String doMapping(String name) {
String[] parts = StringUtil.split(name, NAME_SEPARATOR); //使用/来分割

if (ArrayUtil.isEmptyArray(parts)) {
return throwInvalidNameException(name);
}

parts[parts.length - 1] = normalizeClassName(parts[parts.length - 1]); //肯定最后一个才有后缀，去掉

if (parts[parts.length - 1] == null) {
return throwInvalidNameException(name);
}

return StringUtil.join(parts, MODULE_NAME_SEPARATOR); //用.来拼接
}

（4）FallbackModuleMappingRule
1.作用
与DirectModuleMappingRule相同，将target转化为module，只是如果找不到就会层层向上找，如果最终没找到，就返回模块中第一个class

2.原理
配置如下：

<mapping-rules:direct-template-rule id="screen.template" templatePrefix="screen" />

调用module loader service检查模块是否存在，如果不存在，就查找上一级模块，一直找直至根目录

如果一直找不到，则返回第一个类名

源码如下：

public String doMapping(String name) {
FallbackIterator iter = new FallbackModuleIterator(name, defaultName, matchLastName);

String moduleName = null;
String firstModuleName = iter.getNext(); // 保存第一个精确的类，万一找不到，就返回这个值

while (iter.hasNext()) {
moduleName = iter.next();

log.debug("Looking for module: " + moduleName);

try {
if (getModuleLoaderService().getModuleQuiet(getModuleType(), moduleName) != null) {
return moduleName;
} // else 继续查找
} catch (ModuleLoaderException e) {
throw new MappingRuleException(e);
}
}

return firstModuleName;
}

（5）TemplateMappingRule
1.作用
将target映射到template
webx中我们采用模板引擎来渲染html输出。为了定位模板名，我们需要定义target到template路径的映射，这就是TemplateMapping的作用

2.原理
与module查询完全相同，也是分为直接查找和fallback查找

<mapping-rules:direct-template-rule id="screen.template" templatePrefix="screen" />

<mapping-rules:fallback-template-rule id="layout.template" templatePrefix="layout" />

（6）注意
1.对于target映射module，使用哪种映射方式是根据valve来确定的

<when>
<!-- 执行带模板的screen，默认有layout。 -->
<pl-conditions:target-extension-condition extension="null" />
<pl-valves:performAction />
<pl-valves:performTemplateScreen />
<pl-valves:renderTemplate />
</when>
<when>
<!-- 执行不带模板的screen，无layout。 -->
<pl-conditions:target-extension-condition extension="do" />
<pl-valves:performAction />
<pl-valves:performScreen />
</when>

第一种的valve是PerformTemplateScreenValve，而获得模块名称传递的参数如下：

protected String getModuleName(String target) {
return getMappingRuleService().getMappedName(SCREEN_MODULE, target);
}

传递的是screen，正好与webx-component-and-root.xml中定义的

<mapping-rules:fallback-module-rule id="screen" moduleType="screen" />

一致，因而使用的是FallbackModuleMappingRule

而第二种的valve是PerformScreenValve，而获得模块名称传递的参数如下：

protected String getModuleName(String target) {
return mappingRuleService.getMappedName(SCREEN_MODULE_NO_TEMPLATE, target);
}

传递的是screen.notemplate，正好与webx-component-and-root.xml中定义的

<mapping-rules:direct-module-rule id="screen.notemplate" />

一致，因而使用的是DirectModuleMappingRule

2.cache

设置每种映射是否启用缓存，启用之后可以减少模板查找的开销，提高映射效率

开启方法：

<direct-module-rule id="direct.module" cacheEnabled="${cacheEnabled:false}" />