Package ch.ivyteam.ivy.rest.client

Interface IRestClientContext

public interface IRestClientContext

REST clients of this application. Use the REST clients editor to configure a new REST client and then access it with client(String) or client(UUID)

Example: 

String response = ivy.rest.client("myRestClient").request().get().readEntity(String.class) as String;

API:
This is a public API.

  • Method Summary

    Modifier and Type
    Method
    Description
    javax.ws.rs.client.WebTarget
    client(String name)
    Gets the REST client with the given name.
    javax.ws.rs.client.WebTarget
    client(UUID id)
    Gets the REST client with the given unique identifier.
    static IRestClientContext
    current()
    Gets the current rest client context.
    List<UUID>
    getIds()
    Gets a list with the unique identifiers of all available rest clients
    List<String>
    getNames()
    Gets a list with the names of all available rest clients

  • Method Details

    • client

      javax.ws.rs.client.WebTarget client(String name) throws NoSuchElementException

      Gets the REST client with the given name.

      Example: 

      String response = ivy.rest.client("myRestClient").request().get().readEntity(String.class) as String;

      Parameters:
      name -
      Returns:
      client
      Throws:
      NoSuchElementException - if REST client with the given name or id does not exist
      API:
      This public API is available in Java.

    • client

      javax.ws.rs.client.WebTarget client(UUID id) throws NoSuchElementException

      Gets the REST client with the given unique identifier.

      Examples: 

       import java.util.UUID;
 UUID uuid = UUID.fromString("e00c9735-7733-4da8-85c8-6413c6fb2cd2");
 String response = ivy.rest.client(uuid).request().get().readEntity(String.class) as String;

      Parameters:
      id - unique identifier
      Returns:
      client
      Throws:
      NoSuchElementException - if REST client with the given id does not exist
      API:
      This public API is available in Java.

    • getNames

      List<String> getNames()
      Gets a list with the names of all available rest clients
      Returns:
      list of rest client names
      API:
      This public API is available in Java.

    • getIds

      List<UUID> getIds()
      Gets a list with the unique identifiers of all available rest clients
      Returns:
      list of rest client identifiers
      API:
      This public API is available in Java.

    • current

      static IRestClientContext current()

      Gets the current rest client context.

      Will return null if called out of scope. The scope is set if you call this method from an ivy process or any supported ivy environment. It is not set in non supported ivy environments (e.g. if you start your own threads, etc.).

      Returns:
      current rest client context or null if out of scope
      Since:
      9.1
      API:
      This public API is available in Java.