ReleaseNotes21

Release Notes for REST Assured 2.1.0

Highlights

Introducing support for Json Schema validation. For example given the following schema located in the classpath as products-schema.json:

{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "title": "Product set",
    "type": "array",
    "items": {
        "title": "Product",
        "type": "object",
        "properties": {
            "id": {
                "description": "The unique identifier for a product",
                "type": "number"
            },
            "name": {
                "type": "string"
            },
            "price": {
                "type": "number",
                "minimum": 0,
                "exclusiveMinimum": true
            },
            "tags": {
                "type": "array",
                "items": {
                    "type": "string"
                },
                "minItems": 1,
                "uniqueItems": true
            },
            "dimensions": {
                "type": "object",
                "properties": {
                    "length": {"type": "number"},
                    "width": {"type": "number"},
                    "height": {"type": "number"}
                },
                "required": ["length", "width", "height"]
            },
            "warehouseLocation": {
                "description": "Coordinates of the warehouse with the product",
                "$ref": "http://json-schema.org/geo"
            }
        },
        "required": ["id", "name", "price"]
    }
}

you can validate that a resource (/products) conforms with the schema:

get("/products").then().assertThat().body(matchesJsonSchemaInClasspath("products-schema.json"));

matchesJsonSchemaInClasspath is statically imported from com.jayway.restassured.module.jsv.JsonSchemaValidator and it's recommended to statically import all methods from this class. However in order to use it you need to depend on the json-schema-validator module by either downloading it from the download page or add the following dependency from Maven:

<dependency>
    <groupId>com.jayway.restassured</groupId>
    <artifactId>json-schema-validator</artifactId>
    <version>2.1.0</version>
</dependency>

Added support to for mixing text and path assertions. For example:

 get("/lotto").then().body(containsString("\"numbers\":[52")).and().body("lotto.winners.winnerId", hasItems(23, 54));

Added support for disabling hostname verification during certificate authentication by using the CertificateAuthSettings:
```
 given().auth().certificate(certUrl, password, certAuthSettings().using().allowAllHostnames(). ..
```
Added SSLConfig which allows you to better configure SSL configuration such as KeyStore and host name verification strategies. It's also much simpler to allow all host names (when a server has a bad certificate specifying an invalid host name). Instead of having to create and import a KeyStore you can now do:
```
RestAssured.config = newConfig().sslConfig(sslConifg().allowAllHostnames());
```

Non-backward compatible changes

It's no longer possible to assert that an empty response object has a path that is null, for example let's say that the "/statusCode409WithNoBody" resource returns an empty body:
```
expect().contentType(ContentType.JSON).body("error", equalTo(null)).when().get("/statusCode409WithNoBody"); // This will now throw assertion error
```
Changed default response content charset from ISO-8859-1 to system default charset. The reason for this that most users would probably expect the system default charset. To change the behaviour use the DecoderConfig.
Changed default request content charset from ISO-8859-1 to system default charset. The reason for this that most users would probably expect the system default charset. To change the behaviour use the EncoderConfig.
Removed the following methods from the RestAssured and AuthenticationSpecification API:
certificate(String certURL, String password, String certType, int port, KeystoreProvider trustStoreProvider) They are replaced by the certificate(String certURL, String password, CertificateAuthSettings certificateAuthSettings) method. For example:
```
RestAssured.authentication = certificate(certUrl, password, certAuthSettings().with().port(435));
```
and:
```
given().auth().certificate(certUrl, password, certAuthSettings().with().port(435)). ..
```
Removed static method "RestAssured.keystore()". You can now get the keystore settings from the SSLConfig instead.
Removed the com.jayway.restassured.authentication.KeyStoreProvider interface. The KeyStoreProvider was actually NOT used to create a KeyStore but rather a trust store. To specify the trust store after this change use the SSLConfig or certificate authentication.
All keystore related methods in the RestAssured API now returns void instead of KeyStoreSpec.
Removed method "RestAssured.keyStore()". If you want to get the configured "keystore" configuration you can now call "RestAssured.config().getSSLConfig();".

Deprecations

Deprecated RestAssured#certificate(String certURL, String password, String certType, int port)
Deprecated AuthenticationSpecification#certificate(String certURL, String password, String certType, int port)

Minor changes

See change log for more details.

Provide feedback

Saved searches