我很高兴地宣布，Moco 1.5.0正式发布了。
Moco是什么？
Moco 是一个可以轻松搭建模拟服务器的框架/工具/程序库。
主要能力
Moco 可以方便地支持 HTTP 模拟服务器的搭建。
- 根据需要，匹配响应的请求，返回相应的应答，配置诸如 HTTP 版本、内容和 HTTP 头等信息。
- 模拟服务器的特殊场景，比如，响应慢。
- 将转发请求至远程服务器，隔离不稳定的服务器。
- 接收请求后异步调用，模拟多级 HTTP 请求的场景。
- 用于单元测试场景，校验请求状况，进行细节验证。
- 提供文件挂载能力，给前端开发提供便利。
更详细的 API，请参考 API。
更多的使用方式，请参考 用法。
过往版本更新：Moco 1.4.0、Moco 1.3.0
版本变更
在 1.5.0 版本中，新增了下面几个 API：
- 在应答响应中，增加
cors，以支持 CORS，下面是 CORS 配置对应的 API：allowOrigin(Access-Control-Allow-Credentials)allowCredentials(Access-Control-Allow-Credentials)exposeHeaders(Access-Control-Expose-Headers)maxAge(Access-Control-Max-Age)allowMethods(Access-Control-Allow-Methods)allowHeaders(Access-Control-Allow-Headers)
- 在模板中，增加了
req.client.port，支持获取客户端连接端口信息 - 在Cookie中，增加了
sameSite，对 SameSite 属性进行配置
CORS
在 1.5.0 中最大的一个新增特性是对于 CORS 的支持。跨域访问是软件开发中常常遇到的问题，因此，服务端常常需要配置对于 CORS（Cross-origin resource sharing）的支持。我们可以通过在应答中配置cors 来设置服务器对于 CORS 的支持。
默认的 CORS 设置
使用 CORS 最简单的方式是默认支持 CORS，也就是允许所有的跨域访问。这时，我们无需配置任何信息，只要在应答中设置cors即可。
- Java API
server.response(cors());
- JSON API
{
"response" :
{
"cors" : true
}
}
在这种默认的情况下，Moco 会设置常用的 HTTP 头以支持 CORS，比如：
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: *
Access-Control-Allow-Headers: *
allowOrigin/Access-Control-Allow-Origin
在 CORS 中，通过设置 Access-Control-Allow-Origin 这个头，我们可以限制哪些域名可以进行跨域访问。通过 allowOrigin，我们可以设置 Access-Control-Allow-Origin HTTP 头，比如：
- Java API
server.response(cors(allowOrigin("https://www.github.com/")));
- JSON API
{
"response" :
{
"cors" :
{
"allowOrigin" : "https://www.github.com/"
}
}
}
如果允许来自所有域名的请求访问，我们可以将 allowOrigin 的值设置成 *。
在 JSON API 中，我们还可以直接设置 Access-Control-Allow-Origin。
- JSON
{
"response" :
{
"cors" :
{
"Access-Control-Allow-Origin" : "https://www.github.com"
}
}
}
allowMethods/Access-Control-Allow-Methods
在 CORS 中，通过设置 Access-Control-Allow-Methods 这个头，我们可以限制哪些 HTTP 方法可以进行跨域访问。通过 allowMethods，我们可以设置 Access-Control-Allow-Methods HTTP 头，比如：
- Java API
server.response(cors(allowMethods("GET", "PUT")));
server.response(cors(allowMethods(HttpMethod.GET, HttpMethod.PUT)));
在 Java API 中，你可以直接使用字符串进行设置，或者使用 HttpMethod 的枚举。
- JSON
{
"response" :
{
"cors" :
{
"allowMethods" : ["GET", "PUT"],
}
}
}
如果允许所有的 HTTP 方法，我们可以将 allowMethods 的值设置成 *。
在 JSON API 中，我们还可以直接设置 Access-Control-Allow-Methods。
- JSON
{
"response" :
{
"cors" :
{
"Access-Control-Allow-Methods" : ["GET", "PUT"]
}
}
}
allowHeaders/Access-Control-Allow-Headers
在 CORS 中，Access-Control-Allow-Headers 这个头表示服务器支持的所有头信息字段。通过 allowHeaders，我们可以设置 Access-Control-Allow-Headers HTTP 头，比如：
- Java API
server.response(cors(allowHeaders("X-Header", "Y-Header")));
- JSON
{
"response" :
{
"cors" :
{
"allowHeaders" : ["X-Header", "Y-Header"]
}
}
}
如果支持所有的 HTTP 头，我们可以将 allowHeaders 的值设置成 *。
在 JSON API 中，我们还可以直接设置 Access-Control-Allow-Headers。
{
"response" :
{
"cors" :
{
"Access-Control-Allow-Headers" : ["X-Header", "Y-Header"]
}
}
}
maxAge/Access-Control-Max-Age
在 CORS 中，Access-Control-Max-Age 这个头表示预检请求的有效期。通过 maxAge，我们可以设置 Access-Control-Max-Age HTTP 头，这里我们需要设置时间以及其单位，比如：
- Java API
server.response(cors(maxAge(1728000, TimeUnit.SECONDS)));
- JSON
{
"response" :
{
"cors" :
{
"maxAge": {
"duration": 1728000,
"unit": "second"
}
}
}
}
在 JSON API 中，我们还可以直接设置 Access-Control-Max-Age。
{
"response" :
{
"cors" :
{
"Access-Control-Max-Age" : {
"duration": 1728000,
"unit": "second"
}
}
}
}
allowCredentials/Access-Control-Allow-Credential
在 CORS 中，Access-Control-Allow-Credential 这个头表示是否允许发送Cookie。通过 allowCredentials，我们可以设置 Access-Control-Allow-Credential HTTP 头，比如：
- Java API
server.response(cors(allowCredentials(true)));
- JSON
{
"response" :
{
"cors" :
{
"allowCredentials" : true
}
}
}
在 JSON API 中，我们还可以直接设置 Access-Control-Allow-Credentials。
{
"response" :
{
"cors" :
{
"Access-Control-Allow-Credentials" : true
}
}
}
exposeHeaders/Access-Control-Expose-Headers
在 CORS 中，Access-Control-Expose-Headers 指定了浏览器能够通过 XMLHttpRequest 对象的getResponseHeader() 方法得到的 HTTP 头信息。通过 exposeHeaders，我们可以设置 Access-Control-Expose-Headers 这个 HTTP 头，比如：
- Java API
server.response(cors(exposeHeaders("X-Header", "Y-Header")));
- JSON
{
"response" :
{
"cors" :
{
"exposeHeaders" : ["X-Header", "Y-Header"]
}
}
}
在 JSON API 中，我们还可以直接设置 Access-Control-Expose-Headers。
{
"response" :
{
"cors" :
{
"Access-Control-Expose-Headers" : ["X-Header", "Y-Header"]
}
}
}
req.client.port
req.client.port 提供了在模板中访问客户端连接端口的能力。
- Java API
server.request(by(uri("/template"))).response(template("${req.client.port}"));
- JSON API
{
"request": {
"uri": "/template"
},
"response": {
"text": {
"template": "${req.client.port}"
}
}
}
sameSite
相比于原有的几个 Cookie 属性，SameSite 是一个后来增加的 Cookie 属性，用来防止 CSRF 攻击和用户追踪。sameSite API 可以让我们为 Cookie 设置 SameSite 属性。
- Java API
server.response(cookie("loggedIn", "true", sameSite("NONE")), status(302));
server.response(cookie("loggedIn", "true", sameSite(CookieAttribute.SameSite.NONE)), status(302));
sameSite 支持 STRICT、LAX、NONE 几个值。在 Java API 中，你可以直接使用字符串进行设置，或者使用 CookieAttribute.SameSite 的枚举。
- JSON API
{
"request": {
"uri": "/cookie-with-same-site"
},
"response": {
"cookies": {
"login": {
"value": "true",
"sameSite": "Lax"
}
}
}
}
欢迎使用 1.5.0 版本，体验 Moco 最新的功能！