au.com.dius.pact.core.pactbroker

Interface IHalClient

All Known Implementing Classes:

HalClient

public IHalClient

Interface to a HAL Client

Constructor Detail

IHalClient

public IHalClient()

Method Detail

navigate

@NotNull
IHalClient navigate()

Navigates to the Root

navigate

@NotNull
IHalClient navigate(@NotNull
                             java.util.Map<java.lang.String,? extends java.lang.Object> options,
                             @NotNull
                             java.lang.String link)

Navigates the URL associated with the given link using the current HAL document

Parameters:

options - Map of key-value pairs to use for parsing templated links

link - Link name to navigate

navigate

@NotNull
IHalClient navigate(@NotNull
                             java.lang.String link)

Navigates the URL associated with the given link using the current HAL document

Parameters:

link - Link name to navigate

linkUrl

@Nullable
java.lang.String linkUrl(@NotNull
                                   java.lang.String name)

Returns the HREF of the named link from the current HAL document

forAll

void forAll(@NotNull
            java.lang.String linkName,
            @NotNull
            java.util.function.Consumer<java.util.Map> closure)

Calls the closure with a Map of attributes for all links associated with the link name

Parameters:

linkName - Name of the link to loop over

closure - Closure to invoke with the link attributes

postJson

@NotNull
com.github.michaelbull.result.Result<java.lang.Boolean,java.lang.Exception> postJson(@NotNull
                                                                                              java.lang.String url,
                                                                                              @NotNull
                                                                                              java.lang.String body)

Upload the JSON document to the provided URL, using a POST request

Parameters:

url - Url to upload the document to

body - JSON contents for the body

Returns:

Returns a Success result object with a boolean value to indicate if the request was successful or not. Any exception will be wrapped in a Failure

postJson

@NotNull
com.github.michaelbull.result.Result<java.lang.Boolean,java.lang.Exception> postJson(@NotNull
                                                                                              java.lang.String url,
                                                                                              @NotNull
                                                                                              java.lang.String body,
                                                                                              @Nullable
                                                                                              kotlin.jvm.functions.Function2<? super java.lang.Integer,? super org.apache.http.client.methods.CloseableHttpResponse,java.lang.Boolean> handler)

Upload the JSON document to the provided URL, using a POST request

Parameters:

url - Url to upload the document to

body - JSON contents for the body

handler - Response handler

Returns:

Returns a Success result object with the boolean value returned from the handler closure. Any exception will be wrapped in a Failure

fetch

@NotNull
com.github.michaelbull.result.Result<au.com.dius.pact.core.support.json.JsonValue.Object,java.lang.Exception> fetch(@NotNull
                                                                                                                             java.lang.String path,
                                                                                                                             boolean encodePath)

Fetches the HAL document from the provided path

Parameters:

path - The path to the HAL document. If it is a relative path, it is relative to the base URL

encodePath - If the path should be encoded to make a valid URL

fetch

@NotNull
com.github.michaelbull.result.Result<au.com.dius.pact.core.support.json.JsonValue.Object,java.lang.Exception> fetch(@NotNull
                                                                                                                             java.lang.String path)

Fetches the HAL document from the provided path

Parameters:

path - The path to the HAL document. If it is a relative path, it is relative to the base URL

withDocContext

@NotNull
IHalClient withDocContext(@NotNull
                                   java.util.Map<java.lang.String,? extends java.lang.Object> docAttributes)

Sets the starting context from a previous broker interaction (Pact document)

withDocContext

@NotNull
IHalClient withDocContext(@NotNull
                                   au.com.dius.pact.core.support.json.JsonValue.Object docAttributes)

Sets the starting context from a previous broker interaction (Pact document)

putJson

@NotNull
com.github.michaelbull.result.Result<java.lang.String,java.lang.Exception> putJson(@NotNull
                                                                                            java.lang.String link,
                                                                                            @NotNull
                                                                                            java.util.Map<java.lang.String,? extends java.lang.Object> options,
                                                                                            @NotNull
                                                                                            java.lang.String json)

Upload a JSON document to the current path link, using a PUT request

postJson

@NotNull
com.github.michaelbull.result.Result<au.com.dius.pact.core.support.json.JsonValue.Object,java.lang.Exception> postJson(@NotNull
                                                                                                                                java.lang.String link,
                                                                                                                                @NotNull
                                                                                                                                java.util.Map<java.lang.String,? extends java.lang.Object> options,
                                                                                                                                @NotNull
                                                                                                                                java.lang.String json)

Upload a JSON document to the current path link, using a POST request

getJson

@NotNull
com.github.michaelbull.result.Result<au.com.dius.pact.core.support.json.JsonValue,java.lang.Exception> getJson(@NotNull
                                                                                                                        java.lang.String path)

Get JSON from the provided path

getJson

@NotNull
com.github.michaelbull.result.Result<au.com.dius.pact.core.support.json.JsonValue,java.lang.Exception> getJson(@NotNull
                                                                                                                        java.lang.String path,
                                                                                                                        boolean encodePath)

Get JSON from the provided path

Parameters:

path - Path to fetch the JSON document from

encodePath - If the path should be encoded