common

package
v4.2.4 Latest Latest
Warning

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

 Go to latest Published: Oct 16, 2022 License: AGPL-3.0 Imports: 47 Imported by: 18

Documentation

Index

Constants

View Source 
const (
	ConfigName  = `ConfigFromFile`
	SettingName = `ConfigFromDB`
)
View Source 
const DirShardingNum = float64(50000)

DirShardingNum 文件夹分组基数

Variables

View Source 
var (
	MustGetMyContext = defaults.MustGetContext
	MustGetContext   = defaults.MustGetContext
	NewMockContext   = defaults.NewMockContext
)
View Source 
var (

	//ErrUserNotLoggedIn 用户未登录
	ErrUserNotLoggedIn = echo.NewError(`User not logged in`, code.Unauthenticated)
	//ErrUserNotFound 用户不存在
	ErrUserNotFound = echo.NewError(`User does not exist`, code.UserNotFound)
	//ErrUserNoPerm 用户无权限
	ErrUserNoPerm = echo.NewError(`User has no permission`, code.NonPrivileged)
	//ErrUserDisabled 用户已被禁用
	ErrUserDisabled = echo.NewError(`User has been disabled`, code.UserDisabled)
	//ErrBalanceNoEnough 余额不足
	ErrBalanceNoEnough = echo.NewError(`Balance is not enough`, code.BalanceNoEnough)
	//ErrCaptcha 验证码错误
	ErrCaptcha = echo.NewError(`Captcha is incorrect`, code.CaptchaError)
	//ErrCaptchaIdMissing 缺少captchaId
	ErrCaptchaIdMissing = echo.NewError(`Missing captchaId`, code.CaptchaIdMissing).SetZone(`captchaId`)
	//ErrInvalidAppID App ID 无效
	ErrInvalidAppID = echo.NewError(`Invalid app id`, code.InvalidAppID)
	//ErrInvalidSign 无效签名
	ErrInvalidSign = echo.NewError(`Invalid sign`, code.InvalidSignature)
	//ErrInvalidToken 令牌无效
	ErrInvalidToken = echo.NewError(`Invalid token`, code.InvalidToken)

	//ErrRepeatOperation 重复操作
	ErrRepeatOperation = echo.NewError(`Repeat operation`, code.RepeatOperation)
	//ErrUnsupported 不支持
	ErrUnsupported = echo.NewError(`Unsupported`, code.Unsupported)
	//ErrOperationTimeout 操作超时
	ErrOperationTimeout = echo.NewError(`Operation timeout`, code.OperationTimeout)
	//ErrOperationFail 操作失败
	ErrOperationFail = echo.NewError(`Operation fail`, code.Failure)

	//ErrResponseFormatError 响应格式错误
	ErrResponseFormatError = echo.NewError(`Response format error`, code.AbnormalResponse)
	//ErrRequestTimeout 提交超时
	ErrRequestTimeout = echo.NewError(`Request timeout`, code.RequestTimeout)
	//ErrRequestFail 提交失败
	ErrRequestFail = echo.NewError(`Request fail`, code.RequestFailure)

	// ErrIgnoreConfigChange 忽略配置文件更改
	ErrIgnoreConfigChange = errors.New(`Ignore configuration file changes`)

	// ErrNext 需要继续向下检查
	ErrNext            = errors.New("Next")
	ErrConcurrentLock  = errors.New("Concurrent lock has been triggered")
	ErrContextCanceled = errors.New("Context canceled")
)
View Source 
var (
	// Sorts 获取数据查询时的排序方式
	Sorts                = clientPagination.Sorts
	Paging               = dbPagination.Paging
	PagingWithPagination = dbPagination.PagingWithPagination
	PagingWithLister     = dbPagination.PagingWithLister
	PagingWithListerCond = dbPagination.PagingWithListerCond
	PagingWithSelectList = dbPagination.PagingWithSelectList
	NewLister            = dbPagination.NewLister
	NewListParam         = dbPagination.NewListParam
	NewOffsetLister      = dbPagination.NewOffsetLister
)
View Source 
var (
	SonyflakeStartDate  = `2018-09-01 08:08:08`
	ErrInvalidIPAddress = errors.New("Invalid IP address")
)
View Source 
var DefaultNextURLVarName = `next`
View Source 
var ErrorProcessors = []render.ErrorProcessor{
	func(ctx echo.Context, err error) (processed bool, newErr error) {
		if errors.Is(err, db.ErrNoMoreRows) {
			return true, echo.NewError(ctx.T(`数据不存在`), stdCode.DataNotFound)
		}
		return false, err
	},
}
View Source 
var LogParsers = map[string]LogParser{}

LogParsers 日志格式解析器

Functions

func BackendURL 

func BackendURL(ctx echo.Context) string

func BatchAdd 

func BatchAdd(ctx echo.Context, field string, adder Adder, before func(*string) error, seperators ...string) (added []string, err error)

BatchAdd 批量添加(常用于批量添加分类) BatchAdd(ctx, `ident,>name`, adder, before, `=`) 可以通过在字段名称前面添加“>”前缀来指定表单字段名称，如果不指定则默认使用第一个作为表单字段名

func BoolToFlag added in v4.2.2 

func BoolToFlag(v bool) string

func CaptchaInfo 

func CaptchaInfo(hostAlias string, captchaName string, captchaID string, args ...string) echo.H

CaptchaInfo 新验证码信息

func ClearHTML 

func ClearHTML(title string) string

ClearHTML 清除所有HTML标签及其属性，一般用处理文章标题等不含HTML标签的字符串

func ContentEncode 

func ContentEncode(content string, contypes ...string) string

func CookieConfig 

func CookieConfig() scookie.Config

func Crypto 

func Crypto() codec.Codec

func Decrypt 

func Decrypt(secret string, datas ...*string)

Decrypt 数据解密

func DecryptedByRandomSecret 

func DecryptedByRandomSecret(ctx echo.Context, sessionKey string, datas ...*string)

DecryptedByRandomSecret 用上次设置的随机密码解密

func DeleteRandomSecret 

func DeleteRandomSecret(ctx echo.Context, sessionKey string)

DeleteRandomSecret 删除随机密码

func DirSharding 

func DirSharding(id uint64) uint64

DirSharding 文件夹分组(暂不使用)

func Encrypt 

func Encrypt(secret string, datas ...*string)

Encrypt 数据加密

func Err 

func Err(ctx echo.Context, err error) (ret interface{})

Err 获取错误信息

func FlagToBool added in v4.2.2 

func FlagToBool(v string) bool

func Float32Sum 

func Float32Sum(numbers ...float32) float32

func Float64Sum 

func Float64Sum(numbers ...float64) float64

func FloorNumber added in v4.2.4 

func FloorNumber(page int, pageSize int, index int) int

FloorNumber 楼层号

func FullURL 

func FullURL(domianURL string, myURL string) string

func GenAndRecordCaptchaID 

func GenAndRecordCaptchaID(ctx echo.Context, opt *hdlCaptcha.Options) string

func GenCaptchaError 

func GenCaptchaError(ctx echo.Context, hostAlias string, captchaName string, id string, args ...string) echo.Data

func GenPassword 

func GenPassword() (string, error)

func GenSecret 

func GenSecret(sizes ...uint) string

GenSecret 生成随机密钥

func GetBoolFlag 

func GetBoolFlag(value string, defaults ...string) string

func GetCaptchaID added in v4.2.2 

func GetCaptchaID(ctx echo.Context, id string) (string, error)

func GetContype 

func GetContype(value string, defaults ...string) string

func GetEnumValue 

func GetEnumValue(enums []string, value string, defaults string) string

func GetErr 

func GetErr(key string) (err error)

func GetHistoryOrNewCaptchaID added in v4.2.2 

func GetHistoryOrNewCaptchaID(ctx echo.Context) string

func GetLocalIP 

func GetLocalIP() (ipv4 string, err error)

GetLocalIP 获取本机网卡IP

func GetNextURL 

func GetNextURL(ctx echo.Context, varNames ...string) string

func GetNowTime 

func GetNowTime(ctx echo.Context) time.Time

GetNowTime 获取当前时间(同一个context中只获取一次)

func GetOtherURL 

func GetOtherURL(ctx echo.Context, next string) string

func HPoolGet 

func HPoolGet() echo.H

func HPoolRelease 

func HPoolRelease(m echo.H)

func HTMLFilter 

func HTMLFilter() *bluemonday.Policy

HTMLFilter 构建自定义的HTML标签过滤器

func IDSharding 

func IDSharding(id uint64, shardingNum float64) uint64

IDSharding 按照ID进行分片

func IPv4ToMachineID 

func IPv4ToMachineID(ipv4 string) (uint16, error)

func IsAnonymousMode added in v4.2.2 

func IsAnonymousMode(ownerType string) bool

func IsCaptchaErrCode 

func IsCaptchaErrCode(code stdCode.Code) bool

IsCaptchaErrCode 是否验证码错误码

func IsCaptchaError 

func IsCaptchaError(err error) bool

IsCaptchaError 用户验证码错误

func IsErr 

func IsErr(err error, key string) bool

func IsError 

func IsError(err interface{}) bool

IsError 是否是错误信息

func IsFailureCode 

func IsFailureCode(code stdCode.Code) bool

func IsFullURL added in v4.2.2 

func IsFullURL(purl string) bool

func IsMessage 

func IsMessage(err interface{}) bool

IsMessage 判断err是否为Message

func IsOk 

func IsOk(err interface{}) bool

IsOk 是否是成功信息

func IsUserDisabled 

func IsUserDisabled(err error) bool

IsUserDisabled 用户是否被禁用

func IsUserNoPerm 

func IsUserNoPerm(err error) bool

IsUserNoPerm 用户是否没有操作权限

func IsUserNotFound 

func IsUserNotFound(err error) bool

IsUserNotFound 用户是否不存在

func IsUserNotLoggedIn 

func IsUserNotLoggedIn(err error) bool

IsUserNotLoggedIn 用户是否未登录

func JSONBytesParseError 

func JSONBytesParseError(err error, jsonBytes []byte) error

func LogShow 

func LogShow(ctx echo.Context, logFile string, extensions ...echo.H) error

LogShow 获取日志内容用于显示

func LookPath 

func LookPath(bin string, otherPaths ...string) (string, error)

LookPath 获取二进制可执行文件路径

func MD5Sharding 

func MD5Sharding(str interface{}, length ...int) string

MD5Sharding 按照MD5进行分片

func MarkdownPickoutCodeblock 

func MarkdownPickoutCodeblock(content string) (repl []string, newContent string)

func MarkdownRestorePickout 

func MarkdownRestorePickout(repl []string, content string) string

func ModTimeCache 

func ModTimeCache(dir string, name string) (time.Time, error)

ModTimeCache 缓存文件修改时间

func MonthSharding 

func MonthSharding(ctx echo.Context) string

MonthSharding 按照日期月进行分片

func MyCleanTags 

func MyCleanTags(value string) string

func MyCleanText 

func MyCleanText(value string) string

func MyRemoveXSS 

func MyRemoveXSS(content string) string

func NewSonyflake 

func NewSonyflake(startDate string, machineIDs ...uint16) (*sonyflake.Sonyflake, error)

NewSonyflake 19位

func NewStrictPolicy 

func NewStrictPolicy() *bluemonday.Policy

func NewUGCPolicy 

func NewUGCPolicy() *bluemonday.Policy

func NextID 

func NextID(machineIDs ...uint16) (uint64, error)
func NoLink() *bluemonday.Policy

func OkString 

func OkString(err interface{}) string

OkString 获取成功信息

func OnErrorRetry added in v4.1.3 

func OnErrorRetry(f func() error, maxTimes int, interval time.Duration) error

func ParseMysqlConnectionURL 

func ParseMysqlConnectionURL(settings *mysql.ConnectionURL)

func ParseSQL 

func ParseSQL(sqlFile string, isFile bool, installer func(string) error) (err error)

func ProcessError 

func ProcessError(ctx echo.Context, err error) error

func ReadCache 

func ReadCache(dir string, name string) (content []byte, err error)

ReadCache 读缓存文件

func RegisterErr 

func RegisterErr(key string, err error)

func RemoveBytesXSS 

func RemoveBytesXSS(content []byte, noLinks ...bool) []byte

func RemoveCache 

func RemoveCache(dir string, names ...string) (err error)

RemoveCache 删除缓存文件

func RemoveReaderXSS 

func RemoveReaderXSS(reader io.Reader, noLinks ...bool) *bytes.Buffer

func RemoveXSS 

func RemoveXSS(content string, noLinks ...bool) string

RemoveXSS 清除不安全的HTML标签和属性，一般用于处理文章内容

func ReplaceCharset 

func ReplaceCharset(sqlStr string, charset string, checkCreateDDL ...bool) string

ReplaceCharset 替换DDL语句中的字符集

func ReplacePrefix 

func ReplacePrefix(m factory.Model, field string, oldPrefix string, newPrefix string) error

ReplacePrefix 替换前缀数据

func ReturnToCurrentURL 

func ReturnToCurrentURL(ctx echo.Context, varNames ...string) string

func SQLLineParser 

func SQLLineParser(exec func(string) error) func(string) error

func SQLQuery 

func SQLQuery() *sqlQuery

func SQLQueryLimit 

func SQLQueryLimit(limit int, linkIDs ...int) *sqlQuery

func SeekLinesWithoutComments 

func SeekLinesWithoutComments(r io.Reader) (string, error)

func SelectPageCond 

func SelectPageCond(ctx echo.Context, cond *db.Compounds, pkAndLabelFields ...string)

func SendErr 

func SendErr(ctx echo.Context, err error)

SendErr 记录错误信息 (SendFail的别名)

func SendFail 

func SendFail(ctx echo.Context, msg string)

SendFail 记录失败信息

func SendOk 

func SendOk(ctx echo.Context, msg string)

SendOk 记录成功信息

func SetRandomSecret 

func SetRandomSecret(ctx echo.Context, sessionKey string, storeKey ...string)

SetRandomSecret 设置随机密码

func SetSonyflake 

func SetSonyflake(startDate string, machineIDs ...uint16) (sonyFlake *sonyflake.Sonyflake, err error)

func Setting 

func Setting(group ...string) echo.H

func SonyflakeInit 

func SonyflakeInit(machineIDs ...uint16) *sonyflake.Sonyflake

func StringMapPoolGet 

func StringMapPoolGet() param.StringMap

func StringMapPoolRelease 

func StringMapPoolRelease(m param.StringMap)

func SystemAPIKey 

func SystemAPIKey() string

func Tx 

func Tx(ctx echo.Context) *factory.Transaction

func URLValuesPoolGet 

func URLValuesPoolGet() url.Values

func URLValuesPoolRelease 

func URLValuesPoolRelease(m url.Values)

func UniqueID 

func UniqueID(machineIDs ...uint16) (string, error)

func VerifyAndSetCaptcha 

func VerifyAndSetCaptcha(ctx echo.Context, hostAlias string, captchaName string, args ...string) echo.Data

VerifyAndSetCaptcha 验证码验证并设置新验证码信息

func VerifyCaptcha 

func VerifyCaptcha(ctx echo.Context, hostAlias string, captchaName string, args ...string) echo.Data

VerifyCaptcha 验证码验证

func WithNextURL 

func WithNextURL(ctx echo.Context, urlStr string, varNames ...string) string

func WithURLParams 

func WithURLParams(urlStr string, key string, value string, args ...string) string

func WithoutCommentsLineParser 

func WithoutCommentsLineParser(exec func(string) error) func(string) error

func WriteCache 

func WriteCache(dir string, name string, content []byte) (err error)

WriteCache 写缓存文件

func YearSharding 

func YearSharding(ctx echo.Context) string

YearSharding 按照日期年进行分片

Types

type APIKeyGetter 

type APIKeyGetter interface {
	APIKey() string
}

APIKeyGetter API Key

type Adder 

type Adder interface {
	Set(interface{}, ...interface{})
	Add() (interface{}, error)
}

Adder interface

type ConfigFromDB 

type ConfigFromDB interface {
	ConfigFromDB() echo.H
}

type CookieConfigGetter 

type CookieConfigGetter interface {
	CookieConfig() scookie.Config
}

type ErrorTab 

type ErrorTab interface {
	ErrorTab() string
}

type Errors 

type Errors []error

Errors 多个错误信息

func NewErrors 

func NewErrors() Errors

func (*Errors) Add 

func (e *Errors) Add(err error)

func (Errors) Error 

func (e Errors) Error() string

func (Errors) ErrorTab 

func (e Errors) ErrorTab() string

func (Errors) IsEmpty 

func (e Errors) IsEmpty() bool

func (Errors) String 

func (e Errors) String() string

func (Errors) Stringify 

func (e Errors) Stringify(separator string) string

func (*Errors) ToError 

func (e *Errors) ToError() error

type List 

type List = dbPagination.List

type Lister 

type Lister = dbPagination.Lister

type LogParser 

type LogParser func(line *tail.Line) (interface{}, error)

type Messager 

type Messager interface {
	Successor
	error
}

Messager 信息接口 

var DefaultNopMessage Messager = &NopMessage{}

DefaultNopMessage 默认空消息

func Message 

func Message(err interface{}) Messager

Message 获取err中的信息接口

type NopMessage 

type NopMessage struct {
}

NopMessage 空消息

func (*NopMessage) Error 

func (n *NopMessage) Error() string

Error 错误信息

func (*NopMessage) String 

func (n *NopMessage) String() string

String 信息字符串

func (*NopMessage) Success 

func (n *NopMessage) Success() string

Success 成功信息

type OffsetListFunc 

type OffsetListFunc = dbPagination.OffsetListFunc

type OffsetLister 

type OffsetLister = dbPagination.OffsetLister

type PageListFunc 

type PageListFunc = dbPagination.PageListFunc

type SortedURLValues added in v4.2.4 

type SortedURLValues []*URLValues

func NewSortedURLValues added in v4.2.4 

func NewSortedURLValues(query string) SortedURLValues

func (*SortedURLValues) Add added in v4.2.4 

func (s *SortedURLValues) Add(key, value string)

func (SortedURLValues) ApplyCond added in v4.2.4 

func (s SortedURLValues) ApplyCond(cond *db.Compounds)

func (*SortedURLValues) Del added in v4.2.4 

func (s *SortedURLValues) Del(key string)

func (SortedURLValues) Get added in v4.2.4 

func (s SortedURLValues) Get(key string) string

func (SortedURLValues) Has added in v4.2.4 

func (s SortedURLValues) Has(key string) bool

func (*SortedURLValues) ParseQuery added in v4.2.4 

func (s *SortedURLValues) ParseQuery(query string) (err error)

ParseQuery 解析 URL Query copy from standard library src/net/url/url.go: func parseQuery(m Values, query string) (err error)

func (*SortedURLValues) Set added in v4.2.4 

func (s *SortedURLValues) Set(key, value string)

type StatusColor 

type StatusColor string

StatusColor 状态色

func HTTPStatusColor 

func HTTPStatusColor(httpCode int) StatusColor

HTTPStatusColor HTTP状态码相应颜色

func (StatusColor) Bootstrap 

func (s StatusColor) Bootstrap() string

Bootstrap 前端框架 bootstrap css 状态样式

func (StatusColor) String 

func (s StatusColor) String() string

func (StatusColor) Terminal 

func (s StatusColor) Terminal() func(string, ...interface{})

Terminal 控制台样式

type Stringify 

type Stringify interface {
	Stringify(separator string) string
}

type Success 

type Success struct {
	Value string
}

Success 成功信息

func (*Success) String 

func (s *Success) String() string

func (*Success) Success 

func (s *Success) Success() string

Success 成功信息

type Successor 

type Successor interface {
	Success() string
}

Successor 成功信息接口

func NewOk 

func NewOk(v string) Successor

NewOk 创建成功信息

func Ok 

func Ok(v string) Successor

Ok 操作成功

type URLValues added in v4.2.4 

type URLValues struct {
	Key    string
	Values []string
}

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.