org.glassfish.jersey.client.JerseyClientBuilder Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jaxrs-ri Show documentation
Show all versions of jaxrs-ri Show documentation
A bundle project producing JAX-RS RI bundles. The primary artifact is an "all-in-one" OSGi-fied JAX-RS RI bundle
(jaxrs-ri.jar).
Attached to that are two compressed JAX-RS RI archives. The first archive (jaxrs-ri.zip) consists of binary RI bits and
contains the API jar (under "api" directory), RI libraries (under "lib" directory) as well as all external
RI dependencies (under "ext" directory). The secondary archive (jaxrs-ri-src.zip) contains buildable JAX-RS RI source
bundle and contains the API jar (under "api" directory), RI sources (under "src" directory) as well as all external
RI dependencies (under "ext" directory). The second archive also contains "build.xml" ANT script that builds the RI
sources. To build the JAX-RS RI simply unzip the archive, cd to the created jaxrs-ri directory and invoke "ant" from
the command line.
/*
* Copyright (c) 2012, 2020 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v. 2.0, which is available at
* http://www.eclipse.org/legal/epl-2.0.
*
* This Source Code may also be made available under the following Secondary
* Licenses when the conditions for such availability set forth in the
* Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
* version 2 with the GNU Classpath Exception, which is available at
* https://www.gnu.org/software/classpath/license.html.
*
* SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
*/
package org.glassfish.jersey.client;
import java.security.KeyStore;
import java.util.Map;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.ScheduledExecutorService;
import java.util.concurrent.TimeUnit;
import jakarta.ws.rs.client.ClientBuilder;
import jakarta.ws.rs.core.Configuration;
import javax.net.ssl.HostnameVerifier;
import javax.net.ssl.SSLContext;
import org.glassfish.jersey.SslConfigurator;
import org.glassfish.jersey.client.internal.LocalizationMessages;
import org.glassfish.jersey.internal.util.collection.UnsafeValue;
import org.glassfish.jersey.internal.util.collection.Values;
/**
* Jersey provider of {@link jakarta.ws.rs.client.ClientBuilder JAX-RS client builder}.
*
* @author Marek Potociar
*/
public class JerseyClientBuilder extends ClientBuilder {
private final ClientConfig config;
private HostnameVerifier hostnameVerifier;
private SslConfigurator sslConfigurator;
private SSLContext sslContext;
/**
* Create a new custom-configured {@link JerseyClient} instance.
*
* @return new configured Jersey client instance.
* @since 2.5
*/
public static JerseyClient createClient() {
return new JerseyClientBuilder().build();
}
/**
* Create a new custom-configured {@link JerseyClient} instance.
*
* @param configuration data used to provide initial configuration for the new
* Jersey client instance.
* @return new configured Jersey client instance.
* @since 2.5
*/
public static JerseyClient createClient(Configuration configuration) {
return new JerseyClientBuilder().withConfig(configuration).build();
}
/**
* Create new Jersey client builder instance.
*/
public JerseyClientBuilder() {
this.config = new ClientConfig();
}
@Override
public JerseyClientBuilder sslContext(SSLContext sslContext) {
if (sslContext == null) {
throw new NullPointerException(LocalizationMessages.NULL_SSL_CONTEXT());
}
this.sslContext = sslContext;
sslConfigurator = null;
return this;
}
@Override
public JerseyClientBuilder keyStore(KeyStore keyStore, char[] password) {
if (keyStore == null) {
throw new NullPointerException(LocalizationMessages.NULL_KEYSTORE());
}
if (password == null) {
throw new NullPointerException(LocalizationMessages.NULL_KEYSTORE_PASWORD());
}
if (sslConfigurator == null) {
sslConfigurator = SslConfigurator.newInstance();
}
sslConfigurator.keyStore(keyStore);
sslConfigurator.keyPassword(password);
sslContext = null;
return this;
}
@Override
public JerseyClientBuilder trustStore(KeyStore trustStore) {
if (trustStore == null) {
throw new NullPointerException(LocalizationMessages.NULL_TRUSTSTORE());
}
if (sslConfigurator == null) {
sslConfigurator = SslConfigurator.newInstance();
}
sslConfigurator.trustStore(trustStore);
sslContext = null;
return this;
}
@Override
public JerseyClientBuilder hostnameVerifier(HostnameVerifier hostnameVerifier) {
this.hostnameVerifier = hostnameVerifier;
return this;
}
@Override
public ClientBuilder executorService(ExecutorService executorService) {
config.executorService(executorService);
return this;
}
@Override
public ClientBuilder scheduledExecutorService(ScheduledExecutorService scheduledExecutorService) {
config.scheduledExecutorService(scheduledExecutorService);
return this;
}
@Override
public ClientBuilder connectTimeout(long timeout, TimeUnit unit) {
if (timeout < 0) {
throw new IllegalArgumentException("Negative timeout.");
}
this.property(ClientProperties.CONNECT_TIMEOUT, Math.toIntExact(unit.toMillis(timeout)));
return this;
}
@Override
public ClientBuilder readTimeout(long timeout, TimeUnit unit) {
if (timeout < 0) {
throw new IllegalArgumentException("Negative timeout.");
}
this.property(ClientProperties.READ_TIMEOUT, Math.toIntExact(unit.toMillis(timeout)));
return this;
}
@Override
public JerseyClient build() {
if (sslContext != null) {
return new JerseyClient(config, sslContext, hostnameVerifier, null);
} else if (sslConfigurator != null) {
final SslConfigurator sslConfiguratorCopy = sslConfigurator.copy();
return new JerseyClient(
config,
Values.lazy(new UnsafeValue() {
@Override
public SSLContext get() {
return sslConfiguratorCopy.createSSLContext();
}
}),
hostnameVerifier);
} else {
return new JerseyClient(config, (UnsafeValue) null, hostnameVerifier);
}
}
@Override
public ClientConfig getConfiguration() {
return config;
}
@Override
public JerseyClientBuilder property(String name, Object value) {
this.config.property(name, value);
return this;
}
@Override
public JerseyClientBuilder register(Class componentClass) {
this.config.register(componentClass);
return this;
}
@Override
public JerseyClientBuilder register(Class componentClass, int priority) {
this.config.register(componentClass, priority);
return this;
}
@Override
public JerseyClientBuilder register(Class componentClass, Class... contracts) {
this.config.register(componentClass, contracts);
return this;
}
@Override
public JerseyClientBuilder register(Class componentClass, Map, Integer> contracts) {
this.config.register(componentClass, contracts);
return this;
}
@Override
public JerseyClientBuilder register(Object component) {
this.config.register(component);
return this;
}
@Override
public JerseyClientBuilder register(Object component, int priority) {
this.config.register(component, priority);
return this;
}
@Override
public JerseyClientBuilder register(Object component, Class... contracts) {
this.config.register(component, contracts);
return this;
}
@Override
public JerseyClientBuilder register(Object component, Map, Integer> contracts) {
this.config.register(component, contracts);
return this;
}
@Override
public JerseyClientBuilder withConfig(Configuration config) {
this.config.loadFrom(config);
return this;
}
}