javax.mail.internet

Interface SharedInputStream

public interface SharedInputStream

An InputStream backed by data that can be shared by multiple readers. The users of such an InputStream can determine the current position in the InputStream, and create new InputStreams representing a subset of the data in the original InputStream. The new InputStream will access the same underlying data as the original, without copying the data in it.
Version:
1.4
Author:
Chris Burdess

Method Summary

long
getPosition()
Returns the current position in the InputStream as an offset from the beginning of the InputStream.
InputStream
newStream(long start, long end)
Returns a new InputStream representing a subset of the data from this InputStream, from start (inclusive) up to end (exclusive).

Method Details

getPosition

public long getPosition()
Returns the current position in the InputStream as an offset from the beginning of the InputStream.

newStream

public InputStream newStream(long start,
                             long end)
Returns a new InputStream representing a subset of the data from this InputStream, from start (inclusive) up to end (exclusive). start must be non-negative. If end is -1, the new stream ends at the same place as this stream. The returned InputStream will also implement the SharedInputStream interface.
Parameters:
start - the start position
end - the end position + 1

© Copyright 2003, 2004 The Free Software Foundation, All rights reserved