org.springframework.boot.test.json

Class JacksonTester<T>

java.lang.Object

org.springframework.boot.test.json.AbstractJsonMarshalTester<T>

org.springframework.boot.test.json.JacksonTester<T>

Type Parameters:

T - the type under test

public class JacksonTester<T>
extends AbstractJsonMarshalTester<T>

AssertJ based JSON tester backed by Jackson. Usually instantiated via initFields(Object, ObjectMapper), for example:

 public class ExampleObjectJsonTests {

     private JacksonTester<ExampleObject> json;

     @Before
     public void setup() {
         ObjectMapper objectMapper = new ObjectMapper();
         JacksonTester.initFields(this, objectMapper);
     }

     @Test
     public void testWriteJson() throws IOException {
         ExampleObject object = //...
         assertThat(json.write(object)).isEqualToJson("expected.json");
     }

 }
 

See AbstractJsonMarshalTester for more details.

Since:

1.4.0

Author:

Phillip Webb, Madhura Bhave, Diego Berrueta

Nested Class Summary

Nested classes/interfaces inherited from class org.springframework.boot.test.json.AbstractJsonMarshalTester

AbstractJsonMarshalTester.FieldInitializer<M>

Constructor Summary

Constructors

Modifier	Constructor and Description
	JacksonTester(Class<?> resourceLoadClass, ResolvableType type, com.fasterxml.jackson.databind.ObjectMapper objectMapper) Create a new JacksonTester instance.
	JacksonTester(Class<?> resourceLoadClass, ResolvableType type, com.fasterxml.jackson.databind.ObjectMapper objectMapper, Class<?> view)
protected	JacksonTester(com.fasterxml.jackson.databind.ObjectMapper objectMapper) Create a new JacksonTester instance.

Method Summary

Modifier and Type	Method and Description
JacksonTester<T>	forView(Class<?> view) Returns a new instance of JacksonTester with the view that should be used for json serialization/deserialization.
protected JsonContent<T>	getJsonContent(String json) Factory method used to get a JsonContent instance from a source JSON string.
static void	initFields(Object testInstance, ObjectFactory<com.fasterxml.jackson.databind.ObjectMapper> objectMapperFactory) Utility method to initialize JacksonTester fields.
static void	initFields(Object testInstance, com.fasterxml.jackson.databind.ObjectMapper objectMapper) Utility method to initialize JacksonTester fields.
protected T	readObject(InputStream inputStream, ResolvableType type) Read from the specified input stream to create an object of the specified type.
protected T	readObject(Reader reader, ResolvableType type) Read from the specified reader to create an object of the specified type.
protected String	writeObject(T value, ResolvableType type) Write the specified object to a JSON string.

Methods inherited from class org.springframework.boot.test.json.AbstractJsonMarshalTester

getResourceLoadClass, getType, initialize, parse, parse, parseObject, parseObject, read, read, read, read, read, readObject, readObject, readObject, readObject, readObject, write

Methods inherited from class java.lang.Object

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

Constructor Detail

JacksonTester

protected JacksonTester(com.fasterxml.jackson.databind.ObjectMapper objectMapper)

Create a new JacksonTester instance.

Parameters:

objectMapper - the Jackson object mapper

JacksonTester

public JacksonTester(Class<?> resourceLoadClass,
                     ResolvableType type,
                     com.fasterxml.jackson.databind.ObjectMapper objectMapper)

Create a new JacksonTester instance.

Parameters:

resourceLoadClass - the source class used to load resources

type - the type under test

objectMapper - the Jackson object mapper

JacksonTester

public JacksonTester(Class<?> resourceLoadClass,
                     ResolvableType type,
                     com.fasterxml.jackson.databind.ObjectMapper objectMapper,
                     Class<?> view)

Method Detail

getJsonContent

protected JsonContent<T> getJsonContent(String json)

Description copied from class: AbstractJsonMarshalTester

Factory method used to get a JsonContent instance from a source JSON string.

Overrides:

getJsonContent in class AbstractJsonMarshalTester<T>

Parameters:

json - the source JSON

Returns:

a new JsonContent instance

readObject

protected T readObject(InputStream inputStream,
                       ResolvableType type)
                throws IOException

Description copied from class: AbstractJsonMarshalTester

Read from the specified input stream to create an object of the specified type. The default implementation delegates to AbstractJsonMarshalTester.readObject(Reader, ResolvableType).

Overrides:

readObject in class AbstractJsonMarshalTester<T>

Parameters:

inputStream - the source input stream (never null)

type - the resulting type (never null)

Returns:

the resulting object

Throws:

IOException - on read error

readObject

protected T readObject(Reader reader,
                       ResolvableType type)
                throws IOException

Description copied from class: AbstractJsonMarshalTester

Read from the specified reader to create an object of the specified type.

Specified by:

readObject in class AbstractJsonMarshalTester<T>

Parameters:

reader - the source reader (never null)

type - the resulting type (never null)

Returns:

the resulting object

Throws:

IOException - on read error

writeObject

protected String writeObject(T value,
                             ResolvableType type)
                      throws IOException

Description copied from class: AbstractJsonMarshalTester

Write the specified object to a JSON string.

Specified by:

writeObject in class AbstractJsonMarshalTester<T>

Parameters:

value - the source value (never null)

type - the resulting type (never null)

Returns:

the JSON string

Throws:

IOException - on write error

initFields

public static void initFields(Object testInstance,
                              com.fasterxml.jackson.databind.ObjectMapper objectMapper)

Utility method to initialize JacksonTester fields. See class-level documentation for example usage.

Parameters:

testInstance - the test instance

objectMapper - the object mapper

See Also:

initFields(Object, ObjectMapper)

initFields

public static void initFields(Object testInstance,
                              ObjectFactory<com.fasterxml.jackson.databind.ObjectMapper> objectMapperFactory)

Utility method to initialize JacksonTester fields. See class-level documentation for example usage.

Parameters:

testInstance - the test instance

objectMapperFactory - a factory to create the object mapper

See Also:

initFields(Object, ObjectMapper)

forView

public JacksonTester<T> forView(Class<?> view)

Returns a new instance of JacksonTester with the view that should be used for json serialization/deserialization.

Parameters:

view - the view class

Returns:

the new instance