mirror of
https://github.com/mainflux/mainflux.git
synced 2025-05-01 13:48:56 +08:00

* Move Things and Users to Clients Signed-off-by: dusanb94 <dusan.borovcanin@mainflux.com> Signed-off-by: rodneyosodo <blackd0t@protonmail.com> Signed-off-by: dusanb94 <dusan.borovcanin@mainflux.com> * NOISSUE - Update Add and Delete Policies (#1792) * Remove Policy Action Ranks Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix Rebase Issues Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix CI Test Errors Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Adding Check on Subject For Clients Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Remove Check Client Exists Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Check When Sharing Clients Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Only Add User to Group When Sharing Things Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Remove clientType Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Minor Fix on ShareClient and Fix Tests Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix Policies Tests Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Clean Up Things Authorization Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix Tests on RetrieveAll Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Test ShareThing Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix Merge Conflicts Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Remove Adding Policies. Only Use Ownership Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Check If Subject is same as Object Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Move Back To Union As Sometimes Policy is Empty and Fails to Evaluate on Ownership Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix Entity Type For Failing Tests Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix BUG in policy evaluation Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix Tests Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Add Comments Regarding checkAdmin Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix Tests On Rebase Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Combine Authorize For Things and Users Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix Tests On Rebase Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Error on Things SVC `unsupported protocol scheme` Signed-off-by: rodneyosodo <blackd0t@protonmail.com> --------- Signed-off-by: rodneyosodo <blackd0t@protonmail.com> Signed-off-by: dusanb94 <dusan.borovcanin@mainflux.com> * Fix Bug on Things Authorization Cache (#1810) Signed-off-by: rodneyosodo <blackd0t@protonmail.com> Signed-off-by: dusanb94 <dusan.borovcanin@mainflux.com> * Use Password instead of username in MQTT handler Signed-off-by: dusanb94 <dusan.borovcanin@mainflux.com> * Simplify MQTT authorization Signed-off-by: dusanb94 <dusan.borovcanin@mainflux.com> * Fix MQTT tests Signed-off-by: dusanb94 <dusan.borovcanin@mainflux.com> * NOISSUE - Add More Functions to SDK (#1811) * Add More Functions to SDK Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Add Examples to GoDoc Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Update Unassign Interface Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Pass Subject as ID and Not Token on List Channels By Thing Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix Bootstrap Errors For Element Check Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Add empty line Before Return Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Reorder URLS in things mux Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix Listing Things Policies Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix Share Thing Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Add Examples to CLI Docs Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix Update Identity To Update Another User Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix Identify an Update Policies on Things Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix Update Things Policies Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix GoDocs on Disconnect Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix Tests Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Change Authorize To Use AccessRequest Signed-off-by: rodneyosodo <blackd0t@protonmail.com> --------- Signed-off-by: rodneyosodo <blackd0t@protonmail.com> Signed-off-by: dusanb94 <dusan.borovcanin@mainflux.com> * For Evaluate Policy Use AccessRequest (#1814) Signed-off-by: rodneyosodo <blackd0t@protonmail.com> Signed-off-by: dusanb94 <dusan.borovcanin@mainflux.com> * NOISSUE - Add SDK Tests (#1812) * Add Things Tests Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Add Channel Tests Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Add Certs Tests Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Add Consumer Tests Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Enrich Group Tests Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Add Tests For Health Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Add Tests For Tokens Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Rename SDK for Tests Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Add Policies Tests Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix Linter Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Fix Tests Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Make Variable Defination Inline Signed-off-by: rodneyosodo <blackd0t@protonmail.com> --------- Signed-off-by: rodneyosodo <blackd0t@protonmail.com> Signed-off-by: dusanb94 <dusan.borovcanin@mainflux.com> * NOISSUE - Make Cache Key Duration Configurable (#1815) * Make Cache Key Duration Configurable Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Rename ENV Var Signed-off-by: rodneyosodo <blackd0t@protonmail.com> --------- Signed-off-by: rodneyosodo <blackd0t@protonmail.com> Signed-off-by: dusanb94 <dusan.borovcanin@mainflux.com> * NOISSUE - Update GoDocs (#1816) * Add GoDocs Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Add Missing GoDoc Files Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Enable godot Signed-off-by: rodneyosodo <blackd0t@protonmail.com> * Add License Information Signed-off-by: rodneyosodo <blackd0t@protonmail.com> --------- Signed-off-by: rodneyosodo <blackd0t@protonmail.com> Signed-off-by: dusanb94 <dusan.borovcanin@mainflux.com> * NOISSUE - Add Call Home Client to Mainflux services (#1751) * Move Things and Users to Clients Signed-off-by: dusanb94 <dusan.borovcanin@mainflux.com> Signed-off-by: rodneyosodo <blackd0t@protonmail.com> Signed-off-by: SammyOina <sammyoina@gmail.com> * collect and send data package Signed-off-by: SammyOina <sammyoina@gmail.com> * create telemetry migrations Signed-off-by: SammyOina <sammyoina@gmail.com> * add telemetry endpoints Signed-off-by: SammyOina <sammyoina@gmail.com> * add transport Signed-off-by: SammyOina <sammyoina@gmail.com> * create service Signed-off-by: SammyOina <sammyoina@gmail.com> * remove homing server Signed-off-by: SammyOina <sammyoina@gmail.com> * add call home to adapters Signed-off-by: SammyOina <sammyoina@gmail.com> * add last seen Signed-off-by: SammyOina <sammyoina@gmail.com> * rename logger Signed-off-by: SammyOina <sammyoina@gmail.com> * remove homing client Signed-off-by: SammyOina <sammyoina@gmail.com> * use unmerged repo Signed-off-by: SammyOina <sammyoina@gmail.com> * use renamed module Signed-off-by: SammyOina <sammyoina@gmail.com> * update call home version Signed-off-by: SammyOina <sammyoina@gmail.com> * edit documentation Signed-off-by: SammyOina <sammyoina@gmail.com> * align table Signed-off-by: SammyOina <sammyoina@gmail.com> * use alias for call home client Signed-off-by: SammyOina <sammyoina@gmail.com> * update callhome Signed-off-by: SammyOina <sammyoina@gmail.com> * update call home pkg Signed-off-by: SammyOina <sammyoina@gmail.com> * update call home Signed-off-by: SammyOina <sammyoina@gmail.com> * fix modules Signed-off-by: SammyOina <sammyoina@gmail.com> * use mf build version Signed-off-by: SammyOina <sammyoina@gmail.com> * use mf build version Signed-off-by: SammyOina <sammyoina@gmail.com> * restore default Signed-off-by: SammyOina <sammyoina@gmail.com> * add call home for users and things Signed-off-by: SammyOina <sammyoina@gmail.com> * enable opting on call home Signed-off-by: SammyOina <sammyoina@gmail.com> * remove full stops Signed-off-by: SammyOina <sammyoina@gmail.com> * update callhome client Signed-off-by: SammyOina <sammyoina@gmail.com> * add call home to all services Signed-off-by: SammyOina <sammyoina@gmail.com> * fix build Signed-off-by: SammyOina <sammyoina@gmail.com> * restore sdk tests Signed-off-by: SammyOina <sammyoina@gmail.com> * remove unnecessary changes Signed-off-by: SammyOina <sammyoina@gmail.com> * restore health_test.go Signed-off-by: SammyOina <sammyoina@gmail.com> --------- Signed-off-by: dusanb94 <dusan.borovcanin@mainflux.com> Signed-off-by: rodneyosodo <blackd0t@protonmail.com> Signed-off-by: SammyOina <sammyoina@gmail.com> Co-authored-by: b1ackd0t <blackd0t@protonmail.com> Signed-off-by: dusanb94 <dusan.borovcanin@mainflux.com> --------- Signed-off-by: dusanb94 <dusan.borovcanin@mainflux.com> Signed-off-by: rodneyosodo <blackd0t@protonmail.com> Signed-off-by: SammyOina <sammyoina@gmail.com> Co-authored-by: b1ackd0t <blackd0t@protonmail.com> Co-authored-by: Sammy Kerata Oina <44265300+SammyOina@users.noreply.github.com>
173 lines
5.0 KiB
Go
173 lines
5.0 KiB
Go
package httprc
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"net/http"
|
|
"sync"
|
|
"time"
|
|
)
|
|
|
|
// ErrSink is an abstraction that allows users to consume errors
|
|
// produced while the cache queue is running.
|
|
type HTTPClient interface {
|
|
Get(string) (*http.Response, error)
|
|
}
|
|
|
|
// Cache represents a cache that stores resources locally, while
|
|
// periodically refreshing the contents based on HTTP header values
|
|
// and/or user-supplied hints.
|
|
//
|
|
// Refresh is performed _periodically_, and therefore the contents
|
|
// are not kept up-to-date in real time. The interval between checks
|
|
// for refreshes is called the refresh window.
|
|
//
|
|
// The default refresh window is 15 minutes. This means that if a
|
|
// resource is fetched is at time T, and it is supposed to be
|
|
// refreshed in 20 minutes, the next refresh for this resource will
|
|
// happen at T+30 minutes (15+15 minutes).
|
|
type Cache struct {
|
|
mu sync.RWMutex
|
|
queue *queue
|
|
wl Whitelist
|
|
}
|
|
|
|
const defaultRefreshWindow = 15 * time.Minute
|
|
|
|
// New creates a new Cache object.
|
|
//
|
|
// The context object in the argument controls the life-cycle of the
|
|
// auto-refresh worker. If you cancel the `ctx`, then the automatic
|
|
// refresh will stop working.
|
|
//
|
|
// Refresh will only be performed periodically where the interval between
|
|
// refreshes are controlled by the `refresh window` variable. For example,
|
|
// if the refresh window is every 5 minutes and the resource was queued
|
|
// to be refreshed at 7 minutes, the resource will be refreshed after 10
|
|
// minutes (in 2 refresh window time).
|
|
//
|
|
// The refresh window can be configured by using `httprc.WithRefreshWindow`
|
|
// option. If you want refreshes to be performed more often, provide a smaller
|
|
// refresh window. If you specify a refresh window that is smaller than 1
|
|
// second, it will automatically be set to the default value, which is 15
|
|
// minutes.
|
|
//
|
|
// Internally the HTTP fetching is done using a pool of HTTP fetch
|
|
// workers. The default number of workers is 3. You may change this
|
|
// number by specifying the `httprc.WithFetcherWorkerCount`
|
|
func NewCache(ctx context.Context, options ...CacheOption) *Cache {
|
|
var refreshWindow time.Duration
|
|
var errSink ErrSink
|
|
var wl Whitelist
|
|
var fetcherOptions []FetcherOption
|
|
for _, option := range options {
|
|
//nolint:forcetypeassert
|
|
switch option.Ident() {
|
|
case identRefreshWindow{}:
|
|
refreshWindow = option.Value().(time.Duration)
|
|
case identFetcherWorkerCount{}, identWhitelist{}:
|
|
fetcherOptions = append(fetcherOptions, option)
|
|
case identErrSink{}:
|
|
errSink = option.Value().(ErrSink)
|
|
}
|
|
}
|
|
|
|
if refreshWindow < time.Second {
|
|
refreshWindow = defaultRefreshWindow
|
|
}
|
|
|
|
fetch := NewFetcher(ctx, fetcherOptions...)
|
|
queue := newQueue(ctx, refreshWindow, fetch, errSink)
|
|
|
|
return &Cache{
|
|
queue: queue,
|
|
wl: wl,
|
|
}
|
|
}
|
|
|
|
// Register configures a URL to be stored in the cache.
|
|
//
|
|
// For any given URL, the URL must be registered _BEFORE_ it is
|
|
// accessed using `Get()` method.
|
|
func (c *Cache) Register(u string, options ...RegisterOption) error {
|
|
c.mu.Lock()
|
|
defer c.mu.Unlock()
|
|
|
|
if wl := c.wl; wl != nil {
|
|
if !wl.IsAllowed(u) {
|
|
return fmt.Errorf(`httprc.Cache: url %q has been rejected by whitelist`, u)
|
|
}
|
|
}
|
|
|
|
return c.queue.Register(u, options...)
|
|
}
|
|
|
|
// Unregister removes the given URL `u` from the cache.
|
|
//
|
|
// Subsequent calls to `Get()` will fail until `u` is registered again.
|
|
func (c *Cache) Unregister(u string) error {
|
|
c.mu.Lock()
|
|
defer c.mu.Unlock()
|
|
return c.queue.Unregister(u)
|
|
}
|
|
|
|
// IsRegistered returns true if the given URL `u` has already been
|
|
// registered in the cache.
|
|
func (c *Cache) IsRegistered(u string) bool {
|
|
c.mu.RLock()
|
|
defer c.mu.RUnlock()
|
|
return c.queue.IsRegistered(u)
|
|
}
|
|
|
|
// Refresh is identical to Get(), except it always fetches the
|
|
// specified resource anew, and updates the cached content
|
|
func (c *Cache) Refresh(ctx context.Context, u string) (interface{}, error) {
|
|
return c.getOrFetch(ctx, u, true)
|
|
}
|
|
|
|
// Get returns the cached object.
|
|
//
|
|
// The context.Context argument is used to control the timeout for
|
|
// synchronous fetches, when they need to happen. Synchronous fetches
|
|
// will be performed when the cache does not contain the specified
|
|
// resource.
|
|
func (c *Cache) Get(ctx context.Context, u string) (interface{}, error) {
|
|
return c.getOrFetch(ctx, u, false)
|
|
}
|
|
|
|
func (c *Cache) getOrFetch(ctx context.Context, u string, forceRefresh bool) (interface{}, error) {
|
|
c.mu.RLock()
|
|
e, ok := c.queue.getRegistered(u)
|
|
if !ok {
|
|
c.mu.RUnlock()
|
|
return nil, fmt.Errorf(`url %q is not registered (did you make sure to call Register() first?)`, u)
|
|
}
|
|
c.mu.RUnlock()
|
|
|
|
// Only one goroutine may enter this section.
|
|
e.acquireSem()
|
|
|
|
// has this entry been fetched? (but ignore and do a fetch
|
|
// if forceRefresh is true)
|
|
if forceRefresh || !e.hasBeenFetched() {
|
|
if err := c.queue.fetchAndStore(ctx, e); err != nil {
|
|
e.releaseSem()
|
|
return nil, fmt.Errorf(`failed to fetch %q: %w`, u, err)
|
|
}
|
|
}
|
|
|
|
e.releaseSem()
|
|
|
|
e.mu.RLock()
|
|
data := e.data
|
|
e.mu.RUnlock()
|
|
|
|
return data, nil
|
|
}
|
|
|
|
func (c *Cache) Snapshot() *Snapshot {
|
|
c.mu.RLock()
|
|
defer c.mu.RUnlock()
|
|
return c.queue.snapshot()
|
|
}
|