01: /*
02: *
03: *
04: * Copyright 1990-2007 Sun Microsystems, Inc. All Rights Reserved.
05: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER
06: *
07: * This program is free software; you can redistribute it and/or
08: * modify it under the terms of the GNU General Public License version
09: * 2 only, as published by the Free Software Foundation.
10: *
11: * This program is distributed in the hope that it will be useful, but
12: * WITHOUT ANY WARRANTY; without even the implied warranty of
13: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14: * General Public License version 2 for more details (a copy is
15: * included at /legal/license.txt).
16: *
17: * You should have received a copy of the GNU General Public License
18: * version 2 along with this work; if not, write to the Free Software
19: * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
20: * 02110-1301 USA
21: *
22: * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
23: * Clara, CA 95054 or visit www.sun.com if you need additional
24: * information or have any questions.
25: */
26:
27: package javax.microedition.io;
28:
29: import java.io.*;
30:
31: /**
32: * This interface defines the capabilities that a stream connection
33: * must have.
34: * <p>
35: * In a typical implementation of this interface (for instance
36: * in MIDP), all <code>StreamConnections</code> have one
37: * underlying <code>InputStream</code> and one <code>OutputStream</code>.
38: * Opening a <code>DataInputStream</code> counts as opening an
39: * <code>InputStream</code> and opening a <code>DataOutputStream</code>
40: * counts as opening an <code>OutputStream</code>. Trying to open
41: * another <code>InputStream</code> or <code>OutputStream</code>
42: * causes an <code>IOException</code>. Trying to open the
43: * <code>InputStream</code> or <code>OutputStream</code> after
44: * they have been closed causes an <code>IOException</code>.
45: * <p>
46: * The methods of <code>StreamConnection</code> are not
47: * synchronized. The only stream method that can be called safely
48: * in another thread is <code>close</code>.
49: *
50: * @version 12/17/01 (CLDC 1.1)
51: * @since CLDC 1.0
52: */
53: public interface StreamConnection extends InputConnection,
54: OutputConnection {
55: }
|