container

README

Контейнер объектов.

Под капотом используется https://pkg.go.dev/go.uber.org/dig, который реализует стратегию, "ленивого" создания объектов, т.е. только по востребованности и создание только один раз.

Реализует интерфейс Container.

type Container interface {
	Provide(interface{}) error
	Provides(...interface{}) error
	Invoke(interface{}) error
}

• Provide - добавляет конструктор объекта в контейнер;
• Provides - тоже самое что Provide, только сразу для пачки конструкторов;
• Invoke - метод для вызова функций с внедренными зависимостями.

Все методы, в случае не удачи, возвращают ошибку.

Пример

func example(c Container) {
  if err := c.Provide(NewLogger); err != nil {
       panic(err)
   }

   err := c.Invoke(func(l Logger) {...})
   if err != nil {
       panic(err)
   }
}

Контейнер не является потокобезопасным.

Хелперы.

Пакет предоставляет хелпер Get[T any](container Container) (T, error) который позволяет получить определенный объект непосредственно из контейнера, без вызова метода Invoke. Считается устаревшим и будет удален в последующих релизах, вместо него используйте метод Run в объекте компонента.

Documentation

Index

• func Get[T any](container Container) (T, error)
• type Container
  • func New() (Container, error)
• type DigDecorator
  • func NewDigDecorator() (*DigDecorator, error)
  • func (container *DigDecorator) Invoke(function interface{}) error
  • func (container *DigDecorator) Provide(constructor interface{}) error
  • func (container *DigDecorator) Provides(constructors ...interface{}) error

Functions

func Get

func Get[T any](container Container) (T, error)

Deprecated

Types

type Container

type Container interface {
	Provide(interface{}) error
	Provides(...interface{}) error
	Invoke(interface{}) error
}

func New

func New() (Container, error)

type DigDecorator

type DigDecorator struct {
	Dig *dig.Container
}

func NewDigDecorator

func NewDigDecorator() (*DigDecorator, error)

func (*DigDecorator) Invoke

func (container *DigDecorator) Invoke(function interface{}) error

func (*DigDecorator) Provide

func (container *DigDecorator) Provide(constructor interface{}) error

func (*DigDecorator) Provides

func (container *DigDecorator) Provides(constructors ...interface{}) error