jaxrs.examples.bootstrap.NativeJavaSeBootstrapExample Maven / Gradle / Ivy
/*
* Copyright (c) 2018 Markus KARG. 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 jaxrs.examples.bootstrap;
import java.net.URI;
import jakarta.ws.rs.SeBootstrap;
import jakarta.ws.rs.core.Application;
/**
* Java SE bootstrap example demonstrating the use of native properties.
*
* This example demonstrates bootstrapping on Java SE platforms with native properties, in particular by explicitly
* selecting the Grizzly2 backend in Jersey. It will effectively startup the {@link HelloWorld} application at the URL
* {@code http://localhost:80/}, i. e. the Grizzly2 backend selects exactly port 80 as this is its default IP port. The
* actual configuration needs to be queried after bootstrapping, otherwise callers would be unaware of the actual chosen
* port, as Grizzly2's default behavior is not publicly documented.
*
*
* This is a native example, hence it only works with Jersey, and in particular only with its Grizzly2 backend. To
* actually run this demo, the following libraries have to be found on the classpath:
*
*
* - jersey-server
* - jersey-container-grizzly2-http
*
*
* @author Markus KARG ([email protected])
* @since 3.1
*/
public final class NativeJavaSeBootstrapExample {
private NativeJavaSeBootstrapExample() {
}
/**
* Runs this example.
*
* @param args unused command line arguments
* @throws InterruptedException when process is killed
* @throws ClassNotFoundException when Jersey's Grizzly backend is not on the classpath
*/
public static void main(final String[] args) throws InterruptedException, ClassNotFoundException {
final Application application = new HelloWorld();
final SeBootstrap.Configuration requestedConfiguration = SeBootstrap.Configuration.builder()
.property("jersey.config.server.httpServerClass",
Class.forName("org.glassfish.jersey.grizzly2.httpserver.GrizzlyHttpServer"))
.build();
SeBootstrap.start(application, requestedConfiguration).thenAccept(instance -> {
instance.stopOnShutdown(stopResult ->
System.out.printf("Stop result: %s [Native stop result: %s].%n", stopResult,
stopResult.unwrap(Object.class)));
final URI uri = instance.configuration().baseUri();
System.out.printf("Instance %s running at %s [Native handle: %s].%n", instance, uri,
instance.unwrap(Object.class));
System.out.println("Send SIGKILL to shutdown.");
});
Thread.currentThread().join();
}
}