按角色组织
如果你用MVC框架开发过应用,应该知道MVC
框架之下,通常有这样一种代码组织方式:
controllers/
todoController.js
filterController.js
models/
todoModel.js
filterModel.js
views/
todo.js
todoItem.js
filter.js
Controller
、Model
、View
分别代表三种模块角色。这种组织代码的方式叫做“按角色组织”。
因为MVC
的影响深远,一些风格依然影响了前端人员的思维方式,在Redux应用的构建中,就有这种组织方式:
reducers/
todoReducer.js
filterReducer.js
actions/
todoAction.js
filterActions.js
components/
todoList.js
todoItem.js
filter.js
containers/
todoListContainer.js
todoItemContainer.js
filterContainer.js
角色如下:
-
reducers
目录包含所有Redux的reducer; -
actions
目录包含所有action构造函数; -
components
目录包含所有的展示组件; -
containers
目录包含所有的容器组件。
这种按角色组织的方式看起来不错,实际非常不利于应用的扩展。当你需要对一个功能进行修改时,要在多个角色目录下切换,当功能模块多了,这种频繁的目录切换即浪费时间也增加了编码厌倦感。
如果说MVC
框架下,因为三个角色之间的交叉关系,也只能默默接受,那么在Redux
框架下,我们已经有机会实行严格模块化思想。
按功能组织
Redux
应用适合于“按功能组织”,也就是把完成同一应用功能的代码放在一个目录下,一个应用功能包含多个角色的代码。Redux
中,不同的角色就是reducer
、actions
和视图,而应用功能对应的就是用户界面的交互模块。
拿Todo
应用来说,两个基本的功能就是TodoList
和Filter
,所以按功能组织就是这样子:
todoList/
actions.js
actionTypes.js
index.js
reducer.js
views/
components.js
containers.js
filter/
actions.js
actionTypes.js
index.js
reducer.js
views/
components.js
container.js
每个功能模块对应一个目录,分别是todoList
和filter
,每个目录下包含同样的角色文件:
-
actionTypes.js
定义action类型; -
actions.js
定义action构造函数; -
reducer.js
定义这个功能模块如果响应actions.js定义的动作; -
views
包含功能模块中所有的React组件,包括展示组件和容器组件; -
index.js
把所有的角色导入,统一导出。
这种组织方式下,当你要修改某个模块时,只要关注对应的目录即可。
按功能组织下的每个模块,都有一个index.js,明确了模块对外的接口:
import * as actions from './actions.js';
import reducer from './reducer.js';
import view from './views/container.js';
export { actions, reducer, view };
当filter模块依赖todoList模块时,对应的导入代码:
import { actions, reducer, view as TodoList } from '../todoList';
混合方式
大型应用中,下面这种混合方式(既采用类型划分的优势,又添加了功能划分的特点)也是不错的选择。
src/ 所有源代码存放的路径
app.js 整个应用的入口
views/ 应用中某个页面的入口文件,一般为路由组件
Home.js 例如,首页的入口就是Home.js
Home.css Home页面对应的样式
HomeRedux.js Home页面中所有与Redux相关的reducer、action creator的汇总,即components/Home/下所有*Redux.js的汇总
components/ 所有应用的组件
Home/ 例如,views/中一个名为Home的view,则在components/中就有一个名为Home的子文件夹
Table.js Home页面中的一个列表组件
Table.css 列表组件对应的样式
TableRedux.js 列表组件的reducer、action creator及action type,整合在一个文件中
Modal.js
Modal.css
ModalRedux.js
shared/ 不归属于任何view的组件,如一些公共组件等
containers/
DevTools.js 配置DevTools
Root.js 一般被app.js依赖,用于根据环境判断是否需要加载DevTools
layouts/ 布局相关的组件及样式,如菜单、侧边栏、header、footer等
redux/ Redux store相关的配置
reducers.js 整个应用中所有reducer的汇总
routes/ 路由相关的配置
utils/ 工具函数、常量等
styles/ 全局公共样式
app.css 应用主样式表
基本上,我们只需要关注的就是views/和components/这两个目录,它们也是存放绝大多数业务代码的地方。
在views/目录中,存放的是每个路由的入口页,如首页(Home)、详情页(Detail)、管理后台页(Admin)等。而每个入口都会有三个文件:.js是入口的组件,.css是对应组件的样式,而*Redux.js是components/Home/目录下所有reducer和action的聚合。
在components/Home/目录里,是当前路由对应的页面(Home)需要的所有内容——components、actions、reducers、样式等。
什么是*Redux.js?实际上,按照Redux应用的一般目录结构划分方式,应该分别有reducers、action creator和constants文件夹。但是在实际应用中,我们发现这样的划分方式略显繁琐,添加一个组件需要至少新建4个文件。同时对于业务应用来说,reducers等于Redux相关的文件并不太可能被其他地方复用,因此放在一个文件里组织并管理是更好的选择。目前在Redux社区中也存在一个类似的规范。Ducks modular redux