01: /*
02: * <copyright>
03: *
04: * Copyright 1997-2004 BBNT Solutions, LLC
05: * under sponsorship of the Defense Advanced Research Projects
06: * Agency (DARPA).
07: *
08: * You can redistribute this software and/or modify it under the
09: * terms of the Cougaar Open Source License as published on the
10: * Cougaar Open Source Website (www.cougaar.org).
11: *
12: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
13: * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
14: * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
15: * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
16: * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
17: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
18: * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
19: * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
20: * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
21: * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
22: * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
23: *
24: * </copyright>
25: */
26:
27: package org.cougaar.tools.server.rmi;
28:
29: import java.io.IOException;
30: import java.rmi.Remote;
31: import java.rmi.RemoteException;
32:
33: /**
34: * Remote RMI-wrapper for an InputStream.
35: *
36: * @see java.io.InputStream
37: */
38: interface InputStreamDecl extends Remote {
39:
40: /**
41: * Special "read(byte[])" equivalent for RMI.
42: * <p>
43: * This replaces:<ul>
44: * <li>public int read(byte[] b) throws IOException</li>
45: * <li>public int read(byte[] b, int off, int len) throws IOException</li>
46: * </ul>
47: * The typical "read(byte[] ..)" methods will not work for RMI, since
48: * the result must be serialized back as a separate Object.
49: *
50: * @param len number of bytes to read
51: *
52: * @return a byte[] of data, or null if the end of the stream has been
53: * reached
54: */
55: byte[] read(int len) throws IOException, RemoteException;
56:
57: //
58: // all the other methods of InputStream:
59: //
60:
61: int read() throws IOException, RemoteException;
62:
63: long skip(long n) throws IOException, RemoteException;
64:
65: int available() throws IOException, RemoteException;
66:
67: void close() throws IOException, RemoteException;
68:
69: void mark(int readlimit) throws RemoteException;
70:
71: void reset() throws IOException, RemoteException;
72:
73: boolean markSupported() throws RemoteException;
74: }
|