mapPost

mach::ControllerBuilder::mapPost

Registers a POST handler.

Description

Registers a POST endpoint for the controller.

Syntax

// (1)
template <typename THandler>
ControllerBuilder<TController>& mapPost(std::string_view pattern, THandler&& handler);

// (2)
template <typename THandler>
ControllerBuilder<TController>& mapPost(THandler&& handler);

Return Value

A reference to the current ControllerBuilder instance.

Template Parameters

Parameter	Description
THandler	The type of the endpoint handler.

Parameters

Overload (1)

Parameter	Description
pattern	The route pattern to map.
handler	The handler invoked for the endpoint.

Overload (2)

Parameter	Description
handler	The handler invoked for the endpoint.

Exceptions

Exception	Condition
std::logic_error	Thrown if a route with the same method and pattern has already been registered.

Remarks

In overload (2), the route pattern defaults to the controller’s route.

Thread Safety

This method is not thread-safe and should only be called during controller configuration, before the application starts handling requests.

Examples

Overload (1)

controller.mapPost("/users", &UserController::createUser);

Overload (2)

controller.mapPost(&UserController::createUser);

See Also

Name	Description
mapGet	Registers a GET handler.
mapPut	Registers a PUT handler.
mapPatch	Registers a PATCH handler.
mapDelete	Registers a DELETE handler.
mapHead	Registers a HEAD handler.