Return handler

Purpose: Return from current request handler back to its caller.

 return-handler

Copied!

Returns from current request handler by transferring control back to its caller. If the current request handler was called from an outside caller (such as web browser, API, command line etc.), then return-handler is equivalent to exit-handler. If the current request handler was called from another request handler with call-handler, then control transfers back to that handler immediately after call-handler.

Examples

In this example, "req-handler" (the caller) will call "other-handler" (the callee), which will return to the caller (immediately after call-handler). Here's the caller:

 begin-handler /req-handler public
     ...
     call-handler other-handler
     ...
 end-handler

Copied!

The callee handler:

 begin-handler /other-handler public
     ...
     return-handler
     ...
 end-handler

Copied!