Instrumented version of HTTP client integrated with Bootique, built on top of Jersey.

Provides HTTP client integrated with Bootique, built on top of Jersey.

License

License

Categories

Categories

CLI User Interface Jersey Program Interface REST Frameworks Bootique Web Frameworks
GroupId

GroupId

com.nhl.bootique.jersey.client
ArtifactId

ArtifactId

bootique-jersey-client-instrumented
Last Version

Last Version

0.5
Release Date

Release Date

Type

Type

jar
Description

Description

Instrumented version of HTTP client integrated with Bootique, built on top of Jersey.
Provides HTTP client integrated with Bootique, built on top of Jersey.
Project Organization

Project Organization

National Hockey League

Download bootique-jersey-client-instrumented

How to add to project

<!-- https://jarcasting.com/artifacts/com.nhl.bootique.jersey.client/bootique-jersey-client-instrumented/ -->
<dependency>
    <groupId>com.nhl.bootique.jersey.client</groupId>
    <artifactId>bootique-jersey-client-instrumented</artifactId>
    <version>0.5</version>
</dependency>
// https://jarcasting.com/artifacts/com.nhl.bootique.jersey.client/bootique-jersey-client-instrumented/
implementation 'com.nhl.bootique.jersey.client:bootique-jersey-client-instrumented:0.5'
// https://jarcasting.com/artifacts/com.nhl.bootique.jersey.client/bootique-jersey-client-instrumented/
implementation ("com.nhl.bootique.jersey.client:bootique-jersey-client-instrumented:0.5")
'com.nhl.bootique.jersey.client:bootique-jersey-client-instrumented:jar:0.5'
<dependency org="com.nhl.bootique.jersey.client" name="bootique-jersey-client-instrumented" rev="0.5">
  <artifact name="bootique-jersey-client-instrumented" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.nhl.bootique.jersey.client', module='bootique-jersey-client-instrumented', version='0.5')
)
libraryDependencies += "com.nhl.bootique.jersey.client" % "bootique-jersey-client-instrumented" % "0.5"
[com.nhl.bootique.jersey.client/bootique-jersey-client-instrumented "0.5"]

Dependencies

compile (2)

Group / Artifact Type Version
com.nhl.bootique.jersey.client : bootique-jersey-client jar 0.5
com.nhl.bootique.metrics : bootique-metrics jar 0.6

test (5)

Group / Artifact Type Version
junit : junit jar 4.12
org.mockito : mockito-core jar 2.0.31-beta
com.nhl.bootique.jersey : bootique-jersey jar 0.15
com.nhl.bootique : bootique-test jar 0.17
com.nhl.bootique.logback : bootique-logback jar 0.8

Project Modules

There are no modules declared in this project.

Build Status Maven Central

WARNING: Since 2.0 Jersey client integration is developed in "bootique-jersey" project per this issue. This project is only for 1.x support.

bootique-jersey-client

Integrates JAX-RS-based HTTP client in Bootique with support for various types of server authentication (BASIC, OAuth2, etc.). Allows to configure multiple client runtime parameters, as well as define server URL endpoints. Implementation is built on top of Jersey and Grizzly connector.

Quick Start

Add the module to your Bootique app:

<dependency>
	<groupId>io.bootique.jersey.client</groupId>
	<artifactId>bootique-jersey-client</artifactId>
</dependency>

Or if you want HTTPS clients with health checks and metrics:

<dependency>
	<groupId>io.bootique.jersey.client</groupId>
	<artifactId>bootique-jersey-client-instrumented</artifactId>
</dependency>

Inject HttpClientFactory and create client instances:

@Inject
private HttpClientFactory clientFactory;

public void doSomething() {

    Client client = clientFactory.newClient();
    Response response = client
        .target("https://example.org")
        .request()
        .get();
} 

Configuring Connection Parameters

You can specify a number of runtime parameters for your HTTP clients via the app .yml (or any other Bootique configuration mechanism):

jerseyclient:
  followRedirects: true
  readTimeoutMs: 2000
  connectTimeoutMs: 2000
  asyncThreadPoolSize: 10

Mapping URL Targets

In the example above we injected HttpClientFactory (that produced instances of JAX RS Client), and hardcoded the endpoint URL in Java. Instead you can map multiple URLs in the .yml, assigning each URL a symbolic name and optionally providing URL-specific runtime parameters:

jerseyclient:
  targets:
    google:
      url: "https://google.com"
    bootique:
      url: "https://bootique.io"
      followRedirects: false

Now you can inject HttpTargets and acquire instances of WebTarget by name:

@Inject
private HttpTargets targets;

public void doSomething() {

    Response response = targets.newTarget("bootique").request().get();
}

This not only reduces the amount of code, but more importantly allows to manage your URLs (and their runtime parameters) via configuration. E.g. you might use a different URL between test and production environments without changing the code.

Using BASIC Authentication

If your server endpoint requires BASIC authentication, you can associate your Clients and WebTargets with a named auth configuration. One or more named configurations are setup like this:

jerseyclient:
  auth:
    myauth:
      type: basic
      username: myuser
      password: mypassword

When creating a client in the Java code you can reference auth name ("myauth"):

@Inject
private HttpClientFactory clientFactory;

public void doSomething() {

    Client client = clientFactory.newBuilder().auth("myauth").build();
    Response response = client
        .target("https://example.org")
        .request()
        .get();
} 

Or you can associate a target with it:

jerseyclient:
  ...
  targets:
    secret:
      url: "https://example.org"
      auth: myauth

Using OAuth2 Authentication

OAuth2 authentication is very similar to BASIC. In fact they are no different on the Java end. In YAML the type should be "oauth2", and an extra "tokenUrl" property is required. Here is an example auth for a Twitter client:

jerseyclient:
  auth:
    twitter:
      type: oauth2
      tokenUrl: https://api.twitter.com/oauth2/token
      username: sdfjkdferefxfkdsf
      password: Efcdsfdsflkurecdsfj 
com.nhl.bootique.jersey.client

Versions

Version
0.5