Minimal Example for JAX-RS Bootstrapping on Java SE 8

MinimumSeBootstrapExample.java

/*
 * 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.io.IOException;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.ExecutionException;

import javax.ws.rs.JAXRS;
import javax.ws.rs.JAXRS.Instance;

/**
 * Minimum Java SE Bootstrap Example
 *
 * @author Markus KARG (markus@headcrashing.eu)
 */
public class MinimumSeBootstrapExample {

  public void main(final String[] args) throws IOException, InterruptedException, ExecutionException {
    final CompletableFuture<Instance> boot = JAXRS.start(new HelloWorld(), JAXRS.Configuration.builder().build()).toCompletableFuture();
    final Instance instance = boot.get();

    System.out.println("Press any key to shutdown.");
    System.in.read();

    instance.stop().toCompletableFuture().join();
  }

}

"startedIntance" is semantically wrong;

Than how is the flow ?

-> stage completes (instance started) -> callback called with (JAXRS.Instance instance))

And the first completed stage joins the main thread ? Or what is the purpose of 'toCompletableFuture().join()' ?

There is no need to give explicitly "(JAXRS.Instance instance)"; Java already knows the type.

I know that, but I like examples to be more explicit. But I can remove it...

Separate blocks is fine for me, but not necessarily better than inline code, as this is just an example that shall outline the steps to perform.

Just judging from the discussion regarding 'startedIntance' it may at least help to understand the concepts more clearly ;-)

BTW: I think this one is wrong;

default Builder port(String port) {
return property(PORT, port);
}

Shouldn't that be an Integer? At least I get : java.lang.String cannot be cast to java.lang.Integer when using the builder.

@mkarg I'm OK with keep stop async, gives it a nice symmetry even if not as useful IMO.

@mkarg Newer versions of example are much nicer. I still find System.in.read() unrealistic; process should stop on a signal.