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 "HL7Reader.java".  Description: 
010    "An HL7Reader implements reading from an input stream using a particular lower 
011      layer protocol" 
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    
033    /**
034     * An HL7Reader implements reading from an input stream using a particular lower 
035     * layer protocol.  
036     * @author Bryan Tripp
037     */
038    public interface HL7Reader {
039    
040        /** 
041         * Reads a complete HL7 message from the underlying input stream 
042         */
043        public String getMessage() throws LLPException, IOException;
044        
045        /**
046         * Sets the InputStream from which to read messages.  The InputStream must be set 
047         * before any calls to <code>getMessage()</code>.
048         */
049        public void setInputStream(InputStream in) throws IOException;
050        
051        /** 
052         * Closes the underlying stream and any other resources that should be closed. 
053         */
054        public void close() throws java.io.IOException;
055        
056    }