001/** 002The contents of this file are subject to the Mozilla Public License Version 1.1 003(the "License"); you may not use this file except in compliance with the License. 004You may obtain a copy of the License at http://www.mozilla.org/MPL/ 005Software distributed under the License is distributed on an "AS IS" basis, 006WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the 007specific language governing rights and limitations under the License. 008 009The Original Code is "HapiContextSupport.java". Description: 010"Abstract base class for subclasses supporting the access to a HapiContext." 011 012The Initial Developer of the Original Code is University Health Network. Copyright (C) 0132001. All Rights Reserved. 014 015Contributor(s): ______________________________________. 016 017Alternatively, the contents of this file may be used under the terms of the 018GNU General Public License (the "GPL"), in which case the provisions of the GPL are 019applicable instead of those above. If you wish to allow use of your version of this 020file only under the terms of the GPL and not to allow others to use your version 021of this file under the MPL, indicate your decision by deleting the provisions above 022and replace them with the notice and other provisions required by the GPL License. 023If you do not delete the provisions above, a recipient may use your version of 024this file under either the MPL or the GPL. 025 */ 026package ca.uhn.hl7v2; 027 028import java.io.IOException; 029import java.util.concurrent.ExecutorService; 030 031import ca.uhn.hl7v2.app.Connection; 032import ca.uhn.hl7v2.app.ConnectionHub; 033import ca.uhn.hl7v2.app.HL7Service; 034import ca.uhn.hl7v2.app.ServerConfiguration; 035import ca.uhn.hl7v2.conf.store.CodeStoreRegistry; 036import ca.uhn.hl7v2.conf.store.ProfileStore; 037import ca.uhn.hl7v2.llp.LowerLayerProtocol; 038import ca.uhn.hl7v2.model.Message; 039import ca.uhn.hl7v2.parser.*; 040import ca.uhn.hl7v2.util.SocketFactory; 041import ca.uhn.hl7v2.validation.ValidationContext; 042import ca.uhn.hl7v2.validation.ValidationExceptionHandlerFactory; 043import ca.uhn.hl7v2.validation.Validator; 044import ca.uhn.hl7v2.validation.builder.ValidationRuleBuilder; 045 046/** 047 * Abstract base class for subclasses supporting the access to a HapiContext. 048 * 049 * @author Christian Ohr 050 */ 051public abstract class HapiContextSupport { 052 053 private HapiContext context; 054 055 public HapiContextSupport(HapiContext context) { 056 super(); 057 this.context = context; 058 } 059 060 /** 061 * Returns a unmodifiable instance of HapiContext 062 */ 063 public final HapiContext getHapiContext() { 064 return unmodifiableContext(context); 065 } 066 067 /** 068 * Only for internal purposes: associate a new {@link HapiContext} with an existing 069 * service object. 070 * 071 * @param context new {@link HapiContext} 072 */ 073 protected void setHapiContext(HapiContext context) { 074 this.context = context; 075 } 076 077 /** 078 * Supports the intention that HapiContext instances should not be altered e.g. from within a 079 * Parser instance, but only explicitly from where the HapiContext instance is actually owned. 080 * 081 * @param context context to be made unmodifiable 082 * @return an unmodifiable HapiContext 083 */ 084 private static HapiContext unmodifiableContext(HapiContext context) { 085 return new UnmodifiableHapiContext(context); 086 } 087 088 private static class UnmodifiableHapiContext implements HapiContext { 089 090 private HapiContext context; 091 092 public UnmodifiableHapiContext(HapiContext context) { 093 this.context = context; 094 } 095 096 public CodeStoreRegistry getCodeStoreRegistry() { 097 return context.getCodeStoreRegistry(); 098 } 099 100 public ca.uhn.hl7v2.conf.check.Validator getConformanceValidator() { 101 return context.getConformanceValidator(); 102 } 103 104 /** 105 * @deprecated 106 */ 107 public ConnectionHub getConnectionHub() { 108 return context.getConnectionHub(); 109 } 110 111 public ExecutorService getExecutorService() { 112 return context.getExecutorService(); 113 } 114 115 public GenericParser getGenericParser() { 116 return context.getGenericParser(); 117 } 118 119 public LowerLayerProtocol getLowerLayerProtocol() { 120 return context.getLowerLayerProtocol(); 121 } 122 123 public <R> Validator<R> getMessageValidator() { 124 return context.getMessageValidator(); 125 } 126 127 public ModelClassFactory getModelClassFactory() { 128 return context.getModelClassFactory(); 129 } 130 131 public ParserConfiguration getParserConfiguration() { 132 return context.getParserConfiguration(); 133 } 134 135 public PipeParser getPipeParser() { 136 return context.getPipeParser(); 137 } 138 139 public ProfileStore getProfileStore() { 140 return context.getProfileStore(); 141 } 142 143 public SocketFactory getSocketFactory() { 144 return context.getSocketFactory(); 145 } 146 147 public ValidationContext getValidationContext() { 148 return context.getValidationContext(); 149 } 150 151 public <R> ValidationExceptionHandlerFactory<R> getValidationExceptionHandlerFactory() { 152 return context.getValidationExceptionHandlerFactory(); 153 } 154 155 public ValidationRuleBuilder getValidationRuleBuilder() { 156 return context.getValidationRuleBuilder(); 157 } 158 159 public XMLParser getXMLParser() { 160 return context.getXMLParser(); 161 } 162 163 public Connection newClient(String host, int port, boolean tls) throws HL7Exception { 164 return context.newClient(host, port, tls); 165 } 166 167 public Connection newClient(String host, int outboundPort, int inboundPort, boolean tls) throws HL7Exception { 168 return context.newClient(host, outboundPort, inboundPort, tls); 169 } 170 171 public Connection newLazyClient(String host, int port, boolean tls) throws HL7Exception { 172 return context.newLazyClient(host, port, tls); 173 } 174 175 public Connection newLazyClient(String host, int outboundPort, int inboundPort, boolean tls) throws HL7Exception { 176 return context.newLazyClient(host, outboundPort, inboundPort, tls); 177 } 178 179 public HL7Service newServer(int port, boolean tls) { 180 return context.newServer(port, tls); 181 } 182 183 public HL7Service newServer(int inboundPort, int outboundPort, boolean tls) { 184 return context.newServer(inboundPort, outboundPort, tls); 185 } 186 187 public Message newMessage(String eventType, String triggerEvent, Version version) throws HL7Exception { 188 return context.newMessage(eventType, triggerEvent, version); 189 } 190 191 public <T extends Message> T newMessage(Class<T> clazz) throws HL7Exception { 192 return context.newMessage(clazz); 193 } 194 195 public void setCodeStoreRegistry(CodeStoreRegistry store) { 196 throw new UnsupportedOperationException("Read-only instance"); 197 } 198 199 public void setExecutorService(ExecutorService executorService) { 200 throw new UnsupportedOperationException("Read-only instance"); 201 } 202 203 public void setLowerLayerProtocol(LowerLayerProtocol llp) { 204 throw new UnsupportedOperationException("Read-only instance"); 205 } 206 207 public void setModelClassFactory(ModelClassFactory modelClassFactory) { 208 throw new UnsupportedOperationException("Read-only instance"); 209 } 210 211 public void setParserConfiguration(ParserConfiguration configuration) { 212 throw new UnsupportedOperationException("Read-only instance"); 213 } 214 215 public void setProfileStore(ProfileStore store) { 216 throw new UnsupportedOperationException("Read-only instance"); 217 } 218 219 public void setSocketFactory(SocketFactory socketFactory) { 220 throw new UnsupportedOperationException("Read-only instance"); 221 } 222 223 public void setValidationContext(String contextClassName) { 224 throw new UnsupportedOperationException("Read-only instance"); 225 } 226 227 public void setValidationContext(ValidationContext context) { 228 throw new UnsupportedOperationException("Read-only instance"); 229 } 230 231 public <R> void setValidationExceptionHandlerFactory( 232 ValidationExceptionHandlerFactory<R> factory) { 233 context.setValidationExceptionHandlerFactory(factory); 234 } 235 236 public void setValidationRuleBuilder(String builderClassName) { 237 throw new UnsupportedOperationException("Read-only instance"); 238 } 239 240 public void setValidationRuleBuilder(ValidationRuleBuilder ruleBuilder) { 241 throw new UnsupportedOperationException("Read-only instance"); 242 } 243 244 public ServerConfiguration getServerConfiguration() { 245 return context.getServerConfiguration(); 246 } 247 248 public void setServerConfiguration(ServerConfiguration theServerConfiguration) { 249 throw new UnsupportedOperationException("Read-only instance"); 250 } 251 252 public void close() throws IOException { 253 context.close(); 254 } 255 } 256 257}