diff options
| author |  Makarand Dharmapurikar <makarandd@google.com> | 2016-09-28 10:46:27 -0700 |
|---|---|---|
| committer | Makarand Dharmapurikar <makarandd@google.com> | 2016-09-28 10:46:27 -0700 |
| commit | 012fc18be93b98967a20986469eada34eac0c061 (patch) | |
| tree | af88942d263ffee00d0c025443708dcddaa6c2bd /doc/interop-test-descriptions.md | |
| parent | a04c6789632c1e454cfe563f3144c27498d5ef0a (diff) | |
doc fixes and max-age set to 60
Diffstat (limited to 'doc/interop-test-descriptions.md')
| -rw-r--r-- | doc/interop-test-descriptions.md | 15 |
1 files changed, 9 insertions, 6 deletions
diff --git a/doc/interop-test-descriptions.md b/doc/interop-test-descriptions.md index 8a1e93eee0..62d36708f9 100644 --- a/doc/interop-test-descriptions.md +++ b/doc/interop-test-descriptions.md @@ -67,13 +67,17 @@ of POST, and that server sets appropriate cache control headers for the response to be cached by a proxy. This interop test requires that the server is behind a caching proxy. Use of current timestamp in the request prevents accidental cache matches left over from previous tests. +Note that client adds a `x-user-ip` header with value `1.2.3.4` to the request. +This is done since some proxys such as GFE will not cache requests from +localhost. Server features: * [CacheableUnaryCall][] Procedure: 1. Client calls CacheableUnaryCall with `SimpleRequest` request with payload - set to current timestamp. + set to current timestamp. Timestamp format is irrelevant, and resolution is + in nanoseconds. 2. Client calls CacheableUnaryCall with `SimpleRequest` request again immediately with the same payload as the previous request. @@ -965,13 +969,12 @@ for the `SimpleRequest.response_type`. If the server does not support the ### CacheableUnaryCall Server gets the default SimpleRequest proto as the request. The content of the -request are ignored. It returns the SimpleResponse proto with the payload set -to current timestamp string. In addition it adds +request is ignored. It returns the SimpleResponse proto with the payload set +to current timestamp. The timestamp is an integer representing current time +with nanosecond resolution. In addition it adds 1. cache control headers such that the response can be cached by proxies in the response path. Server should be behind a caching proxy for this test - to pass. - 2. adds a `x-user-ip` header with `1.2.3.4` to the response. This is done - since some proxys such as GFE will not cache requests from localhost. + to pass. Currently we set the max-age to 60 seconds. ### CompressedResponse [CompressedResponse]: #compressedresponse |