Class MockMvcWebConnectionBuilderSupport<T extends MockMvcWebConnectionBuilderSupport<T>>

Constructor Detail

• MockMvcWebConnectionBuilderSupport

  protected MockMvcWebConnectionBuilderSupport​(MockMvc mockMvc)

  Create a new instance using the supplied MockMvc instance.

  Parameters:

  mockMvc - the MockMvc instance to use; never null

• MockMvcWebConnectionBuilderSupport

  protected MockMvcWebConnectionBuilderSupport​(WebApplicationContext context)

  Create a new instance using the supplied WebApplicationContext.

  Parameters:

  context - the WebApplicationContext to create a MockMvc instance from; never null

• MockMvcWebConnectionBuilderSupport

  protected MockMvcWebConnectionBuilderSupport​(WebApplicationContext context,
                                               MockMvcConfigurer configurer)

  Create a new instance using the supplied WebApplicationContext and MockMvcConfigurer.

  Parameters:

  context - the WebApplicationContext to create a MockMvc instance from; never null

  configurer - the MockMvcConfigurer to apply; never null

Method Detail

• contextPath

  public T contextPath​(String contextPath)

  Set the context path to use.

  If the supplied value is null or empty, the first path segment of the request URL is assumed to be the context path.

  Default is "".

  Parameters:

  contextPath - the context path to use

  Returns:

  this builder for further customization

• alwaysUseMockMvc

  public T alwaysUseMockMvc()

  Specify that MockMvc should always be used regardless of what the request looks like.

  Returns:

  this builder for further customization

• useMockMvc

  public T useMockMvc​(WebRequestMatcher... matchers)

  Add additional WebRequestMatcher instances that will ensure that MockMvc is used to process the request, if such a matcher matches against the web request.

  Parameters:

  matchers - additional WebRequestMatcher instances

  Returns:

  this builder for further customization

• useMockMvcForHosts

  public T useMockMvcForHosts​(String... hosts)

  Add additional WebRequestMatcher instances that return true if a supplied host matches — for example, "example.com" or "example.com:8080".

  Parameters:

  hosts - additional hosts that ensure MockMvc gets invoked

  Returns:

  this builder for further customization

• createConnection

  @Deprecated
  protected final com.gargoylesoftware.htmlunit.WebConnection createConnection​(com.gargoylesoftware.htmlunit.WebConnection defaultConnection)

  Deprecated.

  Use createConnection(WebClient) instead
  Create a new WebConnection that will use a MockMvc instance if one of the specified WebRequestMatcher instances matches.

  Parameters:

  defaultConnection - the default WebConnection to use if none of the specified WebRequestMatcher instances matches; never null

  Returns:

  a new WebConnection that will use a MockMvc instance if one of the specified WebRequestMatcher matches

  See Also:

  alwaysUseMockMvc(), useMockMvc(WebRequestMatcher...), useMockMvcForHosts(String...)

• createConnection

  protected final com.gargoylesoftware.htmlunit.WebConnection createConnection​(com.gargoylesoftware.htmlunit.WebClient webClient)

  Create a new WebConnection that will use a MockMvc instance if one of the specified WebRequestMatcher instances matches.

  Parameters:

  webClient - the WebClient to use if none of the specified WebRequestMatcher instances matches (never null)

  Returns:

  a new WebConnection that will use a MockMvc instance if one of the specified WebRequestMatcher matches

  Since:

  4.3

  See Also:

  alwaysUseMockMvc(), useMockMvc(WebRequestMatcher...), useMockMvcForHosts(String...)