All Known Implementing Classes:
ServerImpl

public interface Server
Microprofile server.
  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Interface
    Description
    static final class 
    Builder to build Server instance.
  • Method Summary

    Modifier and Type
    Method
    Description
    Builder to customize Server instance.
    static Server
    Create a server instance for discovered JAX-RS application (through CDI).
    static Server
    create(Application... applications)
    Create a server instance for a JAX-RS application.
    static Server
    create(Class<? extends Application>... applicationClasses)
    Create a server instance for a JAX-RS application class.
    Get the host this server listens on.
    int
    Get the port this server listens on or -1 if the server is not running.
    Start this server (can only be used once).
    Stop this server immediately (can only be used on a started server).
  • Method Details

    • create

      @SafeVarargs static Server create(Application... applications) throws MpException
      Create a server instance for a JAX-RS application.
      Parameters:
      applications - application(s) to use
      Returns:
      Server instance to be started
      Throws:
      MpException - in case the server fails to be created
      See Also:
    • create

      @SafeVarargs static Server create(Class<? extends Application>... applicationClasses) throws MpException
      Create a server instance for a JAX-RS application class.
      Parameters:
      applicationClasses - application class(es) to use
      Returns:
      Server instance to be started
      Throws:
      MpException - in case the server fails to be created
      See Also:
    • create

      static Server create() throws MpException
      Create a server instance for discovered JAX-RS application (through CDI).
      Returns:
      Server instance to be started
      Throws:
      MpException - in case the server fails to be created
      See Also:
    • builder

      static Server.Builder builder()
      Builder to customize Server instance.
      Returns:
      builder instance
    • start

      Server start() throws MpException
      Start this server (can only be used once). This is a blocking call.
      Returns:
      Server instance, started
      Throws:
      MpException - in case the server fails to start
    • stop

      Server stop() throws MpException
      Stop this server immediately (can only be used on a started server). This is a blocking call.
      Returns:
      Server instance, stopped
      Throws:
      MpException - in case the server fails to stop
    • host

      String host()
      Get the host this server listens on.
      Returns:
      host name
    • port

      int port()
      Get the port this server listens on or -1 if the server is not running.
      Returns:
      port