nl.vpro.test.util.jaxb

Class JAXBTestUtil

java.lang.Object

nl.vpro.test.util.jaxb.JAXBTestUtil

public class JAXBTestUtil
extends Object

Since:

1.6

Author:

Roelof Jan Koekoek

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JAXBTestUtil.XMLObjectAssert<S extends JAXBTestUtil.XMLObjectAssert<S,A>,A>
static class	JAXBTestUtil.XMLStringAssert

Field Summary

Fields

Modifier and Type	Field and Description
static Consumer<org.xmlunit.builder.DiffBuilder>	IGNORE_ELEMENT_ORDER

Constructor Summary

Constructors

Constructor and Description
JAXBTestUtil()

Method Summary

Modifier and Type	Method and Description
static JAXBTestUtil.XMLStringAssert	assertThatXml(byte[] o)
static JAXBTestUtil.XMLStringAssert	assertThatXml(ByteArrayOutputStream o)
static JAXBTestUtil.XMLStringAssert	assertThatXml(String o)
static <S extends JAXBTestUtil.XMLObjectAssert<S,T>,T> JAXBTestUtil.XMLObjectAssert<S,T>	assertThatXml(T o)
static <T> String	marshal(T object)
static <T> Element	marshalToElement(T object)
static <T> T	roundTrip(T input)
static <T> T	roundTrip(T input, String contains) Deprecated.
static <T> T	roundTripAndSimilar(InputStream input, Class<? extends T> inputClazz, Consumer<org.xmlunit.builder.DiffBuilder>... build)
static <T> T	roundTripAndSimilar(String input, Class<? extends T> inputClazz, Consumer<org.xmlunit.builder.DiffBuilder>... build)
static <T> T	roundTripAndSimilar(T input, InputStream expected)
static <T> T	roundTripAndSimilar(T input, String expected) Marshalls input and checks if it is similar to given string.
static <T> T	roundTripAndSimilarAndEquals(T input, String expected)
static <T> T	roundTripAndSimilarValue(T input, String expected)
static <T> T	roundTripAndValidateAndSimilar(T input, URL xsd, String expected)
static <T> T	roundTripContains(T input, boolean namespaceAware, String... contains) Checks whether the
static <T> T	roundTripContains(T input, String... contains) Checks whether marshalled version of an object contains a certain piece of xml.
static void	similar(InputStream input, InputStream expected)
static void	similar(InputStream input, String expected)
static <T> T	similar(String input, String expected, Class<T> result)
static void	similar(String input, String expected, Consumer<org.xmlunit.builder.DiffBuilder>... build)
static <T> T	unmarshal(String xml, Class<? extends T> clazz)

Methods inherited from class java.lang.Object

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

Field Detail

IGNORE_ELEMENT_ORDER

public static Consumer<org.xmlunit.builder.DiffBuilder> IGNORE_ELEMENT_ORDER

Constructor Detail

JAXBTestUtil

public JAXBTestUtil()

Method Detail

marshal

public static <T> String marshal(T object)

marshalToElement

public static <T> Element marshalToElement(T object)

unmarshal

public static <T> T unmarshal(String xml,
                              Class<? extends T> clazz)

roundTrip

public static <T> T roundTrip(T input)

roundTrip

@Deprecated
public static <T> T roundTrip(T input,
                                          String contains)

Deprecated.

One might disagree on this subject! I prefer a decent error report. The supposed improvement {#link roundTripAndSimilar} returns "expected [true] got [false]" on failure which is a very poor description of what goes wrong and always needs further debugging to investigate the source. Besides that, if a whatever upgrade brakes the layout, while honoring the syntax, I would still like the be informed om this change. MM: The difference was in the order of attributes and/or namespaces. Those are not relevant changes. SAX implementations are not required to preserve or guarantee any order in this. It is hence impossible to make a test using this that succeeds in every java version. Furthermore roundTripAndSimilar will if not similar still do a test for equals to enforce a clearer message.

roundTripContains

public static <T> T roundTripContains(T input,
                                      boolean namespaceAware,
                                      String... contains)

Checks whether the

Type Parameters:

T -

Parameters:

input -

contains -

Returns:

Since:

2.7

roundTripContains

public static <T> T roundTripContains(T input,
                                      String... contains)

Checks whether marshalled version of an object contains a certain piece of xml.

Type Parameters:

T -

Parameters:

input -

contains -

Returns:

Since:

2.7

roundTripAndSimilar

@SafeVarargs
public static <T> T roundTripAndSimilar(String input,
                                                     Class<? extends T> inputClazz,
                                                     Consumer<org.xmlunit.builder.DiffBuilder>... build)
                                              throws IOException,
                                                     SAXException

Throws:

IOException

SAXException

roundTripAndSimilar

public static <T> T roundTripAndSimilar(InputStream input,
                                        Class<? extends T> inputClazz,
                                        Consumer<org.xmlunit.builder.DiffBuilder>... build)
                                 throws IOException,
                                        SAXException

Throws:

IOException

SAXException

roundTripAndSimilar

public static <T> T roundTripAndSimilar(T input,
                                        String expected)
                                 throws IOException,
                                        SAXException

Marshalls input and checks if it is similar to given string. Then unmarshals it, and marshalls it another time. The result XMl should still be similar.

Throws:

IOException

SAXException

roundTripAndValidateAndSimilar

public static <T> T roundTripAndValidateAndSimilar(T input,
                                                   URL xsd,
                                                   String expected)
                                            throws IOException,
                                                   SAXException

Throws:

IOException

SAXException

roundTripAndSimilar

public static <T> T roundTripAndSimilar(T input,
                                        InputStream expected)
                                 throws IOException,
                                        SAXException

Throws:

IOException

SAXException

roundTripAndSimilarAndEquals

public static <T> T roundTripAndSimilarAndEquals(T input,
                                                 String expected)
                                          throws Exception

Throws:

Exception

roundTripAndSimilarValue

public static <T> T roundTripAndSimilarValue(T input,
                                             String expected)
                                      throws IOException,
                                             SAXException,
                                             JAXBException

Throws:

IOException

SAXException

JAXBException

similar

public static void similar(String input,
                           String expected,
                           Consumer<org.xmlunit.builder.DiffBuilder>... build)
                    throws IOException,
                           SAXException

Throws:

IOException

SAXException

similar

public static <T> T similar(String input,
                            String expected,
                            Class<T> result)
                     throws IOException,
                            SAXException

Throws:

IOException

SAXException

similar

public static void similar(InputStream input,
                           String expected)
                    throws IOException,
                           SAXException

Throws:

IOException

SAXException

similar

public static void similar(InputStream input,
                           InputStream expected)
                    throws IOException,
                           SAXException

Throws:

IOException

SAXException

assertThatXml

public static <S extends JAXBTestUtil.XMLObjectAssert<S,T>,T> JAXBTestUtil.XMLObjectAssert<S,T> assertThatXml(T o)

assertThatXml

public static JAXBTestUtil.XMLStringAssert assertThatXml(String o)

assertThatXml

public static JAXBTestUtil.XMLStringAssert assertThatXml(ByteArrayOutputStream o)
                                                  throws UnsupportedEncodingException

Throws:

UnsupportedEncodingException

assertThatXml

public static JAXBTestUtil.XMLStringAssert assertThatXml(byte[] o)
                                                  throws UnsupportedEncodingException

Throws:

UnsupportedEncodingException