程序包 cn.taketoday.test.web.client

类 AbstractRequestExpectationManager

java.lang.Object

cn.taketoday.test.web.client.AbstractRequestExpectationManager

所有已实现的接口:

RequestExpectationManager

直接已知子类:

SimpleRequestExpectationManager, UnorderedRequestExpectationManager

public abstract class AbstractRequestExpectationManager
extends Object
implements RequestExpectationManager

Base class for RequestExpectationManager implementations responsible for storing expectations and actual requests, and checking for unsatisfied expectations at the end.

Subclasses are responsible for validating each request by matching it to to expectations following the order of declaration or not.

从以下版本开始:

4.0

作者:

Rossen Stoyanchev, Juergen Hoeller, Harry Yang

嵌套类概要

嵌套类

修饰符和类型	类	说明
protected static class	AbstractRequestExpectationManager.RequestExpectationGroup	Helper class to manage a group of remaining expectations.

字段概要

字段

修饰符和类型	字段	说明
private final List<RequestExpectation>	expectations
private final Map<cn.taketoday.http.client.ClientHttpRequest,Throwable>	requestFailures
private final List<cn.taketoday.http.client.ClientHttpRequest>	requests

构造器概要

构造器

构造器	说明
AbstractRequestExpectationManager()

方法概要

修饰符和类型	方法	说明
protected void	afterExpectationsDeclared()	Invoked at the time of the first actual request, which effectively means the expectations declaration phase is over.
protected AssertionError	createUnexpectedRequestError(cn.taketoday.http.client.ClientHttpRequest request)	Return an AssertionError that a sub-class can raise for an unexpected request.
ResponseActions	expectRequest(ExpectedCount count, RequestMatcher matcher)	Set up a new request expectation.
protected List<RequestExpectation>	getExpectations()	Return a read-only list of the expectations.
protected String	getRequestDetails()	Return details of executed requests.
protected List<cn.taketoday.http.client.ClientHttpRequest>	getRequests()	Return a read-only list of requests executed so far.
protected RequestExpectation	matchRequest(cn.taketoday.http.client.ClientHttpRequest request)	subclasses should implement this method instead of #validateRequestInternal(ClientHttpRequest) in order to match the request to an expectation, leaving the call to create the response as a separate step (to be invoked by this class).
void	reset()	Reset the internal state removing all expectations and recorded requests.
cn.taketoday.http.client.ClientHttpResponse	validateRequest(cn.taketoday.http.client.ClientHttpRequest request)	Validate the given actual request against the declared expectations.
void	verify()	Verify that all expectations have been met.
void	verify(Duration timeout)	Variant of RequestExpectationManager.verify() that waits for up to the specified time for all expectations to be fulfilled.
private int	verifyInternal()

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

expectations

private final List<RequestExpectation> expectations

requests

private final List<cn.taketoday.http.client.ClientHttpRequest> requests

requestFailures

private final Map<cn.taketoday.http.client.ClientHttpRequest,Throwable> requestFailures

构造器详细资料

AbstractRequestExpectationManager

public AbstractRequestExpectationManager()

方法详细资料

getExpectations

protected List<RequestExpectation> getExpectations()

Return a read-only list of the expectations.

getRequests

protected List<cn.taketoday.http.client.ClientHttpRequest> getRequests()

Return a read-only list of requests executed so far.

expectRequest

public ResponseActions expectRequest(ExpectedCount count,
 RequestMatcher matcher)

从接口复制的说明: RequestExpectationManager

Set up a new request expectation. The returned ResponseActions is used to add more expectations and define a response.

This is a delegate for MockRestServiceServer.expect(ExpectedCount, RequestMatcher).

指定者:

expectRequest 在接口中 RequestExpectationManager

matcher - a request expectation

返回:

for setting up further expectations and define a response

另请参阅:

• MockRestServiceServer.expect(RequestMatcher)
• MockRestServiceServer.expect(ExpectedCount, RequestMatcher)

validateRequest

public cn.taketoday.http.client.ClientHttpResponse validateRequest(cn.taketoday.http.client.ClientHttpRequest request)
                                                            throws IOException

从接口复制的说明: RequestExpectationManager

Validate the given actual request against the declared expectations. Is successful return the mock response to use or raise an error.

This is used in MockRestServiceServer against actual requests.

指定者:

validateRequest 在接口中 RequestExpectationManager

参数:

request - the request

返回:

the response to return if the request was validated.

抛出:

IOException - in case of any validation errors

afterExpectationsDeclared

protected void afterExpectationsDeclared()

Invoked at the time of the first actual request, which effectively means the expectations declaration phase is over.

matchRequest

protected RequestExpectation matchRequest(cn.taketoday.http.client.ClientHttpRequest request)
                                   throws IOException

subclasses should implement this method instead of #validateRequestInternal(ClientHttpRequest) in order to match the request to an expectation, leaving the call to create the response as a separate step (to be invoked by this class).

参数:

request - the current request

返回:

the matched expectation with its request count updated via RequestExpectation.incrementAndValidate().

抛出:

IOException

verify

public void verify()

从接口复制的说明: RequestExpectationManager

Verify that all expectations have been met.

This is a delegate for MockRestServiceServer.verify().

指定者:

verify 在接口中 RequestExpectationManager

另请参阅:

• MockRestServiceServer.verify()

verify

public void verify(Duration timeout)

从接口复制的说明: RequestExpectationManager

Variant of RequestExpectationManager.verify() that waits for up to the specified time for all expectations to be fulfilled. This can be useful for tests that involve asynchronous requests.

指定者:

verify 在接口中 RequestExpectationManager

参数:

timeout - how long to wait for all expecations to be met

verifyInternal

private int verifyInternal()

getRequestDetails

protected String getRequestDetails()

Return details of executed requests.

createUnexpectedRequestError

protected AssertionError createUnexpectedRequestError(cn.taketoday.http.client.ClientHttpRequest request)

Return an AssertionError that a sub-class can raise for an unexpected request.

reset

public void reset()

从接口复制的说明: RequestExpectationManager

Reset the internal state removing all expectations and recorded requests.

This is a delegate for MockRestServiceServer.reset().

指定者:

reset 在接口中 RequestExpectationManager

另请参阅:

• MockRestServiceServer.reset()