com.jcabi.http.mock

Interface MkContainer

All Known Implementing Classes:

MkGrizzlyContainer

public interface MkContainer

Mock version of Java Servlet container.

A convenient tool to test your application classes against a web service. For example:

 MkContainer container = new MkGrizzlyContainer()
   .next(new MkAnswer.Simple(200, "works fine!"))
   .start();
 new JdkRequest(container.home())
   .header("Accept", "text/xml")
   .fetch().as(RestResponse.class)
   .assertStatus(200)
   .assertBody(Matchers.equalTo("works fine!"));
 MatcherAssert.assertThat(
   container.take().method(),
   Matchers.equalTo("GET")
 );
 container.stop();

Keep in mind that container automatically reserves a new free TCP port and works until JVM is shut down. The only way to stop it is to call stop().

Since:

0.10

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

See Also:

Examples

Method Summary

Methods

Modifier and Type	Method and Description
URI	home() Get its home.
MkContainer	next(MkAnswer answer) Give this answer on the next request.
int	queries() How many queries we have left.
MkContainer	start() Start it on the first available TCP port.
MkContainer	start(int prt) Start it on a provided port.
void	stop() Stop container.
MkQuery	take() Get the oldest request received (NoSuchElementException if no more elements in the list).

Method Detail

next

MkContainer next(MkAnswer answer)

Give this answer on the next request.

Parameters:

answer - Next answer to give

Returns:

This object

take

MkQuery take()

Get the oldest request received (NoSuchElementException if no more elements in the list).

Returns:

Request received

queries

int queries()

How many queries we have left.

Returns:

Total number of queries you can retrieve with take()

Since:

1.0

start

MkContainer start()
                  throws IOException

Start it on the first available TCP port.

Returns:

This object

Throws:

IOException - If fails

start

MkContainer start(int prt)
                  throws IOException

Start it on a provided port.

Parameters:

prt - The port where it should start listening

Returns:

This object

Throws:

IOException - If fails

stop

void stop()

Stop container.

home

URI home()

Get its home.

Returns:

URI of the started container