美文网首页
后台小白前端入门--React+React-Router+Red

后台小白前端入门--React+React-Router+Red

作者: wuqke | 来源:发表于2017-11-26 15:44 被阅读559次

    导语:

    其实demo早在四五月份就已经写好了,只是那段时间后台项目太忙,加上自己拖延症晚期,到最近才写这篇文章。文章结构大概从介绍本文使用的前端技术,使用的原因出发,同时结合代码进行使用讲解,最后在配上如何基于本文demo进行进一步开发,尽量做到浅显易懂,延续系列的特点。这篇文章应该是我近期内写的最后一篇前端文章。写完这篇文章,也算是从React系前端勉强毕业了,同时也是给自己这一年来前端学习的一个交代。文章有点长,大家慢慢看。也可以直接到最底下获取我的github地址,直接下载demo跑起来,只需要一个npm start,童嫂无欺。
    React

    框架概念介绍

    所使用的相关前端技术框架:React+React-Router+Redux+webpack2.0,ui框架用的是Ant Design。异步请求用的是fetch api

    1.React:这个就不用介绍了吧,这个还用介绍,估计这篇文章不太适合你。这个不熟的建议先学习一下,可以从我之前写的后台小白前端入门--React看起。

    2.Reac-Router:使用React-Router,可以让你轻松使用React进行多页面开发。React—Router是React官方的貌似也是唯一的React路由解决方案。简单来说,就是url改变,但是不经过后台,在前端进行路由,根据url的不同选择并渲染不同的路由组件。React-Router其实没有多少东西,就一个路由容器,还有一些api,现在也出中文文档了,可以跟着官方文档的demo敲一遍就好了。

    3.Redux:个人认为这是技术栈里面比较难学的一个。不仅你要学习Redux是什么,也要学习如何和React搭配使用。简而言之,Redux就是在浏览器内存中弄了一个容器,用于存放及管理js状态的地方。然后通过一系列的规范和限制,让你能清晰地管理这些状态,同时用这些状态去改变页面。

    使用React做过复杂页面的人可能会深有体会,当一个嵌套了三四层的组件,最底层的子组件想要改变父组件的状态,使得父组件通过这个状态去改变另外一个最底层的子组件的时候,不使用消息订阅方式的时候,无非就是写一个回调一直传到子组件供其调用,来改变这个父组件的状态(其实就是父组件的state),然后父组件又把这个状态一层层传到另外一个子组件,然后另外一个子组件通过props值获取到状态的改变,来渲染页面。这种代码写起来非常地恶心,一多起来,基本没办法阅读和维护。

    所以这个时候,你就需要在一个地方去统一管理这些状态了,让所有的组件都去这个地方获取状态的变化,或者改变状态。这个就是Redux做的事情。React最初起步的时候,由官方推出的Flux也是做着类似的事情。不过后来Redux的出现,以更加清晰的store机制和使用方式,取代了Flux成为了主流。我自己也试着写过Flux的代码,写起来Redux会更简洁一些,所以这里就选择使用Redux。

    Redux学习的话,可以先从Redux中文文档开始看起,大概了解一下Redux的相关机制。如果英文好一下的话,可以去看一个英文的Redux使用视频,大概20多个,照着敲下来,应该也差不多。当然,本文后续也会介绍Redux结合React,React-Router使用。

    4.框架作用小总结:为什么写个React还要加着么多东西呢?简单来说,就是你在最初使用React开发页面的时候,你发现你的页面只有一个url(单页),没办法做到通过url到达不同的页面,然后你使用React-Router,就可以使用React进行“多页面”开发。然后你的网站越来越复杂了,抽出来的公共组件越来越多,页面组件嵌套越来越深,状态(父组件于子组件之间的state)之间的关系影响越来越复杂。这时候你就需要使用Redux来统一管理这些状态了。

    上面提到的相关资料站,都可以从本文最底下获取到相关的链接,大家按需获取。本demo的相关代码放到了github里面,链接也放到底下了。

    框架使用及说明

    下面将介绍框架代码的结构和使用。先附上目录结构,介绍各个文件夹存放的文件及文件的结构:

    front
    |---actions(使用Redux开发,对应的action都放到这个目录下,稍后详解)
    |---build(webpack打包编译后生成的js文件,实际html引用的也是这里的文件)
    |---common(一些公共的变量和api都放在这个文件夹下)
    |---css
    |---data(node服务器mock后台数据的文件放在这)
    |---jsx(组件代码文件都放在这)
    |---node_modules
    |---reducers(使用Redux开发,对应的action都放到这个目录下,稍后详解)
    |---store(使用Redux开发,store文件存放路径)
    |---index.html(主页面)
    |---package.json(npm)
    |---proxy.config.js(node服务器请求接口映射配置文件)
    |---webpack.config.js

    建议大家把demo下下来直接跑起来,先安装好node和webpack,然后在front目录下,使用npm install安装以来,再使用webpack打包,最后使用npm start启动node服务器,然后浏览器访问http://localhost:8000/即可。demo比较简单,只做了登陆页,注册页和主页。不过也够用了。不知道node和webpack用法的可以先在我的上一篇博客搭个简单例子,你就会有所了解了。后台小白前端入门--React前端框架搭建Demo及介绍

    启动后,你就能看到这样的页面:


    image.png

    点击右上角的名字,退出,可以跳到登陆页,登陆页点注册,可到注册页。

    关键代码详解

    1.jsx/index.jsx

    //省略引入第三方库的代码。
    import store, {history} from '../store/store.jsx';
    class RouterComponent extends React.Component {
        render() {
            return (
                <Provider store={store}>
                    <Router history={history}>
                        <Route path={env.homePage} component={ContainerComponent}>
                            <IndexRoute component={MainComponent}/>
                            <Route path={env.login } component={LoginComponent}/>
                            <Route path={env.register } component={RegisterComponent}/>
                        </Route>
                    </Router>
                </Provider>
            );
        }
    }
    
    

    前面说到,我们已经将state交给了Redux进行管理,放在了store里面。那么如何在负责渲染页面的组件里面获取到这些state呢?在React-Redux中,提供了Provider组件,把它作为根组件,同时把store作为参数传给它,你就能在嵌套在它下面的组件中拿到state。

    接下来就是Router组件了,Router组件使用起来和不用Redux一样,这里就不用详细介绍。不过我们可以把history和store做个绑定,下面有详细介绍。

    2.store/store.jsx

    //省略引入第三方库的代码。
    import * as reducers from '../reducers/rootreducer.jsx';
    
    const rootReducer = combineReducers({
        ...reducers,
        routing: RouterReducer
    });
    
    const store = createStore(rootReducer, applyMiddleware(thunk));
    
    export const history = syncHistoryWithStore(browserHistory, store);
    
    export default store;
    
    

    上面的combineReducers,用于将多个负责改变不同的state的reducer合并成同一个reducer函数。这样你就可以分别根据业务情况编写不同的reducer了,代码结构清晰。

    接着是syncHistoryWithStore,用于将History中的变化反映到store里的state中。这里我自己也不是很清楚,demo里面应该是没有用到对应的例子,因为我把这个代码换成export const history = browserHistory; 编译运行都正常,有兴趣的话可以做个深入研究。

    3.jsx/component/MainComponent.jsx

    接下来,写完上面那两个配置文件。React+React-Router+Redux的框架就简单的搭建起来了。现在开始写一些比较简单的页面组件。下面主页的代码比较简单,相信大家看懂应该不费吹灰之力。如果我们没有用到Redux,其实就是把下面的loadData改成异步请求,同创建组件的相关state,把请求回来的参数传给这个内部的state,通过state组件的更新来更新页面。代码如下:

    //以上略去了使用Redux需要声明和绑定和函数,后面会给出。
    export default class MainComponent extends React.Component {
        constructor(props) {
            super(props);
    
        }
    
        loadData() {
            //这里是Redux的写法,如果是不使用Redux,则直接写异步请求并且将返回的数据setState到本组件的state中。
            const {actions} = this.props;
            actions.fetchArticleList();
        }
    
    
        componentDidMount() {
            this.loadData();
        }
    
        render() {
            var articleListHtml = [];
            //这里是Redux的写法,如果是不使用Redux,则直接从this.state中获得数据。
            const {articleList} = this.props;
            if (common.isNotEmpty(articleList) && articleList.length > 0) {
                for (var i = 0; i < articleList.length; i++) {
                    articleListHtml.push(
                        <tr key={i}>
                            <td className="td-align-center" style={{width:"50%"}}>
                                <a href="" target="_blank">{articleList[i].title}</a>
                            </td>
                            <td className="td-align-center" style={{width:"25%"}}>{articleList[i].creator}</td>
                            <td className="td-align-center"
                                style={{width:"25%"}}>{articleList[i].commentNum}/{articleList[i].readedNum}</td>
                        </tr>
                    )
                }
            }
            return (
                <div>
                    <Row type="flex" justify="center">
                        <h1>博文列表</h1>
                    </Row>
                    <Row type="flex" className="add-code-lib-row standard-margin-top">
                        <Col span={24}>
                            <div className="code-manage-main">
                                <table>
                                    <thead>
                                    <tr>
                                        <th className="td-align-center">标题</th>
                                        <th className="td-align-center">作者</th>
                                        <th className="td-align-center">回复/查看</th>
                                    </tr>
                                    </thead>
                                    <tbody>
                                    {articleListHtml}
                                    </tbody>
                                </table>
                            </div>
                        </Col>
                    </Row>
                </div>
            );
        }
    }
    
    

    --.Redux怎么用,用的时候该注意些什么
    写完UI组件,这里有必要花一些篇幅简单介绍一下Redux的一些机制和原则,以便于实在不想看Redux是什么以及怎么用的读者理解接下来的代码。

    前面有说到,Redux就是用来管理状态(state)的,不过它自己有一套自己的管理机制和规范,大概的示意图如下:

    image.png

    (1)UI组件通过connet,绑定action和state(即图中的1和2),使得组件可以dispatch action,同时也能在props里面获取到store里对应的state。

    (2)组件生成action,并且进行dispatch(即图中的3),这里主要为了调用异步请求,获取服务端数据。

    (3)请求成功或者失败后,会再在3的Action里,dispatch一个Action(图中的4),这个action,才是用来通知reducer,让其去改变store中对应的状态的。

    (4)所有的Reducer都会收到该请求(图中的5),如果符合条件的reducer会更改store中的state,并且返回新的state到store中,如果不符合,则直接返回旧的state,不做任何更改。

    上面大概就是使用Redux的大致开发流程及数据流向了。同时Redux规定了3条原则,来保证store中状态改变和使用足够清晰。1.只有一个store,所有的状态都存在于这个store中。2.通过action来触发store中状态的改变,reducer执行具体的state变化。其它任何时间任何方式的state是只读的。3.reducer函数必须是一个纯函数,即对应于任何两个相同的输入,只会有一种相同的输出。举个例子,你在这个纯函数里面,Redux是不允许你使用诸如Math.random()或者new Date()等函数来改变state的。这样做是为了保证状态变化的可预测性和清晰性。

    通过上面一系列原理和原则,Redux让前端开发者和维护者对前端的代码和逻辑更佳清楚易懂,对于状态变化清晰可预测。

    4.reducers/articleList.jsx

    import * as constants from '../common/constants.jsx'
    
    const initialState = {};
    
    export default function (state = initialState, action) {
        switch (action.type) {
            case constants.RECEIVE_ARTICLELIST:
                const {articleList} = action;
                return {
                    ...state,
                    articleList
                };
                break;
            default:
                return state
        }
    }
    
    
    //同时在common/constants.jsx中添加如下内容,因为action和reducer都会用到,所以放倒一个公共变量里面比较好。编程习惯编程习惯
    export const RECEIVE_ARTICLELIST = 'RECEIVE_ARTICLELIST';
    
    //在reducers/rootreducer.jsx中添加如下代码,使得上面写的reducer能绑定到store中。
    export articleList from './articleList.jsx'
    
    
    

    Redux部分的代码讲解将按照Redux流程从后到前讲解,即从reducer,action,再到前端UI component 的顺序,方便大家更加清楚地了解如何进行Redux开发。

    上面部分的代码就是写一个负责改变文章列表状态的reducer,当有一个type为'RECEIVE_ARTICLELIST'的action被分派的时候,这个reducer会进行响应,同时修改状态里的articleList,重新计算并返回新的state到store中。需要说明的是,当一个action被分派的时候,所有绑定的reducer都会被触发执行。如果符合则更新状态,如果没有则直接返回原state(即default:return state),store里的状态就不会变化。

    我们写完了这个reducer,就要把它绑定到store中,前面我们已经通过如下代码进行配置了,所以只需要在reducers/rootreducer.jsx 添加即可绑定到store中。

    
    import * as reducers from '../reducers/rootreducer.jsx';
    const rootReducer = combineReducers({
        ...reducers,
        routing: RouterReducer
    });
    
    const store = createStore(rootReducer, applyMiddleware(thunk));
    
    

    5.actions/receiveArticleList.jsx

    接着往前写,写到Action,这里分派到Reducer的Action,是一个对象,其中有一个type属性,是必须的,用来和reducer里面接受参数里面的action.type是一致的,也就是constants.jsx中的RECEIVE_ARTICLELIST = 'RECEIVE_ARTICLELIST'。另外你可以在这个对象里面添加一些其它的参数,以便于reducer匹配到以后拿这些参数去改变store中的状态。如下代码:

    const constants = require('../common/constants.jsx');
    
    export function receiveArticleList(articleList) {
        return {
            type: constants.RECEIVE_ARTICLELIST,
            articleList
        }
    }
    
    

    6.actions/fetchArticleList.jsx

    这里这个Action,其实在我看来,是一个伪“action”,因为它并没有分派到reducer中,而是触发另外一个Action。这里这个Action是由UI组件分派的,为了进行异步请求,在请求成功或者失败后,再分派一个真正的Action,去改变store中的state。

    在Redux中,把异步请求数据的代码和逻辑放在Action里面是比较好的。当然你可以直接在UI组件里面直接进行异步请求,然后派发Action去改变store中的状态。但是这么做的话,你的业务代码和你的UI组件又耦合在一起了。代码也不够通用,感觉不太好。这部分的代码如下:

    import fetch from 'isomorphic-fetch'
    require('es6-promise').polyfill();
    import * as actions from './actions.jsx';
    import env from '../common/env.js';
    
    export function fetchArticleList() {
        return (dispatch, getState) => {
            fetch(env.getArticleList, {
                credentials: 'same-origin',
                headers: {
                    "Content-Type": "application/json"
                }
                // body: formData
            }).then(function (response) {
                if (response.status >= 400) {
                    throw new Error("Bad response from server");
                }
                return response.json();
            }).then(function (result) {
                var code = result.code;
                if (code == "0") {
                        //这里才是真正触发Aciton的地方,去store的状态。
                    dispatch(actions.receiveArticleList(result.data))
                }
            }.bind(this)).catch(function (error) {
                alert("请求失败,请检查网络");
                //这里才是真正触发Aciton的地方,去store的状态。
                dispatch(actions.receiveArticleList([]))
            });
        }
    }
    
    
    

    7.jsx/component/MainComponent.jsx

    最后,又回到了我们的UI组件。我们在前面已经写好了异步请求的Action,改变Store中状态的Action,以及如何改变Store状态的Reducer。

    接下来,就是UI组件如何去获取到store中的状态,如何去直接或者间接(需要异步请求的时候)去派发一个Action,以及store中的state变化时,UI组件是如何过获取到变化的。先贴上代码,下面再进行代码说明。

    import env from '../../common/env.js';
    import common from '../../common/common.js';
    import {fetchArticleList} from '../../actions/actions.jsx';
    import {connect} from 'React-Redux';
    
    const mapDispatchToProps = dispatch => {
        return {
            actions: {
                fetchArticleList: () => dispatch(fetchArticleList())
            }
        }
    };
    
    
    // Map Redux state to component props
    const mapStateToProps = createSelector(
        state => state.articleList.articleList,
        (articleList) => {
            return {
                articleList
            }
        }
    );
    
    
    @connect(mapStateToProps, mapDispatchToProps)
    export default class MainComponent extends React.Component {
    
    //这部分的代码和  3.jsx/component/MainComponent.jsx中贴出的代码一样,不再给出。
    
    }
    
    

    接下里,我们一一解决上面的问题。

    我们首先写一个mapDispatchToProps函数,封装一下需要派发的action,使得UI组件中的代码能比较方便调用action。

    其次,再写一个mapStateToProps函数,返回想要订阅的store的状态(在本例子中,就是存储在store中的articleList)。需要额外说明的是,这个state.articleList.articleList,
    中间的articleList,是你在rootreducer.jsx中export的值。

    最后使用React-Redux库中的connet,将上面两个函数绑定到UI组件上。这样,UI组件就可以通过this.props中拿到store中的状态值了,并且每一次store中的状态值变化,也会触发React组件中props的改变,触发React生命周期的相关函数回调。同时,如果UI组件中想要触发一次Action派发,也是在props里面进行this.props.actions.fetchArticleList();即可。上面两个函数已经把action和store中的state都绑定到props对象里了。

    至此,已经把整个Demo的关键代码进行一一说明。详细的代码建议大家去我的github上下载下来看。这里就不提供全量代码了。

    基于demo代码进行相关开发步骤

    上面代码已经详细到,从零开始搭一套React大礼包了。但是如果你实在不想自己搭一套,去折腾什么依赖包问题,webpack问题,中间件问题,fetch请求兼容性问题等一大堆问题。想在本demo上直接开发,也是可以的。大概步骤如下:

    1.写好UI组件。

    2.在index.jsx中配置好路由。

    如果有异步请求,则还需要以下步骤:

    3.在constants.jsx中设置action.type,供reducer和action使用。

    4.在reducers文件夹中添加reducer。

    5.在rootreducer。jsx中添加4中的文件

    6.在actions文件夹中添加相关action,如果有ajax请求,建议分成fetch,receive两个action

    7.在actions。jsx中添加6中的文件

    8.在对应的组件中编写对应的逻辑。etc:@connect(mapStateToProps, mapDispatchToProps)等

    总结

    当然,这个demo代码比较简单,只是为了用React大礼包而用React大礼包,太过于复杂的代码也不适合进行讲解说明。而且,这套框架搭起来了,仍然有很多问题,很多规范需要去解决。比如什么时候把组件中的state放到store中,怎样接着精简代码,去掉rootreducer.jsx、actions.jsx等等等等。都值得进行深入的学习和研究,也欢迎大家这篇文章下面评论讨论,提出解决方案。

    想把这套框架吃下来,合理运用起来,光是这些代码和学习也是远远不够的。还需要更多的学习和实践,不过希望这篇文章提供一些信心,成为一个好的起点。

    临走之前,我还有话要说

    其实在15年的时候就已经开始写前端代码了,用的是jQuery。然后到去年,开始认真研究React及其相关生态系统。感觉现在的前端,处于一个群雄割据的年代。老派的还在用jQuery,然后现在比较主流的三大框架React,Vue,Angular,都占有不小的使用比例。这对于前端学习者,我觉得已经算是不小的负担,并且这些技术还在飞速迭代着。当然这也无可厚非,大家都想一统天下,但是,在这种急功近利的趋势,导致很多时候,自己都没统一自己。我在用webpack的时候,刚好经历webpack1过渡到webpack2,然后发现webpack2竟然不兼容webpack1,要做代码升级及兼容。听前端的同时说,Angular2和Angular1,差别也很大。这一系列的变动,也导致了对应的插件和api库跟着不兼容,需要升级。导致这个过程非常的痛苦。暂别前端,希望下次回来,前端有一番新气象。

    相关技术资料站

    相关文章

      网友评论

          本文标题:后台小白前端入门--React+React-Router+Red

          本文链接:https://www.haomeiwen.com/subject/tpcfvxtx.html