View Javadoc

1   /* ***** BEGIN LICENSE BLOCK *****
2    * Version: MPL 1.1/GPL 2.0/LGPL 2.1
3    *
4    * The contents of this file are subject to the Mozilla Public License Version
5    * 1.1 (the "License"); you may not use this file except in compliance with
6    * the License. You may obtain a copy of the License at
7    * http://www.mozilla.org/MPL/
8    *
9    * Software distributed under the License is distributed on an "AS IS" basis,
10   * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
11   * for the specific language governing rights and limitations under the
12   * License.
13   *
14   * The Original Code is "SMS Library for the Java platform".
15   *
16   * The Initial Developer of the Original Code is Markus Eriksson.
17   * Portions created by the Initial Developer are Copyright (C) 2002
18   * the Initial Developer. All Rights Reserved.
19   *
20   * Contributor(s):
21   *
22   * Alternatively, the contents of this file may be used under the terms of
23   * either the GNU General Public License Version 2 or later (the "GPL"), or
24   * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
25   * in which case the provisions of the GPL or the LGPL are applicable instead
26   * of those above. If you wish to allow use of your version of this file only
27   * under the terms of either the GPL or the LGPL, and not to allow others to
28   * use your version of this file under the terms of the MPL, indicate your
29   * decision by deleting the provisions above and replace them with the notice
30   * and other provisions required by the GPL or the LGPL. If you do not delete
31   * the provisions above, a recipient may use your version of this file under
32   * the terms of any one of the MPL, the GPL or the LGPL.
33   *
34   * ***** END LICENSE BLOCK ***** */
35  package org.marre.sms.transport.gsm;
36  
37  import java.io.IOException;
38  
39  /***
40   * Interface for communicating with a GSM device.
41   * 
42   * @author Markus
43   * @version $Id: GsmComm.java,v 1.1 2005/11/26 16:38:50 c95men Exp $
44   */
45  public interface GsmComm
46  {
47      /***
48       * Opens a connection to the device.
49       * @throws IOException
50       */
51      void open() throws IOException;
52  
53      /***
54       * Closes the connection to the device.
55       *
56       */
57      void close();
58  
59      /***
60       * Send data to the device.
61       * 
62       * @param data
63       * @throws IOException
64       */
65      void send(String data) throws IOException;
66  
67      /***
68       * Reads one row of data from the device.
69       * 
70       * @return
71       * @throws IOException
72       */
73      String readLine() throws IOException;
74  
75      /***
76       * Reads one row of data from the device or until we have read the find string.
77       * 
78       * @param find
79       * @return
80       * @throws IOException
81       */
82      String readLine(String find) throws IOException;
83  }