ca.uhn.hl7v2.app

Class SimpleServer

java.lang.Object

ca.uhn.hl7v2.concurrent.Service

ca.uhn.hl7v2.app.HL7Service

ca.uhn.hl7v2.app.SimpleServer

All Implemented Interfaces:

Runnable

public class SimpleServer
extends HL7Service

A simple TCP/IP-based HL7 server. This server listens for connections on a particular port, and creates a ConnectionManager for each incoming connection.

A single SimpleServer can only service requests that use a single class of LowerLayerProtocol (specified at construction time).

The ConnectionManager uses a PipeParser of the version specified in the constructor

ConnectionManagers currently only support original mode processing.

The ConnectionManager routes messages to various Applications based on message type. From the HL7 perspective, an Application is something that does something with a message.

Author:

Bryan Tripp, Christian Ohr

Field Summary

Fields

Modifier and Type	Field and Description
static int	SO_TIMEOUT Socket timeout for simple server

Constructor Summary

Constructors

Constructor and Description
SimpleServer(HapiContext hapiContext, int port, boolean tls) Creates a new instance of SimpleServer that listens on a given server socket.
SimpleServer(int port) Creates a new instance of SimpleServer that listens on the given port, using the MinLowerLayerProtocol and a standard PipeParser.
SimpleServer(int port, boolean tls) Creates a new instance of SimpleServer that listens on the given port, using the MinLowerLayerProtocol and a standard PipeParser.
SimpleServer(int port, LowerLayerProtocol llp, Parser parser) Creates a new instance of SimpleServer that listens on the given port.
SimpleServer(int port, LowerLayerProtocol llp, Parser parser, boolean tls) Creates a new instance of SimpleServer that listens on the given port.
SimpleServer(int port, LowerLayerProtocol llp, Parser parser, boolean tls, ExecutorService executorService) Creates a new instance of SimpleServer using a custom {link ExecutorService.

Method Summary

Modifier and Type	Method and Description
protected void	afterStartup() Prepare server by initializing the server socket
protected void	afterTermination() Close down socket
protected void	handle() Loop that waits for a connection and starts a ConnectionManager when it gets one.
static void	main(String[] args) Run server from command line.

Methods inherited from class ca.uhn.hl7v2.app.HL7Service

getRemoteConnection, getRemoteConnections, keepRunning, loadApplicationsFromFile, newConnection, registerApplication, registerApplication, registerApplication, registerApplication, registerConnectionListener, setExceptionHandler, unregisterApplication, unregisterApplication

Methods inherited from class ca.uhn.hl7v2.concurrent.Service

getExecutorService, getServiceExitedWithException, isRunning, prepareTermination, run, setServiceExitedWithException, setShutdownTimeout, start, startAndWait, stop, stopAndWait, waitForTermination

Methods inherited from class java.lang.Object

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

Field Detail

SO_TIMEOUT

public static final int SO_TIMEOUT

Socket timeout for simple server

See Also:

Constant Field Values

Constructor Detail

SimpleServer

public SimpleServer(int port)

Creates a new instance of SimpleServer that listens on the given port, using the MinLowerLayerProtocol and a standard PipeParser.

SimpleServer

public SimpleServer(int port,
                    boolean tls)

Creates a new instance of SimpleServer that listens on the given port, using the MinLowerLayerProtocol and a standard PipeParser.

SimpleServer

public SimpleServer(int port,
                    LowerLayerProtocol llp,
                    Parser parser)

Creates a new instance of SimpleServer that listens on the given port.

SimpleServer

public SimpleServer(int port,
                    LowerLayerProtocol llp,
                    Parser parser,
                    boolean tls)

Creates a new instance of SimpleServer that listens on the given port.

SimpleServer

public SimpleServer(int port,
                    LowerLayerProtocol llp,
                    Parser parser,
                    boolean tls,
                    ExecutorService executorService)

Creates a new instance of SimpleServer using a custom {link ExecutorService. This ExecutorService instance will not be shut down after the server stops!

SimpleServer

public SimpleServer(HapiContext hapiContext,
                    int port,
                    boolean tls)

Creates a new instance of SimpleServer that listens on a given server socket. SimpleServer will bind the socket when it is started, so the server socket must not already be bound.

Throws:

IllegalStateException - If serverSocket is already bound

Since:

2.1

Method Detail

afterStartup

protected void afterStartup()

Prepare server by initializing the server socket

Overrides:

afterStartup in class HL7Service

See Also:

HL7Service.afterStartup()

handle

protected void handle()

Loop that waits for a connection and starts a ConnectionManager when it gets one.

Specified by:

handle in class Service

afterTermination

protected void afterTermination()

Close down socket

Overrides:

afterTermination in class HL7Service

main

public static void main(String[] args)

Run server from command line. Port number should be passed as an argument, and a file containing a list of Applications to use can also be specified as an optional argument (as per loadApplicationsFromFile(...)). Uses the default LowerLayerProtocol.