http/response

Documentation

• source: http/response.ts

Overview

Classes

Response

isValid()

Checks if the response façade is currently valid or connected to an active request context.

static isValid(): boolean;

Returns

• Type: boolean
• Description: True if valid, false otherwise.

json()

Serializes a JavaScript object to JSON, sets the `Content-Type: application/json` header, and writes the JSON string to the response output stream.

static json(obj: any): void;

Parameter	Type	Description
obj	any	The JavaScript object to be serialized and sent.

Returns

• Type: void
• Description:

print()

Writes a string of text to the response body using UTF-8 encoding. Note: This method automatically handles flushing the output stream.

static print(text: string): void;

Parameter	Type	Description
text	string	The string content to write.

Returns

• Type: void
• Description:

println()

Writes a string of text followed by a newline character (`\n`) to the response body using UTF-8 encoding.

static println(text: string): void;

Parameter	Type	Description
text	string	The string content to write.

Returns

• Type: void
• Description:

write()

Writes an array of bytes directly to the response output stream, typically used for binary data.

static write(bytes: any): void;

Parameter	Type	Description
bytes	any	The array of bytes to write.

Returns

• Type: void
• Description:

isCommitted()

Checks if the response headers and status have already been sent to the client.

static isCommitted(): boolean;

Returns

• Type: boolean
• Description: True if the response is committed, false otherwise.

setContentType()

Sets the value of the `Content-Type` header.

static setContentType(contentType: string): void;

Parameter	Type	Description
contentType	string	The MIME type string (e.g., 'text/html', 'application/pdf').

Returns

• Type: void
• Description:

flush()

Forces any buffered output to be written to the client.

static flush(): void;

Returns

• Type: void
• Description:

close()

Closes the response output stream.

static close(): void;

Returns

• Type: void
• Description:

addCookie()

Adds a cookie to the response. The cookie object is serialized to JSON before being passed to the underlying Java facade.

static addCookie(cookie: Cookie): void;

Parameter	Type	Description
cookie	Cookie	The cookie definition object.

Returns

• Type: void
• Description:

containsHeader()

Checks if a response header with the specified name has already been set.

static containsHeader(name: string): boolean;

Parameter	Type	Description
name	string	The name of the header.

Returns

• Type: boolean
• Description: True if the header exists, false otherwise.

encodeURL()

Encodes a URL for use in redirects or forms, including session information if necessary.

static encodeURL(url: string): string;

Parameter	Type	Description
url	string	The URL to encode.

Returns

• Type: string
• Description: The encoded URL string.

getCharacterEncoding()

Gets the character encoding used for the response body.

static getCharacterEncoding(): string;

Returns

• Type: string
• Description: The character encoding string.

encodeRedirectURL()

Encodes a URL for use in the `Location` header of a redirect response.

static encodeRedirectURL(url: string): string;

Parameter	Type	Description
url	string	The redirect URL to encode.

Returns

• Type: string
• Description: The encoded redirect URL string.

getContentType()

Gets the current `Content-Type` header value.

static getContentType(): string;

Returns

• Type: string
• Description: The content type string.

sendError()

Sends an HTTP error response to the client with the specified status code and optional message. This bypasses the normal response body writing process.

static sendError(status: number, message: string): void;

Parameter	Type	Description
status	number	The HTTP status code (e.g., 404, 500).
message	string	An optional message to include in the error response.

Returns

• Type: void
• Description:

setCharacterEncoding()

Sets the character encoding to be used for the response body (e.g., 'UTF-8').

static setCharacterEncoding(charset: string): void;

Parameter	Type	Description
charset	string	The character set string.

Returns

• Type: void
• Description:

sendRedirect()

Sends a redirect response (status code 302 by default) to the client.

static sendRedirect(location: string): void;

Parameter	Type	Description
location	string	The new URL to redirect the client to.

Returns

• Type: void
• Description:

setContentLength()

Sets the `Content-Length` header for the response.

static setContentLength(length: number): void;

Parameter	Type	Description
length	number	The size of the response body in bytes.

Returns

• Type: void
• Description:

setHeader()

Sets a response header with the given name and value. If the header already exists, its value is overwritten.

static setHeader(name: string, value: string): void;

Parameter	Type	Description
name	string	The name of the header.
value	string	The value of the header.

Returns

• Type: void
• Description:

addHeader()

Adds a response header with the given name and value. If the header already exists, a second header with the same name is added.

static addHeader(name: string, value: string): void;

Parameter	Type	Description
name	string	The name of the header.
value	string	The value of the header.

Returns

• Type: void
• Description:

setStatus()

Sets the HTTP status code for the response.

static setStatus(status: number): void;

Parameter	Type	Description
status	number	The integer status code (e.g., 200, 404).

Returns

• Type: void
• Description:

reset()

Clears all buffers, status code, and headers from the response, allowing a new response to be generated. This is only possible if the response has not yet been committed.

static reset(): void;

Returns

• Type: void
• Description:

getHeader()

Gets the value of a specific header. If multiple headers with the same name exist, it returns the first one.

static getHeader(name: string): string;

Parameter	Type	Description
name	string	The name of the header.

Returns

• Type: string
• Description: The header value string.

setLocale()

Sets the locale for the response, which may affect language and date/time formatting.

static setLocale(language: string, country: string, variant: string): void;

Parameter	Type	Description
language	string	The language code (e.g., 'en', 'fr').
country	string	The optional country code (e.g., 'US', 'GB').
variant	string	The optional variant code.

Returns

• Type: void
• Description:

getHeaders()

Gets all header values for a specific header name as an array of strings.

static getHeaders(name: string): void;

Parameter	Type	Description
name	string	The name of the header.

Returns

• Type: void
• Description: An array of header values.

getHeaderNames()

Gets the names of all headers that have been set on the response.

static getHeaderNames(): void;

Returns

• Type: void
• Description: An array of header names.

getLocale()

Gets the currently set locale string for the response.

static getLocale(): string;

Returns

• Type: string
• Description: The locale string.

getOutputStream()

Gets the underlying output stream object, wrapped in the SDK's `OutputStream` class. This is useful for writing raw or large amounts of data.

static getOutputStream(): OutputStream;

Returns

• Type: OutputStream
• Description: The output stream object.