Webx示例-PetStore分析1

1. 下载源码

2. 启动容器，加载组件--WebxContextLoaderListener

WebxContextLoaderListener继承自org.springframework.web.context.ContextLoaderListener。它覆盖了一个方法：createContextLoader()，该方法返回一个ContextLoader对象，即上下文加载器。方法的实现采用了匿名内部类方式，返回WebxComponentsLoader的匿名子类，该子类覆盖了一个方法：getDefaultContextClass()。

WebxContextLoaderListener继承了父类ContextLoaderListener中的方法contextInitialized()，该方法内部调用了被覆盖过的方法createContextLoader()，并使用该方法返回的WebxComponentsLoader对象调用org.springframework.web.context.ContextLoader的initWebApplicationContext()方法。

WebxComponentsLoader中的initWebApplicationContext方法除了保存servletContext对象，调用了init()之后，调用父类ContextLoader的同名方法。

默认使用WebxComponentsContext类作为实际启动Spring容器的ApplicationContext。它派生自WebxApplicationContext类。org.springframework.web.context.support.XmlWebApplicationContext的后代。

WebxComponentsLoader.createComponents方法代码很长，但是做的事情只有一件：创建Webx组件

Webx中的组件是一组相关功能的集合，本质上是一个WebApplicationContext。

组件的来源有两个：

•自动扫描WEB-INF目录下的配置文件生成

•webx.xml中指定

将两种方式获取到的组件名集合取并集，就是最终将要处理的组件名集合。注意，在webx.xml中指定的组件名，其配置文件的名字也是webx-*.xml的形式，并不能随意指定。

•自动扫描是可以关掉的，这个时候，只能通过配置的方式来获取组件

•组件的componentPath属性只能通过webx.xml设定

自动扫描是这样工作的：扫描WEB-INF目录下所有匹配webx-*.xml的文件，其中*所代替的字符串为组件名。例如，WEB-INF下有一个名为webx-home.xml的文件，那么它代表一个名为home的组件。

3. 加载其他配置文件

4. 配置服务

RequestContexts服务

详细讲解可参考官方指南第7，8章。http://openwebx.org/docs/requestcontexts.html

upload服务

pull服务

pull service就相当于提供工具类，可以将工具定义成java类，而能够在vm模板中调用

module-loader服务

Module是一段可编程、可执行的逻辑，它由Module接口标识。Module接口只有一个execute方法：

 void execute() throws Exception 

实现自定义的Module只需实现Module接口并在execute()方法中实现自定的执行逻辑。在调用方，通过Module接口调用execute()方法触发Module的执行。

ModuleLoaderService是定义、查找Modules的服务。它通过扫描特定的包或者特定类来加载类，并将加载到的类适配为可执行的Module。ModuleLoaderService中的每个Module都有moduleType和moduleName这两个用来表示Module的信息。可以根据这两个信息，通过ModuleLoaderService提供的查找接口从ModuleLoaderService中查找所需的Module。

ModuleLoaderService有两个重要组件，ModuleFactory和ModuleAdapterFactory。前者用于根据特定的条件扫描并加载module (可以是非Java语言编写)；后者则用于将加载到的module转换成可执行的Module(实现Module接口)。因为ModuleFactory加载的module未必都实现了Module接口；即使实现了Module接口，该接口也只有一个无参数的方法，限制了Module的灵活性。所以，!ModuleAdapterFactory通过适配器的机制将未实现Module接口但满足一定条件的module转换为实现了Module接口的Adapter，同时保持原来的处理逻辑不变。

在webx体系中，Module承担了用户提交数据的接收、处理；请求的控制与转发；处理结果的展示等重要功能。Webx缺省定义了三种类型的Module：

• action：主要用于处理用户提交的数据，以及请求的控制与转发；
• screen：主要用于处理页面的主体内容；
• control：主要用于处理页面的部分内容，特别是可重用的内容。

其中，screen和control可以与模板文件配合共同完成页面的展示，也可以脱离模板而独立输出页面。

除了action、screen和control，ModuleLoaderService也支持方便的定义其他类型的Module。

ModuleFactory接口根据特定的条件扫描并加载类，webx为该接口提供了两个实现：ClassModuleFactory和ScriptModuleFactory。前者用于加载Java编写的module，而后者用于加载用动态语言(如groovy)编写的module。

ModuleAdapterFactory接口用于将加载到的module转换成可执行的Module，DataBindingAdapterFactory和ActionEventAdapterFactory是该接口的两个实现。DataBindingAdapterFactory对所有具有名为execute的方法的module（可以不实现Module接口，同时execute方法的参数也可以任意定义）进行适配，生成DataBindingAdapter；而ActionEventAdapterFactory则对类型为“action”的module进行适配，生成ActionEventAdapter。DataBindingAdapter和ActionEventAdapter都实现了Module接口。DataBindingAdapter只代理了原有module的名为execute的public方法，执行时候直接调用该方法；而ActionEventAdapter则代理了所有以do开头的public方法(例如doAdd())，执行时根据请求参数的值调用相应的方法。

<services:module-loader>是根据SpringExt机制定义的专门用于定义ModuleLoaderService的元素，其有两个属性：

• cacheEnabled：是否缓存Module；如果使用缓存，则查找Module时先从缓存中查找，当缓存中不存在时才从ModuleFactory中查找；如果不使用缓存则直接从ModuleFactory中查找。生产中建议开启Module缓存以提高Module查找性能；

• includeDefaultAdapters：是否使用webx默认实现的ModuleAdapterFactory，包括：DataBindingAdapterFactory、ActionEventAdapterFactory和Webx2ModuleAdapterFactory，如果将这个属性的值设为true，则默认会在moduleLoaderService中加载这几个AdapterFactory而不需要再额外的配置；

<services:module-loader>元素也可以包含子元素，其子元素可以分为两种类型：配置ModuleFactory的子元素和配置ModuleAdapterFactory的子元素。配置ModuleFactory的子元素有：

• <ml-factories:class-modules>：配置查找classes生成Module的ClassModuleFactory；

• <ml-factories:script-modules>：配置查找script生成Module的ScriptModuleFactory；

• <ml-factories:factory >：ClassModuleFactory和ScriptModuleFactory是webx提供的ModuleFactory实现，也可以扩展自定义的ModuleFactory，然后采用<ml-factories:factory >元素配置，其属性与spring提供的<bean>元素相同；

配置ModuleAdapterFactory的子元素也有多个：

• <ml-adapters:data-binding-adapter/>：配置DataBindingAdapterFactory；

• <ml-adapters:action-event-adapter/>：配置ActionEventAdapterFactory；

• <ml-adapters:adapter>：与ModuleFactory类似，也可以对ModuleAdapterFactory进行扩展实现自定义的ModuleAdapterFactory，<ml-adapters:adapter>用于配置自定义的ModuleAdapterFactory。

当设置<services:module-loader>的includeDefaultAdapters=" true"时，会自动为ModuleLoaderService加载DataBindingAdapterFactory、ActionEventAdapterFactory，所以可以不需要再用<ml-adapters:data-binding-adapter/>和<ml-adapters:action-event-adapter/>另外配置。

参考资料

http://code.taobao.org/p/webx/wiki/module_load_service/

http://www.atatech.org/articles/55937