Top Description Fields Constructors Methods
jakarta.servlet

public abstract Class ServletOutputStream

extends OutputStream
Class Inheritance
Known Direct Subclasses
jakarta.servlet.http.NoBodyOutputStream
Imports
java.io.CharConversionException, .IOException, .OutputStream, java.text.MessageFormat, java.util.ResourceBundle

Provides an output stream for sending binary data to the client. A ServletOutputStream object is normally retrieved via the ServletResponse#getOutputStream method.

This is an abstract class that the servlet container implements. Subclasses of this class must implement the java.io.OutputStream.write(int) method.

Author
Various
See Also
ServletResponse

Field Summary

Modifier and TypeField and Description
private static final String
private static ResourceBundle

Constructor Summary

AccessConstructor and Description
protected
ServletOutputStream()

Does nothing, because this is an abstract class.

Method Summary

Modifier and TypeMethod and Description
public abstract boolean

Returns:

true if data can be written without blocking, otherwise returns false.
isReady
()

Returns true if data can be written without blocking else returns false.

public void
println()

Writes a carriage return-line feed (CRLF) to the client.

public void
println(String
the String to write to the client
s
)

Writes a String to the client, followed by a carriage return-line feed (CRLF).

public void
println(boolean
the boolean value to write to the client
b
)

Writes a boolean value to the client, followed by a carriage return-line feed (CRLF).

public void
println(char
the character to write to the client
c
)

Writes a character to the client, followed by a carriage return-line feed (CRLF).

public void
println(int
the int to write to the client
i
)

Writes an int to the client, followed by a carriage return-line feed (CRLF) character.

public void
println(long
the long value to write to the client
l
)

Writes a long value to the client, followed by a carriage return-line feed (CRLF).

public void
println(float
the float value to write to the client
f
)

Writes a float value to the client, followed by a carriage return-line feed (CRLF).

public void
println(double
the double value to write to the client
d
)

Writes a double value to the client, followed by a carriage return-line feed (CRLF).

public abstract void
setWriteListener(WriteListener
the WriteListener that should be notified when it's possible to write
writeListener
)

Instructs the ServletOutputStream to invoke the provided WriteListener when it is possible to write

Inherited from java.io.OutputStream:
closeflushnullOutputStreamwritewritewrite

Field Detail

LSTRING_FILEback to summary
private static final String LSTRING_FILE
lStringsback to summary
private static ResourceBundle lStrings

Constructor Detail

ServletOutputStreamback to summary
protected ServletOutputStream()

Does nothing, because this is an abstract class.

Method Detail

isReadyback to summary
public abstract boolean isReady()

Returns true if data can be written without blocking else returns false.

If this method returns false and a WriteListener has been set with setWriteListener(WriteListener), then container will subsequently invoke WriteListener#onWritePossible() once a write operation becomes possible without blocking. Other than the initial call, WriteListener#onWritePossible() will only be called if and only if this method is called and returns false.

Returns:boolean

true if data can be written without blocking, otherwise returns false.

Since
Servlet 3.1
See Also
WriteListener
printlnback to summary
public void println() throws IOException

Writes a carriage return-line feed (CRLF) to the client.

Exceptions
IOException:
if an input or output exception occurred
printlnback to summary
public void println(String s) throws IOException

Writes a String to the client, followed by a carriage return-line feed (CRLF).

Parameters
s:String

the String to write to the client

Exceptions
IOException:
if an input or output exception occurred
printlnback to summary
public void println(boolean b) throws IOException

Writes a boolean value to the client, followed by a carriage return-line feed (CRLF).

Parameters
b:boolean

the boolean value to write to the client

Exceptions
IOException:
if an input or output exception occurred
printlnback to summary
public void println(char c) throws IOException

Writes a character to the client, followed by a carriage return-line feed (CRLF).

Parameters
c:char

the character to write to the client

Exceptions
IOException:
if an input or output exception occurred
printlnback to summary
public void println(int i) throws IOException

Writes an int to the client, followed by a carriage return-line feed (CRLF) character.

Parameters
i:int

the int to write to the client

Exceptions
IOException:
if an input or output exception occurred
printlnback to summary
public void println(long l) throws IOException

Writes a long value to the client, followed by a carriage return-line feed (CRLF).

Parameters
l:long

the long value to write to the client

Exceptions
IOException:
if an input or output exception occurred
printlnback to summary
public void println(float f) throws IOException

Writes a float value to the client, followed by a carriage return-line feed (CRLF).

Parameters
f:float

the float value to write to the client

Exceptions
IOException:
if an input or output exception occurred
printlnback to summary
public void println(double d) throws IOException

Writes a double value to the client, followed by a carriage return-line feed (CRLF).

Parameters
d:double

the double value to write to the client

Exceptions
IOException:
if an input or output exception occurred
setWriteListenerback to summary
public abstract void setWriteListener(WriteListener writeListener)

Instructs the ServletOutputStream to invoke the provided WriteListener when it is possible to write

Parameters
writeListener:WriteListener

the WriteListener that should be notified when it's possible to write

Exceptions
IllegalStateException:
if one of the following conditions is true
  • the associated request is neither upgraded nor the async started
  • setWriteListener is called more than once within the scope of the same request.
NullPointerException:
if writeListener is null
Since
Servlet 3.1