| Classes in this File | Line Coverage | Branch Coverage | Complexity | ||||
| Responder |
|
| 1.75;1.75 |
| 1 | /** | |
| 2 | * The contents of this file are subject to the Mozilla Public License Version 1.1 | |
| 3 | * (the "License"); you may not use this file except in compliance with the License. | |
| 4 | * You may obtain a copy of the License at http://www.mozilla.org/MPL/ | |
| 5 | * Software distributed under the License is distributed on an "AS IS" basis, | |
| 6 | * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the | |
| 7 | * specific language governing rights and limitations under the License. | |
| 8 | * | |
| 9 | * The Original Code is "Responder.java". Description: | |
| 10 | * "Performs the responding role in a message exchange according to HL7's original mode | |
| 11 | * processing rules." | |
| 12 | * | |
| 13 | * The Initial Developer of the Original Code is University Health Network. Copyright (C) | |
| 14 | * 2002. All Rights Reserved. | |
| 15 | * | |
| 16 | * Contributor(s): ______________________________________. | |
| 17 | * | |
| 18 | * Alternatively, the contents of this file may be used under the terms of the | |
| 19 | * GNU General Public License (the �GPL�), in which case the provisions of the GPL are | |
| 20 | * applicable instead of those above. If you wish to allow use of your version of this | |
| 21 | * file only under the terms of the GPL and not to allow others to use your version | |
| 22 | * of this file under the MPL, indicate your decision by deleting the provisions above | |
| 23 | * and replace them with the notice and other provisions required by the GPL License. | |
| 24 | * If you do not delete the provisions above, a recipient may use your version of | |
| 25 | * this file under either the MPL or the GPL. | |
| 26 | * | |
| 27 | */ | |
| 28 | package ca.uhn.hl7v2.app; | |
| 29 | ||
| 30 | import java.io.BufferedReader; | |
| 31 | import java.io.File; | |
| 32 | import java.io.FileReader; | |
| 33 | import java.io.PipedInputStream; | |
| 34 | import java.io.PipedOutputStream; | |
| 35 | import java.io.Reader; | |
| 36 | import java.net.InetSocketAddress; | |
| 37 | import java.net.Socket; | |
| 38 | import java.util.HashMap; | |
| 39 | import java.util.Map; | |
| 40 | ||
| 41 | import ca.uhn.hl7v2.HL7Exception; | |
| 42 | import ca.uhn.hl7v2.model.Message; | |
| 43 | import ca.uhn.hl7v2.parser.Parser; | |
| 44 | import ca.uhn.hl7v2.parser.PipeParser; | |
| 45 | import ca.uhn.hl7v2.protocol.ApplicationRouter; | |
| 46 | import ca.uhn.hl7v2.protocol.Transportable; | |
| 47 | import ca.uhn.hl7v2.protocol.impl.TransportableImpl; | |
| 48 | ||
| 49 | /** | |
| 50 | * <p> | |
| 51 | * Performs the responding role in a message exchange (i.e receiver of the first | |
| 52 | * message, sender of the response; analagous to the server in a client-server | |
| 53 | * interaction), according to HL7's original mode processing rules. | |
| 54 | * </p> | |
| 55 | * <p> | |
| 56 | * At the time of writing, enhanced mode, two-phase reply, continuation | |
| 57 | * messages, and batch processing are unsupported. | |
| 58 | * </p> | |
| 59 | * | |
| 60 | * @author Bryan Tripp | |
| 61 | */ | |
| 62 | class Responder { | |
| 63 | ||
| 64 | private ApplicationRouter apps; | |
| 65 | private Socket inboundSocket; | |
| 66 | ||
| 67 | /** | |
| 68 | * Creates a new instance of Responder | |
| 69 | */ | |
| 70 | 439 | public Responder(Socket theInboundSocket) { |
| 71 | 439 | inboundSocket = theInboundSocket; |
| 72 | 439 | } |
| 73 | ||
| 74 | ||
| 75 | /** | |
| 76 | * Processes an incoming message string and returns the response message | |
| 77 | * string. Message processing consists of parsing the message, finding an | |
| 78 | * appropriate Application and processing the message with it, and encoding | |
| 79 | * the response. Applications are chosen from among those registered using | |
| 80 | * <code>registerApplication</code>. The Parser is obtained from the | |
| 81 | * Connection associated with this Responder. | |
| 82 | */ | |
| 83 | protected String processMessage(String incomingMessageString) | |
| 84 | throws HL7Exception { | |
| 85 | ||
| 86 | 633 | Map<String, Object> metadata = new HashMap<String, Object>(); |
| 87 | 633 | InetSocketAddress remoteSocketAddress = (InetSocketAddress) inboundSocket.getRemoteSocketAddress(); |
| 88 | 633 | metadata.put(ApplicationRouter.METADATA_KEY_SENDING_IP, remoteSocketAddress.getAddress().getHostAddress()); |
| 89 | 633 | metadata.put(ApplicationRouter.METADATA_KEY_SENDING_PORT, remoteSocketAddress.getPort()); |
| 90 | ||
| 91 | 633 | Transportable response = apps.processMessage(new TransportableImpl(incomingMessageString, metadata)); |
| 92 | 633 | return response.getMessage(); |
| 93 | } | |
| 94 | ||
| 95 | // /** | |
| 96 | // * Logs the given exception and creates an error message to send to the | |
| 97 | // * remote system. | |
| 98 | // * | |
| 99 | // * @param encoding | |
| 100 | // * The encoding for the error message. If <code>null</code>, uses | |
| 101 | // * default encoding | |
| 102 | // */ | |
| 103 | // public static String logAndMakeErrorMessage(Exception e, Segment inHeader, | |
| 104 | // Parser p, String encoding) throws HL7Exception { | |
| 105 | // return ApplicationRouterImpl.logAndMakeErrorMessage(e, inHeader, p, encoding); | |
| 106 | // } | |
| 107 | ||
| 108 | /** | |
| 109 | * Registers an Application with this Responder. The "Application", in this | |
| 110 | * context, is the software that uses the information in the message. If | |
| 111 | * multiple applications are registered, incoming Message objects will be | |
| 112 | * passed to each one in turn (calling <code>canProcess()</code>) until one | |
| 113 | * of them accepts responsibility for the message. If none of the registered | |
| 114 | * applications can process the message, a DefaultApplication is used, which | |
| 115 | * simply returns an Application Reject message. | |
| 116 | */ | |
| 117 | void setApplicationRouter(ApplicationRouter router) { | |
| 118 | 234 | this.apps = router; |
| 119 | 234 | } |
| 120 | ||
| 121 | /** | |
| 122 | * Test code. | |
| 123 | */ | |
| 124 | @SuppressWarnings({ "unused", "resource" }) | |
| 125 | public static void main(String args[]) { | |
| 126 | 0 | if (args.length != 1) { |
| 127 | 0 | System.err.println("Usage: DefaultApplication message_file"); |
| 128 | 0 | System.exit(1); |
| 129 | } | |
| 130 | ||
| 131 | // read test message file ... | |
| 132 | try { | |
| 133 | 0 | File messageFile = new File(args[0]); |
| 134 | 0 | Reader in = new BufferedReader(new FileReader(messageFile)); |
| 135 | 0 | int fileLength = (int) messageFile.length(); |
| 136 | 0 | char[] cbuf = new char[fileLength]; |
| 137 | 0 | in.read(cbuf, 0, fileLength); |
| 138 | 0 | String messageString = new String(cbuf); |
| 139 | ||
| 140 | // parse inbound message ... | |
| 141 | 0 | final Parser parser = new PipeParser(); |
| 142 | 0 | Message inMessage = null; |
| 143 | try { | |
| 144 | 0 | inMessage = parser.parse(messageString); |
| 145 | 0 | } catch (HL7Exception e) { |
| 146 | 0 | e.printStackTrace(); |
| 147 | 0 | } |
| 148 | ||
| 149 | // process with responder ... | |
| 150 | 0 | PipedInputStream initInbound = new PipedInputStream(); |
| 151 | 0 | PipedOutputStream initOutbound = new PipedOutputStream(); |
| 152 | 0 | PipedInputStream respInbound = new PipedInputStream(initOutbound); |
| 153 | 0 | PipedOutputStream respOutbound = new PipedOutputStream(initInbound); |
| 154 | ||
| 155 | /* | |
| 156 | * This code won't work with new changes: final ActiveInitiator init = new | |
| 157 | * ActiveInitiator(parser, new MinLowerLayerProtocol(), initInbound, | |
| 158 | * initOutbound); Responder resp = new Responder(respInbound, | |
| 159 | * respOutbound); | |
| 160 | * | |
| 161 | * //run the initiator in a separate thread ... final Message | |
| 162 | * inMessCopy = inMessage; Thread initThd = new Thread(new | |
| 163 | * Runnable() { public void run() { try { Message response = | |
| 164 | * init.sendAndReceive(inMessCopy); | |
| 165 | * System.out.println("This is initiator writing response ..."); | |
| 166 | * System.out.println(parser.encode(response)); } catch (Exception | |
| 167 | * ie) { if (HL7Exception.class.isAssignableFrom(ie.getClass())) { | |
| 168 | * System.out.println("Error in segment " + | |
| 169 | * ((HL7Exception)ie).getSegmentName() + " field " + | |
| 170 | * ((HL7Exception)ie).getFieldPosition()); } ie.printStackTrace(); } | |
| 171 | * } }); initThd.start(); | |
| 172 | * | |
| 173 | * //process the message we expect from the initiator thread ... | |
| 174 | * System.out.println("Responder is going to respond now ..."); | |
| 175 | * resp.processOneMessage(); | |
| 176 | */ | |
| 177 | 0 | } catch (Exception e) { |
| 178 | 0 | e.printStackTrace(); |
| 179 | 0 | } |
| 180 | ||
| 181 | 0 | } |
| 182 | ||
| 183 | ||
| 184 | } |