用ReactRouter4构建通用JavaScript应用

React Router 是一个在 React 领域非常流行的库。它依靠位置栏上的请求 URL 和 浏览器的操作历史来渲染不同的页面内容来保持显示，进而将你的 app 同步到用户接口的页面上。

专注于为中小企业提供成都网站设计、成都做网站、外贸网站建设服务,电脑端+手机端+微信端的三站合一,更高效的管理,为中小企业烈山免费做网站提供优质的服务。我们立足成都，凝聚了一批互联网行业人才，有力地推动了1000+企业的稳健成长，帮助中小企业通过网站建设实现规模扩充和转变。

新的闪闪发亮

最近，版本4的 React Router 已经进入 beta 发布阶段。损誉各半，React Router 的这一次发布是对上一版本的完整重写，这导致了很多破坏性的 API 变更。

在版本 4 的核心理念是 “声明式可组合性（declarative composability）”？—— 它包含 React 之所以优秀的组件概念，并将其应用于 routing。React Router 4 的每一个部分都是 React 的组件： Router ,  Route ,  Link 等等。

React Router 的一位开发者， Ryan Florence ，亲手制作了一个简短的视频来介绍***的 React Router，这段视频获得了很多人的推荐：

视频： https://youtu.be/a4kqMQorcnE

后台如何?

新版本的 React Router 奉上了一个新的 web 页面，上面有 许多实用的代码示例 ，但没有提供实例介绍如何在服务端使用 React Router 来进行基于 React 的页面的渲染。

对于我近期正在进行的项目，对搜索引擎友好且具备***的网站运行速度是重中之重，难道这样就要在客户端渲染整个页面？难道就用示例页面上所有实例所采取的办法？那是不可取的。我们要使用一个 Express 服务器来在后台对 React 页面进行渲染。

在其介绍视屏中, Ryan 有一个可以从某些 API 获取数据来初始化其状态的 App 组件, 使用的是 componentDidMount 生命周期方法。但异步数据的获取操作完毕，组件就会被更新以显示数据。

但是当要在服务端对 App 组件进行渲染的时候这样做不会有效果: 在你使用 renderToString 的时候, 带有 HTML 代码的字符串在调用了组件的渲染方法之后就会被同步地创建出来。 componentDidMount 从未被调用到。

因此如果我们使用 Ryan 视频里的示例在后台渲染出 App 组件，它只会生成一条 “Loading…” 消息。

解决方案

作为对概念方案的验证，我创建了一个 demo 应用，基本上就是对视频中 Ryan 的示例进行重造，但采取的是服务器端的渲染。

应用使用了 GitHub API 去获取有关于 Gist 代码片段的数据:

代码展示

你可以在 Github 上找到 demo 应用的源代码:

https://github.com/technology-ebay-de/universal-react-router4

简而言之，下面就是我所做的事情…

server/index.js

这就是每次有 HTTP 请求发到 Express 服务器的时候都会跑一次的代码:

const routes = [
    '/',
    '/g/:gistId'
];

app.get('*', (req, res) => {
    const match = routes.reduce((acc, route) => matchPath(req.url, route, { exact: true }) || acc, null);
    if (!match) {
        res.status(404).send(render());
        return;
    }
    fetch('https://api.github.com/gists')
        .then(r => r.json())
        .then(gists => 
            res.status(200).send(render(
                (
                    
                        
                    
                ), gists
            ))
        ).catch(err => res.status(500).send(render());
});

app.listen(3000, () => console.log('Demo app listening on port 3000'));

(注意：这里只是摘录，你可以在  GitHub  找到完整的源代码 )

在第 1–4行 , 我为 app 定义了一个路由数组。数组的***个元素就是针对主页的初始请求, 没有 Gists 被选上。第二个路由就是用来展示一个被选上的 Gist 的。

在第 6行 , 我的 Express app 被告知要处理任何可以使用星号匹配上的请求。

在第 7行 , 我使用了来自于 React Router 的  matchPath 函数对路由数组进行简省; 结果就是一个匹配对象，其拥有关于能匹配到的路由以及任何可以从 URL 路径转换过来的参数，这些信息。

在第 8–11行 , 如果有不能匹配的路由，我就渲染出一个错误页面，上面会说 : “页面没找到（Page not found）”。

这里的 render 函数只是围绕 React 的  renderToString 的一个封装而已，添加了包围 React 组件的 HTML 的基础页面的 HTML 代码 ( ,  ,  , 等等)。

在第 12–22行 , 我会从 GitHub API 获取到可以填充 App 状态的数据，并且对 App 组件进行渲染。

最显而易见是第 17 行，我使用了 StaticRouter 组件来初始化 React Router。该 Router 组件类型是采用服务端渲染方案的***选择。它永远不会改变位置, 这是我们在本场景下所需要的, 因为是在后台上, 我们只会渲染一次，而且不会直接地对用户的交互操作做出反应。

而第 23 行 会捕获在处理期间产生的错误信息来渲染出一个错误页面。

我的 App 组件看起来像下面这样:

export default ({ gists }) => (
    

        
            {
                gists ? gists.map(gist => (
                    
                        
                            {gist.description || '[no description]'}
                        
                    
                )) : (
Loading…
)
            }
        
        

            
            {
                gists && (
                     (
                             g.id === match.params.gistId)} />
                        )
                    } />
                )
            }
        

    

);

(→  GitHub上有完整的源代码 )

在第 1 行 , 组件接收到作为一个属性的 Gist 数据对象。

第 3–13行 渲染了一个  Sidebar 组件，里面是连接到不同 Gist 链接。  SidebarItem 组件里面所包含的是只有在存在实际的 Gist 数据时才会被渲染的数据。在服务端，总会有这样的情况发生。而我们在服务端和客户端渲染中都会用到该组件。如果组件是在客户端被渲染的, 我们可能处在获取新的 Gist 数据这一过程之中，所以会展示出一条 “Loading…（加载中）” 的消息。

第 15行 使用了一个来自于 React Router 库的  Route 组件，用以在路由匹配到“/”这个路径的时候展示出  Home 组件。这里我们使用的是精确匹配, 不然的话任何以斜线开头的路径都会匹配到。

如果有 Gist 数据要展示的话, 那么在第 18 行 , 另外一个 Route 组件就会被用来展示一个  Gist 组件，上面是被选择的 Gist 的详细信息。

client/index.js

如前所述，这是一个 通用 JavaScript 应用(大家都知道的“同构”)，意思是相同的代码即可用于渲染服务器页面，又可以用于渲染客户端页面。这里摘录了一段在客户端初始化页面的代码：

render((
    
        
    
), document.getElementById('app'));

(→  GitHub 上的完整代码 )

这比服务端代码简单多了！ 第 1 行 的  render 函数就是  ReactDOM 的 render 函数 。它把我的 React 组件渲染出来的布局附加到 DOM 节点上。

第 2 行 使用了  BrowserRouter (代替了我在服务端进行渲染使用的 StaticRouter)。

第 3 行 我使用 gist 数据对 App 组件进行实例化，以此代替通过 GitHub API 获取数据。gist 数据来自浏览器 DOM 的全局变量，它是后端通过