Webx3-介绍和开发实战

Webx2 特点
    Webx2 架构比较复杂
    两套容器混合 – Service容器&Spring容器
    跨容器注入难度大
    Xml 配置较为复杂
    开发较为复杂，难度较大
    简化架构
    简化Web 容器, 去掉 Service 容器
    敏捷开发
    减少机械和粘合代码
    降低开发复杂度
    简化容器Xml配置
    兼容性
    对网站向后兼容，改良式升级
    中文站，国际站，淘宝



二、Webx3总体架构


WEBX 3.0简介
What’s New?
主流化
基于Java5，框架本身支持Generic、Annotations
基于Spring框架
基于POJO/依赖注入编程
增强特性
基于XML Schema的配置文件
使Spring配置文件易读、易写
以组件的思维来扩展系统
生产模式/开发模式
保留Webx2中的优点
页面驱动
先建模板、再建程序
模板中“按需”取得工具对象（pull tools）
约定胜于配置
基于规则展示页面
screen/layout/control

比较：
Spring context成为一等公民，取消Service框架
Context结构完全同Spring MVC，两层结构，大为简化
子容器中的bean可取得root context中的对象
在Spring context中创建webx2 service context adapters，完全兼容webx2
取消Singleton Service Context，以root context取代其职责。
Adapter将所有对Singleton Service Context的调用全部转向root context。



Webx3架构变化总揽



三、Webx3 快速入门
Webx3 核心开发概念

1  Model
    基本类型：String,int,long
    复合类型: JavaBean
    集合类型: List, Array
2. View
    模板 Velocity
    Layout
3. Controller
    Screen/Action/Ctronol
    映射规则同 Webx2.x



代码篇:

1. 绑定环境变量
    void doGetRundata(TurbineRunData rundata)
    void doGetNavigator(Navigator nav)
    void doGetContext(Context context)
    void doGetRequestContext(RequestContext requestContext)
2.绑定Query参数
  基本类型及数组
  JavaBean及数组
    void doGetInt(@Param("aaa") int i)
    void doGetIntDefault(@Param(name = "aaa", defaultValue = "123") Integer i)
    void doGetIntArray(@Param("aaa") int[] i)
    void doGetIntegerArrayDefault(@Param(name = "aaa", defaultValues = { "123", "456" }) Integer[] i)
    void doGetIntegerList(@Param("aaa") List<Integer> i)
3.绑定FromService
    基本类型及数组
    JavaBean及数组
    校验失败是否不进入
    3.1 Form
        void doGetFormDefaultAnnotation(@FormData Form form)
        void doGetFormDontSkipAction(@FormData(skipIfInvalid = false) Form form)
    3.2 Group
        void doGetGroup(@FormGroup("myGroup1") Group group)
        void doGetGroupInstanceBean(@FormGroup(name = "myGroup1", instanceKey = "aaa") MyData data)
        void doGetGroupsBeansDontSkipAction(@FormGroups(name = “myGroup1”,skipIfInvalid = false),  Collection<MyData> data)
    3.3 Field
        void doGetField(@FormField(name = "field1", group = "myGroup1") Field field)




四、Webx3 架构新特性
配置篇
统一Spring容器
    只用 Spring 配置文件
     webx.xml
     pipeline.xml
     webx-*.xml
     uris.xml
    …
组件
    WebxContextLoaderListener
    装载/WEB-INF/webx.xml, /WEB-INF/webx-*.xml
    WebxFrameworkFilter
    拦截request，以便被webx容器处理
    LogConfiguratorListener
    初始化日志系统
服务Bean
    services:resource-loading
    services:request-contexts
    services:mapping-rules
    services:template
    services:pull
    services:data-resolver
    services:pipeline
    services:uris
Webx3 配置文件对比


Webx3 服务配置
1 RequestContext
<!-- 设置request/response/session。 -->
<services:request-contexts
    xmlns="http://www.alibaba.com/schema/services/request-contexts">
        <buffered />
        <lazy-commit />
        <parser />
        <set-locale defaultLocale="zh_CN" defaultCharset="UTF-8" />
        <session>
            <id>
                <cookie path="/" maxAge="0" httpOnly="true" />
            </id>
            <stores>
                <session-stores:cookie-store id="temporaryCookie">
                    <session-stores:cookie name="tmp" />
                </session-stores:cookie-store>
            </stores>
            <store-mappings>
                <match name="*" store="temporaryCookie" />
            </store-mappings>
        </session>
</services:request-contexts>
2 PipeLine.xml
<services:pipeline xmlns=http://www.alibaba.com/schema/services/pipeline/valves>
        <!-- 初始化turbine rundata，并在pipelineContext中设置可能会用到的对象(如rundata、utils)，以便valve取得。 -->
        <prepareForTurbine />
        <!-- 预备webx所需的对象。 -->
        <prepareForWebx2 />
        <setLoggingContext />
        <!-- 分析URL，取得target。 -->
        <analyzeURL homepage="homepage" />
        <checkCsrfToken />
         <loop>
               … Valve
         </loop>
    </services:pipeline>
<services:pipeline xmlns=http://www.alibaba.com/schema/services/pipeline/valves>
    ………
    <loop>
            <choose>
                <when>
<pl-conditions:target-extension-condition extension="null, vm, jsp" />
                    <performAction />
                    <performTemplateScreen />
                    <renderTemplate />
                </when> 
                <when>
                   <pl-co ditions:target-extension-condition extension="do" />
                    <performAction />
                    <performScreen />
                </when>
                <otherwise>
                    <!-- 将控制交还给servlet engine。 -->
                    <exit />
                </otherwise>
            </choose>
         <breakUnlessTargetRedirected />
        </loop>
    </services:pipeline>
3 ModuleLoader
<!-- 装载模块。 -->
    <services:module-loader>
        <ml-factories:class-modules>
            <ml-factories:search-packages type="$1"
                packages="com.alibaba.sample.petstore.web.admin.module.*"
                includeAbstractClasses="true" />
       </ml-factories:class-modules>
        <ml-adapters:webx2-module-adapter />
    </services:module-loader>
4 PullService
<services:pull xmlns="http://www.alibaba.com/schema/services/pull/tools">
        <!-- 全局tools。 -->
        <services:tools>
            <!-- Webx3 tools。 -->
            <utils />
            <rundata-tool />
            <csrfToken />
        </services:tools>
        <!-- 每个request都会创建一次的tools。 -->
        <services:tools scope="request">
            <!-- Webx3 tools。 -->
            <control-tool />
            <!-- Webx2 tools。 -->
            <webx2-tool id="form" class="com.alibaba.service.form.FormTool" />
            <webx2-tool id="uri" class="com.alibaba.service.uribroker.URIBrokerTool" />
        </services:tools>
        <!-- 每个request都会创建一次的tools，但components之间共享同一个实例。 -->
        <services:tools scope="request" shareWithComponents="true">
            <!-- Webx3 tools。 -->
            <page-tool />
        </services:tools>
    </services:pull>
5  MappingRule
<services:mapping-rules xmlns="http://www.alibaba.com/schema/services/mapping-rules">
       <direct-module-rule id="action" />
        <!-- Target name => Screen module name (*.do) -->
        <direct-module-rule id="screen.notemplate" />
        <!-- Target name => Screen module name (*.jsp, *.vm) -->
        <fallback-module-rule id="screen" moduleType="screen" />
        <!-- Target name => Screen template name -->
        <direct-template-rule id="screen.template" templatePrefix="screen" />
        <!-- Target name => Layout template name -->
        <fallback-template-rule id="layout.template" templatePrefix="layout" />
        <!-- Target name => Control module name (setControl method) -->
        <direct-module-rule id="control.notemplate" />
        <fallback-module-rule id="control" moduleType="control" />
        <direct-template-rule id="control.template" templatePrefix="control" />
    </services:mapping-rules>
6 DataResolver
<!-- 支持注入参数，可以在这里扩展自己的参数绑定器 -->
    <services:data-resolver xmlns="http://www.alibaba.com/schema/services/data-resolver/factories">
        <turbine-rundata-resolver />
        <parameter-resolver />
        <form-resolver />
    </services:data-resolver>
7 Form
<services:form>
        <services:group name="addProduct">
            <services:field name="productId" displayName="产品ID">
                <required-validator>
                    <message>必须填写${displayName}</message>
                </required-validator>
                <custom-error id="duplicatedProductId">
                    <message>产品ID和已有产品冲突</message>
                </custom-error>
            </services:field>
          services:field name="picture" displayName="产品图片">
                <required-validator>
                    <message>必须上传产品图片</message>
                </required-validator>
                <uploaded-file-validator
                    contentType="image/gif, image/jpeg, image/pjpeg, image/jpg, image/png">
                    <message>${displayName}不是合法的图片文件</message>
                </uploaded-file-validator>
                <uploaded-file-validator maxSize="100K">
                    <message>${displayName}不能超过${maxSize}字节</message>
                </uploaded-file-validator>
            </services:field>
        </services:group>
    </services:form>
8 Rewrite
<services:request-contexts id="rewrite" sort="false">
  <parser />
    <rewrite>
    <!-- 永久重定向，301   -->
    <rule pattern="/test1/hello.htm">
    <substitution uri="/test1/new_hello.htm" flags="L,R=301" />
    </rule>
    <!-- 临时重定向，302，不保留参数   -->
    <rule pattern="/test2/hello.htm">
    <substitution uri="/test2/new_hello.htm" flags="L,R" />
    </rule>
    <!-- 临时重定向，302，保留参数   -->
    <rule pattern="/test2.4/hello.htm">
    <substitution uri="/test2.4/new_hello.htm" flags="L,R,QSA" />
    </rule>
Webx2.0/2.5 应用基本迁移步骤
1.Webx2/2.5  Webx3迁移指南
2.按指南修改基础配置
3.对应用回归测试
4.修改，重复 步骤3
5.发布应用
9 兼容2.0 Service
重要：
   对于中文站，国际站自己扩展的 Webx2.0 Service，可以按下面的方式移植：
<!-- Webx2兼容设置, 直接将旧配置copy过来即可 -->
    <services:webx2-instance-context xmlns="http://www.alibaba.com/schema/webx2-services">
        <services>
            <service name="PageAuthorizationService"
                class="com.alibaba.sample.petstore.DefaultPageAuthorizationService">
                <property name="access.descriptors">
                    <value>/petstore/${component}/access.xml</value>
                </property>
            </service>
        </services>
    </services:webx2-instance-context>
10 兼容2.0 Valve
重要：
   对于中文站，国际站自己扩展的 Webx2.0 PipeLine Valve，可以按下面的方式移植：
<!-- Webx2兼容设置, 直接将旧配置copy过来即可 -->
<beans:beans>
<services:pipeline xmlns=“http://www.alibaba.com/schema/services/pipeline/valves”>        
    <webx2-valve class=
           “com.alibaba.sample.petstore.web.common.auth.PageAuthorizationValve”/>
   </services:pipeline>
</beans:beans>

Spring-schema的扩展



1. Spring定义了三种接口，用来将Schema所描述的XML文件转换成
    Spring beans
    Bean Definition Parser
    Bean Definition Decorator
    Bean Definition Decorator for Attribute
    NamespaceHandler
         将XML NS和上述parsers/decorators关联起来；
         Webx 3 实现了此接口，做成了一套及其灵活的schema扩展机制。
2   扩展点（配置点，Configuration Point）
       Webx3定义了一个顶级的扩展点：services，
       Namespace为：“http://www.alibaba.com/schema/services"。
3.  捐献（Contribution）
    对指定扩展点的扩展，例如：“Velocity Engine”
    每个Contribution必须对应一个schema。
    每个Contribution必须对应一个bean definition parser
4.  组件
     可以捐献给指定的扩展点