Package de.aristaflow.adept2.ui.htmlgui
Class HTMLContext.Response
- java.lang.Object
-
- de.aristaflow.adept2.ui.htmlgui.HTMLContext.Response
-
- All Implemented Interfaces:
TypedCloneable<HTMLContext.Response>
,Closeable
,AutoCloseable
,Cloneable
- Enclosing interface:
- HTMLContext
public static class HTMLContext.Response extends Object implements Closeable, TypedCloneable<HTMLContext.Response>
A HTTP-response to be sent to the HTTP-client.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
HTMLContext.Response.MimeType
Deprecated, for removal: This API element is subject to removal in a future version.UseMediaType
andMediaTypes
instead.
-
Constructor Summary
Constructors Modifier Constructor Description Response(int status, InputStream data)
Creates a response with the designated status and the designated data.Response(int status, InputStream data, String fileName)
Creates a response with the designated status and the designated data.Response(int status, String txt)
Creates a response with the designated status and the designated UTF-8-encoded plain text.Response(int status, String origMimeType, InputStream data)
Creates a new HTTP-response with the designated status, MIME-type and data.Response(int status, String mimeType, String txt)
Deprecated, for removal: This API element is subject to removal in a future version.UseResponse(int, String)
instead.protected
Response(int status, String mimeType, Map<String,String> header)
Creates a new response with the designated properties and no data.Response(int status, org.apache.tika.mime.MediaType mediaType, InputStream data)
Creates a response with the designated status and the designated data using the designated media type.Response(int status, org.apache.tika.mime.MediaType mediaType, String txt)
Creates a response with the designated status and the designated text using the designated media type.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description void
addHeader(String name, String value)
Adds the designated line to the header of this HTTP-response.HTMLContext.Response
clone()
Clones this object (usually viaObject.clone()
).void
close()
InputStream
getData()
Deprecated, for removal: This API element is subject to removal in a future version.UsegetInputStream()
instead.Map<String,String>
getHeader()
Returns the additional response headers.InputStream
getInputStream()
Gets the response data asInputStream
.String
getMimeType()
Returns the mime type of the response.int
getStatus()
Return the HTTP status code of the response.
-
-
-
Field Detail
-
status
protected final int status
HTTP status code after processing, e. g. ""200 OK", HTTP_OK
-
mimeType
protected final String mimeType
MIME type of content, e. g. "text/html".
-
-
Constructor Detail
-
Response
public Response(int status, String txt)
Creates a response with the designated status and the designated UTF-8-encoded plain text.- Parameters:
status
- The HTTP-status of the response to create.txt
- The string which to send as UTF-8-encoded plain text.- Throws:
UncheckedIOException
- If there are problems creating aRereadableContent
from the designatedtxt
, anUncheckedIOException
will be thrown.
-
Response
@Deprecated(since="14.0.0", forRemoval=true) public Response(int status, String mimeType, String txt)
Deprecated, for removal: This API element is subject to removal in a future version.UseResponse(int, String)
instead.Creates a response with the designated status and the designated text using the designated MIME type.- Parameters:
status
- The HTTP-status of the response to create.mimeType
- The MIME-type of the HTTP-response to create.txt
- The string which to send as UTF-8-encoded plain text.- Throws:
UncheckedIOException
- If there are problems creating aRereadableContent
from the designatedtxt
, anUncheckedIOException
will be thrown.
-
Response
public Response(int status, org.apache.tika.mime.MediaType mediaType, String txt)
Creates a response with the designated status and the designated text using the designated media type.- Parameters:
status
- The HTTP-status of the response to create.mediaType
- The media type of the HTTP-response to create. This may benull
.txt
- The string which to send as UTF-8-encoded plain text.- Throws:
UncheckedIOException
- If there are problems creating aRereadableContent
from the designatedtxt
, anUncheckedIOException
will be thrown.
-
Response
public Response(int status, InputStream data)
Creates a response with the designated status and the designated data. The MIME type is determined from the data.- Parameters:
status
- The HTTP-status of the response to create.data
- The contents of the HTTP-response to create. The stream will be closed after the creation.- Throws:
UncheckedIOException
- If there are problems reading from the designated stream or creating the correspondingRereadableContent
, anUncheckedIOException
will be thrown.
-
Response
public Response(int status, InputStream data, String fileName)
Creates a response with the designated status and the designated data. The MIME type is determined from the data and/or the designated file name.- Parameters:
status
- The HTTP-status of the response to create.data
- The contents of the HTTP-response to create. The stream will be closed after the creation.fileName
- The name of the file the designated data represents. This is used to determine the MIME type. It may benull
.- Throws:
UncheckedIOException
- If there are problems reading from the designated stream or creating the correspondingRereadableContent
, anUncheckedIOException
will be thrown.
-
Response
public Response(int status, String origMimeType, InputStream data)
Creates a new HTTP-response with the designated status, MIME-type and data.- Parameters:
status
- The HTTP-status of the response to create.origMimeType
- The MIME-type of the HTTP-response to create. If this isnull
, the MIME type will be determined from the designated data.data
- The contents of the HTTP-response to create. The stream will be closed after the creation.- Throws:
UncheckedIOException
- If there are problems reading from the designated stream or creating the correspondingRereadableContent
, anUncheckedIOException
will be thrown.
-
Response
public Response(int status, org.apache.tika.mime.MediaType mediaType, InputStream data)
Creates a response with the designated status and the designated data using the designated media type. The caller has to make sure that this corresponds to the data.- Parameters:
status
- The HTTP-status of the response to create.mediaType
- The media type of the designated data. If this isnull
, the media type will be determined from the designated data.data
- The contents of the HTTP-response to create. The stream will be closed after the creation.- Throws:
UncheckedIOException
- If there are problems reading from the designated stream or creating the correspondingRereadableContent
, anUncheckedIOException
will be thrown.
-
Response
protected Response(int status, String mimeType, Map<String,String> header)
Creates a new response with the designated properties and no data. This allows for implementing wrappers in subclasses.- Parameters:
status
- HTTP status code after processing, e. g. "200 OK", HTTP_OK.mimeType
- MIME type of content, e. g. "text/html".header
- Headers for the HTTP response. Use addHeader() to add lines.
-
-
Method Detail
-
addHeader
public void addHeader(String name, String value)
Adds the designated line to the header of this HTTP-response.- Parameters:
name
- The name of the header-field to add to this HTTP-response.value
- The value of the header-field to add to this HTTP-response.
-
getStatus
public int getStatus()
Return the HTTP status code of the response.- Returns:
- The HTTP status code of the response.
-
getMimeType
public String getMimeType()
Returns the mime type of the response.- Returns:
- The mime type of the response.
-
getData
@Deprecated(since="15.0.0", forRemoval=true) public InputStream getData()
Deprecated, for removal: This API element is subject to removal in a future version.UsegetInputStream()
instead.Returns the response data.- Returns:
- The response data. The caller is responsible for closing.
- Throws:
UncheckedIOException
- If there are problems creating a newInputStream
for the data, anIOException
will be thrown.
-
getInputStream
public InputStream getInputStream() throws IOException
Gets the response data asInputStream
.- Returns:
- The response data as
InputStream
. The caller is responsible for closing. - Throws:
IOException
- If there are problems creating a newInputStream
for the data, anIOException
will be thrown.
-
getHeader
public Map<String,String> getHeader()
Returns the additional response headers.- Returns:
- Additional response headers.
-
clone
public HTMLContext.Response clone()
Description copied from interface:TypedCloneable
Clones this object (usually viaObject.clone()
).- Specified by:
clone
in interfaceTypedCloneable<HTMLContext.Response>
- Overrides:
clone
in classObject
- Returns:
- A clone of the implementing object.
-
close
public void close() throws IOException
- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceCloseable
- Throws:
IOException
-
-