如何在同构 React + React Router 应用程序中处理 Post 请求
How to Handle Post Request in Isomorphic React + React Router Application
我想构建同构 react
+ react-router
应用程序,经过几天谷歌搜索,现在我可以实现仅处理 GET 请求的同构应用程序。
这是我到目前为止所做的:
- 服务器使用
react-router
处理所有请求
react-router
将调用驻留在与路由匹配的每个 React View 中的 fetchData
函数。
- 将之前获取的数据设置到React View的props中,渲染到
string
- 将
string
和之前获取的数据作为全局变量window.__STATE__
注入HTML并将HTML传递给客户端
- 我们已成功从服务器渲染 React App
- 当客户端完成加载我们的 React App javascript 时,它将尝试呈现。但是我们将来自
window.__STATE__
的状态作为 React App 的 props 传递,并且 React 不会重新渲染,因为状态是相同的
问题是它不适用于 POST/PUT/DELETE/WHATEVER 请求。在处理 GET 请求时,react-router
有关于 params
和 query
的信息。例如,如果我们有一条路由:/user/:uid
并且客户端请求此 url:/user/1?foo=bar
,那么 params
将是:{uid: 1}
并且 query
将成为 {foo: 'bar'}
react-router
然后可以将其传递给 fetchData
函数,这样它将知道使用 uid
为 1 获取用户并使用 foo
查询执行任何操作。
虽然在 POST 请求中,react-router
不知道 POST 参数。在 Server 上,我们当然可以将 POST 参数传递给 fetchData
函数,但是 Client 端呢?它不知道 POST 参数是什么。
有没有办法让服务器告诉客户端 POST 参数?下面是我的登录视图的示例。我希望当用户提交表单时,服务器会在出错时呈现错误消息,或者在成功时将其重定向到仪表板。
fetchData.js
import whenKeys from 'when/keys';
export default (authToken, routerState) => {
var promises = routerState.routes.filter((match) => {
return match.handler.fetchData;
}).reduce((promises, match) => {
promises[match.name] = match.handler.fetchData(authToken, routerState.params, routerState.query);
return promises;
}, {});
return whenKeys.all(promises);
}
server.js
...
app.use((req, res) => {
const router = Router.create({
routes,
location: req.originalUrl,
onError: next,
onAbort: (abortReason) => {
next(abortReason);
}
});
router.run((Handler, state) => {
fetchData(authToken, state).then((data) => {
// render matched react View and generate the HTML
// ...
})
});
});
...
login.jsx
import React from 'react';
import DocumentTitle from 'react-document-title';
import api from './api';
export default class Login extends React.Component {
constructor(props) {
super(props);
// how to fill this state with POST parameters on error?
// how to redirect on success?
// and remember that this file will be called both from server and client
this.state = {
error: '',
username: '',
password: ''
};
}
// I saw some people use this function, but it'll only work if
// the form's method is GET
static willTransitionTo(transition, params, query) {
// if only we could read POST parameters here
// we could do something like this
transition.wait(
api.post('/doLogin', postParams).then((data) => {
transition.redirect(`/dashboard`);
});
);
}
render() {
return (
<DocumentTitle title="Login">
<div className="alert alert-danger">{this.state.error}</div>
<form method="post">
<input type="text" name="username" value={this.state.username} onChange={this._onFieldChange('username')} placeholder="Username" /><br />
<input type="password" name="password" value={this.state.password} onChange={this._onFieldChange('password')} placeholder="Password" /><br />
<button type="submit">Login</button>
</form>
</DocumentTitle>
);
}
_onFieldChange(name) {
var self = this;
return (e) => {
e.preventDefault();
var nextState = {};
nextState[name] = e.target.value;
self.setState(nextState);
}
}
}
在客户端获取 "POST" 数据
在客户端,您通过从表单输入中提取值来获取 POST 数据,其方式与正常提交表单时您在服务器上收到的内容相对应。
使用 POST 数据
所以现在你有了 POST 数据,但你仍然遇到无法将 POST 数据提供给 React Router 0 中的转换挂钩的问题。13.x和更早。我创建了一个 pull request for this feature 现在已经关闭,因为它被包含在即将发布的 v1.0 版本的重写中。
它的要点是位置现在有一个状态对象,用于存储你需要的关于当前正在处理的 request/transition(两者是类似的)的任何额外数据:
- 在服务器上,您一次处理一个请求,因此您使用来自
req.body
的数据创建一个静态位置
- 在客户端上,您将状态对象(包含提取的表单数据)传递给
transitionTo()
。
现在您的转换挂钩能够在两种环境中接收相同的表单数据。如果一切顺利,那就太好了!如果事情进展不顺利,您需要一种方法来传递错误并再次 re-render 表单。新州对象再次出手相救!使用 transition.redirect()
并传递输入数据和错误,您现在拥有了在两侧呈现所需的一切。
我现在不打算讨论更具体的细节,因为 v1.0 仍处于测试阶段,而 v0.13.x 无论如何都没有 API 执行此操作的必要条件,但我有一个存储库,它使用上面的拉取请求来实现这个工作流 0.13.x 您可以同时查看:
- isomorphic-lab - 自述文件概述了事物如何组合在一起。
这里也有一些粗略的流程图:
服务器 POST 有错误并重新显示
客户端 POST 有错误并重新显示
我还创建了一些与此场景相关的可重用模块:
- get-form-data 从表单的输入中获取数据,格式为 POST 编辑的格式。
- react-auto-form 提供
<AutoForm>
,您可以使用它代替 <form>
从表单的输入中接收所有数据作为其 onSubmit
处理程序的参数
- react-router-form,对于
<form>
就像 React Router 的 <Link>
对于 <a>
- 它处理触发到给定 action
的转换,通过method
和 body
(表单数据)状态 - 这将很快更新到 v1.0。
我想构建同构 react
+ react-router
应用程序,经过几天谷歌搜索,现在我可以实现仅处理 GET 请求的同构应用程序。
这是我到目前为止所做的:
- 服务器使用
react-router
处理所有请求 react-router
将调用驻留在与路由匹配的每个 React View 中的fetchData
函数。- 将之前获取的数据设置到React View的props中,渲染到
string
- 将
string
和之前获取的数据作为全局变量window.__STATE__
注入HTML并将HTML传递给客户端 - 我们已成功从服务器渲染 React App
- 当客户端完成加载我们的 React App javascript 时,它将尝试呈现。但是我们将来自
window.__STATE__
的状态作为 React App 的 props 传递,并且 React 不会重新渲染,因为状态是相同的
问题是它不适用于 POST/PUT/DELETE/WHATEVER 请求。在处理 GET 请求时,react-router
有关于 params
和 query
的信息。例如,如果我们有一条路由:/user/:uid
并且客户端请求此 url:/user/1?foo=bar
,那么 params
将是:{uid: 1}
并且 query
将成为 {foo: 'bar'}
react-router
然后可以将其传递给 fetchData
函数,这样它将知道使用 uid
为 1 获取用户并使用 foo
查询执行任何操作。
虽然在 POST 请求中,react-router
不知道 POST 参数。在 Server 上,我们当然可以将 POST 参数传递给 fetchData
函数,但是 Client 端呢?它不知道 POST 参数是什么。
有没有办法让服务器告诉客户端 POST 参数?下面是我的登录视图的示例。我希望当用户提交表单时,服务器会在出错时呈现错误消息,或者在成功时将其重定向到仪表板。
fetchData.js
import whenKeys from 'when/keys';
export default (authToken, routerState) => {
var promises = routerState.routes.filter((match) => {
return match.handler.fetchData;
}).reduce((promises, match) => {
promises[match.name] = match.handler.fetchData(authToken, routerState.params, routerState.query);
return promises;
}, {});
return whenKeys.all(promises);
}
server.js
...
app.use((req, res) => {
const router = Router.create({
routes,
location: req.originalUrl,
onError: next,
onAbort: (abortReason) => {
next(abortReason);
}
});
router.run((Handler, state) => {
fetchData(authToken, state).then((data) => {
// render matched react View and generate the HTML
// ...
})
});
});
...
login.jsx
import React from 'react';
import DocumentTitle from 'react-document-title';
import api from './api';
export default class Login extends React.Component {
constructor(props) {
super(props);
// how to fill this state with POST parameters on error?
// how to redirect on success?
// and remember that this file will be called both from server and client
this.state = {
error: '',
username: '',
password: ''
};
}
// I saw some people use this function, but it'll only work if
// the form's method is GET
static willTransitionTo(transition, params, query) {
// if only we could read POST parameters here
// we could do something like this
transition.wait(
api.post('/doLogin', postParams).then((data) => {
transition.redirect(`/dashboard`);
});
);
}
render() {
return (
<DocumentTitle title="Login">
<div className="alert alert-danger">{this.state.error}</div>
<form method="post">
<input type="text" name="username" value={this.state.username} onChange={this._onFieldChange('username')} placeholder="Username" /><br />
<input type="password" name="password" value={this.state.password} onChange={this._onFieldChange('password')} placeholder="Password" /><br />
<button type="submit">Login</button>
</form>
</DocumentTitle>
);
}
_onFieldChange(name) {
var self = this;
return (e) => {
e.preventDefault();
var nextState = {};
nextState[name] = e.target.value;
self.setState(nextState);
}
}
}
在客户端获取 "POST" 数据
在客户端,您通过从表单输入中提取值来获取 POST 数据,其方式与正常提交表单时您在服务器上收到的内容相对应。
使用 POST 数据
所以现在你有了 POST 数据,但你仍然遇到无法将 POST 数据提供给 React Router 0 中的转换挂钩的问题。13.x和更早。我创建了一个 pull request for this feature 现在已经关闭,因为它被包含在即将发布的 v1.0 版本的重写中。
它的要点是位置现在有一个状态对象,用于存储你需要的关于当前正在处理的 request/transition(两者是类似的)的任何额外数据:
- 在服务器上,您一次处理一个请求,因此您使用来自
req.body
的数据创建一个静态位置
- 在客户端上,您将状态对象(包含提取的表单数据)传递给
transitionTo()
。
现在您的转换挂钩能够在两种环境中接收相同的表单数据。如果一切顺利,那就太好了!如果事情进展不顺利,您需要一种方法来传递错误并再次 re-render 表单。新州对象再次出手相救!使用 transition.redirect()
并传递输入数据和错误,您现在拥有了在两侧呈现所需的一切。
我现在不打算讨论更具体的细节,因为 v1.0 仍处于测试阶段,而 v0.13.x 无论如何都没有 API 执行此操作的必要条件,但我有一个存储库,它使用上面的拉取请求来实现这个工作流 0.13.x 您可以同时查看:
- isomorphic-lab - 自述文件概述了事物如何组合在一起。
这里也有一些粗略的流程图:
服务器 POST 有错误并重新显示
客户端 POST 有错误并重新显示
我还创建了一些与此场景相关的可重用模块:
- get-form-data 从表单的输入中获取数据,格式为 POST 编辑的格式。
- react-auto-form 提供
<AutoForm>
,您可以使用它代替<form>
从表单的输入中接收所有数据作为其onSubmit
处理程序的参数 - react-router-form,对于
<form>
就像 React Router 的<Link>
对于<a>
- 它处理触发到给定action
的转换,通过method
和body
(表单数据)状态 - 这将很快更新到 v1.0。