RestAssured

      <tr><td colspan='2'><input name="submit" type="submit"/></td></tr><br />       </table><br />        </form><br />      </body><br /> </html> |

| —- |

也就是说，服务器期望用户填写 “j_username” 和 “j_password” 输入字段，然后按 “提交” 登录。 使用 REST Assured，您可以测试受表单身份验证保护的服务，如下所示：

在 REST 中使用此类表单身份验证时，会导致为检索包含登录详细信息的网页而向服务器发出附加请求。 REST Assured 将尝试解析此页面并查找两个输入字段（用户名和密码）以及表单操作的 URI。 这可能失败，取决于网页的复杂性。 更好的选择是在设置表单身份验证时提供这些详细信息。 在这种情况下，可以：

这样 REST Assured 不需要提出额外的请求并解析网页。 还有一个预定义的 FormAuthConfig 称为springSecurity，如果你使用默认的 Spring Security 属性，可以使用它：

CSRF
如今，服务器要求请求中提供一个CSRF token 是常有的事了，这可以抵御多种类型的攻击。rest-assured 支持解析并自动给服务器供应一个 CSRF token。为此，rest-assured 必须先发起一个追加请求来解析该网站（的部分内容）。
你可以通过下面的代码启用对 CSRF 的支持：

现在 rest-assured 将会自动尝试侦测这个网站是否包含 CSRF token 机制。为了使 rest-assured 的暴力破解更加顺利，可能会提供一个 CSRF 域的名称（这里我们假设我们正在使用 Spring 的安全默认值，因此我们可以使用预定义的springSecurity表单认证配置）：

我们至此已经告诉 rest-assured 去查找名为”_csrf”的 CSRF 域了（然而这虽然会比自动侦测更快，也更容易出错）。
默认情况下 CSRF 值将会作为一个请求参数，但是如果必要你也可以配置其放在请求的 header 中：

OAuth
为了使用 OAuth1 和 OAuth2（关于查询/请求参数签名方面的机制），您需要添加Scribe到 classpath 中（如果你正在使用 2.1.0 或者更早之前版本的 rest-assured，请参考旧版指南）。如果是 maven 请添加以下的依赖：

OAuth 1
OAuth1 要求Scribe在 classpath 中。为使用 auth1 的认证您可以：

OAuth 2
自从 2.5.0 版本您可以依赖于Scribe使用 OAuth2 的认证：

这将会把 OAuth2 的accessToken放入 header 中。想要更加显式的操作可以：

这里之所以存在given().auth().oauth2(..)这种语法是为了向后兼容 (做的是相同的事情)。如果你需要在请求参数中提供一个 OAuth2 token，您需要把Scribe放在 classpath 下，接下来：

自定义身份验证
rest-assured 允许您创建一个自定义的身份验证。你可以通过实现io.restassured.spi.AuthFilter接口，并作为一个过滤器。假设您的安全机制，是由两个 header 值相加然后组成一个新的叫做”AUTH”的 header（当然这并不安全）。然后您可以这样做（Java 8 的语法）：

使用AuthFilter而不是Filter的原因是，当我们执行given().auth().none(). ..类似这样的操作时AuthFilters会被自动移除。
Multi-part 表单数据
通常我们在向服务器传输大容量的数据时（译者注：比如文件）会使用 multipart 表单数据技术。rest-assured 提供了一种multiPart方法来辨别这究竟是文件、二进制序列、输入流还是上传的文本。表单中上传一个文件可以这样：

它将会假设有一个 control 叫做”file”。在 HTML 中这意味着 input 标签的属性值为 file。为了解释得更清楚请看下面的 HTML 表单：

在这个例子中 control 的名字就是一个属性名为 file 的 input 标签。如果您使用的 control 名不是这个，需要指定：

在同一个请求中提供多个”multi-parts”事务也是可能的：

更多高级使用方法可以使用MultiPartSpecBuilder。举个例子：

你可以通过使用MultiPartConfig指定默认的 control 名和文件名。举个例子：

这就会默认把 control 名配置为”something-else”而不是”file”。
其它用法请查阅 这篇博客。
对象映射
rest-assured 支持从 JSON 和 XML 中映射 Java 对象。映射 JSON 需要 classpath 中有 Jackson 或者 Gson 才能使用，XML 则需要 JAXB。
序列化
假设我们有下面的 Java 对象：

| Java
public class Message {
private String message;

public String getMessage() {<br />        return message;<br />    }
public void setMessage(String message) {<br />        this.message = message;<br />    }<br />} |

| —- |

您需要将这个对象序列化为 JSON 并发送到请求中。可以有多种方式：
基于 Content-Type 的序列化

在这个例子里，由于请求中的 content-type 被设置为”application/json”，rest-assured 也就会把对象序列化为 JSON。rest-assured 首先会在您的 classpath 中寻找 Jackson，如果没有则使用 Gson。如果您把请求中的 content-type 修改为”application/xml”，rest-assured 将会使用 JAXB 把对象序列化为 XML。如果没有指定 content-type，rest-assured 会按照以下的优先级进行序列化：
使用 Jackson 2 将对象序列化为 JSON（Faster Jackson (databind)）
使用 Jackson 将对象序列化为 JSON（databind）
使用 Gson 将对象序列化为 JSON
使用 JAXB 将对象序列化为 XML
rest-assured 也关心 content-type 的字符集（charset）等等。

您也可以把Message这个实例序列化为一个表单参数：

这个 message 对象将会被实例化为 utf-16 编码的 JSON（如果有 Jackson 或者 Gson）。
由 HashMap 创建 JSON
您也可以提供一个 Map，由此 rest-assured 可以创建一个 JSON。

这将会产生一个 JSON 数据（JSON payload）：

使用显式序列化器
如果您的 classpath 中同时有多个对象、或者不考虑 content-type 的设置，可以显示地指定一个序列化器。

在这个例子中 message 对象将会被 JAXB 序列化为一个 XML。
反序列化
让我们再次假设我们有以下的 Java 对象：

| Java
public class Message {
private String message;

public String getMessage() {<br />        return message;<br />    }
public void setMessage(String message) {<br />        this.message = message;<br />    }<br />} |

| —- |

我们需要把响应体反序列化为一个 Message 对象。
基于 Content-Type 的反序列化
假设服务端返回一个这样的 JSON：

将它反序列化为一个 Message 对象：

为此响应体的 content-type 必须是”application/json”（或者其它包含 “json” 的类型）。如果服务端返回：

且 content-type 是”application/xml”，代码可以完全不用修改：

自定义类型 content-type 反序列化
如果服务端返回一个自定义的 content-type，假设是”application/something”，你仍然想使用 rest-assured 的对象映射的话，这有两种方法。你可以使用显式指定的方法或者为自定义的 content-type 注册一个解析器：

或

你也可以注册一个默认解析器，或者静态式注册一个自定义的解析器，也可以使用模式（specifications）。
使用显式反序列化器
如果您的 classpath 下同时有多个对象或者不在意响应体的 content-type，你可以使用显示的反序列化器。

配置
您可以使用ObjectMapperConfig配置预定义的对象映射，并传递给细节配置。举个例子，你可以将 GSON 的命名策略改为 LowerCaseWithUnderscores（译者注：一种策略，将大写字母改为小写字母并添加下划线）：

这里为 GSON、JAXB、Jackson 和 Faster Jackson 都预定义了用来映射实例的工厂。
自定义
默认情况下 rest-assured 将会扫描 classpath 中各种各样的对象映射。如果您想要集成一种对象映射，默认是不支持的，如果您已经做好了封装，可以实现io.restassured.mapper.ObjectMapper 接口。告诉 rest-assured 使用您的对象映射或者将其作为 body 方法里的第二个参数：

或者您可以静态式定义：

更多例子参阅这里。
自定义解析器
rest-assured 提供了预定义的解析器，例如 HTML、XML 和 JSON 的。但是您可以通过注册预置的解析器来解析现在不支持的内容类型：

例如注册一个可以解析’application/vnd.uoml+xml’类型的 XML 解析器：

您也可以注销一个解析器：

解析器可以指定于每个请求中：

然后使用模式。
默认解析器
有时如果响应中不包含任何 content-type，指定一个默认的解析器会很有用。

你也可以为一次请求指定默认的解析器：

或者使用响应体模式。
默认值
rest-assured 发起请求时默认使用 localhost 的 8080 端口.如果你需要换个端口：

或者简单些:

您也可以改变默认的基本 URI、基本路径、端口和认证 scheme：

这意味着类似get(“/hello”)这样的请求实际上会被解析为http://myhost.org:80/resource/hello))。其它的默认值也可以被指定：，附带身份认证中的用户名和密码属性。关于设置根路径参考 这里。

您可以设置重置为标准的 baseURI (localhost)，basePath（空），标准端口（8080），标准根路径（“”），默认身份认证 scheme（none）和 URL 编码启用（true）：

模式复用
与其复制一份响应的断言或者请求参数（的代码）到另一个测试用例中，我们可以使用 RequestSpecBuilder或者ResponseSpecBuilder定义一个规范提案。
举个例子，在多个测试用例中，我们都涉及到这样的内容：判断响应码是否为 200，JSON 数组 x.y 的长度是否是 2，您可以定义一个 ResponseSpecBuilder：

在这个例子中需要重用的数据定义并合并在”responseSpec”，并且仅当所有预期都通过时用例才能通过。
您也可以将相同的请求参数重用：

这里请求数据合并在”requestSpec”中，由此上面例子中实际请求参数包括两个 (“parameter1” 和 “parameter2”) 和一个 header(“header1”)。
过滤器
过滤器会在请求实际发起之前侦测和改变该请求的内容，也可以在响应体实际返回之前拦截并改变。您可以将其理解为 AOP 中的 around advice（译者注：可以自行搜索切片编程）。过滤器也可以用在认证 scheme、session 管理、日志中。创建一个过滤器需要实现io.restassured.filter.Filter接口。使用过滤器：

rest-assured 提供了几个过滤器：
io.restassured.filter.log.RequestLoggingFilter: 可以打印出请求模式的细节。
io.restassured.filter.log.ResponseLoggingFilter: 可以打印响应信息的细节如果响应体的状态码匹配 given 方法的参数。
io.restassured.filter.log.ErrorLoggingFilter: 如果发生了异常（状态码在 400 和 500 之间），过滤器将会打印响应的内容。
Response Builder
如果您想要通过一个过滤器改变Response ，可以使用ResponseBuilder创建一个基于原始 response 的新实例。比如把原始响应体改为 something：

日志
在大量的用例中，打印出响应或者请求的细节将有助于创建正确的预期、发送准确的请求。为此您可以使用 rest-assured 预定义的过滤器，或者使用其中的快捷方法。
请求日志
自 1.5 版本起 rest-assured 支持对特定的请求打日志，之前的做法是使用RequestLoggingFilter。注意打印日志后 HTTP Builder 和 HTTP Client 会添加额外的 header 内容。这个过滤器可以只记录特定请求的特定细节。换句话说，你可以不关注RequestLoggingFilter记录的有关实际往服务端发送的内容。因为随后的其它过滤器会在日志记录后改变这个请求。如果你想要记录实际发送的内容，参阅HTTP Client logging docs ，或者使用第三方工具例如Wireshark。示例如下：

响应日志
如果您想打印除了状态码以外的响应信息，可以：

这样做，无论是否有异常错误发生，都会打印出响应信息。如果您希望只有当错误发生时才打印响应信息，可以：

您也可以记录响应里包括状态码、header、cookie 的所有细节：

也可以只记录状态码、header 或者 cookie：

您也可以配置为仅当状态码匹配某个值时才打印响应体：

认证失败日志
自 rest-assured2.3.1 版本起，您可以仅当认证失败时记录请求或者响应的日志。为请求打日志：

为响应打日志：

同时启用对请求和响应的认证失败记录，可以使用LogConfig:

认证失败，仅记录 header。
还有种针对所有请求的简单写法：

根路径
为避免在 body 方法里使用重复的路径，您可以指定一个根路径：

使用根路径：

也可以设置一个默认的根路径：

在许多高级用例中，在根路径上附加一些参数也很有用。您可以使用appendRoot方法：

也可以对根路径进行拆分：

路径参数
在预定义的路径包含变量时，路径参数会很有用。举个例子：

将会对”something.else[0]（译者注：这里只是举个例子）”是否等于”some value”进行判断。
另一种用法是，如果您有复杂的根路径：

路径参数遵循 Java 的标准格式语法。
注意withArgs方法可以从io.restassured.RestAssured类中静态导入。
有时当所有在根路径中指定的参数都已经验证过了，只想要验证一个不含多余参数的 body 时，可以使用withNoArgs：

Session 支持
rest-assured 提供了一套简单的管理 session 的方式。您可以在 DSL中预定义一个 session 的 id 值:

上面的代码实际上是这个的简写：

您也可以为所有的请求指定一个默认的sessionId：

默认情况下 session id 的名字是JSESSIONID，但是您可以通过使用SessionConfig来修改：

您也可以指定一个 sessionid 并在其它用例中复用，使用RequestSpecBuilder：

从响应对象中获取一个 session id：

Session 过滤器
2.0.0 版本起您可以使用session filter截获并提供一个 session，举个例子：

| Java
SessionFilter sessionFilter = new SessionFilter();
given().
auth().form(“John”, “Doe”).
filter(sessionFilter).
when().
get(“/formAuth”).
then().
statusCode(200);

given().
filter(sessionFilter). // Reuse the same session filter instance to automatically apply the session id from the previous response
when().
get(“/x”).
then().
statusCode(200); | | —- |

要想获取由SessionFilter截获的 session id：

SSL
在多数场景下，SSL 能顺利运转，这多亏于 HTTP Builder 和 HTTP Client。如果服务端使用了无效的证书，然而有些例子下还是会出错。最简单的方法您可以使用”relaxed HTTPs validation”：

也可以为所有的请求静态定义这个配置：

或者放在请求指定中进行复用。
这将会假定我们使用 SSL 协议。想要改变需要覆盖relaxedHTTPSValidation方法：

您也可以创建一个 Java keystore 文件并执行一些细粒度的操作。这并不难，首先阅读指南，然后在 rest-assured 中使用 keystore：

或者为每一个请求指定：

您也可以定义一个可复用的keystore。
如果您已经使用密码载入了一个 keystore，可以将其作为可信的 keystore：

在这也可以找到一些相关的示例。
有关更多 SSL 的高级配置参阅SSL Configuration。
SSL 无效主机名
如果证书指定了一个无效的主机名，并且您无需创建和导入一个 keystore。自 2.2.0 起您可以：

让所有请求支持所有的主机名。

对于单个请求。
注意如果您使用了”relaxed HTTPs validation”，那么allowAllHostnames将会默认启用。
URL 编码
由于 rest-assured 提供了优秀的自动编码，通常您无需考虑 URL 编码的事情。在有些用例中仍然需要关闭 URL 编码的功能。其中一个原因是在使用 rest-assured 之前可能你已经做过一次编码。为防止两次 URL 编码您需要告诉 rest-assured 禁用这个功能。

或者

代理（proxy）配置
从版本 2.3.2 开始 REST Assured 可以更好地支持代理。 例如，如果你有一个代理在 localhost 端口 8888 你可以做：

如果服务器在本地环境中运行，可以不指定主机名：

要使用 HTTPS，需要提供第三个参数（scheme）或使用io.restassured.specification.ProxySpecification。 例如：

其中 host 从 io.restassured.specification.ProxySpecification 静态导入。
从版本 2.7.0 开始，您还可以为代理指定抢占式基本身份验证。 例如：

其中auth是从io.restassured.specification.ProxySpecification静态导入的，也可以将身份验证与不同的 host 相结合：

静态代理配置
可以为所有请求配置静态代理，例如：

或者：

请求规范代理配置
您还可以创建请求规范并在其中指定代理：

详细配置
详细配置由RestAssuredConfig实例提供，您可以使用它配置HTTP Client的参数以及重定向，日志，编码器，解码器，Session，ObjectMapper，Connection，SSL和ParamConfig 设置。 例子：
特定请求:

或使用 RequestSpecBuilder：

或所有请求：

config() and newConfig() can be statically imported from io.restassured.config.RestAssuredConfig.
编码配置
使用 [EncoderConfig]（http://static.javadoc.io/io.rest-assured/rest-assured/3.0.1/io/restassured/config/EncoderConfig.htmlencoding），可以指定默认的内容 charset（如果没有在 content-type 头中指定）和查询参数 charset 为所有请求。 如果未指定内容字符集，则使用 ISO-8859-1，如果未指定查询参数字符集，则使用 UTF-8。 用法示例：

如果没有通过使用EncoderConfig中的 defaultCharsetForContentType 方法为此内容类型显式定义字符集，那么还可以指定用于特定内容类型的编码器字符集。 例如：

如果没有通过使用EncoderConfig中的 defaultCharsetForContentType 方法为此内容类型显式定义字符集，那么还可以指定用于特定内容类型的编码器字符集。 例如：

这将假设明确指定一个字符集的 “application / xml” 内容类型的 UTF-16 编码。 默认情况下，“application / json” 被指定为使用 “UTF-8” 作为默认内容类型，这是由 [RFC4627]（https://www.ietf.org/rfc/rfc4627.txt）指定的。
避免自动将字符集添加到 content-type 标头
默认情况下，REST Assured 会自动添加字符集标头。 要完全禁用这个，你可以这样配置EncoderConfig：

解码配置
使用 [DecoderConfig]（http://static.javadoc.io/io.rest-assured/rest-assured/3.0.1/io/restassured/config/DecoderConfig.html），您可以将默认响应内容解码字符集设置为 所有响应。 如果您期望使用不同于 ISO-8859-1 的内容字符集（这是默认字符集），并且响应未在内容类型标头中定义字符集，那么这将非常有用。 用法示例：

您还可以使用 “DecoderConfig” 来指定要应用哪些内容解码器。 当你这样做时，“Accept-Encoding” 头部将被自动添加到请求中，并且响应主体将被自动解码。 默认情况下，启用 GZIP 和 DEFLATE 解码器。 例如要删除 GZIP 解码但保留 DEFLATE 解码，您可以执行以下操作：
您还可以使用 “DecoderConfig” 来指定要应用哪些内容解码器。 当你这样做时，“Accept-Encoding” 头部将被自动添加到请求中，并且响应主体将被自动解码。 默认情况下，启用 GZIP 和 DEFLATE 解码器。 例如要删除 GZIP 解码但保留 DEFLATE 解码，您可以执行以下操作：

如果没有通过使用DecoderConfig中的 “defaultCharsetForContentType” 方法为此内容类型明确定义字符集，则还可以指定要用于特定内容类型的解码器字符集。 例如：

这将假设明确指定一个字符集的 “application / xml” 内容类型的 UTF-16 编码。 默认情况下，“application / json” 使用 “UTF-8” 作为默认字符集，这是由 [RFC4627]（https://www.ietf.org/rfc/rfc4627.txt）指定的。
Session 配置
使用 Session 配置，您可以配置 REST Assured 使用的默认 session ID 名称。 默认 session id 名称是JSESSIONID，如果应用程序中的名称不同，并且您希望使用 REST Assured 的 [会话支持]（＃Session_support），您只需更改它。 用法：

重定向 DSL
重定向配置可以使用 DSL 指定。 例如。

网络连接配置
让您配置 REST Assured 的连接设置。 例如，如果要在每个响应后强制关闭 Apache HTTP Client 连接。 如果您在响应中使用少量数据进行大量快速连续请求，则可能需要执行此操作。然而，如果你正在下载（尤其是大量的）分块，你绝不能每个响应后关闭连接的数据。 默认情况下，连接在每个响应后不关闭。

Json Config
JsonPathConfig允许您在 REST Assured 或 JsonPath使用时配置 Json 设置。 它让你配置如何处理 JSON 数字。

HTTP Client 配置
为 REST Assured 将在执行请求时使用的 HTTP Client 实例配置属性。 默认情况下，REST Assured 会为每个 “given” 语句创建一个新的 http Client 实例。 要配置重用，请执行以下操作：

您还可以使用httpClientFactory方法提供自定义 HTTP Client 实例，例如：

| Java
RestAssured.config = RestAssured.config().httpClient(httpClientConfig().httpClientFactory(
new HttpClientConfig.HttpClientFactory() {

        @Override<br />            public HttpClient createHttpClient() {<br />                return new SystemDefaultHttpClient();<br />            }<br />        })); |

| —- |

注意，目前你需要提供一个AbstractHttpClient的实例.
也可以配置默认参数等。
SSL 配置
SSLConfig 允许您指定更高级的 SSL 配置，如信任库，密钥库类型和主机名验证器。 例如：

参数配置
ParamConfig 允许您配置在 “冲突” 时，更新不同的参数。 默认情况下，所有参数都将合并，因此如果您执行以下操作：

REST Assured 将发送一个查询字符串param1 = value1＆param1 = value2。
如果这不是您想要的，你可以配置 REST Assured 为 replace 值代替：

REST Assured 现在将替换param1的值为value2（因为它是最后写的），而不是将它们合并在一起。 您也可以为所有参数类型的每种类型配置统一的更新策略

也支持在 [Spring Mock Mvc 模块]（# Spring Mock Mvc 模块）（配置 [MockMvcParamConfig]（http://static.javadoc.io/io.restassured/spring-mock -mvc / 3.0.1 / io / restassured / module / mockmvc / config / MockMvcParamConfig.html）。
Spring Mock Mvc 模块
REST Assured 2.2.0 引入了对 [Spring Mock Mvc]（http://docs.spring.io/spring/docs/current/javadoc-api/org/springframework/test/web/servlet/MockMvc.html）的支持，使用 spring-mock-mvc模块。 这意味着您可以单元测试 Spring Mvc Controller。 例如给出以下 Spring Controller：

| Java
@Controller
public class GreetingController {

private static final String template = "Hello, %s!";<br />    private final AtomicLong counter = new AtomicLong();
@RequestMapping(value = "/greeting", method = GET)<br />    public @ResponseBody Greeting greeting(<br />            @RequestParam(value="name", required=false, defaultValue="World") String name) {<br />        return new Greeting(counter.incrementAndGet(), String.format(template, name));<br />    }<br />} |

| —- |

你可以使用 [RestAssuredMockMvc]（http://static.javadoc.io/io.restassured/spring-mock-mvc/3.0.1/io/restassured/module/mockmvc/RestAssuredMockMvc.html）来测试它，像这样：

即它与标准的 REST Assured 语法非常相似。 这使得运行测试真的很快，并且比标准的 REST Assured 更容易引导环境和使用 mock。 你常用的标准 REST Assured 中的大多数东西都可以使用 RestAssured Mock Mvc。 例如（某些）配置，静态规范，日志等等。要使用它，你需要依赖于 Spring Mock Mvc 模块：

或者 [下载]（http://dl.bintray.com/johanhaleby/generic/spring-mock-mvc-3.0.1-dist.zip）。
Bootstrapping RestAssuredMockMvc
静态导入方法:

有关其他静态导入，请参阅文档的 [静态导入]（＃static-imports）部分。
为了使用 RestAssuredMockMvc 启动测试，您需要使用一组Controller，MockMvc 实例或 Spring 的 WebApplicationContext 来初始化它。您可以对单个请求执行此操作，如上例所示：

也可以使用静态方法:

如果静态定义，则不必在 DSL 中指定任何Controller（或 MockMvc 或 WebApplicationContext 实例）。这意味着前面的例子可以写成：

异步请求
从版本2.5.0开始 RestAssuredMockMvc 支持异步请求。例如，假设有以下Controller

| Java
@Controller
public class PostAsyncController {

@RequestMapping(value = "/stringBody", method = POST)<br />    public @ResponseBody<br />    Callable<String> stringBody(final @RequestBody String body) {<br />        return new Callable<String>() {<br />            public String call() throws Exception {<br />                return body;<br />            }<br />        };<br />    }<br />} |

| —- |

你可以这样测试：

默认超时为 1 秒。也可以使用 DSL 更改超时：

还可以使用AsyncConfig，例如：

withTimeout 是从 io.restassured.module.mockmvc.config.AsyncConfig 静态导入的，只是创建一个具有给定超时时间的AsyncConfig的快捷方式。
全局应用配置以应用于所有请求，如下：

请求 1 和 2 现在将使用默认超时 100 毫秒。
添加请求处理器
Spring MockMvc 已经对请求处理器做了支持，并且您也可以在 RestAssuredMockMvc 中使用。举个例子：

请注意，推荐从org.springframework.security.test.web.servlet.request.SecurityMockMvcRequest PostProcessors(例如认证相关的 RequestPostProcessors) 加入请求处理器时，直接使用auth方法，这样可读性更强，当然结果是一样的：

这里的 httpBasic 静态导入自SecurityMockMvcRequestPostProcessor。
添加结果处理器
Spring MockMvc 对结果处理器 做了支持，您也可以在 RestAssuredMockMvc 中使用。比方说您想要使用原生的 MockMvc 日志功能：

这里的print是从org.springframework.test.web.server.result.MockMvcResultHandlers静态导入的。请注意如果您正在使用 2.6.0 或更早版本的 rest-assured，需要这样使用结果处理器：

但是 rest-assured2.8.0 起不推荐使用这种语法。
使用结果匹配器
Spring MockMvc 提供了许多结果处理器，您可以从中获益。RestAssuredMockMvc 也对其中必要的功能进行支持。举个例子，基于某种原因您想要使用结果匹配器验证状态码是否等于 200：

这里的status()是从org.springframework.test.web.server.result.MockMvcResultMatchers静态导入的。注意，您可以使用expect方法，功能上和assertThat一样，但是更接近原生的 MockMvc 的语法
拦截器
您也可以在mock请求之前截住并改变MockHttpServletRequestBuilder。您需要先定义一个MockHttpServletRequestBuilderInterceptor，并在 RestAssuredMockMvc 中使用：

Specifications
正如标准的 Rest Assured，你可以使用specifications，以便更好地重用。请注意，RestAssuredMockMvc 的请求规范构建器称为MockMvcRequestSpecBuilder。同样的ResponseSpecBuilder 也可以在 RestAssuredMockMvc 中使用。可以静态定义Specifications（规范），就像标准的 Rest Assured 一样。例如：

| Java
RestAssuredMockMvc.requestSpecification = new MockMvcRequestSpecBuilder().addQueryParam(“name”, “Johan”).build();

RestAssuredMockMvc.responseSpecification = new ResponseSpecBuilder().expectStatusCode(200).expectBody(“content”, equalTo(“Hello, Johan!”)).build();

given().
standaloneSetup(new GreetingController()).
when().
get(“/greeting”).
then().
body(“id”, equalTo(1)); | | —- |

重置 RestAssuredMockMvc
如果您使用了任何静态配置，您可以通过调用 RestAssuredMockMvc.reset（）方法轻松地将 RestAssuredMockMvc 重置为其默认状态。
Spring MVC 认证
spring-mock-mvc的版本`2.3.0’支持身份验证。例如：

一些认证方法需要 Spring 安全在类路径（可选）。也可以静态定义认证：

其中principal方法是从RestAssuredMockMvc静态导入的。还可以在请求构建器中定义认证方案：

使用 Spring Security 测试
从版本2.5.0也有更好的支持 Spring Security。如果你在类路径中有spring-security-test，你可以这样做：

其中httpBasic是从SecurityMockMvcRequestPostProcessor静态导入的。这将对请求应用基本认证。为了这个工作，你需要应用SecurityMockMvcConfigurer到 MockMvc 实例。您可以手动执行此操作：

或者 RESTAssuredMockMvc在你初始化一个AbstractMockMvcBuilder实例时，将自动尝试使用springSecurity配置，比如： 当配置一个”web app context”：

这是一个完整的案例：

| Java
import io.restassured.module.mockmvc.RestAssuredMockMvc;
import org.junit.After;
import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
import org.springframework.test.context.web.WebAppConfiguration;
import org.springframework.web.context.WebApplicationContext;
import static io.restassured.module.mockmvc.RestAssuredMockMvc.given;
import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.httpBasic;
import static org.springframework.security.test.web.servlet.response.SecurityMockMvcResultMatchers.authenticated;
@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(classes = MyConfiguration.class)
@WebAppConfiguration
public class BasicAuthExample {

@Autowired<br />    private WebApplicationContext context;
@Before public void<br />    rest_assured_is_initialized_with_the_web_application_context_before_each_test() {<br />        RestAssuredMockMvc.webAppContextSetup(context);<br />    }
@After public void<br />    rest_assured_is_reset_after_each_test() {<br />        RestAssuredMockMvc.reset();<br />    }
@Test public void<br />    basic_auth_example() {<br />        given().<br />                auth().with(httpBasic("username", "password")).<br />        when().<br />                get("/secured/x").<br />        then().<br />                statusCode(200).<br />                expect(authenticated().withUsername("username"));<br />    }<br />} |

| —- |

你也可以定义一个针对于所有请求的身份认证，比如：

此处 with是从io.restassured.module.mockmvc.RestAssuredMockMvc静态导入的。这里也可以使用request specification。
注入一个用户
也可以使用 Spring Security 测试注释，例如_@_WithMockUser和 _@_WithUserDetails。例如，假设您想测试此Controller：

| Java
@Controller
public class UserAwareController {

@RequestMapping(value = "/user-aware", method = GET)<br />    public<br />    @ResponseBody<br />    String userAware(@AuthenticationPrincipal User user) {<br />        if (user == null &#124;&#124; !user.getUsername().equals("authorized_user")) {<br />            throw new IllegalArgumentException("Not authorized");<br />        }
    return "Success");<br />    }<br />} |

| —- |

您可以看到 userAware() 需要一个 User 作为参数，我们让 Spring Security 使用_@_AuthenticationPrincipal 注入它。要生成测试用户，我们可以这样做：

注意，也可以不使用注释，而是使用RequestPostProcessor ，例如SecurityMockMvcRequestPostProcessors#user(java.lang.String)).
参数相关
MockMvc 没有区分不同类型的参数，所以param，formParam和queryParam目前只是委托给 MockMvc 中的 param。 formParam自动添加application / x-www-form-urlencoded内容类型的头部，就像标准的 Rest Assured 一样。
Scala 支持
REST Assured 2.6.0 引入了将 “别名” 添加到 “then” 方法的scala-support模块定义在Response或MockMvcResponse中调用 “Then”。这样做的原因是then在将来可能是 Scala 中的保留关键字，并且当使用具有此名称的方法时，编译器会发出警告。要启用Then，只需从scala-support模块导入io.restassured.module.scala.RestAssuredSupport.AddThenToResponse类。例如：

注意：同样支持 Spring Mock Mvc Module.
可以像这样使用它：
SBT:

Maven:

Gradle:

No build manager:
手动下载 distribution file 。
Kotlin 支持
Kotlin 是由JetBrains开发的一种语言，它与 Java 和 REST Assured 非常好地集成。当使用它与 REST Assured 有一件事，必须逃避when，因为它是 Kotlin 中的保留关键字。例如：

为了解决这个问题，创建一个extension function，创建一个别名为when时叫做When：

代码现在可以像这样写：

注意，我们不需要任何转义。有关更多详细信息，请参阅this博客文章。
更多信息
其他相关信息，请参考 javadoc:
RestAssured
RestAssuredMockMvc Javadoc
Specification package
一些代码示例:
REST Assured tests
JsonPathTest
XmlPathTest