前端模块

一、概述

承担的需求（主要秘密）

负责前端视图模板的管理，能根据相应的视图名称来渲染相应的符合业务需求的视图
负责前端视图渲染方式的管理，能根据需求切换不同的视图渲染方式，以保持高度的前端视图页面构建的灵活性
负责前端视图状态的管理，能根据生产需求切换当前的视图状态来应对不同的生产环境，同时也需要保持视图状态的可扩展性，目前支持的视图状态有：
1. 正常状态，根据路由正常返回相应的视图
2. 维护状态，返回统一的维护提示页面，或者若有重要的页面需要显示额外信息也可以将其模板标记为维护提示用的模板，以便在维护状态中返回相应的维护信息页面

用例图设计

可能会修改的实现（次要秘密）

模板格式
模板处理器的实现方式
前端视图状态

涉及的相关质量属性

R1 可扩展性
R2 可重用性
R3 易用性

设计概述

本模块需要解决的核心问题是：

视图层在基本的表现功能、交互功能实现的情况下，需要面临的是对大量的纷繁复杂的页面做的重复开发工作，所以本模块需要着重考虑如何能对视图层已经做过的工作做很好的重用，故针对本问题前端模块需要包含以下的设计：
1. 借鉴经典设计模式中原型模式的思想，将大量重复的页面内容提取出来作为模板使用，按照分类只编写一次，如所有的商品结果页面都将根据某个特定的模板来进行构造，而页面与页面之间的差异性讲交给相应的处理器来根据页面上的标记进行差异化的解析
其次，前端模块需要应对视图解析方式的变更，无论是今后自己编写新的视图解析模块还是引用开源的解析模块，前端模块都需要对其进行方便的兼容，故解析器需要以接口的方式开放调用以降低耦合，由于同样的原因，视图对象也做相同的处理
接着，前端模块需要具备根据业务场景进行状态变更的能力，以便于应对正常情况下的显示，异常情况下的显示，以及对特定用户的显示。故前端模块在对视图名称进行处理的时候多了一层“中介”，这个中介类的职责就是能维护一个网站当前的状态，并且开放接口来对这个状态进行变更，在中介类的内部可以根据当前状态来返回合适的视图名称

角色

Gateway: 所有外部请求需要统一由网关处理和转发，前端模块的业务同样也受网关的控制

二、类的设计

2.1 类图

2.2 类描述

1. Dispatcher类

类方法	描述
public void handle(String url)	根据传入的url来决定对url执行的操作前置条件:无后置条件:无

2. View接口

接口方法	描述
public void render()	根据自身属性来渲染一个具体的页面内容

3. ConcreteView类

实现View接口，以便保证使用不同的方式来渲染一个页面的具体内容

类方法	描述
public void render()	根据自身属性来渲染一个具体的页面内容前置条件:对象已经实例化后置条件:构建一个相应的视图对象，并转发到客户端

4. ViewResolver类

类方法	描述
public View resolveViewName()	根据上下文和传入的视图名称来构建一个具体的视图对象前置条件:对象已经实例化后置条件:生成一个视图对象
private View buildView()	私有方法，根据自身的属性来构建一个视图对象前置条件:对象已经实例化后置条件:生成一个视图对象

5. Controller类

负责接收dispatcher的路由转发，执行相应的业务逻辑

6. SiteManager类

类方法	描述
public View resolveViewName()	根据上下文和传入的视图名称来构建一个具体的视图对象前置条件:对象已经实例化后置条件:生成一个视图对象
public View switchToNormal()	将当前的服务状态切换为正常状态前置条件:对象已经实例化后置条件:当前状态对象变为NormalState实例
public View switchToMaintain()	将当前的服务状态切换为维护状态前置条件:对象已经实例化后置条件:当前状态对象变为MaintainState实例

重要实例属性	描述
State state	表示当前网站的服务状态

7. State类

对当前网站服务状态的抽象

类方法	描述
public View getViewName(String viewName)	对传入的视图名称做处理前置条件:对象已经实例化后置条件:根据状态返回一个应该被显示的视图的名称

8. NormalState类

类方法	描述
public View getViewName(String viewName)	正常状态下直接正常返回原有的视图名称前置条件:对象已经实例化后置条件:不对传入的ViewName做处理

9. MaintainState类

类方法	描述
public View getViewName(String viewName)	维护状态下返回维护提示视图的名称前置条件:对象已经实例化后置条件:统一返回维护页面的视图名称

三、重要协作

顺序图

四、设计模式应用

单件模式

使用单件模式保证每次引用的网站服务状态管理器都是同一个，从而维护相同的状态

状态模式

将网站不同的状态用不同的状态子类来表示，既保持了统一的操作，又保证了服务状态的可扩展性

FrontendModule