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 classHTMLContext.Response.MimeTypeDeprecated, for removal: This API element is subject to removal in a future version.UseMediaTypeandMediaTypesinstead.
-
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.protectedResponse(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 voidaddHeader(String name, String value)Adds the designated line to the header of this HTTP-response.HTMLContext.Responseclone()Clones this object (usually viaObject.clone()).voidclose()InputStreamgetData()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.InputStreamgetInputStream()Gets the response data asInputStream.StringgetMimeType()Returns the mime type of the response.intgetStatus()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 aRereadableContentfrom the designatedtxt, anUncheckedIOExceptionwill 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 aRereadableContentfrom the designatedtxt, anUncheckedIOExceptionwill 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 aRereadableContentfrom the designatedtxt, anUncheckedIOExceptionwill 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, anUncheckedIOExceptionwill 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, anUncheckedIOExceptionwill 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, anUncheckedIOExceptionwill 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, anUncheckedIOExceptionwill 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 newInputStreamfor the data, anIOExceptionwill 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 newInputStreamfor the data, anIOExceptionwill 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:TypedCloneableClones this object (usually viaObject.clone()).- Specified by:
clonein interfaceTypedCloneable<HTMLContext.Response>- Overrides:
clonein classObject- Returns:
- A clone of the implementing object.
-
close
public void close() throws IOException- Specified by:
closein interfaceAutoCloseable- Specified by:
closein interfaceCloseable- Throws:
IOException
-
-