org.h2.tools

类 Server

java.lang.Object

org.h2.util.Tool

org.h2.tools.Server

所有已实现的接口:

Runnable, ShutdownHandler

public class Server
extends Tool
implements Runnable, ShutdownHandler

Starts the H2 Console (web-) server, TCP, and PG server.

字段概要

从类继承的字段 org.h2.util.Tool

out

构造器概要

构造器

构造器和说明
Server()
Server(Service service, String... args) Create a new server for the given service.

方法概要

限定符和类型	方法和说明
static Server	createPgServer(String... args) Create a new PG server, but does not start it yet.
static Server	createTcpServer(String... args) Create a new TCP server, but does not start it yet.
static Server	createWebServer(String... args) Create a new web server, but does not start it yet.
int	getPort() Gets the port this server is listening on.
Service	getService() Get the service attached to this server.
String	getStatus() Get the status of this server.
String	getURL() Gets the URL of this server.
boolean	isRunning(boolean traceError) Checks if the server is running.
static void	main(String... args) When running without options, -tcp, -web, -browser and -pg are started.
static void	openBrowser(String url) Open a new browser tab or window with the given URL.
void	run() INTERNAL
void	runTool(String... args) Run the tool with the given output stream and arguments.
void	setShutdownHandler(ShutdownHandler shutdownHandler) INTERNAL
void	shutdown() INTERNAL
static void	shutdownTcpServer(String url, String password, boolean force, boolean all) Shutdown one or all TCP server.
Server	start() Tries to start the server.
static void	startWebServer(Connection conn) Start a web server and a browser that uses the given connection.
static void	startWebServer(Connection conn, boolean ignoreProperties) Start a web server and a browser that uses the given connection.
void	stop() Stops the server.

从类继承的方法 org.h2.util.Tool

isOption, printNoDatabaseFilesFound, setOut, showUsage, showUsageAndThrowUnsupportedOption, throwUnsupportedOption

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

Server

public Server()

Server

public Server(Service service,
              String... args)
       throws SQLException

Create a new server for the given service.

参数:

service - the service

args - the command line arguments

抛出:

SQLException - on failure

方法详细资料

main

public static void main(String... args)
                 throws SQLException

When running without options, -tcp, -web, -browser and -pg are started. Options are case sensitive.

Supported options

[-help] or [-?]	Print the list of options
[-web]	Start the web server with the H2 Console
[-webAllowOthers]	Allow other computers to connect - see below
[-webExternalNames <names>]	The comma-separated list of external names and IP addresses of this server, used together with -webAllowOthers
[-webDaemon]	Use a daemon thread
[-webPort <port>]	The port (default: 8082)
[-webSSL]	Use encrypted (HTTPS) connections
[-webAdminPassword]	Password of DB Console administrator
[-browser]	Start a browser connecting to the web server
[-tcp]	Start the TCP server
[-tcpAllowOthers]	Allow other computers to connect - see below
[-tcpDaemon]	Use a daemon thread
[-tcpPort <port>]	The port (default: 9092)
[-tcpSSL]	Use encrypted (SSL) connections
[-tcpPassword <pwd>]	The password for shutting down a TCP server
[-tcpShutdown "<url>"]	Stop the TCP server; example: tcp://localhost
[-tcpShutdownForce]	Do not wait until all connections are closed
[-pg]	Start the PG server
[-pgAllowOthers]	Allow other computers to connect - see below
[-pgDaemon]	Use a daemon thread
[-pgPort <port>]	The port (default: 5435)
[-properties "<dir>"]	Server properties (default: ~, disable: null)
[-baseDir <dir>]	The base directory for H2 databases (all servers)
[-ifExists]	Only existing databases may be opened (all servers)
[-ifNotExists]	Databases are created when accessed
[-trace]	Print additional trace information (all servers)
[-key <from> <to>]	Allows to map a database name to another (all servers)

The options -xAllowOthers are potentially risky. For details, see Advanced Topics / Protection against Remote Access.

参数:

args - the command line arguments

抛出:

SQLException - on failure

runTool

public void runTool(String... args)
             throws SQLException

从类复制的说明: Tool

Run the tool with the given output stream and arguments.

指定者:

runTool 在类中 Tool

参数:

args - the argument list

抛出:

SQLException - on failure

shutdownTcpServer

public static void shutdownTcpServer(String url,
                                     String password,
                                     boolean force,
                                     boolean all)
                              throws SQLException

Shutdown one or all TCP server. If force is set to false, the server will not allow new connections, but not kill existing connections, instead it will stop if the last connection is closed. If force is set to true, existing connections are killed. After calling the method with force=false, it is not possible to call it again with force=true because new connections are not allowed. Example:

 Server.shutdownTcpServer("tcp://localhost:9094",
         password, true, false);
 

参数:

url - example: tcp://localhost:9094

password - the password to use ("" for no password)

force - the shutdown (don't wait)

all - whether all TCP servers that are running in the JVM should be stopped

抛出:

SQLException - on failure

getStatus

public String getStatus()

Get the status of this server.

返回:

the status

createWebServer

public static Server createWebServer(String... args)
                              throws SQLException

Create a new web server, but does not start it yet. Example:

 Server server = Server.createWebServer("-trace").start();
 

Supported options are: -webPort, -webSSL, -webAllowOthers, -webDaemon, -trace, -ifExists, -ifNotExists, -baseDir, -properties. See the main method for details.

参数:

args - the argument list

返回:

the server

抛出:

SQLException - on failure

createTcpServer

public static Server createTcpServer(String... args)
                              throws SQLException

Create a new TCP server, but does not start it yet. Example:

 Server server = Server.createTcpServer(
     "-tcpPort", "9123", "-tcpAllowOthers").start();
 

Supported options are: -tcpPort, -tcpSSL, -tcpPassword, -tcpAllowOthers, -tcpDaemon, -trace, -ifExists, -ifNotExists, -baseDir, -key. See the main method for details.

If no port is specified, the default port is used if possible, and if this port is already used, a random port is used. Use getPort() or getURL() after starting to retrieve the port.

参数:

args - the argument list

返回:

the server

抛出:

SQLException - on failure

createPgServer

public static Server createPgServer(String... args)
                             throws SQLException

Create a new PG server, but does not start it yet. Example:

 Server server =
     Server.createPgServer("-pgAllowOthers").start();
 

Supported options are: -pgPort, -pgAllowOthers, -pgDaemon, -trace, -ifExists, -ifNotExists, -baseDir, -key. See the main method for details.

If no port is specified, the default port is used if possible, and if this port is already used, a random port is used. Use getPort() or getURL() after starting to retrieve the port.

参数:

args - the argument list

返回:

the server

抛出:

SQLException - on failure

start

public Server start()
             throws SQLException

Tries to start the server.

返回:

the server if successful

抛出:

SQLException - if the server could not be started

isRunning

public boolean isRunning(boolean traceError)

Checks if the server is running.

参数:

traceError - if errors should be written

返回:

if the server is running

stop

public void stop()

Stops the server.

getURL

public String getURL()

Gets the URL of this server.

返回:

the url

getPort

public int getPort()

Gets the port this server is listening on.

返回:

the port

run

public void run()

INTERNAL

指定者:

run 在接口中 Runnable

setShutdownHandler

public void setShutdownHandler(ShutdownHandler shutdownHandler)

INTERNAL

参数:

shutdownHandler - to set

shutdown

public void shutdown()

INTERNAL

指定者:

shutdown 在接口中 ShutdownHandler

getService

public Service getService()

Get the service attached to this server.

返回:

the service

openBrowser

public static void openBrowser(String url)
                        throws Exception

Open a new browser tab or window with the given URL.

参数:

url - the URL to open

抛出:

Exception - on failure

startWebServer

public static void startWebServer(Connection conn)
                           throws SQLException

Start a web server and a browser that uses the given connection. The current transaction is preserved. This is specially useful to manually inspect the database when debugging. This method return as soon as the user has disconnected.

参数:

conn - the database connection (the database must be open)

抛出:

SQLException - on failure

startWebServer

public static void startWebServer(Connection conn,
                                  boolean ignoreProperties)
                           throws SQLException

Start a web server and a browser that uses the given connection. The current transaction is preserved. This is specially useful to manually inspect the database when debugging. This method return as soon as the user has disconnected.

参数:

conn - the database connection (the database must be open)

ignoreProperties - if true properties from .h2.server.properties will be ignored

抛出:

SQLException - on failure