gsession

package
v2.0.0-rc3 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Feb 23, 2022 License: MIT Imports: 19 Imported by: 8

Documentation

Overview

Package gsession implements manager and storage features for sessions.

Index

Constants

View Source 
const (
	DefaultStorageFileCryptoEnabled = false
	DefaultStorageFileLoopInterval  = 10 * time.Second
)
View Source 
const (
	// DefaultStorageRedisLoopInterval is the interval updating TTL for session ids
	// in last duration.
	DefaultStorageRedisLoopInterval = 10 * time.Second
)

Variables

View Source 
var (
	DefaultStorageFilePath      = gfile.Temp("gsessions")
	DefaultStorageFileCryptoKey = []byte("Session storage file crypto key!")
)
View Source 
var (
	// ErrorDisabled is used for marking certain interface function not used.
	ErrorDisabled = gerror.NewOption(gerror.Option{
		Text: "this feature is disabled in this storage",
		Code: gcode.CodeNotSupported,
	})
)

Functions

func NewSessionId 

func NewSessionId() string

NewSessionId creates and returns a new and unique session id string, which is in 36 bytes.

Types

type Manager 

type Manager struct {
	// contains filtered or unexported fields
}

Manager for sessions.

func New 

func New(ttl time.Duration, storage ...Storage) *Manager

New creates and returns a new session manager.

func (*Manager) GetStorage 

func (m *Manager) GetStorage() Storage

GetStorage returns the session storage of current manager.

func (*Manager) New 

func (m *Manager) New(ctx context.Context, sessionId ...string) *Session

New creates or fetches the session for given session id. The parameter `sessionId` is optional, it creates a new one if not it's passed depending on Storage.New.

func (*Manager) SetStorage 

func (m *Manager) SetStorage(storage Storage)

SetStorage sets the session storage for manager.

func (*Manager) SetTTL 

func (m *Manager) SetTTL(ttl time.Duration)

SetTTL the TTL for the session manager.

func (*Manager) TTL 

func (m *Manager) TTL() time.Duration

TTL returns the TTL of the session manager.

func (*Manager) UpdateSessionTTL 

func (m *Manager) UpdateSessionTTL(sessionId string, data *gmap.StrAnyMap)

UpdateSessionTTL updates the ttl for given session.

type Session 

type Session struct {
	// contains filtered or unexported fields
}

Session struct for storing single session data, which is bound to a single request. The Session struct is the interface with user, but the Storage is the underlying adapter designed interface for functionality implements.

func (*Session) Close 

func (s *Session) Close() error

Close closes current session and updates its ttl in the session manager. If this session is dirty, it also exports it to storage.

NOTE that this function must be called ever after a session request done.

func (*Session) Contains 

func (s *Session) Contains(key string) (bool, error)

Contains checks whether key exist in the session.

func (*Session) Data 

func (s *Session) Data() (map[string]interface{}, error)

Data returns all data as map. Note that it's using value copy internally for concurrent-safe purpose.

func (*Session) Get 

func (s *Session) Get(key string, def ...interface{}) (*gvar.Var, error)

Get retrieves session value with given key. It returns `def` if the key does not exist in the session if `def` is given, or else it returns nil.

func (*Session) Id 

func (s *Session) Id() (string, error)

Id returns the session id for this session. It creates and returns a new session id if the session id is not passed in initialization.

func (*Session) IsDirty 

func (s *Session) IsDirty() bool

IsDirty checks whether there's any data changes in the session.

func (*Session) MustContains 

func (s *Session) MustContains(key string) bool

MustContains performs as function Contains, but it panics if any error occurs.

func (*Session) MustData 

func (s *Session) MustData() map[string]interface{}

MustData performs as function Data, but it panics if any error occurs.

func (*Session) MustGet 

func (s *Session) MustGet(key string, def ...interface{}) *gvar.Var

MustGet performs as function Get, but it panics if any error occurs.

func (*Session) MustId 

func (s *Session) MustId() string

MustId performs as function Id, but it panics if any error occurs.

func (*Session) MustRemove 

func (s *Session) MustRemove(keys ...string)

MustRemove performs as function Remove, but it panics if any error occurs.

func (*Session) MustSet 

func (s *Session) MustSet(key string, value interface{})

MustSet performs as function Set, but it panics if any error occurs.

func (*Session) MustSetMap 

func (s *Session) MustSetMap(data map[string]interface{})

MustSetMap performs as function SetMap, but it panics if any error occurs.

func (*Session) MustSize 

func (s *Session) MustSize() int

MustSize performs as function Size, but it panics if any error occurs.

func (*Session) Remove 

func (s *Session) Remove(keys ...string) error

Remove removes key along with its value from this session.

func (*Session) RemoveAll 

func (s *Session) RemoveAll() error

RemoveAll deletes all key-value pairs from this session.

func (*Session) Set 

func (s *Session) Set(key string, value interface{}) error

Set sets key-value pair to this session.

func (*Session) SetId 

func (s *Session) SetId(id string) error

SetId sets custom session before session starts. It returns error if it is called after session starts.

func (*Session) SetIdFunc 

func (s *Session) SetIdFunc(f func(ttl time.Duration) string) error

SetIdFunc sets custom session id creating function before session starts. It returns error if it is called after session starts.

func (*Session) SetMap 

func (s *Session) SetMap(data map[string]interface{}) error

SetMap batch sets the session using map.

func (*Session) Size 

func (s *Session) Size() (int, error)

Size returns the size of the session.

type Storage 

type Storage interface {
	// New creates a custom session id.
	// This function can be used for custom session creation.
	New(ctx context.Context, ttl time.Duration) (id string, err error)

	// Get retrieves and returns session value with given key.
	// It returns nil if the key does not exist in the session.
	Get(ctx context.Context, id string, key string) (value interface{}, err error)

	// GetSize retrieves and returns the size of key-value pairs from storage.
	GetSize(ctx context.Context, id string) (size int, err error)

	// Data retrieves all key-value pairs as map from storage.
	Data(ctx context.Context, id string) (data map[string]interface{}, err error)

	// Set sets one key-value session pair to the storage.
	// The parameter `ttl` specifies the TTL for the session id.
	Set(ctx context.Context, id string, key string, value interface{}, ttl time.Duration) error

	// SetMap batch sets key-value session pairs as map to the storage.
	// The parameter `ttl` specifies the TTL for the session id.
	SetMap(ctx context.Context, id string, data map[string]interface{}, ttl time.Duration) error

	// Remove deletes key with its value from storage.
	Remove(ctx context.Context, id string, key string) error

	// RemoveAll deletes all key-value pairs from storage.
	RemoveAll(ctx context.Context, id string) error

	// GetSession returns the session data as `*gmap.StrAnyMap` for given session id from storage.
	//
	// The parameter `ttl` specifies the TTL for this session.
	// The parameter `data` is the current old session data stored in memory,
	// and for some storage it might be nil if memory storage is disabled.
	//
	// This function is called ever when session starts. It returns nil if the TTL is exceeded.
	GetSession(ctx context.Context, id string, ttl time.Duration, data *gmap.StrAnyMap) (*gmap.StrAnyMap, error)

	// SetSession updates the data for specified session id.
	// This function is called ever after session, which is changed dirty, is closed.
	// This copy all session data map from memory to storage.
	SetSession(ctx context.Context, id string, data *gmap.StrAnyMap, ttl time.Duration) error

	// UpdateTTL updates the TTL for specified session id.
	// This function is called ever after session, which is not dirty, is closed.
	UpdateTTL(ctx context.Context, id string, ttl time.Duration) error
}

Storage is the interface definition for session storage.

type StorageFile 

type StorageFile struct {
	// contains filtered or unexported fields
}

StorageFile implements the Session Storage interface with file system.

func NewStorageFile 

func NewStorageFile(path ...string) *StorageFile

NewStorageFile creates and returns a file storage object for session.

func (*StorageFile) Data 

func (s *StorageFile) Data(ctx context.Context, id string) (data map[string]interface{}, err error)

Data retrieves all key-value pairs as map from storage.

func (*StorageFile) Get 

func (s *StorageFile) Get(ctx context.Context, id string, key string) (value interface{}, err error)

Get retrieves session value with given key. It returns nil if the key does not exist in the session.

func (*StorageFile) GetSession 

func (s *StorageFile) GetSession(ctx context.Context, id string, ttl time.Duration, data *gmap.StrAnyMap) (*gmap.StrAnyMap, error)

GetSession returns the session data as *gmap.StrAnyMap for given session id from storage.

The parameter `ttl` specifies the TTL for this session, and it returns nil if the TTL is exceeded. The parameter `data` is the current old session data stored in memory, and for some storage it might be nil if memory storage is disabled.

This function is called ever when session starts.

func (*StorageFile) GetSize 

func (s *StorageFile) GetSize(ctx context.Context, id string) (size int, err error)

GetSize retrieves the size of key-value pairs from storage.

func (*StorageFile) New 

func (s *StorageFile) New(ctx context.Context, ttl time.Duration) (id string, err error)

New creates a session id. This function can be used for custom session creation.

func (*StorageFile) Remove 

func (s *StorageFile) Remove(ctx context.Context, id string, key string) error

Remove deletes key with its value from storage.

func (*StorageFile) RemoveAll 

func (s *StorageFile) RemoveAll(ctx context.Context, id string) error

RemoveAll deletes all key-value pairs from storage.

func (*StorageFile) Set 

func (s *StorageFile) Set(ctx context.Context, id string, key string, value interface{}, ttl time.Duration) error

Set sets key-value session pair to the storage. The parameter `ttl` specifies the TTL for the session id (not for the key-value pair).

func (*StorageFile) SetCryptoEnabled 

func (s *StorageFile) SetCryptoEnabled(enabled bool)

SetCryptoEnabled enables/disables the crypto feature for session storage.

func (*StorageFile) SetCryptoKey 

func (s *StorageFile) SetCryptoKey(key []byte)

SetCryptoKey sets the crypto key for session storage. The crypto key is used when crypto feature is enabled.

func (*StorageFile) SetMap 

func (s *StorageFile) SetMap(ctx context.Context, id string, data map[string]interface{}, ttl time.Duration) error

SetMap batch sets key-value session pairs with map to the storage. The parameter `ttl` specifies the TTL for the session id(not for the key-value pair).

func (*StorageFile) SetSession 

func (s *StorageFile) SetSession(ctx context.Context, id string, data *gmap.StrAnyMap, ttl time.Duration) error

SetSession updates the data map for specified session id. This function is called ever after session, which is changed dirty, is closed. This copy all session data map from memory to storage.

func (*StorageFile) UpdateTTL 

func (s *StorageFile) UpdateTTL(ctx context.Context, id string, ttl time.Duration) error

UpdateTTL updates the TTL for specified session id. This function is called ever after session, which is not dirty, is closed. It just adds the session id to the async handling queue.

type StorageMemory 

type StorageMemory struct{}

StorageMemory implements the Session Storage interface with memory.

func NewStorageMemory 

func NewStorageMemory() *StorageMemory

NewStorageMemory creates and returns a file storage object for session.

func (*StorageMemory) Data 

func (s *StorageMemory) Data(ctx context.Context, id string) (data map[string]interface{}, err error)

GetMap retrieves all key-value pairs as map from storage.

func (*StorageMemory) Get 

func (s *StorageMemory) Get(ctx context.Context, id string, key string) (value interface{}, err error)

Get retrieves session value with given key. It returns nil if the key does not exist in the session.

func (*StorageMemory) GetSession 

func (s *StorageMemory) GetSession(ctx context.Context, id string, ttl time.Duration, data *gmap.StrAnyMap) (*gmap.StrAnyMap, error)

GetSession returns the session data as *gmap.StrAnyMap for given session id from storage.

The parameter `ttl` specifies the TTL for this session, and it returns nil if the TTL is exceeded. The parameter `data` is the current old session data stored in memory, and for some storage it might be nil if memory storage is disabled.

This function is called ever when session starts.

func (*StorageMemory) GetSize 

func (s *StorageMemory) GetSize(ctx context.Context, id string) (size int, err error)

GetSize retrieves the size of key-value pairs from storage.

func (*StorageMemory) New 

func (s *StorageMemory) New(ctx context.Context, ttl time.Duration) (id string, err error)

New creates a session id. This function can be used for custom session creation.

func (*StorageMemory) Remove 

func (s *StorageMemory) Remove(ctx context.Context, id string, key string) error

Remove deletes key with its value from storage.

func (*StorageMemory) RemoveAll 

func (s *StorageMemory) RemoveAll(ctx context.Context, id string) error

RemoveAll deletes all key-value pairs from storage.

func (*StorageMemory) Set 

func (s *StorageMemory) Set(ctx context.Context, id string, key string, value interface{}, ttl time.Duration) error

Set sets key-value session pair to the storage. The parameter `ttl` specifies the TTL for the session id (not for the key-value pair).

func (*StorageMemory) SetMap 

func (s *StorageMemory) SetMap(ctx context.Context, id string, data map[string]interface{}, ttl time.Duration) error

SetMap batch sets key-value session pairs with map to the storage. The parameter `ttl` specifies the TTL for the session id(not for the key-value pair).

func (*StorageMemory) SetSession 

func (s *StorageMemory) SetSession(ctx context.Context, id string, data *gmap.StrAnyMap, ttl time.Duration) error

SetSession updates the data map for specified session id. This function is called ever after session, which is changed dirty, is closed. This copy all session data map from memory to storage.

func (*StorageMemory) UpdateTTL 

func (s *StorageMemory) UpdateTTL(ctx context.Context, id string, ttl time.Duration) error

UpdateTTL updates the TTL for specified session id. This function is called ever after session, which is not dirty, is closed. It just adds the session id to the async handling queue.

type StorageRedis 

type StorageRedis struct {
	// contains filtered or unexported fields
}

StorageRedis implements the Session Storage interface with redis.

func NewStorageRedis 

func NewStorageRedis(redis *gredis.Redis, prefix ...string) *StorageRedis

NewStorageRedis creates and returns a redis storage object for session.

func (*StorageRedis) Data 

func (s *StorageRedis) Data(ctx context.Context, id string) (data map[string]interface{}, err error)

Data retrieves all key-value pairs as map from storage.

func (*StorageRedis) Get 

func (s *StorageRedis) Get(ctx context.Context, id string, key string) (value interface{}, err error)

Get retrieves session value with given key. It returns nil if the key does not exist in the session.

func (*StorageRedis) GetSession 

func (s *StorageRedis) GetSession(ctx context.Context, id string, ttl time.Duration, data *gmap.StrAnyMap) (*gmap.StrAnyMap, error)

GetSession returns the session data as *gmap.StrAnyMap for given session id from storage.

The parameter `ttl` specifies the TTL for this session, and it returns nil if the TTL is exceeded. The parameter `data` is the current old session data stored in memory, and for some storage it might be nil if memory storage is disabled.

This function is called ever when session starts.

func (*StorageRedis) GetSize 

func (s *StorageRedis) GetSize(ctx context.Context, id string) (size int, err error)

GetSize retrieves the size of key-value pairs from storage.

func (*StorageRedis) New 

func (s *StorageRedis) New(ctx context.Context, ttl time.Duration) (id string, err error)

New creates a session id. This function can be used for custom session creation.

func (*StorageRedis) Remove 

func (s *StorageRedis) Remove(ctx context.Context, id string, key string) error

Remove deletes key with its value from storage.

func (*StorageRedis) RemoveAll 

func (s *StorageRedis) RemoveAll(ctx context.Context, id string) error

RemoveAll deletes all key-value pairs from storage.

func (*StorageRedis) Set 

func (s *StorageRedis) Set(ctx context.Context, id string, key string, value interface{}, ttl time.Duration) error

Set sets key-value session pair to the storage. The parameter `ttl` specifies the TTL for the session id (not for the key-value pair).

func (*StorageRedis) SetMap 

func (s *StorageRedis) SetMap(ctx context.Context, id string, data map[string]interface{}, ttl time.Duration) error

SetMap batch sets key-value session pairs with map to the storage. The parameter `ttl` specifies the TTL for the session id(not for the key-value pair).

func (*StorageRedis) SetSession 

func (s *StorageRedis) SetSession(ctx context.Context, id string, data *gmap.StrAnyMap, ttl time.Duration) error

SetSession updates the data map for specified session id. This function is called ever after session, which is changed dirty, is closed. This copy all session data map from memory to storage.

func (*StorageRedis) UpdateTTL 

func (s *StorageRedis) UpdateTTL(ctx context.Context, id string, ttl time.Duration) error

UpdateTTL updates the TTL for specified session id. This function is called ever after session, which is not dirty, is closed. It just adds the session id to the async handling queue.

type StorageRedisHashTable 

type StorageRedisHashTable struct {
	// contains filtered or unexported fields
}

StorageRedisHashTable implements the Session Storage interface with redis hash table.

func NewStorageRedisHashTable 

func NewStorageRedisHashTable(redis *gredis.Redis, prefix ...string) *StorageRedisHashTable

NewStorageRedisHashTable creates and returns a redis hash table storage object for session.

func (*StorageRedisHashTable) Data 

func (s *StorageRedisHashTable) Data(ctx context.Context, id string) (data map[string]interface{}, err error)

Data retrieves all key-value pairs as map from storage.

func (*StorageRedisHashTable) Get 

func (s *StorageRedisHashTable) Get(ctx context.Context, id string, key string) (value interface{}, err error)

Get retrieves session value with given key. It returns nil if the key does not exist in the session.

func (*StorageRedisHashTable) GetSession 

func (s *StorageRedisHashTable) GetSession(ctx context.Context, id string, ttl time.Duration, data *gmap.StrAnyMap) (*gmap.StrAnyMap, error)

GetSession returns the session data as *gmap.StrAnyMap for given session id from storage.

The parameter `ttl` specifies the TTL for this session, and it returns nil if the TTL is exceeded. The parameter `data` is the current old session data stored in memory, and for some storage it might be nil if memory storage is disabled.

This function is called ever when session starts.

func (*StorageRedisHashTable) GetSize 

func (s *StorageRedisHashTable) GetSize(ctx context.Context, id string) (size int, err error)

GetSize retrieves the size of key-value pairs from storage.

func (*StorageRedisHashTable) New 

func (s *StorageRedisHashTable) New(ctx context.Context, ttl time.Duration) (id string, err error)

New creates a session id. This function can be used for custom session creation.

func (*StorageRedisHashTable) Remove 

func (s *StorageRedisHashTable) Remove(ctx context.Context, id string, key string) error

Remove deletes key with its value from storage.

func (*StorageRedisHashTable) RemoveAll 

func (s *StorageRedisHashTable) RemoveAll(ctx context.Context, id string) error

RemoveAll deletes all key-value pairs from storage.

func (*StorageRedisHashTable) Set 

func (s *StorageRedisHashTable) Set(ctx context.Context, id string, key string, value interface{}, ttl time.Duration) error

Set sets key-value session pair to the storage. The parameter `ttl` specifies the TTL for the session id (not for the key-value pair).

func (*StorageRedisHashTable) SetMap 

func (s *StorageRedisHashTable) SetMap(ctx context.Context, id string, data map[string]interface{}, ttl time.Duration) error

SetMap batch sets key-value session pairs with map to the storage. The parameter `ttl` specifies the TTL for the session id(not for the key-value pair).

func (*StorageRedisHashTable) SetSession 

func (s *StorageRedisHashTable) SetSession(ctx context.Context, id string, data *gmap.StrAnyMap, ttl time.Duration) error

SetSession updates the data map for specified session id. This function is called ever after session, which is changed dirty, is closed. This copy all session data map from memory to storage.

func (*StorageRedisHashTable) UpdateTTL 

func (s *StorageRedisHashTable) UpdateTTL(ctx context.Context, id string, ttl time.Duration) error

UpdateTTL updates the TTL for specified session id. This function is called ever after session, which is not dirty, is closed. It just adds the session id to the async handling queue.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.