76 lines
2.4 KiB
Go
76 lines
2.4 KiB
Go
// Copyright (c) Mainflux
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
|
|
package things
|
|
|
|
import (
|
|
"context"
|
|
)
|
|
|
|
// Metadata to be used for mainflux thing or channel for customized
|
|
// describing of particular thing or channel.
|
|
type Metadata map[string]interface{}
|
|
|
|
// Thing represents a Mainflux thing. Each thing is owned by one user, and
|
|
// it is assigned with the unique identifier and (temporary) access key.
|
|
type Thing struct {
|
|
ID string
|
|
Owner string
|
|
Name string
|
|
Key string
|
|
Metadata Metadata
|
|
}
|
|
|
|
// ThingsPage contains page related metadata as well as list of things that
|
|
// belong to this page.
|
|
type ThingsPage struct {
|
|
PageMetadata
|
|
Things []Thing
|
|
}
|
|
|
|
// ThingRepository specifies a thing persistence API.
|
|
type ThingRepository interface {
|
|
// Save persists multiple things. Things are saved using a transaction. If one thing
|
|
// fails then none will be saved. Successful operation is indicated by non-nil
|
|
// error response.
|
|
Save(context.Context, ...Thing) ([]Thing, error)
|
|
|
|
// Update performs an update to the existing thing. A non-nil error is
|
|
// returned to indicate operation failure.
|
|
Update(context.Context, Thing) error
|
|
|
|
// UpdateKey updates key value of the existing thing. A non-nil error is
|
|
// returned to indicate operation failure.
|
|
UpdateKey(context.Context, string, string, string) error
|
|
|
|
// RetrieveByID retrieves the thing having the provided identifier, that is owned
|
|
// by the specified user.
|
|
RetrieveByID(context.Context, string, string) (Thing, error)
|
|
|
|
// RetrieveByKey returns thing ID for given thing key.
|
|
RetrieveByKey(context.Context, string) (string, error)
|
|
|
|
// RetrieveAll retrieves the subset of things owned by the specified user.
|
|
RetrieveAll(context.Context, string, uint64, uint64, string, Metadata) (ThingsPage, error)
|
|
|
|
// RetrieveByChannel retrieves the subset of things owned by the specified
|
|
// user and connected to specified channel.
|
|
RetrieveByChannel(context.Context, string, string, uint64, uint64) (ThingsPage, error)
|
|
|
|
// Remove removes the thing having the provided identifier, that is owned
|
|
// by the specified user.
|
|
Remove(context.Context, string, string) error
|
|
}
|
|
|
|
// ThingCache contains thing caching interface.
|
|
type ThingCache interface {
|
|
// Save stores pair thing key, thing id.
|
|
Save(context.Context, string, string) error
|
|
|
|
// ID returns thing ID for given key.
|
|
ID(context.Context, string) (string, error)
|
|
|
|
// Removes thing from cache.
|
|
Remove(context.Context, string) error
|
|
}
|