001    /**
002    The 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. 
004    You may obtain a copy of the License at http://www.mozilla.org/MPL/ 
005    Software distributed under the License is distributed on an "AS IS" basis, 
006    WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the 
007    specific language governing rights and limitations under the License. 
008    
009    The Original Code is "MinLowerLayerProtocol.java".  Description: 
010    "Implements the "Minimal Lower Layer Protocol" from the HL7 Implementation 
011      Guide, Appendix C" 
012    
013    The Initial Developer of the Original Code is University Health Network. Copyright (C) 
014    2001.  All Rights Reserved. 
015    
016    Contributor(s): ______________________________________. 
017    
018    Alternatively, the contents of this file may be used under the terms of the 
019    GNU General Public License (the "GPL"), in which case the provisions of the GPL are 
020    applicable instead of those above.  If you wish to allow use of your version of this 
021    file only under the terms of the GPL and not to allow others to use your version 
022    of this file under the MPL, indicate your decision by deleting  the provisions above 
023    and replace  them with the notice and other provisions required by the GPL License.  
024    If you do not delete the provisions above, a recipient may use your version of 
025    this file under either the MPL or the GPL. 
026    
027    */
028    
029    package ca.uhn.hl7v2.llp;
030    
031    import java.io.*;
032    import java.nio.charset.Charset;
033    
034    /**
035     * Implements the "Minimal Lower Layer Protocol" from the HL7 Implementation 
036     * Guide, Appendix C.  In other words, provides a reader and a writer that can be 
037     * used to communicate with a server that uses the minimal LLP.
038     * 
039     * @see MinLLPReader
040     * @see MinLLPWriter 
041     * @author Bryan Tripp
042     */
043    public class MinLowerLayerProtocol extends LowerLayerProtocol {
044    
045            private Charset charset;
046    
047        /** 
048         * Creates new MinLowerLayerProtocol 
049         */
050        public MinLowerLayerProtocol() {
051        }
052        
053        /**
054         * Creates an HL7Reader that implements message reading according to 
055         * this protocol.  
056         */
057        public HL7Reader getReader(InputStream in) throws LLPException {
058            try {
059                    if (charset != null) {
060                            return new MinLLPReader(in, charset);
061                    } else {
062                            return new MinLLPReader(in);
063                    }
064            } catch (IOException e) {
065                throw new LLPException("Can't create MinLLPReader with the given input stream: " + e.getMessage(), e);
066            }
067        }
068        
069        /**
070         * Creates an HL7Writer that implements message writing according to 
071         * this protocol.  
072         */
073        public HL7Writer getWriter(OutputStream out) throws LLPException {
074            try {
075                    if (charset != null) {
076                            return new MinLLPWriter(out, charset);
077                    } else {
078                            return new MinLLPWriter(out);
079                    }
080            } catch (IOException e) {
081                throw new LLPException("Can't create MinLLPWriter with the given output stream: " + e.getMessage(), e);
082            }
083        }
084        
085        /**
086         * Provides a charset to use for character encoding
087         * @param theCharset The charset to use
088         * @since 1.3
089         */
090            public void setCharset(Charset theCharset) {
091                    charset = theCharset;
092            }
093    
094    }