entity

Documentation

Overview

Package entity Entity interface and base entity for all persistent model entities

Index

• func EntityIndex(entity Entity, tenantId string) string
• func GUID() string
• func ID() string
• func NanoID() string
• func ShortID(delta ...int) string
• type BaseEntity
  • func (e BaseEntity) ID() string
  • func (e BaseEntity) KEY() string
  • func (e BaseEntity) NAME() string
  • func (e BaseEntity) TABLE() string
• type Entity
• type EntityAction
• type EntityFactory
• type Json
• type JsonDoc
• type Timestamp
  • func EpochNowMillis(delta int64) Timestamp
  • func Now() Timestamp
  • func (ts *Timestamp) Add(delta time.Duration) Timestamp
  • func (ts *Timestamp) LocalString(format string, tz string) string
  • func (ts *Timestamp) String(format string) string
  • func (ts *Timestamp) Time() (result time.Time)

Functions

func EntityIndex

func EntityIndex(entity Entity, tenantId string) string

EntityIndex extract table or index name from entity.TABLE()

func GUID

func GUID() string

GUID generate new Global Unique Identifier

func ID

func ID() string

ID return a long string (10 characters) based on Epoch micro-seconds in base 36

func NanoID

func NanoID() string

NanoID return a long string (6 characters) based on go-nanoid project (smaller and faster than GUID)

func ShortID

func ShortID(delta ...int) string

ShortID return a short string (6 characters) based on epoch seconds in base 36

Types

type BaseEntity

type BaseEntity struct {
	Id        string    `json:"id"`        // Unique object Id
	Key       string    `json:"key"`       // Shard (tenant) key
	CreatedOn Timestamp `json:"createdOn"` // When the object was created [Epoch milliseconds Timestamp]
	UpdatedOn Timestamp `json:"updatedOn"` // When the object was last updated [Epoch milliseconds Timestamp]
}

BaseEntity is a base structure for any concrete Entity

func (BaseEntity) ID

func (e BaseEntity) ID() string

func (BaseEntity) KEY

func (e BaseEntity) KEY() string

func (BaseEntity) NAME

func (e BaseEntity) NAME() string

func (BaseEntity) TABLE

func (e BaseEntity) TABLE() string

type Entity

type Entity interface {
	// ID return the entity unique Id
	ID() string

	// TABLE return the entity table name (for sharded entities, table name include the suffix of the tenant id)
	TABLE() string

	// NAME return the entity name
	NAME() string

	// KEY return the entity sharding key (tenant/account id)
	KEY() string
}

Entity is a marker interface for all serialized domain model entities with identity

type EntityAction

type EntityAction int

const (
	AddEntity    EntityAction = 1
	UpdateEntity EntityAction = 2
	DeleteEntity EntityAction = 3
)

type EntityFactory

type EntityFactory func() Entity

EntityFactory is the factory method signature for Entity

type Json

type Json map[string]any

Json Represent arbitrary JSON fields collection

type JsonDoc

type JsonDoc struct {
	Id   string
	Data string
}

JsonDoc is a Json document to store in Document object store (Postgres, ElasticSearch, Couchbase ...)

type Timestamp

type Timestamp int64

Timestamp represents Epoch milliseconds timestamp

func EpochNowMillis

func EpochNowMillis(delta int64) Timestamp

EpochNowMillis return current time as Epoch time milliseconds with delta in millis

func Now

func Now() Timestamp

Now return current time as Epoch time milliseconds with delta in millis

func (*Timestamp) Add

func (ts *Timestamp) Add(delta time.Duration) Timestamp

Add time and return a new timestamp

func (*Timestamp) LocalString

func (ts *Timestamp) LocalString(format string, tz string) string

LocalString convert Epoch milliseconds timestamp with timezone (IANA) to readable string

func (*Timestamp) String

func (ts *Timestamp) String(format string) string

String convert Epoch milliseconds timestamp to readable string

func (*Timestamp) Time

func (ts *Timestamp) Time() (result time.Time)

Time returns the Go primitive time.Time object