OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

amqp message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: HTTP over AMQP proposal

I’ve been asking around on LinkedIn and Twitter whether people would find the idea of the HTTP semantics and content model over AMQP attractive, and the response was quite positive.


Asking the question was motivated by my work on AMQP Management which already borrows heavily from the RFC7231 specification. A cleaner approach would be to do a more complete mapping of RFC7231 over AMQP and then use that.


I’m specifically referring to RFC7231 because that specification describes the semantics and content model of HTTP, which is the most popular foundation for request/response interactions over networks.


The base spec, RFC7230, describes the connection model and wire representation of HTTP. A HTTP-over-AMQP mapping would replace RFC7230 much like HTTP/2 (RFC7540) does – with the differences that HTTP-over-AMQP  

  • is fully bidirectional allowing requests to be issued by either of the connected peers (similar to CoAP; RFC7252),
  • request/reply traffic works alongside and multiplexed with any other AMQP traffic,
  • request and replies integrate with existing AMQP infrastructures, including routing through queues and pub/sub


Because AMQP is a binary protocol with multiplexing support, an HTTP-over-AMQP mapping ought to provide efficiency gains compared to HTTP 1.1 similar to HTTP/2, even though it should not be considered to be a goal to beat HTTP/2 with respect to byte-on-wire footprint or latency.


The greatest strength of such a combination is that the mapping would optionally reseat HTTP on top of a protocol foundation that is designed for application-guided “Layer 7” routing, including routes via durable entities like queues, and for which the TC is already formalizing new routing capabilities (See summary at http://vasters.com/blog/amqp-the-road-ahead/ ).


The mapping would permit any existing HTTP programming model abstraction to function as-is, with the internal implementation having to be adapted to the wire specification much like those implementations had to adapt to HTTP/2. The new opportunity for frameworks is that an HTTP server request context could allow issuing requests back to the client (and any client could act as server in the conversation) because the underlying protocol is fully symmetric after the initial connection handshake. It would indeed also be possible for a party to initiate a connection, e.g. to come out from behind a NAT, and then only act as server towards its peer.


An HTTP-over-AMQP specification would normatively describe the points in the following outline:


  • How is the HTTP message (RFC7230 Sec 3) mapped to an AMQP message
    • Where do elements of the start-line (request-line or status-line) go?
      • method / status-code => msg:properties:subject
      • request-target => msg:properties:to
    • How are headers mapped?
      • End-to-end immutable headers into application-properties (some special headers into properties)
      • Intermediary-contributed/-targeted headers into message-annotations
    • How is the message body represented?
      • Content-Type => msg:properties:content-type
      • Content-Encoding => msg:properties:content-encoding
      • Body => msg:data
    • How does chunked transfer coding work for large messages and streaming?
      • Chunks break across grouped message sequences (msg:properties:group-id, msg:properties:group-sequence). The first message is a group, with group-sequence=0, carries all metadata. Subsequent messages carry minimal metadata and monotonically increasing group-sequence ids with further chunks. The highest order bit of the sequence number acting as FIN bit, marking the last chunk.
  • How are further HTTP semantics (expressed in headers) mapped?
    • RFC7231/-32/-33/-34/-35 standard header mappings
      • Content-Type, Content-Encoding, Expires, Date MUST map to respective AMQP standard properties
      • Dictionary compression for remaining standard headers (numeric indexes instead of strings)
    • Data type conversions for well-known header field values (e.g. HTTP Date => timestamp)
    • Application extensions, other RFCs/standards
      • Case-folding of header names to lowercase (AMQP is case-sensitive, HTTP is not)
  • How are requests and responses correlated?
  • How do targets, links, and redirects work?
    • HTTP request-target maps to an AMQP node, as link target or anonymous terminus routing target
    • AMQP Addressing (network/container/node)
    • Hybrid HTTP/AMQP Addressing?
  • Connection Upgrade from HTTP 1.1; starting AMQP-over-HTTP for http/https URIs
    • This is meant for apps that are written to interact with regular HTTP 1.1 services and which know http/https URIs, and for which their client stack transparently handles upgrades to AMQP-over-HTTP.  
    • Start w/ GET, OPTIONS or other request, requesting WebSocket upgrade with “amqp” subprotocol and also supplying a to-be-named HTTP-over-AMQP upgrade request header
      • Allowing other methods is looser than RFC6455, which demands GET. Allowing other methods allows to inline the upgrade path with an existing HTTP API of the service/server.
    • If the server supports HTTP-over-AMQP upgrades and decides it wants to offer the upgrade, it responds with 101 and then initiates the AMQP upgrade per AMQP web socket binding. The 101 response carries a to-be-named HTTP-over-AMQP response header indicating that this isn’t just a regular WebSocket upgrade.
    • After the upgrade, it would be nifty for the server to map the initial HTTP 1.1 request to an HTTP-over-AMQP request so that it doesn’t have to be resent; the response correlation needs may sabotage that.
  • Security model
    • AMQP SASL context plus TLS plus CBS as equivalent to HTTP-over-TLS (RFC7230, 2.7.2)
    • Request-level security carried over from RFC7235







Clemens Vasters

Messaging Platform Architect

Microsoft Azure

È+49 151 44063557

*  clemensv@microsoft.com   
European Microsoft Innovation Center GmbH | Gewürzmühlstrasse 11 | 80539 Munich| Germany
Geschäftsführer/General Managers: Keith Dolliver, Benjamin O. Orndorff 
Amtsgericht Aachen, HRB 12066



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]