Class DefaultWebResponseMapper

java.lang.Object

io.fluxzero.sdk.web.DefaultWebResponseMapper

All Implemented Interfaces:

ResponseMapper, WebResponseMapper

public class DefaultWebResponseMapper
extends Object
implements WebResponseMapper

Default implementation of WebResponseMapper that converts handler return values into WebResponse objects.

This mapper is used internally to standardize responses from @HandleWeb methods or forwarded HTTP requests. It maps return values based on their type, applying common HTTP status codes and payload formatting conventions.

Mapping Rules

The logic follows these conventions:

• If the response is already a WebResponse, it is returned unchanged
• If the response is a known Throwable, a corresponding HTTP error code and message are assigned:
  • ValidationException or DeserializationException → 400 Bad Request
  • UnauthorizedException or UnauthenticatedException → 401 Unauthorized
  • other FunctionalExceptions → 403 Forbidden
  • TimeoutException or Fluxzero's own TimeoutException → 503 Service Unavailable
  • Any other Throwable → 500 Internal Server Error
• If the response is null, the status is set to 204 No Content
• Otherwise, the response is treated as a normal payload with status 200 OK

Automatically mapped responses are eligible for best-effort content negotiation against the request Accept header before they are serialized. Explicit WebResponse instances and explicit Content-Type response metadata are left unchanged.

In all cases, the provided Metadata is added to the resulting response.

See Also:

• WebResponseMapper
• WebResponse
• HandleWeb

Constructor Summary

Constructors

Constructor	Description
DefaultWebResponseMapper()

Method Summary

Modifier and Type	Method	Description
WebResponse	map(Object response, Metadata metadata)	Maps a raw handler return value and associated metadata into a WebResponse.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface ResponseMapper

mapPayload

Methods inherited from interface WebResponseMapper

map

Constructor Details

DefaultWebResponseMapper

public DefaultWebResponseMapper()

Method Details

map

public WebResponse map(Object response,
 Metadata metadata)

Maps a raw handler return value and associated metadata into a WebResponse.

Specified by:

map in interface ResponseMapper

Specified by:

map in interface WebResponseMapper

Parameters:

response - the return value (may be a WebResponse, a regular object, or a Throwable)

metadata - metadata to attach to the response

Returns:

a mapped WebResponse object