Writing a HTTP
Table of Contents
Introduction xvii
Getting Started xxi
Chapter 1 Writing Command-Line Applications 1
Your First Application 1
Writing Unit Tests 8
Using the Flag Package 14
Testing the Parsing Logic 20
Improving the User Interface 22
Removing Duplicate Error Messages 23
Customizing Usage Message 24
Accept Name via a Positional Argument 25
Updating the Unit Tests 28
Summary 32
Chapter 2 Advanced Command-Line Applications 33
Implementing Sub-commands 33
An Architecture for Sub-command-Driven Applications 37
Testing the Main Package 43
Testing the Cmd Package 45
Making Your Applications Robust 47
User Input with Deadlines 48
Handling User Signals 52
Summary 56
Chapter 3 Writing HTTP Clients 57
Downloading Data 57
Testing the Data Downloader 59
Deserializing Received Data 61
Sending Data 66
Working with Binary Data 72
Summary 80
Chapter 4 Advanced HTTP Clients 81
Using a Custom HTTP Client 81
Downloading from an Overloaded Server 81
Testing the Time-Out Behavior 85
Configuring the Redirect Behavior 88
Customizing Your Requests 91
Implementing Client Middleware 92
Understanding the RoundTripper Interface 93
A Logging Middleware 94
Add a Header to All Requests 96
Connection Pooling 99
Configuring the Connection Pool 103
Summary 104
Chapter 5 Building HTTP Servers 105
Your First HTTP Server 105
Setting Up Request Handlers 108
Handler Functions 109
Testing Your Server 112
The Request Struct 114
Method 115
Url 115
Proto, ProtoMajor, and ProtoMinor 116
Header 116
Host 116
Body 116
Form, PostForm 116
MultipartForm 117
Attaching Metadata to a Request 118
Processing Streaming Requests 121
Streaming Data as Responses 126
Summary 132
Chapter 6 Advanced HTTP Server Applications 133
The Handler Type 133
Sharing Data across Handler Functions 134
Writing Server Middleware 139
Custom HTTP Handler Technique 139
The HandlerFunc Technique 140
Chaining Middleware 142
Writing Tests for Complex Server Applications 147
Code Organization 147
Testing the Handler Functions 153
Testing the Middleware 155
Testing the Server Startup 157
Summary 159
Chapter 7 Production- Ready HTTP Servers 161
Aborting Request Handling 161
Strategies to Abort Request Processing 165
Handling Client Disconnects 169
Server-Wide Time- Outs 173
Implement a Time- Out for All Handler Functions 173
Implementing Server Time- Out 174
Implementing Graceful Shutdown 179
Securing Communication with TLS 184
Configuring TLS and HTTP/2 184
Testing TLS Servers 188
Summary 192
Chapter 8 Building RPC Applications with gRPC 193
gRPC and Protocol Buffers 193
Writing Your First Service 197
Writing the Server 198
Writing a Client 203
Testing the Server 207
Testing the Client 211
A Detour into Protobuf Messages 214
Marshalling and Unmarshalling 214
Forward and Backward Compatibility 219
Multiple Services 220
Error Handling 226
Summary 228
Chapter 9 Advanced gRPC Applications 229
Streaming Communication 229
Server- Side Streaming 230
Client- Side Streaming 237
Bidirectional Streaming 239
Receiving and Sending Arbitrary Bytes 247
Implementing Middleware Using Interceptors 256
Client- Side Interceptors 257
Server- Side Interceptors 263
Wrapping Streams 269
Chaining Interceptors 271
Summary 272
Chapter 10 Production- Ready gRPC Applications 275
Securing Communication with TLS 275
Robustness in Servers 278
Implementing Health Checks 278
Handling Runtime Errors 286
Aborting Request Processing 289
Robustness in Clients 297
Improving Connection Setup 298
Handling Transient Failures 300
Setting Time- Outs for Method Calls 305
Connection Management 306
Summary 309
Chapter 11 Working with Data Stores 311
Working with Object Stores 312
Integration with Package Server 313
Testing Package Uploads 323
Accessing Underlying Driver Types 325
Working with Relational Databases 327
Integration with Package Server 328
Testing Data Storage 339
Data Type Conversions 343
Using Database Transactions 346
Summary 348
Appendix A Making Your Applications Observable 349
Logs, Metrics, and Traces 349
Emitting Telemetry Data 352
Command- Line Applications 352
HTTP Applications 360
gRPC Applications 364
Summary 366
Appendix B Deploying Applications 367
Managing Configuration 367
Distributing Your Application 370
Deploying Server Applications 372
Summary 373
Index 375
