play.libs.ws.ahc

Class AhcWSClient

java.lang.Object

play.libs.ws.ahc.AhcWSClient

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, WSClient

public class AhcWSClient
extends java.lang.Object
implements WSClient

A WS client backed by AsyncHttpClient implementation.

See https://www.playframework.com/documentation/latest/JavaWS for documentation.

Constructor Summary

Constructors

Constructor and Description
AhcWSClient(StandaloneAhcWSClient client)

Method Summary

Modifier and Type	Method and Description
void	close() Closes this client, and releases underlying resources.
static AhcWSClient	create(play.api.libs.ws.ahc.AhcWSClientConfig config, javax.cache.Cache<play.api.libs.ws.ahc.cache.EffectiveURIKey,play.api.libs.ws.ahc.cache.ResponseEntry> cache, akka.stream.Materializer materializer) Creates WS client manually from configuration, internally creating a new instance of AsyncHttpClient and managing its own thread pool.
java.lang.Object	getUnderlying() The underlying implementation of the client, if any.
WSRequest	url(java.lang.String url) Returns a WSRequest object representing the URL.

Methods inherited from class java.lang.Object

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

Constructor Detail

AhcWSClient

@Inject
public AhcWSClient(StandaloneAhcWSClient client)

Method Detail

create

public static AhcWSClient create(play.api.libs.ws.ahc.AhcWSClientConfig config,
                                 javax.cache.Cache<play.api.libs.ws.ahc.cache.EffectiveURIKey,play.api.libs.ws.ahc.cache.ResponseEntry> cache,
                                 akka.stream.Materializer materializer)

Creates WS client manually from configuration, internally creating a new instance of AsyncHttpClient and managing its own thread pool.

This client is not managed as part of Play's lifecycle, and must be closed by calling ws.close(), otherwise you will run into memory leaks.

Parameters:

config - a config object, usually from AhcWSClientConfigFactory

cache - if not null, provides HTTP caching.

materializer - an Akka materializer

Returns:

a new instance of AhcWSClient.

getUnderlying

public java.lang.Object getUnderlying()

Description copied from interface: WSClient

The underlying implementation of the client, if any. You must cast the returned value to the type you want.

Specified by:

getUnderlying in interface WSClient

Returns:

the backing class.

url

public WSRequest url(java.lang.String url)

Description copied from interface: WSClient

Returns a WSRequest object representing the URL. You can append additional properties on the WSRequest by chaining calls, and execute the request to return an asynchronous Promise<WSResponse>.

Specified by:

url in interface WSClient

Parameters:

url - the URL to request

Returns:

the request

close

public void close()
           throws java.io.IOException

Description copied from interface: WSClient

Closes this client, and releases underlying resources.

Use this for manually instantiated clients.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface WSClient

Throws:

java.io.IOException