public abstract class ServletOutputStream
extends java.io.OutputStream
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.
ServletResponse
Modifier | Constructor and Description |
---|---|
protected |
ServletOutputStream()
Does nothing, because this is an abstract class.
|
Modifier and Type | Method and Description |
---|---|
abstract boolean |
isReady()
This method can be used to determine if data can be written without blocking.
|
void |
print(boolean b)
Writes a
boolean value to the client, with no carriage return-line feed (CRLF) character at the end. |
void |
print(char c)
Writes a character to the client, with no carriage return-line feed (CRLF) at the end.
|
void |
print(double d)
Writes a
double value to the client, with no carriage return-line feed (CRLF) at the end. |
void |
print(float f)
Writes a
float value to the client, with no carriage return-line feed (CRLF) at the end. |
void |
print(int i)
Writes an int to the client, with no carriage return-line feed (CRLF) at the end.
|
void |
print(long l)
Writes a
long value to the client, with no carriage return-line feed (CRLF) at the end. |
void |
print(java.lang.String s)
Writes a
String to the client, without a carriage return-line feed (CRLF) character at the end. |
void |
println()
Writes a carriage return-line feed (CRLF) to the client.
|
void |
println(boolean b)
Writes a
boolean value to the client, followed by a carriage return-line feed (CRLF). |
void |
println(char c)
Writes a character to the client, followed by a carriage return-line feed (CRLF).
|
void |
println(double d)
Writes a
double value to the client, followed by a carriage return-line feed (CRLF). |
void |
println(float f)
Writes a
float value to the client, followed by a carriage return-line feed (CRLF). |
void |
println(int i)
Writes an int to the client, followed by a carriage return-line feed (CRLF) character.
|
void |
println(long l)
Writes a
long value to the client, followed by a carriage return-line feed (CRLF). |
void |
println(java.lang.String s)
Writes a
String to the client, followed by a carriage return-line feed (CRLF). |
abstract void |
setWriteListener(WriteListener writeListener)
Instructs the
ServletOutputStream to invoke the provided WriteListener when it is possible to
write |
protected ServletOutputStream()
public void print(java.lang.String s) throws java.io.IOException
String
to the client, without a carriage return-line feed (CRLF) character at the end.s
- the String
to send to the clientjava.io.IOException
- if an input or output exception occurredpublic void print(boolean b) throws java.io.IOException
boolean
value to the client, with no carriage return-line feed (CRLF) character at the end.b
- the boolean
value to send to the clientjava.io.IOException
- if an input or output exception occurredpublic void print(char c) throws java.io.IOException
c
- the character to send to the clientjava.io.IOException
- if an input or output exception occurredpublic void print(int i) throws java.io.IOException
i
- the int to send to the clientjava.io.IOException
- if an input or output exception occurredpublic void print(long l) throws java.io.IOException
long
value to the client, with no carriage return-line feed (CRLF) at the end.l
- the long
value to send to the clientjava.io.IOException
- if an input or output exception occurredpublic void print(float f) throws java.io.IOException
float
value to the client, with no carriage return-line feed (CRLF) at the end.f
- the float
value to send to the clientjava.io.IOException
- if an input or output exception occurredpublic void print(double d) throws java.io.IOException
double
value to the client, with no carriage return-line feed (CRLF) at the end.d
- the double
value to send to the clientjava.io.IOException
- if an input or output exception occurredpublic void println() throws java.io.IOException
java.io.IOException
- if an input or output exception occurredpublic void println(java.lang.String s) throws java.io.IOException
String
to the client, followed by a carriage return-line feed (CRLF).s
- the String
to write to the clientjava.io.IOException
- if an input or output exception occurredpublic void println(boolean b) throws java.io.IOException
boolean
value to the client, followed by a carriage return-line feed (CRLF).b
- the boolean
value to write to the clientjava.io.IOException
- if an input or output exception occurredpublic void println(char c) throws java.io.IOException
c
- the character to write to the clientjava.io.IOException
- if an input or output exception occurredpublic void println(int i) throws java.io.IOException
i
- the int to write to the clientjava.io.IOException
- if an input or output exception occurredpublic void println(long l) throws java.io.IOException
long
value to the client, followed by a carriage return-line feed (CRLF).l
- the long
value to write to the clientjava.io.IOException
- if an input or output exception occurredpublic void println(float f) throws java.io.IOException
float
value to the client, followed by a carriage return-line feed (CRLF).f
- the float
value to write to the clientjava.io.IOException
- if an input or output exception occurredpublic void println(double d) throws java.io.IOException
double
value to the client, followed by a carriage return-line feed (CRLF).d
- the double
value to write to the clientjava.io.IOException
- if an input or output exception occurredpublic abstract boolean isReady()
true
if a write to this ServletOutputStream
will succeed, otherwise returns
false
.public abstract void setWriteListener(WriteListener writeListener)
ServletOutputStream
to invoke the provided WriteListener
when it is possible to
writewriteListener
- the WriteListener
that should be notified when it's possible to writejava.lang.IllegalStateException
- if one of the following conditions is true
java.lang.NullPointerException
- if writeListener is null