# cocos-creator-puremvc

**Repository Path**: d8feel_project/cocos-creator-puremvc

## Basic Information

- **Project Name**: cocos-creator-puremvc
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2020-03-12
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cocos-creator-puremvc
cocos-creator-puremvc 是一个cocos creator项目基础架构。

### 技术栈
* typescript
* puremvc
* [protobufjs](https://github.com/dcodeIO/protobuf.js)

### 安装
使用`npm install`或`yarn`，推荐使用后者。如果你更喜欢`npm`的话，需要修改`package.json`内的`proto`编译命令

### 编译proto
`npm run proto`或`yarn proto`

### script目录结构
* controller
    * bootstrap 需要初始化的MVC
    * commands 游戏内Command，增加Command基本都应该在这里
    * StartupCommand.ts 启动Command
* lib
    * puremvc puremvc源代码和d.ts文件
* model
    * vos vo对象
    * GameProxy.ts 游戏数据代理示例
* services 服务
    * api.ts fetch请求包装
* utils
    * request.ts fetch包装
* view
    * component 视图组件
    * StartViewMediator.ts Start场景中介
* AppFacade.ts puremvc入口
* Constants.ts 常量定义
* Start.ts 开始场景启动脚本，AppFacade在这里初始化

### 注意点
1. Command与Proxy、Mediator  
    Command管理应用程序的 Business Logic（业务逻辑），要协调Model 与视图状态。

    Model 通过使用 Proxy 来保证数据的完整性、一致性 。Proxy 集中程序的Domain Logic（域逻辑），并对外公布操作数据对象的API。它封装了所有对数据模型的操作，不管数据是客户端还是服务器端的。

    Mediator 和Proxy 可以提供一些操作接口让Command 调用来管理View Component 和Data Object ，同时对 Command隐藏具体操作的细节。

2. 一般一个Mediator（handleNotification方法）处理的Notification应该在4、5个之内。  
    还要注意的是，Mediator的职责应该要细分。如果处理的Notification很多，则意味着Mediator需要被拆分，在拆分后的子模块的Mediator里处理要比全部放在一起更好。

3. 应该避免Mediator与Proxy 直接交互。  
    通常应该遵从了这个规则，但实际上项目Mediator中不可避免需要获取Proxy数据，如果每次都通过一个Notification去获取数据，然后返回数据给Mediator，这样无形中增加了通信次数、带反馈数据的通信加重通信负担。所以可以适当是的在Mediator中facade.retrieveProxy获取Proxy然后拿到数据，而且从proxy直接拿数据，可以保证拿到最新数据。 

### 参考文档
* [PureMVC（AS3）剖析：实例](http://www.cnblogs.com/skynet/archive/2013/01/29/2881244.html)
* [i18n](http://docs.cocos.com/creator/manual/zh/advanced-topics/i18n.html)