Top Description Fields Constructors Methods
jakarta.servlet

public abstract Class ServletOutputStream

extends OutputStream
Class Inheritance
Known Direct Subclasses
jakarta.servlet.http.HttpServlet.NoBodyOutputStream, org.apache.catalina.filters.ExpiresFilter.XServletOutputStream, org.apache.catalina.connector.CoyoteOutputStream, org.apache.coyote.http11.upgrade.UpgradeServletOutputStream
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.

See Also
ServletResponse

Field Summary

Modifier and TypeField and Description
private static final String
private static final 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, else false
isReady
()

Checks if a non-blocking write will succeed.

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 non-blocking IO write listener
listener
)

Sets the WriteListener for this ServletOutputStream and thereby switches to non-blocking IO.

Inherited from java.io.OutputStream:
closeflushnullOutputStreamwritewritewrite

Field Detail

LSTRING_FILEback to summary
private static final String LSTRING_FILE
lStringsback to summary
private static final 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()

Checks if a non-blocking write will succeed. If this returns false, it will cause a callback to WriteListener#onWritePossible() when the buffer has emptied. If this method returns false no further data must be written until the container calls WriteListener#onWritePossible().

Returns:boolean

true if data can be written, else false

Since
Servlet 3.1
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 listener)

Sets the WriteListener for this ServletOutputStream and thereby switches to non-blocking IO. It is only valid to switch to non-blocking IO within async processing or HTTP upgrade processing.

Parameters
listener:WriteListener

The non-blocking IO write listener

Exceptions
IllegalStateException:
If this method is called if neither async nor HTTP upgrade is in progress or if the WriteListener has already been set
NullPointerException:
If listener is null
Since
Servlet 3.1