Skip to content

About

A Transport for http.Client that will cache responses according to the HTTP RFC

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

httpcache

Build Status GoDoc

Package httpcache provides a http.RoundTripper implementation that works as a mostly RFC 7234 compliant cache for http responses.

It is only suitable for use as a 'private' cache (i.e. for a web-browser or an API-client and not for a shared proxy).

This project isn't actively maintained; it works for what I, and seemingly others, want to do with it, and I consider it "done". That said, if you find any issues, please open a Pull Request and I will try to review it. Any changes now that change the public API won't be considered.

Cache Backends

If you implement any other backend and wish it to be linked here, please send a PR editing this file.

Signed URLs

Usually there is a big problem related to caching signed URLs. The problem is that the URL is signed with a timestamp, so the URL is different every time. This means that the cache will never hit, and the request will always be sent to the origin server.

This package provides a solution to this problem. The solution is to use a httpcache.CacheConfig to provide additional behavior to use cache.

This solution allow you to pass:

  • CacheKeyFn func(req *http.Request) string - A function that returns a key for the cache. Then you can remove all redundant information from the request, and return a key that will be used to store the response in the cache.
  • AuthorizeCacheFn func(req *http.Request, c *http.Client) bool - function that authorizes original request to be cached. This function should return true if the request should be cached, and false otherwise.

Example for GCS you can find in example/gcs folder. AuthorizeCacheFn is implemented to do HEAD request to remote to check that client has access to the resource. After this you can get cached response by cache-key with no any specific URL-Signature parameters.

License

About

A Transport for http.Client that will cache responses according to the HTTP RFC

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages

⌂ 换网址