Learn R Programming
ambiorix (version 2.1.0)

Ambiorix: Ambiorix

Description

Web server.

Arguments

Value

An object of class Ambiorix from which one can add routes, routers, and run the application.

Super class

ambiorix::Routing -> Ambiorix

Public fields

not_found

404 Response, must be a handler function that accepts the request and the response, by default uses response_404().

error

500 response when the route errors, must a handler function that accepts the request and the response, by default uses response_500().

on_stop

Callback function to run when the app stops, takes no argument.

Active bindings

port

Port to run the application.

host

Host to run the application.

Methods

Public methods

Method new()

Usage

Ambiorix$new(
  host = getOption("ambiorix.host", "0.0.0.0"),
  port = getOption("ambiorix.port", NULL),
  log = getOption("ambiorix.logger", TRUE)
)

Arguments

host

A string defining the host.

port

Integer defining the port, defaults to ambiorix.port option: uses a random port if NULL.

log

Whether to generate a log of events.

Details

Define the webserver.

Method listen()

Usage

Ambiorix$listen(port)

Arguments

port

Port number.

Details

Specifies the port to listen on.

Examples

app <- Ambiorix$new()

app$listen(3000L)

app$get("/", function(req, res){ res$send("Using {ambiorix}!") })

if(interactive()) app$start()

Method set_404()

Usage

Ambiorix$set_404(handler)

Arguments

handler

Function that accepts the request and returns an object describing an httpuv response, e.g.: response().

Details

Sets the 404 page.

Examples

app <- Ambiorix$new()

app$set_404(function(req, res){ res$send("Nothing found here") })

app$get("/", function(req, res){ res$send("Using {ambiorix}!") })

if(interactive()) app$start()

Method static()

Usage

Ambiorix$static(path, uri = "www")

Arguments

path

Local path to directory of assets.

uri

URL path where the directory will be available.

Details

Static directories

Method start()

Usage

Ambiorix$start(port = NULL, host = NULL, open = interactive())

Arguments

port

Integer defining the port, defaults to ambiorix.port option: uses a random port if NULL.

host

A string defining the host.

open

Whether to open the app the browser.

Details

Start Start the webserver.

Examples

app <- Ambiorix$new()

app$get("/", function(req, res){ res$send("Using {ambiorix}!") })

if(interactive()) app$list(posrt = 3000L)

Method serialiser()

Usage

Ambiorix$serialiser(handler)

Arguments

handler

Function to use to serialise. This function should accept two arguments: the object to serialise and ....

Details

Define Serialiser

Examples

app <- Ambiorix$new()

app$serialiser(function(data, ...){ jsonlite::toJSON(x, ..., pretty = TRUE) })

app$get("/", function(req, res){ res$send("Using {ambiorix}!") })

if(interactive()) app$start()

Method stop()

Usage

Ambiorix$stop()

Details

Stop Stop the webserver.

Method print()

Usage

Ambiorix$print()

Details

Print

Method clone()

The objects of this class are cloneable with this method.

Usage

Ambiorix$clone(deep = FALSE)

Arguments

deep

Whether to make a deep clone.

Examples

Run this code
# NOT RUN {
app <- Ambiorix$new()

app$get("/", function(req, res){
 res$send("Using {ambiorix}!")
})

app$on_stop <- function(){
 cat("Bye!\n")
}

if(interactive())
 app$start()


## ------------------------------------------------
## Method `Ambiorix$listen`
## ------------------------------------------------

app <- Ambiorix$new()

app$listen(3000L)

app$get("/", function(req, res){
 res$send("Using {ambiorix}!")
})

if(interactive())
 app$start()

## ------------------------------------------------
## Method `Ambiorix$set_404`
## ------------------------------------------------

app <- Ambiorix$new()

app$set_404(function(req, res){
 res$send("Nothing found here")
})

app$get("/", function(req, res){
 res$send("Using {ambiorix}!")
})

if(interactive())
 app$start()

## ------------------------------------------------
## Method `Ambiorix$start`
## ------------------------------------------------

app <- Ambiorix$new()

app$get("/", function(req, res){
 res$send("Using {ambiorix}!")
})

if(interactive())
 app$list(posrt = 3000L)

## ------------------------------------------------
## Method `Ambiorix$serialiser`
## ------------------------------------------------

app <- Ambiorix$new()

app$serialiser(function(data, ...){
 jsonlite::toJSON(x, ..., pretty = TRUE)
})

app$get("/", function(req, res){
 res$send("Using {ambiorix}!")
})

if(interactive())
 app$start()
# }

Run the code above in your browser using DataLab