/** * The contents of this file are subject to the Mozilla Public License Version 1.1 * (the "License"); you may not use this file except in compliance with the License. * You may obtain a copy of the License at http://www.mozilla.org/MPL/ * Software distributed under the License is distributed on an "AS IS" basis, * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the * specific language governing rights and limitations under the License. * * The Original Code is "SimpleServer.java". Description: * "A simple TCP/IP-based HL7 server." * * The Initial Developer of the Original Code is University Health Network. Copyright (C) * 2002. All Rights Reserved. * * Contributor(s): Kyle Buza * * Alternatively, the contents of this file may be used under the terms of the * GNU General Public License (the “GPL”), in which case the provisions of the GPL are * applicable instead of those above. If you wish to allow use of your version of this * file only under the terms of the GPL and not to allow others to use your version * of this file under the MPL, indicate your decision by deleting the provisions above * and replace them with the notice and other provisions required by the GPL License. * If you do not delete the provisions above, a recipient may use your version of * this file under either the MPL or the GPL. */ package ca.uhn.hl7v2.app; import java.io.File; import java.io.InterruptedIOException; import java.net.ServerSocket; import java.net.Socket; import ca.uhn.hl7v2.llp.LowerLayerProtocol; import ca.uhn.hl7v2.parser.Parser; import ca.uhn.hl7v2.parser.PipeParser; import ca.uhn.log.HapiLog; import ca.uhn.log.HapiLogFactory; /** *

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 "Application"s based on * message type. From the HL7 perspective, an Application is something that * does something with a message.

* @author Bryan Tripp */ public class SimpleServer extends HL7Service { /** * Socket timeout for simple server */ public static final int SO_TIMEOUT = 3000; private static final HapiLog log = HapiLogFactory.getHapiLog(SimpleServer.class); private int port; /** * Creates a new instance of SimpleServer that listens * on the given port. Exceptions are logged using ca.uhn.hl7v2.Log; */ public SimpleServer(int port, LowerLayerProtocol llp, Parser parser) { super(parser, llp); this.port = port; } /** * Loop that waits for a connection and starts a ConnectionManager * when it gets one. */ public void run() { try { ServerSocket ss = new ServerSocket(port); ss.setSoTimeout(SO_TIMEOUT); log.info("SimpleServer running on port " + ss.getLocalPort()); while (keepRunning()) { try { Socket newSocket = ss.accept(); log.info("Accepted connection from " + newSocket.getInetAddress().getHostAddress()); Connection conn = new Connection(parser, this.llp, newSocket); newConnection(conn); } catch (InterruptedIOException ie) { //ignore - just timed out waiting for connection } catch (Exception e) { log.error( "Error while accepting connections: ", e); } } ss.close(); } catch (Exception e) { log.error(e); } finally { //Bug 960113: Make sure HL7Service.stop() is called to stop ConnectionCleaner thread. this.stop(); } } /** * 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. */ public static void main(String args[]) { if (args.length < 1 || args.length > 2) { System.out.println("Usage: ca.uhn.hl7v2.app.SimpleServer port_num [application_spec_file_name]"); System.exit(1); } int port = 0; try { port = Integer.parseInt(args[0]); } catch (NumberFormatException e) { System.err.println("The given port (" + args[0] + ") is not an integer."); System.exit(1); } File appFile = null; if (args.length == 2) { appFile = new File(args[1]); } try { SimpleServer server = new SimpleServer(port, LowerLayerProtocol.makeLLP(), new PipeParser()); if (appFile != null) server.loadApplicationsFromFile(appFile); server.start(); } catch (Exception e) { e.printStackTrace(); } } }