jaxrs.examples.bootstrap.TlsJavaSeBootstrapExample Maven / Gradle / Ivy

Go to download
/*
 * 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 javax.net.ssl.KeyManagerFactory;
import javax.net.ssl.SSLContext;
import java.io.IOException;
import java.net.URI;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.security.GeneralSecurityException;
import java.security.KeyStore;

import jakarta.ws.rs.SeBootstrap;
import jakarta.ws.rs.core.Application;

/**
 * Java SE bootstrap example using TLS customization.
 * 
 * This example demonstrates bootstrapping on Java SE platforms using HTTPS with TLS 1.2 and a particular
 * keystore. It explicitly sets the protocol to {@code HTTPS} using port 443 and provides a {@link SSLContext}
 * customized to TLS v1.2 using a provided keystore file. The example will effectively startup the {@link HelloWorld}
 * application at the URL {@code https://localhost:443/}.
 * 
 *
 * @author Markus KARG ([email protected])
 * @since 3.1
 */
public final class TlsJavaSeBootstrapExample {

    private TlsJavaSeBootstrapExample() {
    }

    /**
     * Runs this example.
     *
     * @param args KEYSTORE_PATH KEYSTORE_PASSWORD
     * @throws GeneralSecurityException in case JSSE fails
     * @throws IOException in case file access fails
     * @throws InterruptedException when process is killed
     */
    public static void main(final String[] args)
            throws GeneralSecurityException, IOException, InterruptedException {
        final Application application = new HelloWorld();

        final Path keyStorePath = Paths.get(args[0]);
        final char[] passphrase = args[1].toCharArray();

        final KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
        keyStore.load(Files.newInputStream(keyStorePath), passphrase);
        final KeyManagerFactory keyManagerFactory = KeyManagerFactory
                .getInstance(KeyManagerFactory.getDefaultAlgorithm());
        keyManagerFactory.init(keyStore, passphrase);
        final SSLContext sslContext = SSLContext.getInstance("TLSv1.2");
        sslContext.init(keyManagerFactory.getKeyManagers(), null, null);

        final SeBootstrap.Configuration requestedConfiguration = SeBootstrap.Configuration.builder().protocol("HTTPS")
                .sslContext(sslContext).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();
    }

}