public class ApnsClientBuilder extends Object
ApnsClientBuilder
constructs new ApnsClient
instances. All settings are optional. Client builders
may be reused to generate multiple clients, and their settings may be changed from one client to the next.Constructor and Description |
---|
ApnsClientBuilder() |
Modifier and Type | Method and Description |
---|---|
ApnsClient |
build()
Constructs a new
ApnsClient with the previously-set configuration. |
ApnsClientBuilder |
setClientCredentials(File p12File,
String p12Password)
Sets the TLS credentials for the client under construction using the contents of the given PKCS#12 file.
|
ApnsClientBuilder |
setClientCredentials(InputStream p12InputStream,
String p12Password)
Sets the TLS credentials for the client under construction using the data from the given PKCS#12 input stream.
|
ApnsClientBuilder |
setClientCredentials(X509Certificate clientCertificate,
PrivateKey privateKey,
String privateKeyPassword)
Sets the TLS credentials for the client under construction.
|
ApnsClientBuilder |
setConnectionTimeout(long connectionTimeout,
TimeUnit timeoutUnit)
Sets the maximum amount of time, in milliseconds, that the client under construction will wait to establish a
connection with the APNs server before the connection attempt is considered a failure.
|
ApnsClientBuilder |
setEventLoopGroup(EventLoopGroup eventLoopGroup)
Sets the event loop group to be used by the client under construction.
|
ApnsClientBuilder |
setGracefulShutdownTimeout(long gracefulShutdownTimeout,
TimeUnit timeoutUnit)
Sets the amount of time clients should wait for in-progress requests to complete before closing a connection
during a graceful shutdown.
|
ApnsClientBuilder |
setIdlePingInterval(long pingInterval,
TimeUnit timeoutUnit)
Sets the amount of idle time (in milliseconds) after which the client under construction will send a PING frame
to the APNs server.
|
ApnsClientBuilder |
setMetricsListener(ApnsClientMetricsListener metricsListener)
Sets the metrics listener for the client under construction.
|
ApnsClientBuilder |
setProxyHandlerFactory(ProxyHandlerFactory proxyHandlerFactory)
Sets the proxy handler factory to be used to construct proxy handlers when establishing a new connection to the
APNs gateway.
|
ApnsClientBuilder |
setSigningKey(ApnsSigningKey signingKey)
Sets the signing key for the client under construction.
|
ApnsClientBuilder |
setTrustedServerCertificateChain(File certificatePemFile)
Sets the trusted certificate chain for the client under construction using the contents of the given PEM
file.
|
ApnsClientBuilder |
setTrustedServerCertificateChain(InputStream certificateInputStream)
Sets the trusted certificate chain for the client under construction using the contents of the given PEM
input stream.
|
ApnsClientBuilder |
setTrustedServerCertificateChain(X509Certificate... certificates)
Sets the trusted certificate chain for the client under construction.
|
public ApnsClientBuilder setClientCredentials(File p12File, String p12Password) throws SSLException, IOException
Sets the TLS credentials for the client under construction using the contents of the given PKCS#12 file. Clients constructed with TLS credentials will use TLS-based authentication when sending push notifications. The PKCS#12 file must contain a certificate/private key pair.
Clients may not have both TLS credentials and a signing key.
p12File
- a PKCS#12-formatted file containing the certificate and private key to be used to identify the
client to the APNs serverp12Password
- the password to be used to decrypt the contents of the given PKCS#12 file; passwords may be
blank (i.e. ""
), but must not be null
SSLException
- if the given PKCS#12 file could not be loaded or if any other SSL-related problem arises
when constructing the contextIOException
- if any IO problem occurred while attempting to read the given PKCS#12 file, or the PKCS#12
file could not be foundpublic ApnsClientBuilder setClientCredentials(InputStream p12InputStream, String p12Password) throws SSLException, IOException
Sets the TLS credentials for the client under construction using the data from the given PKCS#12 input stream. Clients constructed with TLS credentials will use TLS-based authentication when sending push notifications. The PKCS#12 data must contain a certificate/private key pair.
Clients may not have both TLS credentials and a signing key.
p12InputStream
- an input stream to a PKCS#12-formatted file containing the certificate and private key to
be used to identify the client to the APNs serverp12Password
- the password to be used to decrypt the contents of the given PKCS#12 file; passwords may be
blank (i.e. ""
), but must not be null
SSLException
- if the given PKCS#12 file could not be loaded or if any other SSL-related problem arises
when constructing the contextIOException
- if any IO problem occurred while attempting to read the given PKCS#12 input streampublic ApnsClientBuilder setClientCredentials(X509Certificate clientCertificate, PrivateKey privateKey, String privateKeyPassword)
Sets the TLS credentials for the client under construction. Clients constructed with TLS credentials will use TLS-based authentication when sending push notifications.
Clients may not have both TLS credentials and a signing key.
clientCertificate
- the certificate to be used to identify the client to the APNs serverprivateKey
- the private key for the client certificateprivateKeyPassword
- the password to be used to decrypt the private key; may be null
if the private
key does not require a passwordpublic ApnsClientBuilder setSigningKey(ApnsSigningKey signingKey)
Sets the signing key for the client under construction. Clients constructed with a signing key will use token-based authentication when sending push notifications.
Clients may not have both a signing key and TLS credentials.
signingKey
- the signing key to be used by the client under constructionApnsSigningKey.loadFromPkcs8File(File, String, String)
,
ApnsSigningKey.loadFromInputStream(InputStream, String, String)
public ApnsClientBuilder setTrustedServerCertificateChain(File certificatePemFile)
Sets the trusted certificate chain for the client under construction using the contents of the given PEM
file. If not set (or null
), the client will use the JVM's default trust manager.
Callers will generally not need to set a trusted server certificate chain in normal operation, but may wish to do so for certificate pinning or connecting to a mock server for integration testing or benchmarking.
certificatePemFile
- a PEM file containing one or more trusted certificatespublic ApnsClientBuilder setTrustedServerCertificateChain(InputStream certificateInputStream)
Sets the trusted certificate chain for the client under construction using the contents of the given PEM
input stream. If not set (or null
), the client will use the JVM's default trust manager.
Callers will generally not need to set a trusted server certificate chain in normal operation, but may wish to do so for certificate pinning or connecting to a mock server for integration testing or benchmarking.
certificateInputStream
- an input stream to PEM-formatted data containing one or more trusted certificatespublic ApnsClientBuilder setTrustedServerCertificateChain(X509Certificate... certificates)
Sets the trusted certificate chain for the client under construction. If not set (or null
), the
client will use the JVM's default trust manager.
Callers will generally not need to set a trusted server certificate chain in normal operation, but may wish to do so for certificate pinning or connecting to a mock server for integration testing or benchmarking.
certificates
- one or more trusted certificatespublic ApnsClientBuilder setEventLoopGroup(EventLoopGroup eventLoopGroup)
Sets the event loop group to be used by the client under construction. If not set (or if null
), the
client will create and manage its own event loop group.
Generally speaking, callers don't need to set event loop groups for clients, but it may be useful to specify
an event loop group under certain circumstances. In particular, specifying an event loop group that is shared
among multiple ApnsClient
instances can keep thread counts manageable. Regardless of the number of
concurrent ApnsClient
instances, callers may also wish to specify an event loop group to take advantage
of certain platform-specific optimizations (e.g. epoll
or KQueue
event loop groups).
eventLoopGroup
- the event loop group to use for this client, or null
to let the client manage its
own event loop grouppublic ApnsClientBuilder setMetricsListener(ApnsClientMetricsListener metricsListener)
metricsListener
- the metrics listener for the client under construction, or null
if this client
should not report metrics to a listenerpublic ApnsClientBuilder setProxyHandlerFactory(ProxyHandlerFactory proxyHandlerFactory)
null
, in which case the client will connect to the
gateway directly and will not use a proxy. By default, clients will not use a proxy.proxyHandlerFactory
- the proxy handler factory to be used to construct proxy handlers, or null
if
this client should not use a proxypublic ApnsClientBuilder setConnectionTimeout(long connectionTimeout, TimeUnit timeoutUnit)
connectionTimeout
- the maximum amount of time to wait for a connection attempt to completetimeoutUnit
- the time unit for the given timeoutpublic ApnsClientBuilder setIdlePingInterval(long pingInterval, TimeUnit timeoutUnit)
pingInterval
- the amount of idle time after which the client will send a PING frametimeoutUnit
- the time unit for the given idle timepublic ApnsClientBuilder setGracefulShutdownTimeout(long gracefulShutdownTimeout, TimeUnit timeoutUnit)
gracefulShutdownTimeout
- the amount of time to wait for in-progress requests to complete before closing a
connectiontimeoutUnit
- the time unit for the given timeoutApnsClient.disconnect()
public ApnsClient build() throws SSLException
ApnsClient
with the previously-set configuration.SSLException
- if an SSL context could not be created for the new client for any reasonCopyright © 2013–2017 Turo. All rights reserved.