microsoft.exchange.webservices.data.misc

Class HangingTraceStream

java.lang.Object

java.io.InputStream

microsoft.exchange.webservices.data.misc.HangingTraceStream

All Implemented Interfaces:

Closeable, AutoCloseable

public class HangingTraceStream
extends InputStream

A stream that traces everything it returns from its Read() call. That trace may be retrieved at the end of the stream.

Constructor Summary

Constructors

Constructor and Description
HangingTraceStream(InputStream stream, ExchangeService service) Initializes a new instance of the HangingTraceStream class.

Method Summary

Modifier and Type	Method and Description
boolean	getCanRead() Gets a value indicating whether the current stream supports reading.
boolean	getCanSeek() Gets a value indicating whether the current stream supports seeking.
boolean	getCanWrite() Gets a value indicating whether the current stream supports writing.
int	read()
int	read(byte[] buffer, int offset, int count) When overridden in a derived class, reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read.
void	setResponseCopy(ByteArrayOutputStream responseCopy) Sets the response copy.

Methods inherited from class java.io.InputStream

available, close, mark, markSupported, read, reset, skip

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HangingTraceStream

public HangingTraceStream(InputStream stream,
                          ExchangeService service)

Initializes a new instance of the HangingTraceStream class.

Parameters:

stream - The stream.

service - the service.

Method Detail

getCanRead

public boolean getCanRead()

Gets a value indicating whether the current stream supports reading.

Returns:

true

getCanSeek

public boolean getCanSeek()

Gets a value indicating whether the current stream supports seeking.

Returns:

false

getCanWrite

public boolean getCanWrite()

Gets a value indicating whether the current stream supports writing.

Returns:

false

read

public int read(byte[] buffer,
                int offset,
                int count)
         throws IOException

When overridden in a derived class, reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read.

Overrides:

read in class InputStream

Parameters:

buffer - An array of bytes. When this method returns, the buffer contains the specified byte array with the values between

offset - The zero-based byte offset in at which to begin storing the data read from the current stream.

count - The maximum number of bytes to be read from the current stream.

Returns:

The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many bytes are not currently available, or zero (0) if the end of the stream has been reached.

Throws:

IOException - The sum of offset and count is larger than the buffer length.

setResponseCopy

public void setResponseCopy(ByteArrayOutputStream responseCopy)

Sets the response copy.

Parameters:

responseCopy - a copy of response

read

public int read()
         throws IOException

Specified by:

read in class InputStream

Throws:

IOException