Intro

A prototype Clojure library which contains a potential new design for the iPlant DE This library is built with Compojure-api and Liberator.

To quickly see this in action, run the command > lein ring server.

Compojure-api

Compojure-api provides enhanced Compojure which allow RESTful endpoints to be documented in place. Furthermore, Compojure-api uses Schema to define query parameters, body parameters, and JSON output. These schema definitions are used to build the documentation, but they also provide schema validation for the endpoint.

Liberator

Liberator is a library which helps you expose your data as resources while automatically complying with all the relevant requirements of the HTTP specification.

PATCH is currently not supported in liberator v0.11.0, but will be in v0.12.0. An issue was opened asking when 0.12.0 will be released, here.

Useful Links

• HTTP specification
  • HTTP/1.1: Message Syntax and Routing
  • HTTP/1.1: Semantics and Content
  • HTTP/1.1: Conditional Requests
  • HTTP/1.1: Range Requests
  • HTTP/1.1: Caching
  • HTTP/1.1: Authentication
  • PATCH Method for HTTP
  • LINK & UNLINK Methods (not RFC yet)
  • HTTP Method Registry
  • HTTP Status Code Registry
• Compojure-api
• Compojure
• Schema
• Liberator