ii
Preface .................................................................................................................................... iv
1. HttpCore Scope ........................................................................................................... iv
2. HttpCore Goals ............................................................................................................ iv
3. What HttpCore is NOT ................................................................................................ iv
1. Fundamentals ....................................................................................................................... 1
1.1. HTTP messages ......................................................................................................... 1
1.1.1. Structure ......................................................................................................... 1
1.1.2. Basic operations .............................................................................................. 1
1.1.3. HTTP entity .................................................................................................... 3
1.1.4. Creating entities .............................................................................................. 5
1.2. HTTP protocol processors .......................................................................................... 7
1.2.1. Standard protocol interceptors .......................................................................... 7
1.2.2. Working with protocol processors .................................................................... 8
1.3. HTTP execution context ............................................................................................. 9
1.3.1. Context sharing ............................................................................................... 9
2. Blocking I/O model ............................................................................................................ 10
2.1. Blocking HTTP connections ..................................................................................... 10
2.1.1. Working with blocking HTTP connections ..................................................... 10
2.1.2. Content transfer with blocking I/O ................................................................. 11
2.1.3. Supported content transfer mechanisms .......................................................... 11
2.1.4. Terminating HTTP connections ...................................................................... 12
2.2. HTTP exception handling ......................................................................................... 12
2.2.1. Protocol exception ......................................................................................... 12
2.3. Blocking HTTP protocol handlers ............................................................................. 12
2.3.1. HTTP service ................................................................................................ 12
2.3.2. HTTP request executor .................................................................................. 14
2.3.3. Connection persistence / re-use ...................................................................... 14
2.4. Connection pools ..................................................................................................... 15
2.5. TLS/SSL support ..................................................................................................... 16
2.6. Embedded HTTP server ........................................................................................... 17
3. Asynchronous I/O based on NIO ......................................................................................... 18
3.1. Differences from other I/O frameworks ..................................................................... 18
3.2. I/O reactor ............................................................................................................... 18
3.2.1. I/O dispatchers .............................................................................................. 18
3.2.2. I/O reactor shutdown ..................................................................................... 19
3.2.3. I/O sessions ................................................................................................... 19
3.2.4. I/O session state management ........................................................................ 19
3.2.5. I/O session event mask .................................................................................. 19
3.2.6. I/O session buffers ........................................................................................ 20
3.2.7. I/O session shutdown ..................................................................................... 20
3.2.8. Listening I/O reactors .................................................................................... 20
3.2.9. Connecting I/O reactors ................................................................................. 21
3.3. I/O reactor configuration .......................................................................................... 22
3.3.1. Queuing of I/O interest set operations ............................................................ 23
3.4. I/O reactor exception handling .................................................................................. 23
3.4.1. I/O reactor audit log ...................................................................................... 24
3.5. Non-blocking HTTP connections .............................................................................. 24
3.5.1. Execution context of non-blocking HTTP connections ..................................... 24
3.5.2. Working with non-blocking HTTP connections ............................................... 24
