AppFuse学习笔记-控制层

1. 我们先详细介绍一下 Struts的控制器的工作流程。
    首先，控制器（ActionServlet）进行初始化工作，读取配置文件struts-config.xml，为不同的Struts模块初始化相应的ModuleConfig对象。相应地有ControlConfig集合、FormBeanConfig集合、ForwardConfig集合和MessageResourcesConfig集合等。
    AppFuse中设计了一个继承ActionServlet 的子类：LoginServlet做为控制器，对ActionServlet的功能进行了扩展。主要的功能是对本系统使用到的一些组件进行初始化工作，如用户身份的安全校验url、密码加密规则等。
    控制器接收到HTTP请求，并从ActionConfig中找出对应于该请求的Action子类，如果没有对应的Action，控制器直接将请求转发给JSP或者静态页面。否则控制器将请求分发至具体Action类进行处理。
    在控制器调用具体Action的方法之前，相应的ActionForm对象将利用HTTP请求中的参数来填充自己。此外，若所操作的ActionForm类配置了validate，系统会调用validate组件来检查请求参数的合法性，并且返回一个包含所有错误信息的ActionErrors对象。如果执行成功，ActionForm自动将这些参数信息以FormBean的方式保存在Servlet Context中，这样它们就可以被其它Action对象或者JSP调用。
    执行完成Action中的方法之后，返回一个ActionForward对象，控制器通过该ActionForward对象来进行转发工作。

    AppFuse实现的最主要的功能是对用户的管理。下面就以对用户的管理来说明一下AppFuse控制器的实现。

    与用户信息表单数据相关的FormBean是UserForm。UserForm用来存放用户的基本信息。
    UserForm的控制器是org.appfuse.webapp.action.UserAction。UserAction继承了BaseAction。BaseAction也是系统中几乎所有Action类的父类，它继承自Struts提供的DispatchAction，并提供了控制层通用的方法。

2. Action
Action是用户请求和业务逻辑之间的桥梁，每个Action充当客户的一项业务代理。主要完成以下任务：
    1. 接收用户请求。
    2. 根据用户请求，调用合适的模型组件来执行相应的业务逻辑。
    3. 获取业务逻辑执行结果
    4. 根据当前状态以及业务逻辑执行结果，选择合适的视图组件返回给用户。

3. DispatchAction
    org.apache.struts.actions.DispatchAction是org.apache.struts.action.Action的子类。
    Action的execute()方法是调用模型的业务方法，完成用户请求的业务逻辑，然后根据执行结果把请求转发给其它合适的Web组件。通常，在一个Action类中只能完成一种业务操作（通过execute()方法）。
    DispatchAction允许用户将完成一个业务逻辑所需要的连续动作和相关动作集中于一个Action类中。无须覆盖execute()方法，而是可以创建一些实现实际业务操作的方法，用户通过method请求参数指定所需要使用的方法。

4. BaseAction
    BaseAction中实现了系统中Action子类需要用到的通用方法，主要有：
    1. public Object getBean(String name):通过读取Spring的applicationContext-service.xml配置文件来创建实例从而实现“依赖注入”的方法。
    2. public ActionMessages getMessages(HttpServletRequest request)：初始化Struts的ActionMessages，并返回。
    3. protected Object convert(Object o) ：POJO与FormBean之间的转换方法。
    4. execute()：置换了原始的execute()方法。作用是根据请求的url寻找相关的业务方法（没有method请求参数时）。例如请求的页面是editUser.html,则执行edit()方法。
    5. protected ActionForm getActionForm(ActionMapping mapping, HttpServletRequest request)：在mapping范围内得到一个Action FormBean。
    6. protected User getUser(HttpSession session) ：从Session中拿到当前登录用户信息。
    7. protected void updateFormBean(ActionMapping mapping, HttpServletRequest request, ActionForm form)：在指定的范围内更新当前Action 所对应的Form Bean对象。
    8. protected void removeFormBean(ActionMapping mapping, HttpServletRequest request)：去除无用的Form Bean。

5. UserAction
    UserAction是用户数据管理的控制器，提供了对用户数据的添加、修改、删除、查询等操作的控制，其包含的业务方法有：
    1. add()：进入添加用户页面。
    2. cancel()：当用户在表单中点击“取消”按钮时，执行该方法。如果用户是通过用户列表进入该表单，即当前用于拥有管理其它用户的权限，返回到用户列表，否则返回到主页面。
    3. delete()：根据请求的用户ID调用业务层的removeUser ()方法删除相应的记录，返回到用户列表。
    4. edit()：首先校验用户请求的URL是否为editProfile.html，若是，表示当前登录用户要查看自己的信息，此时请求路径中不应该含有用户ID（用户ID从Session中取得）或用于标识请求是通过用户列表的from参数，如果含有这两个参数，发出“无权限”的错误信息。若不是，表示当前用户是通过用户列表进行请求。根据请求的用户ID调用业务层的getUser ()方法取得相应的记录。更新相应的FormBean。
    5. save()：当需要要添加或修改用户信息时，执行该方法。首先校验请求参数中是否有“encryptPass”并值为“true”，若是，表示密码需要加密，随即将密码加密。然后调用业务层的getRole ()方法将提交的用户权限持久化。调用业务层的saveUser ()方法，保存用户信息。如果用户编辑的是自己的信息，更新Session中的当前登录用户信息。如果用户在登录时选择了“记住我”，更新保存的Cookie。如果用户编辑的是其它用户的信息，根据version判断是新添数据还是修改数据，在ActionMessages中存储不同的消息，返回到添加/修改用户信息页面。若是新添数据，调用sendNewUserEmail()给新用户发送一封Email。
    6. search()：具有管理权限的用户进入用户列表时执行该方法。调用业务层的getUsers ()方法，取得包含所有用户信息的List。返回到用户列表页面。
    7. unspecified()：如果请求的url没有包含method参数，通过BaseAction的execute()方法也找不到指定的方法时，执行该方法。在该方法中转到search()方法。
    以上是很多Action需要用到的基本的方法。
    8. sendNewUserEmail()：根据FormBean中的内容给用户发送一封Email。
    9. checkForCookieLogin()：如果用户是通过Cookie登录（用户在登录时选择了“记住我”），发出一个消息警告用户不能修改密码。