bbolt/transaction.go

110 lines
2.1 KiB
Go

package bolt
import (
"unsafe"
)
var (
InvalidTransactionError = &Error{"txn is invalid", nil}
BucketAlreadyExistsError = &Error{"bucket already exists", nil}
)
const (
ps_modify = 1
ps_rootonly = 2
ps_first = 4
ps_last = 8
)
type txnid uint64
type Transaction struct {
id int
db *DB
meta *meta
sys Bucket
buckets map[string]*Bucket
pages map[pgid]*page
}
// init initializes the transaction and associates it with a database.
func (t *Transaction) init(db *DB, meta *meta) {
t.db = db
t.meta = meta
t.buckets = make(map[string]*Bucket)
t.pages = nil
t.sys.transaction = t
t.sys.bucket = &t.meta.sys
}
func (t *Transaction) Close() error {
// TODO: Close buckets.
return nil
}
func (t *Transaction) DB() *DB {
return t.db
}
// Bucket retrieves a bucket by name.
func (t *Transaction) Bucket(name string) *Bucket {
// Return cached reference if it's already been looked up.
if b := t.buckets[name]; b != nil {
return b
}
// Retrieve bucket data from the system bucket.
value := t.sys.cursor().Get([]byte(name))
if value == nil {
return nil
}
// Create a bucket that overlays the data.
b := &Bucket{
bucket: (*bucket)(unsafe.Pointer(&value[0])),
name: name,
transaction: t,
}
t.buckets[name] = b
return b
}
// Cursor creates a cursor associated with a given bucket.
func (t *Transaction) Cursor(name string) *Cursor {
b := t.Bucket(name)
if b == nil {
return nil
}
return b.Cursor()
}
// Get retrieves the value for a key in a named bucket.
func (t *Transaction) Get(name string, key []byte) []byte {
c := t.Cursor(name)
if c == nil {
return nil
}
return c.Get(key)
}
// Stat returns information about a bucket's internal structure.
func (t *Transaction) Stat(name string) *Stat {
// TODO
return nil
}
// page returns a reference to the page with a given id.
// If page has been written to then a temporary bufferred page is returned.
func (t *Transaction) page(id pgid) *page {
// Check the dirty pages first.
if t.pages != nil {
if p, ok := t.pages[id]; ok {
return p
}
}
// Otherwise return directly from the mmap.
return t.db.page(id)
}