Class TCPJDBCServer

java.lang.Object
com.mckoi.database.control.TCPJDBCServer

public class TCPJDBCServer extends Object
Attaches to a DBSystem, and binds a TCP port and serves queries for JDBC connections. This object is used to programmatically create a TCP JDBC server on the local machine.

Note that multiple servers can be constructed to serve the same DBSystem. You can not use this object to connect a single TCP server to multiple DBSystem objects.

If the underlying database is shut down then this server is also shut down.

Author:
Tobias Downer
  • Constructor Summary

    Constructors
    Constructor
    Description
    Constructs the TCP JDBC with the given DBSystem object, and sets the TCP port and address (for multi-homed computers) to the setting of the configuration in 'system'.
    TCPJDBCServer(DBSystem system, int tcp_port)
    Constructs the TCP JDBC with the given DBSystem object, and sets the TCP port that we serve the database from.
    TCPJDBCServer(DBSystem system, InetAddress bind_address, int tcp_port)
    Constructs the TCP JDBC with the given DBSystem object, and sets the inet address and TCP port that we serve the database from.
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    Starts the server and binds it to the given port.
    void
    Stops the server running on the given port.
    Returns a string that contains some information about the server that is running.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
  • Constructor Details

    • TCPJDBCServer

      public TCPJDBCServer(DBSystem system, InetAddress bind_address, int tcp_port)
      Constructs the TCP JDBC with the given DBSystem object, and sets the inet address and TCP port that we serve the database from.

      Constructing this server does not open the port to receive connections from outside. To start the JDBC server you need to call the 'start' method.

    • TCPJDBCServer

      public TCPJDBCServer(DBSystem system, int tcp_port)
      Constructs the TCP JDBC with the given DBSystem object, and sets the TCP port that we serve the database from. This binds the server to all interfaces on the local machine.

      Constructing this server does not open the port to receive connections from outside. To start the JDBC server you need to call the 'start' method.

    • TCPJDBCServer

      public TCPJDBCServer(DBSystem system)
      Constructs the TCP JDBC with the given DBSystem object, and sets the TCP port and address (for multi-homed computers) to the setting of the configuration in 'system'.

      Constructing this server does not open the port to receive connections from outside. To start the JDBC server you need to call the 'start' method.

  • Method Details

    • start

      public void start()
      Starts the server and binds it to the given port. This method will start a new thread that listens for incoming connections.
    • stop

      public void stop()
      Stops the server running on the given port. This method will stop any threads that are listening for incoming connections.

      Note that this does NOT close the underlying DBSystem object. The DBSystem object must be closed separately.

    • toString

      public String toString()
      Returns a string that contains some information about the server that is running.
      Overrides:
      toString in class Object