kern/v4/lev2/kstore_kv_std/rec_meta/rec_meta.go

// package rec_meta -- мета-информация записи KV-хранилища.
package rec_meta

import (
	"gitp78su.ipnodns.ru/svi/kern/v4/lev0/alias"
	"gitp78su.ipnodns.ru/svi/kern/v4/lev0/helpers"
	"gitp78su.ipnodns.ru/svi/kern/v4/lev0/ktypes"
	"gitp78su.ipnodns.ru/svi/kern/v4/lev0/voc"
)

var (
	hassert = helpers.Hassert
)

// RecMeta -- мета-информация записи KV-хранилища.
//
// Вся информация о записи хранится в JSON-строке, без форматирования
// для того, что можно было файл индексов бакета писать построчно.
// Даже если ключ содержит пробелы или экранированное форматирование
// JSON их экранирует внутри.
type RecMeta struct {
	Key_       *alias.AStoreKey `json:"key"`       // Ключ
	Vers_      int64            `json:"vers"`      // Версия записи
	Operation_ string           `json:"operation"` // Тип операции над записью
	createdAt_ ktypes.ITime     `voc:"created_at"` // Дата создания записи
	updateAt_  ktypes.ITimeMut  `voc:"update_at"`  // Дата последнего обновления

	// Хеш мета-информации записи (вместе с значением, но без этого поля разумеется)
	Sha_    string `json:"sha"`
	Offset_ int64  `json:"-"` // Смещение в файле, игнорируется при записи
}

// NewRecMeta -- создание новой мета-информации записи KV-хранилища.
func NewRecMeta(key *alias.AStoreKey) *RecMeta {
	hassert(key != nil, "NewRecMeta: key==nil")
	sf := &RecMeta{
		Key_:       key,
		Vers_:      1,
		Operation_: "create",
		createdAt_: voc.NewETime(voc.VTimeOptDefault()),
		updateAt_:  voc.NewETime(voc.VTimeOptDefault(), voc.VTimeOptMut()),
	}
	_ = ktypes.IRecMeta(sf)
	return sf
}

// Key -- ключ записи.
func (sf *RecMeta) Key() *alias.AStoreKey {
	return sf.Key_
}

// Vers -- версия записи.
func (sf *RecMeta) Vers() int64 {
	return sf.Vers_
}

// Operation -- тип операции над записью.
func (sf *RecMeta) Operation() string {
	return sf.Operation_
}

// CreatedAt -- дата создания записи.
func (sf *RecMeta) CreatedAt() ktypes.ITime {
	return sf.createdAt_
}

// UpdateAt -- дата последнего обновления.
func (sf *RecMeta) UpdateAt() ktypes.ITimeMut {
	return sf.updateAt_
}