SWI-Prolog HTTP support library

This directory provides the SWI-Prolog libraries for accessing and providing HTTP services.

Client library

The main client library is library(http/http_open), which can open both HTTP and HTTPS connections and handle all request methods.

Server library

The main server libraries are

• library(http/thread_httpd) implements the server
• library(http/http_dispatch) implements binding locations predicates
• library(http/http_unix_daemon) implements integration in various Unix server managers and in general provides a suitable entry point for HTTP servers on Unix.
• library(http/html_write) implements generating HTML
• library(http/http_json) implements reading and writing JSON documents.

For simplicity, you can use library(http/http_server), which combines the typical HTTP libraries that most servers need. The idea of a common request handling system and three controlling libraries is outdated; the threaded server now being the only sensible controlling library.

Requirements

This library uses functionality from the ssl package to support HTTPS, the sgml package to read XML/HTML and the clib package for various extensions.

Prolog files

html_decl.pl  -- HTML emitter analysis and IDE support
html_head.pl  -- Automatic inclusion of CSS and scripts links
html_quasiquotations.pl  -- HTML quasi quotations
html_write.pl
html/3	Generate HTML from Content.
html_begin/3	For html_begin//1, Env is a term Env(Attributes); for html_end//1 it is the plain environment name.
html_current_option/1	True if Option is an active option for the HTML generator.
html_end/3	For html_begin//1, Env is a term Env(Attributes); for html_end//1 it is the plain environment name.
html_header_hook/1	This multifile hook is called just before the Content-type header is emitted.
html_post/4	Reposition HTML to the receiving Id.
html_quoted/3	Quote the value for normal (CDATA) text.
html_quoted_attribute/3	Quote the value according to the rules for tag-attributes included in double-quotes.
html_receive/3	Receive posted HTML tokens.
html_receive/4	This extended version of html_receive//1 causes Handler to be called to process all messages posted to the channel at the time output is generated.
html_root_attribute/4	Add an attribute to the HTML root element of the page.
html_set_options/1	Set options for the HTML output.
layout/3	Define required newlines before and after tags.
page/3	Generate a page including the HTML <!DOCTYPE> header.
page/4	Generate a page including the HTML <!DOCTYPE> header.
print_html/1	Print list of atoms and layout instructions.
print_html/2	Print list of atoms and layout instructions.
reply_html_page/2	Provide the complete reply as required by http_wrapper.pl for a page constructed from Head and Body.
reply_html_page/3	Provide the complete reply as required by http_wrapper.pl for a page constructed from Head and Body.
reply_html_partial/1	Reply with partial HTML document.
xhtml_ns/4	Demand an xmlns:id=Value in the outer html tag.
http_client.pl
post_data_hook/3	Hook to extend the datatypes supported by the post(Data) option of http_open/3.
http_convert_data/4	Multi-file hook to convert a HTTP payload according to the Content-Type header.
http_delete/3	Execute a DELETE method on the server.
http_disconnect/1	Close down some connections.
http_get/3	Get data from a URL server and convert it to a suitable Prolog representation based on the Content-Type header and plugins.
http_patch/4	Issue an HTTP PATCH request.
http_post/4	Issue an HTTP POST request.
http_put/4	Issue an HTTP PUT request.
http_read_data/3	Read data from an HTTP connection and convert it according to the supplied to(Format) option or based on the Content-type in the Request.
http_cors.pl  -- Enable CORS: Cross-Origin Resource Sharing
http_dispatch.pl  -- Dispatch requests in the HTTP server
http_dyn_workers.pl  -- Dynamically schedule HTTP workers.
http_exception.pl  -- Map Prolog exceptions to HTTP errors
http_header.pl  -- Handling HTTP headers
http_hook.pl  -- HTTP library hooks
http_host.pl  -- Obtain public server location
http_log.pl  -- HTTP Logging module
http_multipart_plugin.pl  -- Multipart form-data plugin
http_open.pl
disable_encoding_filter/1	Do not use the Content-encoding as Transfer-encoding encoding for specific values of ContentType.
http_close_keep_alive/1	Close all keep-alive connections matching Address.
http_open/3	Open the data at the HTTP server as a Prolog stream.
http_set_authorization/2	Set user/password to supply with URLs that have URL as prefix.
keep_alive/4	Callback when closing the range stream used to process the content of the reply.
map_method/2	Support additional METHOD keywords.
open_hook/6	Hook implementation that makes open_any/5 support http and https URLs for Mode == read.
http_parameters.pl  -- Extract parameters (GET and POST) from HTTP requests
http_path.pl  -- Abstract specification of HTTP server locations
http_redis_plugin.pl
http_server.pl  -- HTTP server library
http_server_files.pl
serve_files_in_directory/2	Serve files from the directory Alias from the path-info from Request.
http_server_health.pl
health/2	Multifile extensible.
hide/1	Multifile hook.
server_health/1	HTTP handler that replies with the overall health of the server.
http_session.pl  -- HTTP Session management
http_stream.pl  -- HTTP Streams
http_unix_daemon.pl
sni_options/2	Hook to provide Server Name Indication (SNI) for TLS servers.
http_certificate_hook/3	Hook called before starting the server if the --https option is used.
http_daemon/0	Start the HTTP server as a daemon process.
http_daemon/1	Start the HTTP server as a daemon process.
http_opt_help/2	Allow reusing http option processing.
http_opt_meta/2	Allow reusing http option processing.
http_opt_type/3	Allow reusing http option processing.
http_server_hook/1	Hook that is called to start the HTTP server.
http_wrapper.pl  -- Server processing of an HTTP request
hub.pl  -- Manage a hub for websockets
js_write.pl
javascript/4	Quasi quotation parser for JavaScript that allows for embedding Prolog variables to substitude identifiers in the JavaScript snippet.
js_arg/3	Same as js_expression//1, but fails if Expression is invalid, where js_expression//1 raises an error.
js_arg_list/3	Write javascript (function) arguments.
js_call/3	Emit a call to a Javascript function.
js_expression/3	Emit a single JSON argument.
js_new/4	Emit a call to a Javascript object declaration.
js_script/3	Generate a JavaScript script element with the given content.
mimepack.pl  -- Create a MIME message
mime_pack/3	Pack a number of inputs into a MIME package using a specified or generated boundary.
mimetype.pl  -- Determine mime-type for a file
term_html.pl  -- Represent Prolog terms as HTML
thread_httpd.pl
schedule_workers/1	Hook called if a new connection or a keep-alive connection cannot be scheduled immediately to a worker.
http_add_worker/2	Add a new worker to the HTTP server for port Port.
http_close_connection/1	Close connection associated to Request.
http_current_server/2	True if Goal is the goal of a server at Port.
http_current_worker/2	True if ThreadID is the identifier of a Prolog thread serving Port.
http_enough_workers/3	Check that we have enough workers in our queue.
http_requeue/1	Re-queue a connection to the worker pool.
http_server/2	Create a server at Port that calls Goal for each parsed request.
http_server_property/2	True if Property is a property of the HTTP server running at Port.
http_spawn/2	Continue this connection on a new thread.
http_stop_server/2	Stop the indicated HTTP server gracefully.
http_workers/2	Query or set the number of workers for the server at this port.
message_level/2	Determine the message stream used for exceptions that may occur during server_loop/5.
websocket.pl
http_open_websocket/3	Establish a client websocket connection.
http_upgrade_to_websocket/3	Create a websocket connection running call(Goal, WebSocket), where WebSocket is a socket-pair.
ws_close/3	Close a WebSocket connection by sending a close message if this was not already sent and wait for the close reply.
ws_mask/1	Produce a good random number of the mask of a client message.
ws_open/3	Turn a raw TCP/IP (or any other binary stream) into a websocket stream.
ws_property/2	True if Property is a property WebSocket.
ws_receive/2	Receive the next message from WebSocket.
ws_receive/3	Receive the next message from WebSocket.
ws_send/2	Send a message over a websocket.