freedom

README

freedom

freedom是一个基于六边形架构的框架，可以支撑充血的领域模型范式。

Overview

• 集成iris v12
• 集成普罗米修斯
• 集成gorm
• 链路追踪
• infra容器 基于组件的基础设施
• http2 server & client
• 依赖注入&依赖倒置&AOP
• CRUD 代码生成
• DDD&六边形架构
• 消息事件&事件重试&领域事件

安装

$ go get github.com/8treenet/freedom/freedom

创建项目

$ freedom new-project [project-name]

生成crud 值对象

# 编辑 [project-name]/cmd/conf/db.toml 填入数据库地址
# 可指定配置地址和输出目录 freedom new-crud -h 查看更多
$ cd [project-name]
$ freedom new-crud

Example

基础教程

http2监听和依赖倒置

事务组件和自定义组件

消息事件和领域事件

一个完整的电商demo,包含CQRS、聚合、实体、领域事件、仓库、基础设施

Documentation

Index

• func Configure(obj interface{}, file string, must bool, metaData ...interface{})
• func Logger() *golog.Logger
• func NewProxy(proxyObj proxyInterface, target interface{})
• func Prepare(f func(Initiator))
• func Prometheus() *general.Prometheus
• func SetConfigurer(confer Configurer)
• type Application
  • func NewApplication() Application
• type BeforeActivation
• type Bus
• type BusHandler
• type Configuration
  • func DefaultConfiguration() Configuration
• type Configurer
• type Context
• type DomainEventInfra
• type Entity
• type GORMRepository
• type Infra
• type Initiator
• type ProxyHandle
  • func (aopHandle *ProxyHandle) Call(fun string, args ...interface{}) (result []interface{}, e error)
• type QueryBuilder
• type Repository
• type Result
• type SingleBoot
• type Starter
• type UnitTest
  • func NewUnitTest() UnitTest
• type Worker
  • func ToWorker(ctx Context) Worker

Functions

func Configure

func Configure(obj interface{}, file string, must bool, metaData ...interface{})

Configure .

func Logger

func Logger() *golog.Logger

Logger .

func NewProxy

func NewProxy(proxyObj proxyInterface, target interface{})

func Prepare

func Prepare(f func(Initiator))

Prepare .

func Prometheus

func Prometheus() *general.Prometheus

Prometheus .

func SetConfigurer

func SetConfigurer(confer Configurer)

SetConfigurer .

Types

type Application

type Application interface {
	InstallGorm(f func() (db *gorm.DB))
	InstallRedis(f func() (client redis.Cmdable))
	InstallOther(f func() interface{})
	InstallMiddleware(handler iris.Handler)
	InstallParty(relativePath string)
	CreateH2CRunner(addr string, configurators ...host.Configurator) iris.Runner
	CreateRunner(addr string, configurators ...host.Configurator) iris.Runner
	Iris() *iris.Application
	Logger() *golog.Logger
	Run(serve iris.Runner, c iris.Configuration)
	InstallDomainEventInfra(eventInfra DomainEventInfra)
	Start(f func(starter Starter))
	InstallBusMiddleware(handle ...BusHandler)
	InstallSerializer(marshal func(v interface{}) ([]byte, error), unmarshal func(data []byte, v interface{}) error)
}

Application .

func NewApplication

func NewApplication() Application

NewApplication .

type BeforeActivation

type BeforeActivation = mvc.BeforeActivation

type Bus

type Bus = general.Bus

type BusHandler

type BusHandler = general.BusHandler

type Configuration

type Configuration = iris.Configuration

func DefaultConfiguration

func DefaultConfiguration() Configuration

type Configurer

type Configurer interface {
	Configure(obj interface{}, file string, must bool, metaData ...interface{})
}

type Context

type Context = iris.Context

type DomainEventInfra

type DomainEventInfra = general.DomainEventInfra

type Entity

type Entity = general.Entity

type GORMRepository

type GORMRepository = general.GORMRepository

GORMRepository .

type Infra

type Infra = general.Infra

Infra .

type Initiator

type Initiator = general.Initiator

Initiator .

type ProxyHandle

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

func (*ProxyHandle) Call

func (aopHandle *ProxyHandle) Call(fun string, args ...interface{}) (result []interface{}, e error)

type QueryBuilder

type QueryBuilder = general.QueryBuilder

QueryBuilder .

type Repository

type Repository = general.Repository

Repository .

type Result

type Result = hero.Result

type SingleBoot

type SingleBoot = general.SingleBoot

SingleBoot .

type Starter

type Starter = general.Starter

type UnitTest

type UnitTest = general.UnitTest

func NewUnitTest

func NewUnitTest() UnitTest

type Worker

type Worker = general.Worker

Worker .

func ToWorker

func ToWorker(ctx Context) Worker