Application configuration

The following parameters are reserved by the system. You can add your application parameters in the main application configuration file (application.yml) or apply additional configuration files using the ConfigReader API.

Key Value (example) Required
application.name Application name Yes
info.app.version major.minor.build (e.g. 1.0.0) Yes
info.app.description Something about your application Yes
server.port e.g. 8083 Yes
static.html.folder e.g. /tmp/html Yes
yaml.rest.automation Default value is classpath:/rest.yaml Optional
yaml.mime.types Optional config file Optional
mime.types Map of file extensions to MIME types Optional
log.format text or json Optional
log.level default 'info' Optional
health.dependencies e.g. 'database.health' Optional

Static HTML contents

You can place static HTML files (e.g. the HTML bundle for a UI program) in the "resources/public" folder or in the local file system using the "static.html.folder" parameter.

The system supports a bare minimal list of file extensions to MIME types. If your use case requires additional MIME type mapping, you may define them in the application.yml configuration file under the mime.types section like this:

mime.types:
  pdf: 'application/pdf'
  doc: 'application/msword'

Alternatively, you can create a mime-types.yml file and point it using the "yaml.mime.types" parameter.

Transient data store

The system uses a temp folder in "/tmp/node/streams" to hold temporary data blocks for streaming I/O.

Reserved route names

The following route names are reserved by the system.

Route Purpose Modules
distributed.tracing Distributed tracing logger core engine
async.http.request HTTP response event handler core engine
event.api.service Event API handler REST automation
actuator.services admin endpoints (/info, /health, /livenessprobe) REST automation

Reserved HTTP header names

Header Purpose
X-Stream-Id Temporal route name for streaming content
X-TTL Time to live in milliseconds for a streaming content
X-Async This header, if set to true, indicates it is a drop-n-forget request
X-Trace-Id This allows the system to propagate trace ID


Chapter-7 Home Appendix-II
Test Driven Development Table of Contents Async HTTP client