我一直在思考,我对Client和Server之间的路由感到困惑。假设我在将请求发送回 Web 浏览器之前使用 ReactJS 进行服务器端渲染,并使用 react-router 作为客户端路由在页面之间切换而不像 SPA 那样刷新。
想到的是:
- 路线如何解释?例如,从主页 (
/home
) 到帖子页面 (/posts
)的请求 - 路由去哪里,在服务器端还是客户端?
- 它如何知道它是如何处理的?
我一直在思考,我对Client和Server之间的路由感到困惑。假设我在将请求发送回 Web 浏览器之前使用 ReactJS 进行服务器端渲染,并使用 react-router 作为客户端路由在页面之间切换而不像 SPA 那样刷新。
想到的是:
/home
) 到帖子页面 ( /posts
)的请求请注意,此答案涵盖 React Router 0.13.x 版 -即将推出的 1.0 版看起来将具有显着不同的实现细节
这是server.js
react-router的最低限度:
var express = require('express')
var React = require('react')
var Router = require('react-router')
var routes = require('./routes')
var app = express()
// ...express config...
app.use(function(req, res, next) {
var router = Router.create({location: req.url, routes: routes})
router.run(function(Handler, state) {
var html = React.renderToString(<Handler/>)
return res.render('react_page', {html: html})
})
})
凡routes
module出口路由的列表:
var React = require('react')
var {DefaultRoute, NotFoundRoute, Route} = require('react-router')
module.exports = [
<Route path="/" handler={require('./components/App')}>
{/* ... */}
</Route>
]
每次向服务器发出请求时,您都会创建一个Router
将传入 URL 配置为静态位置的一次性实例,该实例根据路由树进行解析以设置适当的匹配路由,并使用顶层回调要呈现的路由处理程序以及在每个级别匹配哪些子路由的记录。这是当您<RouteHandler>
在路由处理组件中使用组件来呈现匹配的子路由时所参考的内容。
如果用户关闭了 JavaScript,或者加载速度很慢,他们点击的任何链接都会再次访问服务器,如上再次解决。
这是client.js
react-router的最低要求(重新使用相同的路由module):
var React = require('react')
var Router = require('react-router')
var routes = require('./routes')
Router.run(routes, Router.HistoryLocation, function(Handler, state) {
React.render(<Handler/>, document.body)
})
当您调用 时Router.run()
,它会在幕后为您创建一个 Router 实例,每次您浏览应用程序时都会重新使用该实例,因为 URL 在客户端上可以是动态的,而不是在服务器上,单个请求具有固定网址。
在这种情况下,我们使用HistoryLocation
,它使用History
API来确保在您点击后退/前进按钮时发生正确的事情。还有一个HashLocation
可以更改 URLhash
以创建历史记录条目并侦听window.onhashchange
事件以触发导航。
当你使用 react-router 的<Link>
组件时,你给它一个to
prop,它是路由的名称,加上路由需要的任何params
和query
数据。在<a>
此组件呈现有一个onClick
最终调用处理程序router.transitionTo()
与你给的链接,它看起来像这样的props路由器实例:
/**
* Transitions to the URL specified in the arguments by pushing
* a new URL onto the history stack.
*/
transitionTo: function (to, params, query) {
var path = this.makePath(to, params, query);
if (pendingTransition) {
// Replace so pending location does not stay in history.
location.replace(path);
} else {
location.push(path);
}
},
对于常规链接,这最终会调用location.push()
您使用的任何位置类型,它处理设置历史记录的详细信息,因此使用后退和前进按钮导航将起作用,然后回调router.handleLocationChange()
以让路由器知道它可以继续过渡到新的 URL 路径。
然后路由器router.dispatch()
用新的 URL调用它自己的方法,该方法处理确定哪些配置的路由与 URL 匹配的细节,然后调用匹配路由存在的任何转换钩子。您可以在任何路由处理程序上实现这些转换钩子,以便在路由即将离开或导航到时采取一些操作,如果事情不符合您的喜好,则可以中止转换。
如果转换没有中止,最后一步是Router.run()
使用顶级处理程序组件和包含 URL 和匹配路由的所有详细信息的状态对象调用您提供的回调。顶级处理程序组件实际上是Router
实例本身,它处理渲染匹配的最顶级路由处理程序。
每次导航到客户端上的新 URL 时,都会重新运行上述过程。
在 1.0 中,React-Router 依赖于历史module作为 peerDependency。该module处理浏览器中的路由。默认情况下,React-Router 使用 HTML5 History API ( pushState
, replaceState
),但您可以将其配置为使用基于哈希的路由(见下文)
路由处理现在在幕后完成,当路由改变时,ReactRouter 将新的 props 发送到 Route 处理程序。onUpdate
每当路由发生变化时,路由器都会有一个新的props回调,这对于网页浏览跟踪或更新<title>
.
import {Router} from 'react-router'
import routes from './routes'
var el = document.getElementById('root')
function track(){
// ...
}
// routes can be children
render(<Router onUpdate={track}>{routes}</Router>, el)
import {Router} from 'react-router'
import {createHashHistory} from 'history'
import routes from './routes'
var el = document.getElementById('root')
var history = createHashHistory()
// or routes can be a prop
render(<Router routes={routes} history={history}></Router>, el)
在服务器上,我们可以使用ReactRouter.match
,这是取自服务器渲染指南
import { renderToString } from 'react-dom/server'
import { match, RoutingContext } from 'react-router'
import routes from './routes'
app.get('*', function(req, res) {
// Note that req.url here should be the full URL path from
// the original request, including the query string.
match({ routes, location: req.url }, (error, redirectLocation, renderProps) => {
if (error) {
res.status(500).send(error.message)
} else if (redirectLocation) {
res.redirect(302, redirectLocation.pathname + redirectLocation.search)
} else if (renderProps) {
res.status(200).send(renderToString(<RoutingContext {...renderProps} />))
} else {
res.status(404).send('Not found')
}
})
})