com.ibm.wsspi.kernel.embeddable

Interface Server


  1. public interface Server
An embedded Liberty server instance.

Server instances are obtained using the ServerBuilder. The methods of this interface can be used to manage and control the server instance.

There are some limitations when working with an embedded server: environment variables are not checked, and jvm.options and server.env files are not read. Management of the JVM and environment is assumed to be managed by the caller.

bootstrap.properties and server.xml files will be read as normal, with additional caveats listed as follows.

Consumers of this SPI must not implement this interface. A server instance is thread safe.

See Also:
ServerBuilder.build()

Nested Class Summary

Modifier and Type Interface and Description
  1. static interface
Server.Result
Result of a start or stop operation.

Method Summary

Modifier and Type Method and Description
  1. boolean
isRunning()
  1. java.util.concurrent.Future<Server.Result>
start(java.util.Map<java.lang.String,java.lang.String> props,java.lang.String... arguments)
Start the Liberty server instance using the given arguments.
  1. java.util.concurrent.Future<Server.Result>
start(java.lang.String... arguments)
Start the Liberty server instance using the given arguments.
  1. java.util.concurrent.Future<Server.Result>
stop(java.lang.String... arguments)
Stop the Liberty server instance.

Method Detail

start

  1. java.util.concurrent.Future<Server.Result> start( java.lang.String... arguments)
Start the Liberty server instance using the given arguments. The arguments used here are the same as would be passed to the command line.
Parameters:
arguments - Command line arguments for start
Returns:
a Future representing pending completion of the start operation

start

  1. java.util.concurrent.Future<Server.Result> start( java.util.Map<java.lang.String,java.lang.String> props,
  2. java.lang.String... arguments)
Start the Liberty server instance using the given arguments. The arguments used here are the same as would be passed to the command line.
Parameters:
props - Additional properties that will supersede any values read from bootstrap.properties or System.properties
arguments - Command line arguments for start
Returns:
a Future representing pending completion of the start operation

stop

  1. java.util.concurrent.Future<Server.Result> stop( java.lang.String... arguments)
Stop the Liberty server instance.
Parameters:
arguments - Command line arguments for stop
Returns:
a Future representing pending completion of the stop operation

isRunning

  1. boolean isRunning()
Returns:
true if this server instance is running