cowboy/examples/cors_hello_world/README.asciidoc

= Hello world example

To try this example, you need GNU `make` and `git` in your PATH.

To build and run the example, use the following command:

[source,bash]
$ make run

== HTTP/1.1 example output

[source,bash]
----
$ curl -i \
	-XOPTIONS \
	-H'Origin:http://example.org' \
	-H'Access-Control-Request-Method:GET' \
	-H'Access-Control-Request-Headers:Authorization' \
	'http://localhost:8080'
HTTP/1.1 200 OK
access-control-allow-headers: Authorization
access-control-allow-methods: GET, PUT
access-control-allow-origin: http://example.org
access-control-max-age: 0
content-length: 0
date: Sat, 02 Jul 2016 14:56:30 GMT
server: Cowboy
vary: Origin

$ curl -i \
	-XGET \
	-H'Origin:http://example.org' \
	'http://localhost:8080'
HTTP/1.1 200 OK
access-control-allow-origin: http://example.org
content-length: 12
content-type: text/plain
date: Sat, 02 Jul 2016 14:46:42 GMT
server: Cowboy
vary: Origin

Hello world!
----

== HTTP/2 example output

[source,bash]
----
$ nghttp -v \
	-H':method: OPTIONS' \
	-H'Origin:http://example.org' \
	-H'Access-Control-Request-Method:GET' \
	-H'Access-Control-Request-Headers:Authorization' \
	'http://localhost:8080'
[  0.002] Connected
[  0.002] send SETTINGS frame <length=12, flags=0x00, stream_id=0>
          (niv=2)
          [SETTINGS_MAX_CONCURRENT_STREAMS(0x03):100]
          [SETTINGS_INITIAL_WINDOW_SIZE(0x04):65535]
[  0.002] send PRIORITY frame <length=5, flags=0x00, stream_id=3>
          (dep_stream_id=0, weight=201, exclusive=0)
[  0.002] send PRIORITY frame <length=5, flags=0x00, stream_id=5>
          (dep_stream_id=0, weight=101, exclusive=0)
[  0.002] send PRIORITY frame <length=5, flags=0x00, stream_id=7>
          (dep_stream_id=0, weight=1, exclusive=0)
[  0.002] send PRIORITY frame <length=5, flags=0x00, stream_id=9>
          (dep_stream_id=7, weight=1, exclusive=0)
[  0.002] send PRIORITY frame <length=5, flags=0x00, stream_id=11>
          (dep_stream_id=3, weight=1, exclusive=0)
[  0.002] send HEADERS frame <length=126, flags=0x25, stream_id=13>
          ; END_STREAM | END_HEADERS | PRIORITY
          (padlen=0, dep_stream_id=11, weight=16, exclusive=0)
          ; Open new stream
          :method: OPTIONS
          :path: /
          :scheme: http
          :authority: localhost:8080
          accept: */*
          accept-encoding: gzip, deflate
          user-agent: nghttp2/1.11.1
          origin: http://example.org
          access-control-request-method: GET
          access-control-request-headers: Authorization
[  0.007] recv SETTINGS frame <length=0, flags=0x00, stream_id=0>
          (niv=0)
[  0.007] recv SETTINGS frame <length=0, flags=0x01, stream_id=0>
          ; ACK
          (niv=0)
[  0.007] send SETTINGS frame <length=0, flags=0x01, stream_id=0>
          ; ACK
          (niv=0)
[  0.007] recv (stream_id=13) :status: 200
[  0.007] recv (stream_id=13) access-control-allow-headers: Authorization
[  0.007] recv (stream_id=13) access-control-allow-methods: GET, PUT
[  0.007] recv (stream_id=13) access-control-allow-origin: http://example.org
[  0.007] recv (stream_id=13) access-control-max-age: 0
[  0.007] recv (stream_id=13) content-length: 0
[  0.008] recv (stream_id=13) date: Sat, 02 Jul 2016 15:06:07 GMT
[  0.008] recv (stream_id=13) server: Cowboy
[  0.008] recv (stream_id=13) vary: Origin
[  0.008] recv HEADERS frame <length=138, flags=0x05, stream_id=13>
          ; END_STREAM | END_HEADERS
          (padlen=0)
          ; First response header
[  0.008] send GOAWAY frame <length=8, flags=0x00, stream_id=0>
          (last_stream_id=0, error_code=NO_ERROR(0x00), opaque_data(0)=[])

$ nghttp -v \
	-H':method:GET' \
	-H'Origin:http://example.org' \
	'http://localhost:8080'
[  0.002] Connected
[  0.002] send SETTINGS frame <length=12, flags=0x00, stream_id=0>
          (niv=2)
          [SETTINGS_MAX_CONCURRENT_STREAMS(0x03):100]
          [SETTINGS_INITIAL_WINDOW_SIZE(0x04):65535]
[  0.002] send PRIORITY frame <length=5, flags=0x00, stream_id=3>
          (dep_stream_id=0, weight=201, exclusive=0)
[  0.002] send PRIORITY frame <length=5, flags=0x00, stream_id=5>
          (dep_stream_id=0, weight=101, exclusive=0)
[  0.002] send PRIORITY frame <length=5, flags=0x00, stream_id=7>
          (dep_stream_id=0, weight=1, exclusive=0)
[  0.002] send PRIORITY frame <length=5, flags=0x00, stream_id=9>
          (dep_stream_id=7, weight=1, exclusive=0)
[  0.002] send PRIORITY frame <length=5, flags=0x00, stream_id=11>
          (dep_stream_id=3, weight=1, exclusive=0)
[  0.002] send HEADERS frame <length=59, flags=0x25, stream_id=13>
          ; END_STREAM | END_HEADERS | PRIORITY
          (padlen=0, dep_stream_id=11, weight=16, exclusive=0)
          ; Open new stream
          :method: GET
          :path: /
          :scheme: http
          :authority: localhost:8080
          accept: */*
          accept-encoding: gzip, deflate
          user-agent: nghttp2/1.11.1
          origin: http://example.org
[  0.004] recv SETTINGS frame <length=0, flags=0x00, stream_id=0>
          (niv=0)
[  0.005] recv SETTINGS frame <length=0, flags=0x01, stream_id=0>
          ; ACK
          (niv=0)
[  0.005] recv (stream_id=13) :status: 200
[  0.005] recv (stream_id=13) access-control-allow-origin: http://example.org
[  0.005] recv (stream_id=13) content-length: 12
[  0.005] recv (stream_id=13) content-type: text/plain
[  0.005] recv (stream_id=13) date: Sat, 02 Jul 2016 15:07:01 GMT
[  0.005] recv (stream_id=13) server: Cowboy
[  0.005] recv (stream_id=13) vary: Origin
[  0.005] recv HEADERS frame <length=67, flags=0x04, stream_id=13>
          ; END_HEADERS
          (padlen=0)
          ; First response header
Hello world![  0.009] recv DATA frame <length=12, flags=0x01, stream_id=13>
          ; END_STREAM
[  0.009] send GOAWAY frame <length=8, flags=0x00, stream_id=0>
          (last_stream_id=0, error_code=NO_ERROR(0x00), opaque_data(0)=[])
----