io.bdeploy.jersey.JerseyServer Maven / Gradle / Ivy
Show all versions of api Show documentation
package io.bdeploy.jersey;
import java.io.IOException;
import java.net.URI;
import java.security.GeneralSecurityException;
import java.security.KeyStore;
import java.time.Instant;
import java.util.ArrayList;
import java.util.Collection;
import java.util.HashMap;
import java.util.Map;
import java.util.Set;
import java.util.TreeMap;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.Executors;
import java.util.concurrent.ScheduledExecutorService;
import java.util.concurrent.atomic.AtomicLong;
import java.util.logging.Level;
import java.util.stream.Collectors;
import javax.net.ssl.KeyManagerFactory;
import javax.net.ssl.SSLContext;
import org.glassfish.grizzly.http.CompressionConfig;
import org.glassfish.grizzly.http.CompressionConfig.CompressionMode;
import org.glassfish.grizzly.http.server.HttpHandler;
import org.glassfish.grizzly.http.server.HttpHandlerRegistration;
import org.glassfish.grizzly.http.server.HttpServer;
import org.glassfish.grizzly.http.server.NetworkListener;
import org.glassfish.grizzly.ssl.SSLEngineConfigurator;
import org.glassfish.grizzly.threadpool.ThreadPoolConfig;
import org.glassfish.grizzly.websockets.WebSocketAddOn;
import org.glassfish.grizzly.websockets.WebSocketApplication;
import org.glassfish.grizzly.websockets.WebSocketEngine;
import org.glassfish.hk2.api.Factory;
import org.glassfish.hk2.utilities.Binder;
import org.glassfish.hk2.utilities.binding.AbstractBinder;
import org.glassfish.jersey.grizzly2.httpserver.GrizzlyHttpContainer;
import org.glassfish.jersey.grizzly2.httpserver.GrizzlyHttpServerFactory;
import org.glassfish.jersey.jackson.JacksonFeature;
import org.glassfish.jersey.media.multipart.MultiPartFeature;
import org.glassfish.jersey.server.ContainerFactory;
import org.glassfish.jersey.server.ResourceConfig;
import org.glassfish.jersey.server.ServerProperties;
import org.glassfish.jersey.server.spi.Container;
import org.glassfish.jersey.server.spi.ContainerLifecycleListener;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.slf4j.bridge.SLF4JBridgeHandler;
import io.bdeploy.common.ActivityReporter;
import io.bdeploy.common.audit.Auditor;
import io.bdeploy.common.audit.Slf4jAuditor;
import io.bdeploy.common.util.NamedDaemonThreadFactory;
import io.bdeploy.common.util.Threads;
import io.bdeploy.common.util.VersionHelper;
import io.bdeploy.jersey.JerseyAuthenticationProvider.JerseyAuthenticationUnprovider;
import io.bdeploy.jersey.JerseyAuthenticationProvider.JerseyAuthenticationWeakenerProvider;
import io.bdeploy.jersey.JerseyAuthenticationProvider.UserValidator;
import io.bdeploy.jersey.activity.JerseyBroadcastingActivityReporter;
import io.bdeploy.jersey.activity.JerseyRemoteActivityResourceImpl;
import io.bdeploy.jersey.activity.JerseyRemoteActivityScopeServerFilter;
import io.bdeploy.jersey.fs.FileSystemSpaceService;
import io.bdeploy.jersey.monitoring.JerseyServerMonitor;
import io.bdeploy.jersey.monitoring.JerseyServerMonitoringResourceImpl;
import io.bdeploy.jersey.monitoring.JerseyServerMonitoringSamplerService;
import io.bdeploy.jersey.resources.JerseyMetricsResourceImpl;
import jakarta.annotation.Priority;
import jakarta.inject.Inject;
import jakarta.inject.Singleton;
import jakarta.ws.rs.Priorities;
import jakarta.ws.rs.core.UriBuilder;
import jakarta.ws.rs.ext.ContextResolver;
import jakarta.ws.rs.ext.Provider;
/**
* Encapsulates required functionality from the Grizzly HttpServer with the
* Jersey handlers.
*
* Use {@link #register(Object)} to register additional resource, filters and
* providers before starting the server.
*/
public class JerseyServer implements AutoCloseable, RegistrationTarget {
/**
* The "Content-Length"-Buffer is a buffer used to buffer a response and determine its length.
*
* Once the buffer overflows, the server switches from settings a Content-Length header on a response to chunked transfer
* encoding.
*
* The buffer is intentionally very small to support streaming responses (e.g. ZIP files, ...).
*
* The buffer size is also the limit for response sizes to exclude from compression. If compression would be be there,
* we would set this to zero to completely disable buffering, but compression will /always/ happen for chunked encoding
* as content length cannot be determined up front.
*/
private static final int CL_BUFFER_SIZE = 512;
private static final Logger log = LoggerFactory.getLogger(JerseyServer.class);
public static final String START_TIME = "StartTime";
public static final String BROADCAST_EXECUTOR = "BcExecutor";
public static final String FILE_SYSTEM_MIN_SPACE = "FileSystemMinSpace";
private final int port;
private final ResourceConfig rc = new ResourceConfig();
private final KeyStore store;
private final char[] passphrase;
private final Instant startTime = Instant.now();
private final Collection closeableResources = new ArrayList<>();
private final ActivityReporter.Delegating reporterDelegate = new ActivityReporter.Delegating();
private final CompletableFuture startup = new CompletableFuture<>();
private final AtomicLong broadcasterId = new AtomicLong(0);
private final ScheduledExecutorService broadcastScheduler = Executors.newScheduledThreadPool(1,
new NamedDaemonThreadFactory(() -> "Scheduled Broadcast " + broadcasterId.incrementAndGet()));
private final Map preRegistrations = new HashMap<>();
private HttpServer server;
private Auditor auditor = new Slf4jAuditor();
private final JerseyServerMonitor monitor = new JerseyServerMonitor();
private final JerseyServerMonitoringSamplerService serverMonitoring = new JerseyServerMonitoringSamplerService(monitor);
private final Map wsApplications = new TreeMap<>();
private UserValidator userValidator;
private GrizzlyHttpContainer container;
/**
* @param port the port to listen on
* @param store the keystore carrying the private certificate/key material
* for SSL.
* @param passphrase the passphrase for the keystore.
*/
public JerseyServer(int port, KeyStore store, char[] passphrase) {
this.port = port;
this.store = store;
this.passphrase = passphrase.clone();
}
@Override
public KeyStore getKeyStore() {
return store;
}
@Override
public CompletableFuture afterStartup() {
return startup;
}
/**
* @return an {@link ActivityReporter} which can broadcast to remote.
*/
public ActivityReporter getRemoteActivityReporter() {
return reporterDelegate;
}
/**
* Sets the auditor that will be used by the server to log requests. The auditor will be closed
* when the server is terminated.
*
* @param auditor
* auditor to log requests
*/
public void setAuditor(Auditor auditor) {
this.auditor = auditor;
registerResource(auditor);
}
/**
* @param validator a validator which can verify a user exists and is allowed to proceed.
*/
public void setUserValidator(UserValidator validator) {
this.userValidator = validator;
}
@Override
public void registerResource(AutoCloseable closeable) {
closeableResources.add(closeable);
}
/**
* Registers a class or an instance to be used in this server.
*
* @param provider a {@link Class} or {@link Object} instance to register. Also
* supports registration of custom {@link Binder} instances
* which allow custom dependency injection in services.
*/
@Override
public void register(Object provider) {
if (provider instanceof Class) {
// unfortunately, priorities are not respected correctly in all cases later on from annotations.
Priority prio = ((Class) provider).getAnnotation(Priority.class);
if (prio != null) {
rc.register((Class) provider, prio.value());
} else {
rc.register((Class) provider);
}
} else {
rc.register(provider);
}
}
@Override
public void addHandler(HttpHandler handler, HttpHandlerRegistration registration) {
if (server == null) {
preRegistrations.put(registration, handler);
} else {
server.getServerConfiguration().addHttpHandler(handler, registration);
}
}
@Override
public void removeHandler(HttpHandler handler) {
if (server == null) {
// data is organized differently in grizzly. they remember a list of registrations per handler instead
// of mapping registrations to handlers, which is way easier, since registrations have equals/hashCode anyway.
Set r = preRegistrations.entrySet().stream().filter(e -> e.getValue().equals(handler))
.map(Map.Entry::getKey).collect(Collectors.toSet());
r.forEach(preRegistrations::remove);
} else {
server.getServerConfiguration().removeHttpHandler(handler);
}
}
@Override
public void registerWebsocketApplication(String urlMapping, WebSocketApplication wsa) {
wsApplications.put(urlMapping, wsa);
}
public static void updateLogging() {
// Grizzly uses JUL
if (SLF4JBridgeHandler.isInstalled()) {
SLF4JBridgeHandler.uninstall();
}
// level of JUL is controlled with the level for the own logger
Level target = Level.WARNING;
if (log.isInfoEnabled()) {
target = Level.INFO;
}
if (log.isDebugEnabled()) {
target = Level.FINE;
}
if (log.isTraceEnabled()) {
target = Level.FINER;
// not finest, as this breaks grizzly.
}
java.util.logging.Logger.getLogger("").setLevel(target);
SLF4JBridgeHandler.removeHandlersForRootLogger();
SLF4JBridgeHandler.install();
}
/**
* Start the server as configured.
*/
public void start() {
try {
URI jerseyUri = UriBuilder.fromUri("https://0.0.0.0/api").port(port).build();
// SSL
KeyManagerFactory kmfactory = KeyManagerFactory.getInstance(KeyManagerFactory.getDefaultAlgorithm());
kmfactory.init(store, passphrase);
SSLContext ctx = SSLContext.getInstance("TLS");
ctx.init(kmfactory.getKeyManagers(), null, null);
SSLEngineConfigurator sslEngine = new SSLEngineConfigurator(ctx, false, false, false);
sslEngine.setEnabledProtocols(new String[] { "TLSv1.2", "TLSv1.3" });
// default features
registerDefaultResources(rc);
server = GrizzlyHttpServerFactory.createHttpServer(jerseyUri, rc, true, sslEngine, false);
container = ContainerFactory.createContainer(GrizzlyHttpContainer.class, rc);
server = GrizzlyHttpServerFactory.createHttpServer(jerseyUri, container, true, sslEngine, false);
for (Map.Entry regs : preRegistrations.entrySet()) {
server.getServerConfiguration().addHttpHandler(regs.getValue(), regs.getKey());
}
monitor.setServer(server);
WebSocketAddOn wsao = new WebSocketAddOn();
for (NetworkListener listener : server.getListeners()) {
// we want to have unrestricted thread counts to allow ALL requests to be processed in parallel.
// otherwise in-vm communication can soft-lock the process (e.g. push hangs because the reading
// thread is not started).
final int coresCount = 8;
ThreadPoolConfig cfg = ThreadPoolConfig.defaultConfig().setPoolName("BDeploy-Transport-Worker")
.setCorePoolSize(coresCount).setMaxPoolSize(Integer.MAX_VALUE)
.setMemoryManager(listener.getTransport().getMemoryManager());
listener.getTransport().setWorkerThreadPoolConfig(cfg);
// enable compression on the server for known mime types.
CompressionConfig cc = listener.getCompressionConfig();
cc.setCompressionMode(CompressionMode.ON);
cc.setCompressionMinSize(CL_BUFFER_SIZE);
cc.setDecompressionEnabled(true);
// enable WebSockets on the listener
listener.registerAddOn(wsao);
}
// register all WebSocketApplications on their path.
wsApplications.forEach((path, app) -> WebSocketEngine.getEngine().register("/ws", path, app));
server.getHttpHandler().setAllowEncodedSlash(true);
server.start();
log.info("Started Version {}", VersionHelper.getVersion());
startup.complete(this);
} catch (GeneralSecurityException | IOException e) {
throw new IllegalStateException("Cannot start server", e);
}
}
/**
* @param config a ResourceConfig to enrich with all the default resources and features used by the BDeploy JAX-RS
* infrastructure. Allows to create additional JAX-RS applications which use the same setup as BDeploy itself.
* This is useful e.g. for plugins which should use the same filters/features as BDeploy.
*/
public void registerDefaultResources(ResourceConfig config) {
config.register(new ServerObjectBinder());
config.register(JerseyObjectMapper.class);
config.register(JacksonFeature.class);
config.register(MultiPartFeature.class);
// unfortunately, priorities annotated on the providers are not always respected.
config.register(new JerseyAuthenticationProvider(store, userValidator), Priorities.AUTHENTICATION);
config.register(JerseyAuthenticationUnprovider.class, Priorities.AUTHENTICATION - 1);
config.register(JerseyAuthenticationWeakenerProvider.class, Priorities.AUTHENTICATION - 2);
config.register(JerseyPathReader.class);
config.register(JerseyPathWriter.class);
config.register(JerseyMetricsFilter.class);
config.register(JerseyMetricsResourceImpl.class);
config.register(JerseyAuditingFilter.class);
config.register(JerseyExceptionMapper.class);
config.register(JerseyRemoteActivityResourceImpl.class);
config.register(JerseyRemoteActivityScopeServerFilter.class);
config.register(JerseyServerMonitoringResourceImpl.class);
config.register(new JerseyLazyReporterInitializer());
config.register(new JerseyServerReporterContextResolver());
config.register(new JerseyWriteLockFilter());
config.property(ServerProperties.OUTBOUND_CONTENT_LENGTH_BUFFER, CL_BUFFER_SIZE);
}
/**
* @return whether the server is running.
*/
public boolean isRunning() {
return server != null && server.isStarted();
}
@Override
public void close() {
// Close all registered resources
for (AutoCloseable closeable : closeableResources) {
try {
log.info("Closing resource '{}'", closeable);
closeable.close();
if (log.isDebugEnabled()) {
log.debug("Resource '{}' closed", closeable);
}
} catch (Exception ex) {
log.error("Failed to close resource '{}'", closeable, ex);
}
}
closeableResources.clear();
// Shutdown the server itself
if (server != null) {
server.shutdownNow();
server = null;
}
}
public boolean join() {
while (isRunning()) {
if (!Threads.sleep(1000)) {
return isRunning();
}
}
return isRunning();
}
private class ServerObjectBinder extends AbstractBinder {
@Override
protected void configure() {
// NOTE: *DO NOT* create singleton resources here on the fly, since this binder is used
// when initializing plugins as well. For every plugin loaded this might cause resource leaks.
bind(JerseyBroadcastingActivityReporter.class).in(Singleton.class).to(JerseyBroadcastingActivityReporter.class);
bind(JerseyWriteLockService.class).in(Singleton.class).to(JerseyWriteLockService.class);
bind(JerseyScopeService.class).in(Singleton.class).to(JerseyScopeService.class);
bind(FileSystemSpaceService.class).in(Singleton.class).to(FileSystemSpaceService.class);
bind(startTime).named(START_TIME).to(Instant.class);
bind(broadcastScheduler).named(BROADCAST_EXECUTOR).to(ScheduledExecutorService.class);
bind(serverMonitoring).to(JerseyServerMonitoringSamplerService.class);
// need to lazily access the auditor in case it is changed later.
bindFactory(new JerseyAuditorBridgeFactory()).to(Auditor.class);
// need to bridge over to the same instance as used for the singleton sse activity reporter.
bindFactory(JerseyRemoteActivityReporterBridgeFactory.class).to(ActivityReporter.class);
}
}
/**
* Provides the auditor for dependency injection in a dynamic fashion.
*/
private class JerseyAuditorBridgeFactory implements Factory {
@Override
public Auditor provide() {
return auditor;
}
@Override
public void dispose(Auditor instance) {
// nothing to do
}
}
/**
* Provides the instance of {@link JerseyBroadcastingActivityReporter} when an {@link ActivityReporter} is requested for
* injection.
*/
private static class JerseyRemoteActivityReporterBridgeFactory implements Factory {
@Inject
private JerseyBroadcastingActivityReporter reporter;
@Override
public ActivityReporter provide() {
return reporter;
}
@Override
public void dispose(ActivityReporter instance) {
// nothing to do
}
}
/**
* Updates the delegate {@link ActivityReporter} of the {@link JerseyServer} to the resolved
* {@link JerseyBroadcastingActivityReporter}
* once it is available for injection.
*/
private class JerseyLazyReporterInitializer implements ContainerLifecycleListener {
@Override
public void onStartup(Container container) {
reporterDelegate.setDelegate(container.getApplicationHandler().getInjectionManager()
.getInstance(JerseyBroadcastingActivityReporter.class));
}
@Override
public void onReload(Container container) {
// delegate stays the same
}
@Override
public void onShutdown(Container container) {
// nothing to do
}
}
/**
* Provides the {@link ActivityReporter} delegate as JAX-RS context object, which is required by {@link Provider}s that want
* to resolve the {@link ActivityReporter} from the JAX-RS context.
*/
@Provider
private class JerseyServerReporterContextResolver implements ContextResolver {
@Override
public ActivityReporter getContext(Class type) {
return reporterDelegate;
}
}
}