Creating handlers

Search…
Creating handlers
If you haven't created a project yet, see Get started first.
Your project contains a Directive.yaml file that controls your entire application. The Directive is included in the Runnable Bundle used by Atmo to run your application.
The Directive has some metadata such as a unique application identifier and a version number, as well as some handlers.
Each handler tells Atmo how to handle a resource. A resource is an input that Atmo makes available via HTTP endpoints, event handlers, and more. To start, Atmo supports handlers for HTTP requests, particulary designed to help building web APIs. Here is an example Directive:
1
identifier: com.suborbital.test
2
appVersion: v0.0.1
3
atmoVersion: v0.3.2
4
​
5
handlers:
6
  - type: request
7
    resource: /hello
8
    method: POST
9
    steps:
10
      - group:
11
        - fn: modify-url
12
        - fn: helloworld-rs
13
          as: hello
14
      - fn: fetch-test
15
        with:
16
          url: modify-url
17
          logme: hello
Copied!
This describes the application being constructed. It declares a resource (HTTP POST /hello) and a set of steps to handle that request. The steps are a set of Runnable functions to be composed when handling requests to the /hello endpoint.
There are three types of step. The first step is a group, meaning that all of the functions in that group will be executed concurrently.
The second step is a single fn , which calls a Runnable that uses the Runnable API to make an HTTP request. The API is continually evolving to include more capabilities. In addition to making HTTP requests, it includes logging abilities and more.
There is a third step (not shown in the example above) called forEach, which is discussed later on.
The output of the final function in a handler is used as the response data for the request, by default. If you wish to use the output from a different function, you can include the response option in your handler, listing the name of the function to use as a response. If the final step is a group, then the response clause must be included.
For example:
1
steps:
2
  - group:
3
    - fn: modify-url
4
    - fn: helloworld-rs
5
      as: hello
6
  - fn: fetch-test
7
    with:
8
      url: modify-url
9
      logme: hello
10
response: hello
Copied!
Your application can contain as many handlers as needed, and functions can be re-used among many handlers. Each Runnable in your project can be called by its name. The subo tool will validate your directive to ensure it is not calling any Runnables that don't exist in your project.
The as and with clauses shown above will be discussed next.
Usage - Previous
Creating Runnables
Next - Usage
Managing state
Last modified 1mo ago
Export as PDF
Copy link