View Javadoc
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 "DefaultApplication.java".  Description: 
10  "An Application that does nothing with the message and returns an Application 
11   Reject message in response." 
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.IOException;
31  import java.util.Map;
32  
33  import ca.uhn.hl7v2.AcknowledgmentCode;
34  import ca.uhn.hl7v2.HL7Exception;
35  import ca.uhn.hl7v2.model.Message;
36  import ca.uhn.hl7v2.model.Segment;
37  import ca.uhn.hl7v2.protocol.ReceivingApplication;
38  import ca.uhn.hl7v2.protocol.ReceivingApplicationException;
39  import ca.uhn.hl7v2.util.DeepCopy;
40  
41  /**
42   * An Application that does nothing with the message and returns an Application
43   * Reject message in response. To be used when there are no other Applications
44   * that can process a given message.
45   * 
46   * @author Bryan Tripp
47   * @author Christian Ohr
48   */
49  public class DefaultApplication implements ReceivingApplication<Message> {
50  
51  	public static final String MSG_INTERNAL_ERROR = "Application internal error";
52  	public static final String MSG_NO_APPROPRIATE_DEST = "No appropriate destination could be found to which this message could be routed.";
53  	
54  	private final AcknowledgmentCode myAcknowledgmentCode;
55  	private final String myMessage;
56  	
57  	/**
58  	 * New instance which always returns an acknowledgment code of {@link AcknowledgmentCode#AR} and
59  	 * a message indicating that no appropriate handler could be found.
60  	 * 
61  	 * @see #MSG_NO_APPROPRIATE_DEST
62  	 */
63  	public DefaultApplication() {
64  		this(AcknowledgmentCode.AR);
65  	}
66  
67  	/**
68  	 * <p>
69  	 * New instance which always uses the given acknowledgment code, and generates an
70  	 * appropriate message for the given code, according to the following rules:
71  	 * </p>
72  	 * <table>
73  	 * <tr><th>Code</th><th>Message</th></tr>
74  	 * <tr>
75  	 * 		<td>{@link AcknowledgmentCode#AA}<br/>{@link AcknowledgmentCode#AA}</td>
76  	 * 		<td><code>null</code> (no message)</td>
77  	 * </tr>
78  	 * <tr>
79  	 * 		<td>{@link AcknowledgmentCode#AR}<br/>{@link AcknowledgmentCode#AR}</td>
80  	 * 		<td>{@link #MSG_NO_APPROPRIATE_DEST}</td>
81  	 * </tr>
82  	 * <tr>
83  	 * 		<td>{@link AcknowledgmentCode#AE}<br/>{@link AcknowledgmentCode#AE}</td>
84  	 * 		<td>{@link #MSG_INTERNAL_ERROR}</td>
85  	 * </tr>
86  	 * </table>
87  	 * 
88  	 * @param theAcknowledgmentCode The code to always use (must not be null)
89  	 */
90  	public DefaultApplication(AcknowledgmentCode theAcknowledgmentCode) {
91  		this(theAcknowledgmentCode, defaultMessage(theAcknowledgmentCode));
92  	}
93  
94  	/**
95  	 * New instance which always uses the given acknowledgment code and message
96  	 *  
97  	 * @param theAcknowledgmentCode The code to always use (must not be null)
98  	 * @param theMessage The message (may be null, in which case no message will be given)
99  	 */
100 	public DefaultApplication(AcknowledgmentCode theAcknowledgmentCode, String theMessage) {
101 		if (theAcknowledgmentCode == null) {
102 			throw new NullPointerException("Acknowledgment code must not be null");
103 		}
104 		myAcknowledgmentCode = theAcknowledgmentCode;
105 		myMessage = theMessage;
106 	}
107 
108 	private static String defaultMessage(AcknowledgmentCode theAr) {
109 		switch (theAr) {
110 		case AA:
111 		case CA:
112 			return null;
113 		case AR:
114 		case CR:
115 			return MSG_NO_APPROPRIATE_DEST;
116 		case AE:
117 		case CE:
118 		default:
119 			return MSG_INTERNAL_ERROR;
120 		}
121 	}
122 
123 	/**
124 	 * Returns true.
125 	 */
126 	public boolean canProcess(Message in) {
127 		return true;
128 	}
129 
130 	/**
131 	 * Creates an ACK message with the minimum required information from an
132 	 * inbound message. Optional fields can be filled in afterwards, before the
133 	 * message is returned. Please note that MSH-10, the outbound message
134 	 * control ID, is also set using the class
135 	 * <code>ca.uhn.hl7v2.util.MessageIDGenerator</code>. Also note that the ACK
136 	 * messages returned is the same version as the version stated in the
137 	 * inbound MSH if there is a generic ACK for that version, otherwise a
138 	 * version 2.4 ACK is returned. MSA-1 is set to AA by default.
139 	 * 
140 	 * @param message message
141 	 *            the MSH segment if the inbound message
142 	 * 
143 	 * @deprecated use {@link Message#generateACK()}
144 	 */
145 	public static Message"../../../../ca/uhn/hl7v2/model/Message.html#Message">Message makeACK(Message message) throws HL7Exception, IOException {
146 		return message.generateACK();
147 	}
148 	
149 	/**
150 	 * @deprecated use {@link Message#generateACK()}
151 	 */
152 	public static Message makeACK(Segment inboundHeader) throws HL7Exception,
153 			IOException {
154 		// Make sure that the referenced message is not just a dummy
155 		DeepCopy.copy(inboundHeader, (Segment)inboundHeader.getMessage().get("MSH"));
156 		return inboundHeader.getMessage().generateACK();
157 	}
158 
159 	public Message../../ca/uhn/hl7v2/model/Message.html#Message">Message processMessage(Message theMessage, Map<String, Object> theMetadata) throws ReceivingApplicationException {
160 		try {
161 			if (myMessage != null) {
162 				return theMessage.generateACK(myAcknowledgmentCode, new HL7Exception(myMessage));
163 			} else {
164 				return theMessage.generateACK(myAcknowledgmentCode, null);
165 			}
166 		} catch (Exception e) {
167 			throw new ReceivingApplicationException("Couldn't create response message: "
168 					+ e.getMessage());
169 		}
170 	}
171 
172 }