HTTP Server Lua Module

From Hopmod Wiki

Contents 1 http_server.listener(ip, port) 1.1 listener.set_root(resource) 1.2 listener.start() 1.3 listener.stop() 2 http_server.resource(methodFunctionTable) 2.1 request.uri() 2.2 request.uri_query() 2.3 request.header(name) 2.4 request.content_length() 2.5 request.content_type() 2.6 request.content_subtype() 2.7 request.host() 2.8 request.client_ip() 2.9 request.async_read_content(callback) 3 http_server.response(request) 3.1 response.header(name, value) 3.2 response.set_content_length(value) 3.3 response.async_send_header(callback) 3.4 response.send_header() 3.5 response.async_send_body(content, callback) 3.6 response.send_body(content)

http_server.listener(ip, port)

Create listener object bound to the given local address

listener.set_root(resource)

Set the root resource object

listener.start()

Start the server listener

listener.stop()

Stop the server listener. Note: stopping the listener doesn't shutdown established client connections

http_server.resource(methodFunctionTable)

Create a resource object. Keys supported for the methodFunctionTable argument: resolve, get, put, post, delete. Each of the callback functions (except resolve) when called are given a request object as the first argument. The callback for the resolve handler is given a string of the URI, the server expects this callback function to return a resource object. The callback for the method handlers must create a response object and send a response.

request.uri()

Return a string of the URI

request.uri_query()

Return a strinf of the URI query string component

request.header(name)

Find header field by name and return the field value as a string. The function returns nil if the header is not found.

request.content_length()

Return the value of the content-length field as a number.

request.content_type()

Return the value of the major type part of the content-type field as a string

request.content_subtype()

Return the sub type part of the content-type field as a string

request.host()

Return the value of the host field

request.client_ip()

Return the client ip address

request.async_read_content(callback)

Wait for the request content to be received and then call the callback function with the content. The content argument is passed as a string.

http_server.response(request)

Create a response object from the given request object.

response.header(name, value)

Add header

response.set_content_length(value)

Add content-length field

response.async_send_header(callback)

Send header. The callback function is given a boolean value for the first argument.

response.send_header()

Send header.

response.async_send_body(content, callback)

Send body content. The callback function is given a boolean value for the first argument.

response.send_body(content)

Send body content.