Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security Policy
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

cache

package

Go to main page

Versions in this module

v0

v0.2.0

Aug 1, 2023

Changes in this version

type HttpCache

+ func (c *HttpCache) Strict() bool

type HttpCacheConfig

+ Strict bool

v0.1.0

Jul 14, 2023

Changes in this version

+ const HIT

+ const HeaderAge

+ const HeaderAuthorization

+ const HeaderCacheControl

+ const HeaderDate

+ const HeaderEtag

+ const HeaderExpires

+ const HeaderIfMatch

+ const HeaderIfModifiedSince

+ const HeaderIfNoneMatch

+ const HeaderIfRange

+ const HeaderIfUnmodifiedSince

+ const HeaderLastModified

+ const HeaderPragma

+ const MISS

+ var DefaultTTL = 120 * time.Second

+ func CalculateAge(headers *http.Header, responseTime time.Time, now time.Time) time.Duration

+ func Contains[K comparable, V any](m map[K]V, k K) bool

+ func IsCacheableRequest(req *http.Request) bool

+ func IsCacheableResponse(res *http.Response) bool

+ func Max(x, y int64) int64

+ func StableHashKey(k Key) uint64

+ type Content struct

+ Size int

+ Type string

+ TypeMatcher *regexp.Regexp

+ type Entry struct

+ Body []byte

+ Timestamp int64

+ func DecodeEntry(data []byte) (*Entry, error)

+ func (e *Entry) Encode() ([]byte, error)

+ type EntryStatus int

+ const EntryInvalid

+ const EntryLookupError

+ const EntryOk

+ const EntryRequiresValidation

+ func (s EntryStatus) String() string

+ type Exclude struct

+ Content []Content

+ Header map[string]string

+ Path []string

+ PathMatcher []*regexp.Regexp

+ type HttpCache struct

+ func NewHttpCache(config *HttpCacheConfig, pdr provider.Provider) (*HttpCache, error)

+ func (c *HttpCache) Config() *HttpCacheConfig

+ func (c *HttpCache) DefaultCacheControl() string

+ func (c *HttpCache) DefaultTTL() time.Duration

+ func (c *HttpCache) Delete(ctx context.Context, lookup *LookupRequest)

+ func (c *HttpCache) FetchResponse(ctx context.Context, lookup LookupRequest) *LookupResult

+ func (c *HttpCache) ForceCacheControl() bool

+ func (c *HttpCache) IsExcludedContent(content string, length int64) bool

+ func (c *HttpCache) IsExcludedHeader(h http.Header) bool

+ func (c *HttpCache) IsExcludedPath(p string) bool

+ func (c *HttpCache) MarkCachedResponses() bool

+ func (c *HttpCache) PathTTL(p string) time.Duration

+ func (c *HttpCache) StoreResponse(_ context.Context, lookup *LookupRequest, response *http.Response, ...)

+ func (c *HttpCache) UpdateConfig(config *HttpCacheConfig)

+ func (c *HttpCache) XCacheHeader() string

+ type HttpCacheConfig struct

+ DefaultCacheControl string

+ DefaultTTL string

+ Exclude *Exclude

+ ForceCacheControl bool

+ Timeouts []Timeout

+ XCache bool

+ XCacheName string

+ type Key struct

+ ClusterName string

+ Host string

+ Path string

+ Query string

+ Scheme string

+ func NewKeyFromRequst(req *http.Request) *Key

+ func (k Key) Hash() uint64

+ func (k Key) String() string

+ type LookupRequest struct

+ Key *Key

+ ReqCacheControl RequestCacheControl

+ Request *http.Request

+ Timestamp time.Time

+ func NewLookupRequest(req *http.Request, timestamp time.Time) *LookupRequest

+ type LookupResult struct

+ Status EntryStatus

+ func (r *LookupResult) Header() http.Header

+ func (r *LookupResult) Response() *http.Response

+ func (r *LookupResult) UpdateHeader(header http.Header)

+ type RequestCacheControl struct

+ MaxAge time.Duration

+ MaxStale time.Duration

+ MinFresh time.Duration

+ MustValidate bool

+ NoStore bool

+ NoTransform bool

+ OnlyIfCached bool

+ func ParseRequestCacheControl(header string) RequestCacheControl

+ func (cc *RequestCacheControl) SetDefaults()

+ type RequestHeaderMap = map[string]string

+ type ResponseCacheControl struct

+ IsPublic bool

+ MaxAge time.Duration

+ MustValidate bool

+ NoStale bool

+ NoStore bool

+ NoTransform bool

+ func ParseResponseCacheControl(header string) ResponseCacheControl

+ func (cc *ResponseCacheControl) SetDefaults()

+ type ResponseHeaderMap = map[string]string

+ type Timeout struct

+ Matcher *regexp.Regexp

+ Path string

+ TTL time.Duration