examples

package
v1.11.0 Latest Latest
Warning

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

 Go to latest Published: Aug 29, 2024 License: MIT Imports: 16 Imported by: 0

Documentation

Overview

Code generated by volcago. DO NOT EDIT. generated version: (devel)

Code generated by volcago. DO NOT EDIT. generated version: (devel)

Code generated by volcago. DO NOT EDIT. generated version: (devel)

Code generated by volcago. DO NOT EDIT. generated version: (devel)

Code generated by volcago. DO NOT EDIT. generated version: (devel)

Code generated by volcago. DO NOT EDIT. generated version: (devel)

Code generated by volcago. DO NOT EDIT. generated version: (devel)

Code generated by volcago. DO NOT EDIT. generated version: (devel)

Index

Constants

View Source 
const (
	TaskIndexLabelDescEqual          = "d4"  // perfect-match of Desc
	TaskIndexLabelDescLike           = "d3"  // like-match of Desc
	TaskIndexLabelDescPrefix         = "d1"  // prefix-match of Desc
	TaskIndexLabelDescSuffix         = "d2"  // suffix-match of Desc
	TaskIndexLabelCreatedPrefix      = "c1"  // prefix-match of Created
	TaskIndexLabelCreatedSuffix      = "c2"  // suffix-match of Created
	TaskIndexLabelCreatedLike        = "c3"  // like-match of Created
	TaskIndexLabelCreatedEqual       = "c4"  // perfect-match of Created
	TaskIndexLabelReservedDatePrefix = "r1"  // prefix-match of ReservedDate
	TaskIndexLabelReservedDateSuffix = "r2"  // suffix-match of ReservedDate
	TaskIndexLabelReservedDateLike   = "r3"  // like-match of ReservedDate
	TaskIndexLabelReservedDateEqual  = "r4"  // perfect-match of ReservedDate
	TaskIndexLabelDonePrefix         = "d5"  // prefix-match of Done
	TaskIndexLabelDoneSuffix         = "d6"  // suffix-match of Done
	TaskIndexLabelDoneLike           = "d7"  // like-match of Done
	TaskIndexLabelDoneEqual          = "d8"  // perfect-match of Done
	TaskIndexLabelDone2Prefix        = "d9"  // prefix-match of Done2
	TaskIndexLabelDone2Suffix        = "do1" // suffix-match of Done2
	TaskIndexLabelDone2Like          = "do2" // like-match of Done2
	TaskIndexLabelDone2Equal         = "do3" // perfect-match of Done2
	TaskIndexLabelCountPrefix        = "c5"  // prefix-match of Count
	TaskIndexLabelCountSuffix        = "c6"  // suffix-match of Count
	TaskIndexLabelCountLike          = "c7"  // like-match of Count
	TaskIndexLabelCountEqual         = "c8"  // perfect-match of Count
	TaskIndexLabelCount64Prefix      = "c9"  // prefix-match of Count64
	TaskIndexLabelCount64Suffix      = "co1" // suffix-match of Count64
	TaskIndexLabelCount64Like        = "co2" // like-match of Count64
	TaskIndexLabelCount64Equal       = "co3" // perfect-match of Count64
	TaskIndexLabelNameListPrefix     = "n1"  // prefix-match of NameList
	TaskIndexLabelNameListSuffix     = "n2"  // suffix-match of NameList
	TaskIndexLabelNameListLike       = "n3"  // like-match of NameList
	TaskIndexLabelNameListEqual      = "n4"  // perfect-match of NameList
	TaskIndexLabelProportionPrefix   = "p1"  // prefix-match of Proportion
	TaskIndexLabelProportionSuffix   = "p2"  // suffix-match of Proportion
	TaskIndexLabelProportionLike     = "p3"  // like-match of Proportion
	TaskIndexLabelProportionEqual    = "p4"  // perfect-match of Proportion
	TaskIndexLabelTaskKindEqual      = "t4"  // perfect-match of TaskKind
	TaskIndexLabelTaskKindLike       = "t3"  // like-match of TaskKind
	TaskIndexLabelTaskKindPrefix     = "t1"  // prefix-match of TaskKind
	TaskIndexLabelTaskKindSuffix     = "t2"  // suffix-match of TaskKind
	TaskIndexLabelFlagPrefix         = "f1"  // prefix-match of Flag
	TaskIndexLabelFlagSuffix         = "f2"  // suffix-match of Flag
	TaskIndexLabelFlagLike           = "f3"  // like-match of Flag
	TaskIndexLabelFlagEqual          = "f4"  // perfect-match of Flag
	TaskIndexLabelInner_AEqual       = "i4"  // perfect-match of Inner.A
	TaskIndexLabelInner_ALike        = "i3"  // like-match of Inner.A
	TaskIndexLabelInner_APrefix      = "i1"  // prefix-match of Inner.A
	TaskIndexLabelInner_ASuffix      = "i2"  // suffix-match of Inner.A
	TaskIndexLabelInnerRef_AEqual    = "i8"  // perfect-match of InnerRef.A
	TaskIndexLabelInnerRef_ALike     = "i7"  // like-match of InnerRef.A
	TaskIndexLabelInnerRef_APrefix   = "i5"  // prefix-match of InnerRef.A
	TaskIndexLabelInnerRef_ASuffix   = "i6"  // suffix-match of InnerRef.A
	TaskIndexLabelInnerMapPrefix     = "i9"  // prefix-match of InnerMap
	TaskIndexLabelInnerMapSuffix     = "in1" // suffix-match of InnerMap
	TaskIndexLabelInnerMapLike       = "in2" // like-match of InnerMap
	TaskIndexLabelInnerMapEqual      = "in3" // perfect-match of InnerMap
)

Variables

View Source 
var (
	ErrAlreadyExists        = xerrors.New("already exists")
	ErrAlreadyDeleted       = xerrors.New("already been deleted")
	ErrNotFound             = xerrors.New("not found")
	ErrLogicallyDeletedData = xerrors.New("logically deleted data")
	ErrUniqueConstraint     = xerrors.New("unique constraint error")
	ErrNotAvailableCG       = xerrors.New("not available in collection groups")
	ErrVersionConflict      = xerrors.New("version conflict")
)

Functions

func IsSlice 

func IsSlice(v interface{}) bool

IsSlice - slice judgment

func SetLastThreeToZero 

func SetLastThreeToZero(t time.Time) time.Time

SetLastThreeToZero - set the last three digits to zero

Types

type Cursor 

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

Cursor - query cursor

type DeleteMode 

type DeleteMode int

DeleteMode - delete mode 

const (
	DeleteModeSoft DeleteMode = iota + 1 // logical delete mode
	DeleteModeHard                       // physical delete mode
)

type DeleteOption 

type DeleteOption struct {
	Mode DeleteMode
}

DeleteOption - option to delete logically or physically default: physical deletion use `DeleteModeSoft` or `DeleteModeHard

type Filter 

type Filter struct {
	FilterTypes []FilterType
	Value       interface{}
}

Filter - filters of extra indexer

type FilterType 

type FilterType = int

FilterType - extra indexes filters type 

const (
	FilterTypeAdd FilterType = 1 << iota
	FilterTypeAddPrefix
	FilterTypeAddSuffix
	FilterTypeAddBiunigrams
	FilterTypeAddSomething
)

type GetOption 

type GetOption struct {
	IncludeSoftDeleted bool
}

GetOption - option to include logical deletion data

type MultiError 

type MultiError interface {
	GetIndex() int
	GetError() error
	Error() string
}

MultiError - multi error interface

func NewMultiError 

func NewMultiError(index int, err error) MultiError

NewMultiError - constructor

type MultiErrors 

type MultiErrors []MultiError

MultiErrors - multi errors

func NewMultiErrors 

func NewMultiErrors() MultiErrors

NewMultiErrors - constructor

func (MultiErrors) Error 

func (errs MultiErrors) Error() string

Error - multi errors string

type OpType 

type OpType = string

OpType - operator type 

const (
	OpTypeEqual              OpType = "=="
	OpTypeNotEqual           OpType = "!="
	OpTypeLessThan           OpType = "<"
	OpTypeLessThanOrEqual    OpType = "<="
	OpTypeGreaterThan        OpType = ">"
	OpTypeGreaterThanOrEqual OpType = ">="
	OpTypeIn                 OpType = "in"
	OpTypeNotIn              OpType = "not-in"
	OpTypeArrayContains      OpType = "array-contains"
	OpTypeArrayContainsAny   OpType = "array-contains-any"
)

type PagingResult 

type PagingResult struct {
	NextCursorKey string
	Length        int
}

PagingResult - paging result

type Query 

type Query struct {
	Operator OpType
	Value    interface{}
}

Query - query

func (*Query) IsSlice 

func (q *Query) IsSlice() bool

IsSlice - slice judgment

type QueryBuilder 

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

QueryBuilder - query builder

func NewQueryBuilder 

func NewQueryBuilder(collection *firestore.CollectionRef) *QueryBuilder

NewQueryBuilder - constructor

func (*QueryBuilder) ArrayContains 

func (qb *QueryBuilder) ArrayContains(path string, value interface{}) *QueryBuilder

ArrayContains - array filter ( `array-contains` )

func (*QueryBuilder) ArrayContainsAny 

func (qb *QueryBuilder) ArrayContainsAny(path string, value interface{}) *QueryBuilder

ArrayContainsAny - array filter ( `array-contains-any` )

func (*QueryBuilder) Asc 

func (qb *QueryBuilder) Asc(path string) *QueryBuilder

Asc - order

func (*QueryBuilder) Check 

func (qb *QueryBuilder) Check() error

Check - condition check

func (*QueryBuilder) Desc 

func (qb *QueryBuilder) Desc(path string) *QueryBuilder

Desc - order

func (*QueryBuilder) EndAt 

func (qb *QueryBuilder) EndAt(docSnapshotOrFieldValues ...interface{}) *QueryBuilder

EndAt - end at

func (*QueryBuilder) EndBefore 

func (qb *QueryBuilder) EndBefore(docSnapshotOrFieldValues ...interface{}) *QueryBuilder

EndBefore - end before

func (*QueryBuilder) Equal 

func (qb *QueryBuilder) Equal(path string, value interface{}) *QueryBuilder

Equal - equality filter ( `==` )

func (*QueryBuilder) GreaterThan 

func (qb *QueryBuilder) GreaterThan(path string, value interface{}) *QueryBuilder

GreaterThan - range filter ( `>` )

func (*QueryBuilder) GreaterThanOrEqual 

func (qb *QueryBuilder) GreaterThanOrEqual(path string, value interface{}) *QueryBuilder

GreaterThanOrEqual - range filter ( `>=` )

func (*QueryBuilder) In 

func (qb *QueryBuilder) In(path string, value interface{}) *QueryBuilder

In - array filter ( `in` )

func (*QueryBuilder) LessThan 

func (qb *QueryBuilder) LessThan(path string, value interface{}) *QueryBuilder

LessThan - range filter ( `<` )

func (*QueryBuilder) LessThanOrEqual 

func (qb *QueryBuilder) LessThanOrEqual(path string, value interface{}) *QueryBuilder

LessThanOrEqual - range filter ( `<=` )

func (*QueryBuilder) Limit 

func (qb *QueryBuilder) Limit(limit int) *QueryBuilder

Limit - limit

func (*QueryBuilder) NotEqual 

func (qb *QueryBuilder) NotEqual(path string, value interface{}) *QueryBuilder

NotEqual - inequality filter ( `!=` )

func (*QueryBuilder) NotIn 

func (qb *QueryBuilder) NotIn(path string, value interface{}) *QueryBuilder

NotIn - array filter ( `not-in` )

func (*QueryBuilder) Query 

func (qb *QueryBuilder) Query() *firestore.Query

Query - return firestore.Query

func (*QueryBuilder) StartAfter 

func (qb *QueryBuilder) StartAfter(docSnapshotOrFieldValues ...interface{}) *QueryBuilder

StartAfter - start after

func (*QueryBuilder) StartAt 

func (qb *QueryBuilder) StartAt(docSnapshotOrFieldValues ...interface{}) *QueryBuilder

StartAt - start at

type QueryChainer 

type QueryChainer struct {
	QueryGroup       []*Query
	OrderByDirection firestore.Direction
	Filter           Filter
	// contains filtered or unexported fields
}

QueryChainer - query chainer

func NewQueryChainer 

func NewQueryChainer() *QueryChainer

NewQueryChainer - constructor

func (*QueryChainer) ArrayContains 

func (qc *QueryChainer) ArrayContains(v interface{}) *QueryChainer

ArrayContains - `array-contains`

func (*QueryChainer) ArrayContainsAny 

func (qc *QueryChainer) ArrayContainsAny(v interface{}) *QueryChainer

ArrayContainsAny - `array-contains-any`

func (*QueryChainer) Asc 

func (qc *QueryChainer) Asc() *QueryChainer

Asc - `Asc`

func (*QueryChainer) BuildCursorQuery 

func (qc *QueryChainer) BuildCursorQuery(q firestore.Query) firestore.Query

BuildCursor - build query for cursor

func (*QueryChainer) Desc 

func (qc *QueryChainer) Desc() *QueryChainer

Desc - `Desc`

func (*QueryChainer) EndAt 

func (qc *QueryChainer) EndAt(v ...interface{}) *QueryChainer

EndAt - end at

func (*QueryChainer) EndBefore 

func (qc *QueryChainer) EndBefore(v ...interface{}) *QueryChainer

EndBefore - end before

func (*QueryChainer) Equal 

func (qc *QueryChainer) Equal(v interface{}) *QueryChainer

Equal - `==`

func (*QueryChainer) Error 

func (qc *QueryChainer) Error() error

Error - error

func (*QueryChainer) Filters 

func (qc *QueryChainer) Filters(v interface{}, filterTypes ...FilterType) *QueryChainer

Filters - using `xim`

func (*QueryChainer) GreaterThan 

func (qc *QueryChainer) GreaterThan(v interface{}) *QueryChainer

GreaterThan - `>`

func (*QueryChainer) GreaterThanOrEqual 

func (qc *QueryChainer) GreaterThanOrEqual(v interface{}) *QueryChainer

GreaterThanOrEqual - `>=`

func (*QueryChainer) In 

func (qc *QueryChainer) In(v interface{}) *QueryChainer

In - `in`

func (*QueryChainer) LessThan 

func (qc *QueryChainer) LessThan(v interface{}) *QueryChainer

LessThan - `<`

func (*QueryChainer) LessThanOrEqual 

func (qc *QueryChainer) LessThanOrEqual(v interface{}) *QueryChainer

LessThanOrEqual - `<=`

func (*QueryChainer) NotEqual 

func (qc *QueryChainer) NotEqual(v interface{}) *QueryChainer

NotEqual - `!=`

func (*QueryChainer) NotIn 

func (qc *QueryChainer) NotIn(v interface{}) *QueryChainer

NotIn - `not-in`

func (*QueryChainer) StartAfter 

func (qc *QueryChainer) StartAfter(v ...interface{}) *QueryChainer

StartAt - start after

func (*QueryChainer) StartAt 

func (qc *QueryChainer) StartAt(v ...interface{}) *QueryChainer

StartAt - start at

type TaskRepository 

type TaskRepository interface {
	// Single
	Get(ctx context.Context, id string, opts ...GetOption) (*model.Task, error)
	GetWithDoc(ctx context.Context, doc *firestore.DocumentRef, opts ...GetOption) (*model.Task, error)
	Insert(ctx context.Context, subject *model.Task) (_ string, err error)
	Update(ctx context.Context, subject *model.Task) (err error)
	StrictUpdate(ctx context.Context, id string, param *TaskUpdateParam, opts ...firestore.Precondition) error
	Delete(ctx context.Context, subject *model.Task, opts ...DeleteOption) (err error)
	DeleteByID(ctx context.Context, id string, opts ...DeleteOption) (err error)
	// Multiple
	GetMulti(ctx context.Context, ids []string, opts ...GetOption) ([]*model.Task, error)
	InsertMulti(ctx context.Context, subjects []*model.Task) (_ []string, er error)
	UpdateMulti(ctx context.Context, subjects []*model.Task) (er error)
	DeleteMulti(ctx context.Context, subjects []*model.Task, opts ...DeleteOption) (er error)
	DeleteMultiByIDs(ctx context.Context, ids []string, opts ...DeleteOption) (er error)
	// Single(Transaction)
	GetWithTx(tx *firestore.Transaction, id string, opts ...GetOption) (*model.Task, error)
	GetWithDocWithTx(tx *firestore.Transaction, doc *firestore.DocumentRef, opts ...GetOption) (*model.Task, error)
	InsertWithTx(ctx context.Context, tx *firestore.Transaction, subject *model.Task) (_ string, err error)
	UpdateWithTx(ctx context.Context, tx *firestore.Transaction, subject *model.Task) (err error)
	StrictUpdateWithTx(tx *firestore.Transaction, id string, param *TaskUpdateParam, opts ...firestore.Precondition) error
	DeleteWithTx(ctx context.Context, tx *firestore.Transaction, subject *model.Task, opts ...DeleteOption) (err error)
	DeleteByIDWithTx(ctx context.Context, tx *firestore.Transaction, id string, opts ...DeleteOption) (err error)
	// Multiple(Transaction)
	GetMultiWithTx(tx *firestore.Transaction, ids []string, opts ...GetOption) ([]*model.Task, error)
	InsertMultiWithTx(ctx context.Context, tx *firestore.Transaction, subjects []*model.Task) (_ []string, er error)
	UpdateMultiWithTx(ctx context.Context, tx *firestore.Transaction, subjects []*model.Task) (er error)
	DeleteMultiWithTx(ctx context.Context, tx *firestore.Transaction, subjects []*model.Task, opts ...DeleteOption) (er error)
	DeleteMultiByIDsWithTx(ctx context.Context, tx *firestore.Transaction, ids []string, opts ...DeleteOption) (er error)
	// Search
	Search(ctx context.Context, param *TaskSearchParam, q *firestore.Query) ([]*model.Task, error)
	SearchWithTx(tx *firestore.Transaction, param *TaskSearchParam, q *firestore.Query) ([]*model.Task, error)
	SearchByParam(ctx context.Context, param *TaskSearchParam) ([]*model.Task, *PagingResult, error)
	SearchByParamWithTx(tx *firestore.Transaction, param *TaskSearchParam) ([]*model.Task, *PagingResult, error)
	// misc
	GetCollection() *firestore.CollectionRef
	GetCollectionName() string
	GetDocRef(id string) *firestore.DocumentRef
	RunInTransaction() func(ctx context.Context, f func(context.Context, *firestore.Transaction) error, opts ...firestore.TransactionOption) (err error)
}

TaskRepository - Repository of Task

func NewTaskRepository 

func NewTaskRepository(firestoreClient *firestore.Client, middleware ...TaskRepositoryMiddleware) TaskRepository

NewTaskRepository - constructor

type TaskRepositoryMiddleware 

type TaskRepositoryMiddleware interface {
	BeforeInsert(ctx context.Context, subject *model.Task) (bool, error)
	BeforeUpdate(ctx context.Context, old, subject *model.Task) (bool, error)
	BeforeDelete(ctx context.Context, subject *model.Task, opts ...DeleteOption) (bool, error)
	BeforeDeleteByID(ctx context.Context, ids []string, opts ...DeleteOption) (bool, error)
}

TaskRepositoryMiddleware - middleware of TaskRepository

type TaskSearchParam 

type TaskSearchParam struct {
	ID           *QueryChainer
	Desc         *QueryChainer
	Created      *QueryChainer
	ReservedDate *QueryChainer
	Done         *QueryChainer
	Done2        *QueryChainer
	Count        *QueryChainer
	Count64      *QueryChainer
	NameList     *QueryChainer
	Proportion   *QueryChainer
	TaskKind     *QueryChainer
	Flag         *QueryChainer
	Inner        struct {
		A *QueryChainer
	}
	InnerRef struct {
		A *QueryChainer
	}
	InnerMap *QueryChainer

	CursorKey   string
	CursorLimit int
}

TaskSearchParam - params for search

type TaskUpdateParam 

type TaskUpdateParam struct {
	Desc         interface{}
	Created      interface{}
	ReservedDate interface{}
	Done         interface{}
	Done2        interface{}
	Count        interface{}
	Count64      interface{}
	NameList     interface{}
	Proportion   interface{}
	TaskKind     interface{}
	Flag         interface{}
	Inner        struct {
		A interface{}
	}
	InnerRef struct {
		A interface{}
	}
	InnerMap interface{}
}

TaskUpdateParam - params for strict updates

type Unique 

type Unique struct {
	ID         string `firestore:"-"`
	Collection string
	Data       string
	Value      string
}

Unique - Collections for unique constraints

type UniqueMiddlewareKey 

type UniqueMiddlewareKey struct{}

type UniqueRepositoryMiddleware 

type UniqueRepositoryMiddleware interface {
	WrapError(ctx context.Context, err error, uniques []*Unique) error
}

UniqueRepositoryMiddleware - middleware

Notes

Bugs

  • there may be potential bugs

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.