endpoint

Documentation

Index

• Constants
• func GetRouteMeta[T any](m map[string]any, key string) T
• type ACCESS_MODE
• type DescribeEndpointRequest
  • func NewDescribeEndpointRequest() *DescribeEndpointRequest
• type Endpoint
  • func NewEndpoint() *Endpoint
  • func (u *Endpoint) SetRouteEntry(v RouteEntry) *Endpoint
  • func (u *Endpoint) TableName() string
• type QueryEndpointRequest
  • func NewQueryEndpointRequest() *QueryEndpointRequest
• type RegistryEndpointRequest
  • func NewRegistryEndpointRequest() *RegistryEndpointRequest
  • func (r *RegistryEndpointRequest) AddItem(items ...*RouteEntry) *RegistryEndpointRequest
  • func (r *RegistryEndpointRequest) Validate() error
• type RouteEntry
  • func NewEntryFromRestRequest(req *restful.Request) *RouteEntry
  • func NewEntryFromRestRoute(route restful.Route) *RouteEntry
  • func NewEntryFromRestRouteReader(route restful.RouteReader) *RouteEntry
  • func NewEntryFromRestfulContainer(c *restful.Container) (entries []*RouteEntry)
  • func NewRouteEntry() *RouteEntry
  • func (e *RouteEntry) AddRequiredRole(roles ...string) *RouteEntry
  • func (e *RouteEntry) BuildUUID() *RouteEntry
  • func (e *RouteEntry) HasRequiredRole() bool
  • func (e *RouteEntry) IsRequireRole(target string) bool
  • func (e *RouteEntry) LoadMeta(meta map[string]any)
  • func (e *RouteEntry) SetExtensionFromMap(m map[string]string) *RouteEntry
  • func (e *RouteEntry) SetLabel(value string) *RouteEntry
  • func (e *RouteEntry) SetRequiredAuth(v bool) *RouteEntry
  • func (e *RouteEntry) SetRequiredCode(v bool) *RouteEntry
  • func (e *RouteEntry) SetRequiredPerm(v bool) *RouteEntry
  • func (e *RouteEntry) UniquePath() string
• type Service
  • func GetService() Service

Constants

const (
	ACCESS_MODE_READ = iota
	ACCESS_MODE_READ_WRITE
)

const (
	META_REQUIRED_AUTH_KEY      = "required_auth"
	META_REQUIRED_CODE_KEY      = "required_code"
	META_REQUIRED_PERM_KEY      = "required_perm"
	META_REQUIRED_ROLE_KEY      = "required_role"
	META_REQUIRED_AUDIT_KEY     = "required_audit"
	META_REQUIRED_NAMESPACE_KEY = "required_namespace"
	META_RESOURCE_KEY           = "resource"
)

const (
	AppName = "endpoint"
)

Functions

func GetRouteMeta

func GetRouteMeta[T any](m map[string]any, key string) T

Types

type ACCESS_MODE

type ACCESS_MODE uint8

type DescribeEndpointRequest

type DescribeEndpointRequest struct {
	apps.GetRequest
}

func NewDescribeEndpointRequest

func NewDescribeEndpointRequest() *DescribeEndpointRequest

type Endpoint

type Endpoint struct {
	// 基础数据
	apps.ResourceMeta
	// 路由条目信息
	RouteEntry `json:"route_entry" bson:",inline" validate:"required"`
}

Endpoint Service's features

func NewEndpoint

func NewEndpoint() *Endpoint

func (*Endpoint) SetRouteEntry

func (u *Endpoint) SetRouteEntry(v RouteEntry) *Endpoint

func (*Endpoint) TableName

func (u *Endpoint) TableName() string

type QueryEndpointRequest

type QueryEndpointRequest struct {
	*request.PageRequest
}

func NewQueryEndpointRequest

func NewQueryEndpointRequest() *QueryEndpointRequest

type RegistryEndpointRequest

type RegistryEndpointRequest struct {
	Items []*RouteEntry `json:"items"`
}

func NewRegistryEndpointRequest

func NewRegistryEndpointRequest() *RegistryEndpointRequest

func (*RegistryEndpointRequest) AddItem

func (r *RegistryEndpointRequest) AddItem(items ...*RouteEntry) *RegistryEndpointRequest

func (*RegistryEndpointRequest) Validate

func (r *RegistryEndpointRequest) Validate() error

type RouteEntry

type RouteEntry struct {
	// 该功能属于那个服务
	UUID string `json:"uuid" bson:"uuid" gorm:"column:uuid;type:varchar(100);uniqueIndex" optional:"true" description:"路由UUID"`
	// 该功能属于那个服务
	Service string `` /* 129-byte string literal not displayed */
	// 服务那个版本的功能
	Version string `` /* 139-byte string literal not displayed */
	// 资源名称
	Resource string `json:"resource" bson:"resource" gorm:"column:resource;type:varchar(100);index" description:"资源名称"`
	// 资源操作
	Action string `json:"action" bson:"action" gorm:"column:action;type:varchar(100);index" description:"资源操作"`
	// 读或者写
	AccessMode ACCESS_MODE `` /* 128-byte string literal not displayed */
	// 操作标签
	ActionLabel string `json:"action_label" gorm:"column:action_label;type:varchar(200);index" optional:"true" description:"资源标签"`
	// 函数名称
	FunctionName string `` /* 131-byte string literal not displayed */
	// HTTP path 用于自动生成http api
	Path string `json:"path" bson:"path" gorm:"column:path;type:varchar(200);index" description:"接口的路径"`
	// HTTP method 用于自动生成http api
	Method string `json:"method" bson:"method" gorm:"column:method;type:varchar(100);index" description:"接口的方法"`
	// 接口说明
	Description string `json:"description" bson:"description" gorm:"column:description;type:text" optional:"true" description:"接口说明"`
	// 是否校验用户身份 (acccess_token 校验)
	RequiredAuth bool `` /* 163-byte string literal not displayed */
	// 验证码校验(开启双因子认证需要) (code 校验)
	RequiredCode bool `` /* 174-byte string literal not displayed */
	// 开启鉴权
	RequiredPerm bool `` /* 128-byte string literal not displayed */
	// ACL模式下, 允许的通过的身份标识符, 比如角色, 用户类型之类
	RequiredRole []string `` /* 207-byte string literal not displayed */
	// 是否开启操作审计, 开启后这次操作将被记录
	RequiredAudit bool `` /* 178-byte string literal not displayed */
	// 名称空间不能为空
	RequiredNamespace bool `` /* 155-byte string literal not displayed */
	// 扩展信息
	Extras map[string]string `json:"extras" bson:"extras" gorm:"column:extras;serializer:json;type:json" optional:"true" description:"扩展信息"`
}

Entry 路由条目, service-method-path

func NewEntryFromRestRequest

func NewEntryFromRestRequest(req *restful.Request) *RouteEntry

func NewEntryFromRestRoute

func NewEntryFromRestRoute(route restful.Route) *RouteEntry

func NewEntryFromRestRouteReader

func NewEntryFromRestRouteReader(route restful.RouteReader) *RouteEntry

func NewEntryFromRestfulContainer

func NewEntryFromRestfulContainer(c *restful.Container) (entries []*RouteEntry)

func NewRouteEntry

func NewRouteEntry() *RouteEntry

func (*RouteEntry) AddRequiredRole

func (e *RouteEntry) AddRequiredRole(roles ...string) *RouteEntry

func (*RouteEntry) BuildUUID

func (e *RouteEntry) BuildUUID() *RouteEntry

service-method-path

func (*RouteEntry) HasRequiredRole

func (e *RouteEntry) HasRequiredRole() bool

UniquePath todo

func (*RouteEntry) IsRequireRole

func (e *RouteEntry) IsRequireRole(target string) bool

func (*RouteEntry) LoadMeta

func (e *RouteEntry) LoadMeta(meta map[string]any)

func (*RouteEntry) SetExtensionFromMap

func (e *RouteEntry) SetExtensionFromMap(m map[string]string) *RouteEntry

func (*RouteEntry) SetLabel

func (e *RouteEntry) SetLabel(value string) *RouteEntry

func (*RouteEntry) SetRequiredAuth

func (e *RouteEntry) SetRequiredAuth(v bool) *RouteEntry

func (*RouteEntry) SetRequiredCode

func (e *RouteEntry) SetRequiredCode(v bool) *RouteEntry

func (*RouteEntry) SetRequiredPerm

func (e *RouteEntry) SetRequiredPerm(v bool) *RouteEntry

func (*RouteEntry) UniquePath

func (e *RouteEntry) UniquePath() string

UniquePath todo

type Service

type Service interface {
	// 查询API接口列表
	QueryEndpoint(context.Context, *QueryEndpointRequest) (*types.Set[*Endpoint], error)
	// 查询API接口详情
	DescribeEndpoint(context.Context, *DescribeEndpointRequest) (*Endpoint, error)
	// 注册API接口
	RegistryEndpoint(context.Context, *RegistryEndpointRequest) (*types.Set[*Endpoint], error)
}

func GetService

func GetService() Service