database

Documentation

Index

• Constants
• Variables
• type Batch
  • func NewTableBatch(db Database, prefix string) Batch
• type Database
  • func NewTable(db Database, prefix string) Database
• type Deleter
• type Iterator
• type LDBDatabase
  • func NewLDBDatabase(file string, cache int, handles int, logger log.Log) (*LDBDatabase, error)
  • func (db *LDBDatabase) Close()
  • func (db *LDBDatabase) Delete(key []byte) error
  • func (db LDBDatabase) Find(key []byte) Iterator
  • func (db *LDBDatabase) Get(key []byte) ([]byte, error)
  • func (db *LDBDatabase) Has(key []byte) (bool, error)
  • func (db *LDBDatabase) Iterator() iterator.Iterator
  • func (db *LDBDatabase) LDB() *leveldb.DB
  • func (db *LDBDatabase) Meter(prefix string)
  • func (db *LDBDatabase) NewBatch() Batch
  • func (db *LDBDatabase) NewIterator() iterator.Iterator
  • func (db *LDBDatabase) NewIteratorWithPrefix(prefix []byte) iterator.Iterator
  • func (db *LDBDatabase) Path() string
  • func (db *LDBDatabase) Put(key []byte, value []byte) error
• type MemDatabase
  • func NewMemDatabase() *MemDatabase
  • func NewMemDatabaseWithCap(size int) *MemDatabase
  • func (db *MemDatabase) Close()
  • func (db *MemDatabase) Delete(key []byte) error
  • func (db *MemDatabase) Find(key []byte) Iterator
  • func (db *MemDatabase) Get(key []byte) ([]byte, error)
  • func (db *MemDatabase) Has(key []byte) (bool, error)
  • func (db *MemDatabase) Iterator() Iterator
  • func (db *MemDatabase) Keys() [][]byte
  • func (db *MemDatabase) Len() int
  • func (db *MemDatabase) NewBatch() Batch
  • func (db *MemDatabase) NewMemDatabaseIterator() *MemDatabaseIterator
  • func (db *MemDatabase) Put(key []byte, value []byte) error
• type MemDatabaseIterator
  • func (iter *MemDatabaseIterator) Error() error
  • func (iter *MemDatabaseIterator) First() bool
  • func (iter *MemDatabaseIterator) Key() []byte
  • func (iter *MemDatabaseIterator) Last() bool
  • func (iter *MemDatabaseIterator) Next() bool
  • func (iter *MemDatabaseIterator) Prev() bool
  • func (iter *MemDatabaseIterator) Release()
  • func (iter *MemDatabaseIterator) Seek(key []byte) bool
  • func (iter *MemDatabaseIterator) Value() []byte
• type Putter

Constants

const IdealBatchSize = 100 * 1024

Code using batches should try to add this much data to the batch. The value was determined empirically.

Variables

var ErrNotFound = errors.ErrNotFound

var OpenFileLimit = 64

Types

type Batch

type Batch interface {
	Putter
	Deleter
	ValueSize() int // amount of data in the batch
	Write() error
	// Reset resets the batch for reuse
	Reset()
}

Batch is a write-only database that commits changes to its host database when Write is called. Batch cannot be used concurrently.

func NewTableBatch

func NewTableBatch(db Database, prefix string) Batch

NewTableBatch returns a Batch object which prefixes all keys with a given string.

type Database

type Database interface {
	Putter
	Deleter
	Get(key []byte) ([]byte, error)
	Has(key []byte) (bool, error)
	Close()
	NewBatch() Batch
	Find(key []byte) Iterator
}

Database wraps all database operations. All methods are safe for concurrent use.

func NewTable

func NewTable(db Database, prefix string) Database

NewTable returns a Database object that prefixes all keys with a given string.

type Deleter

type Deleter interface {
	Delete(key []byte) error
}

Deleter wraps the database delete operation supported by both batches and regular databases.

type Iterator

type Iterator interface {
	iterator.IteratorSeeker
	Key() []byte
	Value() []byte
}

type LDBDatabase

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

func NewLDBDatabase

func NewLDBDatabase(file string, cache int, handles int, logger log.Log) (*LDBDatabase, error)

NewLDBDatabase returns a LevelDB wrapped object.

func (*LDBDatabase) Close

func (db *LDBDatabase) Close()

func (*LDBDatabase) Delete

func (db *LDBDatabase) Delete(key []byte) error

Delete deletes the key from the queue and database

func (LDBDatabase) Find

func (db LDBDatabase) Find(key []byte) Iterator

func (*LDBDatabase) Get

func (db *LDBDatabase) Get(key []byte) ([]byte, error)

Get returns the given key if it's present.

func (*LDBDatabase) Has

func (db *LDBDatabase) Has(key []byte) (bool, error)

func (*LDBDatabase) Iterator

func (db *LDBDatabase) Iterator() iterator.Iterator

func (*LDBDatabase) LDB

func (db *LDBDatabase) LDB() *leveldb.DB

func (*LDBDatabase) Meter

func (db *LDBDatabase) Meter(prefix string)

Meter configures the database metrics collectors and

func (*LDBDatabase) NewBatch

func (db *LDBDatabase) NewBatch() Batch

func (*LDBDatabase) NewIterator

func (db *LDBDatabase) NewIterator() iterator.Iterator

func (*LDBDatabase) NewIteratorWithPrefix

func (db *LDBDatabase) NewIteratorWithPrefix(prefix []byte) iterator.Iterator

NewIteratorWithPrefix returns a iterator to iterate over subset of database content with a particular prefix.

func (*LDBDatabase) Path

func (db *LDBDatabase) Path() string

Path returns the path to the database directory.

func (*LDBDatabase) Put

func (db *LDBDatabase) Put(key []byte, value []byte) error

Put puts the given key / value to the queue

type MemDatabase

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

* This is a test memory database. Do not use for any production it does not get persisted

func NewMemDatabase

func NewMemDatabase() *MemDatabase

func NewMemDatabaseWithCap

func NewMemDatabaseWithCap(size int) *MemDatabase

func (*MemDatabase) Close

func (db *MemDatabase) Close()

func (*MemDatabase) Delete

func (db *MemDatabase) Delete(key []byte) error

func (*MemDatabase) Find

func (db *MemDatabase) Find(key []byte) Iterator

func (*MemDatabase) Get

func (db *MemDatabase) Get(key []byte) ([]byte, error)

func (*MemDatabase) Has

func (db *MemDatabase) Has(key []byte) (bool, error)

func (*MemDatabase) Iterator

func (db *MemDatabase) Iterator() Iterator

func (*MemDatabase) Keys

func (db *MemDatabase) Keys() [][]byte

func (*MemDatabase) Len

func (db *MemDatabase) Len() int

func (*MemDatabase) NewBatch

func (db *MemDatabase) NewBatch() Batch

func (*MemDatabase) NewMemDatabaseIterator

func (db *MemDatabase) NewMemDatabaseIterator() *MemDatabaseIterator

func (*MemDatabase) Put

func (db *MemDatabase) Put(key []byte, value []byte) error

type MemDatabaseIterator

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

func (*MemDatabaseIterator) Error

func (iter *MemDatabaseIterator) Error() error

func (*MemDatabaseIterator) First

func (iter *MemDatabaseIterator) First() bool

func (*MemDatabaseIterator) Key

func (iter *MemDatabaseIterator) Key() []byte

func (*MemDatabaseIterator) Last

func (iter *MemDatabaseIterator) Last() bool

func (*MemDatabaseIterator) Next

func (iter *MemDatabaseIterator) Next() bool

func (*MemDatabaseIterator) Prev

func (iter *MemDatabaseIterator) Prev() bool

func (*MemDatabaseIterator) Release

func (iter *MemDatabaseIterator) Release()

func (*MemDatabaseIterator) Seek

func (iter *MemDatabaseIterator) Seek(key []byte) bool

func (*MemDatabaseIterator) Value

func (iter *MemDatabaseIterator) Value() []byte

type Putter

type Putter interface {
	Put(key []byte, value []byte) error
}

Putter wraps the database write operation supported by both batches and regular databases.