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}