Call handler

Purpose: Call another handler within the same process.

 call-handler <request path>

Copied!

Calls another handler within the same request in the same process. You can call any handler within the same application.

<request path> is the request path served by the handler being called. It can be a string variable or a constant.

Use set-param and get-param to pass parameters between the caller and callee handlers.

call-handler uses the same high-performance hash table used by a request to route requests by name.

Examples

The following example demonstrate calling a call-handler twice, and also using its output inline in the caller. An input parameter is passed to it, and an output obtained:

Copy to file "callsub.gliim":

 %% /callsub public
     //
     // First call to call-handler
     //
     // Set input for call-handler
     set-param inp = "some string"
     (( s
     call-handler "/sub/service"
     ))
     // Get output from call-handler
     get-param out type string
     @<<p-out s>> with output [<<p-out out>>]

     //
     // Second call to call-handler
     //
     // Set input for call-handler called as inline code
     set-param inp = "new string"
     (( s
     @Output: <<call-handler "/sub/service">>
     ))
     // Get output from call-handler
     get-param out type string
     @<<p-out s>> with output [<<p-out out>>]
 %%

Copied!

And in "sub/service.gliim" file (meaning file "service.gliim" in subdirectory "sub"):

 %% /sub/service private
     @This is sub!
     get-param inp
     (( out
     @got input: <<p-out inp>>
     ))
     set-param out = out
 %%

Copied!

Create and build an application:

sudo mgrg -i -u $(whoami) subhandler
gg -q

Copied!

Run it:

gg -r --req="/callsub" --exec --silent-header

Copied!

The output:

This is sub! with output [got input: some string]
Output: This is sub! with output [got input: new string]

Copied!