# ace

**Repository Path**: coxio/ace

## Basic Information

- **Project Name**: ace
- **Description**: Ace 在多种场合被用来表示顶尖、最好，此名字寓意该框架是顶尖、最优的
- **Primary Language**: Go
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-10-31
- **Last Updated**: 2023-11-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ant-go
> Ant Design Pro Vue  + Golang 后台管理基础模板


https://github.com/go-orz/captcha
https://github.com/2captcha/2captcha-go
https://github.com/Dxmonski/gosolver

## go-logger 是golang 的高性能日志库
https://github.com/donnie4w/go-logger
https://blog.csdn.net/wxd_001/article/details/133674979
go-logger 比slog占用更少的内存，效率比slog更高
go-logger 对日志文件处理，如 日志文件按大小切分备份，按日期：月，日，时切分备份，日志文件压缩备份，日志文件限制最大文件数等特性，目前slog还不具备这些特征。

------------

#### 日志级别打印：

###### 调用 Debug()，Info()，Warn(), Error() ,Fatal() 级别由低到高

## 设置日志打印格式：

##### 如： SetFormat(FORMAT_SHORTFILENAME|FORMAT_DATE|FORMAT_TIME)

###### FORMAT_SHORTFILENAME|FORMAT_DATE|FORMAT_TIME 为默认格式

##### 不调用SetFormat()时，使用默认格式

	不格式化，只打印日志内容    FORMAT_NANO		无格式
	长文件名及行数          FORMAT_LONGFILENAME	全路径
	短文件名及行数			FORMAT_SHORTFILENAME	如：logging_test.go:10
	精确到日期			    FORMAT_DATE		如：2023/02/14
	精确到秒            FORMAT_TIME		如：01:33:27
	精确到微秒          FORMAT_MICROSECNDS	如：01:33:27.123456

##### 打印结果形如：

###### [DEBUG]2023/02/14 01:33:27 logging_test.go:10: 11111111111111

### 日志级别

#####  DEBUG < INFO < WARN < ERROR < FATAL

###### 关闭所有日志 SetLevel(OFF)

#### 说明：

	若设置 INFO
	如：SetLevel(INFO)
	则 所有 Debug("*********")   不再打印出来
	所以调试阶段，常设置为默认级别ALL，或DEBUG，打印出项目中所有日志，包括调试日志
	若设置 OFF
	SetLevel(OFF)
	则 所有日志不再打印出来
	所以正式环境，常设置为ERROR或以上的日志级别，项目中Debug()，Info(),warn()等日志不再打印出来，具体视实际需求设置
	

#### 需将日志写入文件时，则要设置日志文件

	使用全局log对象时，直接调用设置方法：

	SetRollingDaily()		按日期分割
	SetRollingByTime()		可按 小时，天，月 分割日志
	SetRollingFile()		指定文件大小分割日志
	SetRollingFileLoop()	指定文件大小分割日志，并指定保留最大日志文件数
	SetGzipOn(true)			压缩分割的日志文件 

#### 多实例：

	log1 := NewLogger()
	log1.SetRollingDaily("", "logMonitor.log")
	 
	log12:= NewLogger()
	log2.SetRollingDaily("", "logBusiness.log")

#### 1. 按日期分割日志文件

	log.SetRollingDaily("d:/foldTest", "log.txt")
	每天按 log_20221015.txt格式 分割
	若 log_20221015.txt已经存在，则生成 log_20221015.1.txt ，log_20221015.2.txt等文件
	
	log.SetRollingByTime("d:/foldTest", "log.txt",MODE_MONTH)
	按月份分割日志，跨月时，保留上月份日志，如：
		log_202210.txt
		log_202211.txt
		log_202212.txt
	
	log.SetRollingByTime("d:/foldTest", "log.txt",MODE_HOUR)
	按小时分割日志, 如：
		log_2022101506.txt
		log_2022101507.txt
		log_2022101508.txt

#### 2. 按文件大小分割日志文件

	log.SetRollingFile("d:/foldTest", "log.txt", 300, MB)
	当文件超过300MB时，按log.1.txt，log.2.txt 格式备份
	目录参数可以为空，则默认当前目录。
	
	log.SetRollingFileLoop(`d:/foldTest`, "log.txt", 300, MB, 50) 
	设置日志文件大小最大为300M
	日志文件只保留最新的50个

#### 控制台日志设置

	全局log：SetConsole(false)控制台不打日志,默认值true
	实例log：log.SetConsole(false)控制台不打日志,默认值true

***

### 打印日志示例：

	//SetRollingFile("", "log.txt", 1000, KB)  设置日志文件信息
	//SetRollingFileLoop(``, "log.txt", 300, MB, 50)   设置日志文件大小300M，最多保留50个最近的日志文件
	//SetRollingByTime(``, "log.txt", MODE_MONTH) 按月份分割日志
	//SetRollingByTime(``, "log.txt", MODE_HOUR)  按小时分割日志
	//SetRollingByTime(``, "log.txt", MODE_DAY)  按天分割日志与调用SetRollingDaily("", "log.txt") 作用相同
	
	
	//控制台不打印
	// SetConsole(false)
	
	Debug("00000000000")
	//默认格式：[DEBUG]2023/07/10 18:40:49 logging_test.go:12: 00000000000

	SetFormat(FORMAT_NANO) 
	Debug("111111111111")
	//设置格式(无格式化)：111111111111

	SetFormat(FORMAT_LONGFILENAME) 
	Info("22222222")
	//设置格式(长文件路径) ：[INFO]/usr/log/logging/logging_test.go:14: 22222222

	SetFormat(FORMAT_DATE | FORMAT_SHORTFILENAME) 
	Warn("333333333")
	//设置格式(日期+短文件路径) ：[WARN]2023/07/10 logging_test.go:16: 333333333

	SetFormat(FORMAT_DATE | FORMAT_TIME) /
	Error("444444444")
	/设置格式 ：[ERROR]2023/07/10 18:35:19 444444444
	
	SetFormat(FORMAT_SHORTFILENAME)
	Fatal("5555555555")
	//设置格式 ：[FATAL]logging_test.go:21: 5555555555

	SetFormat(FORMAT_TIME)
	Fatal("66666666666")
	//设置格式 ：[FATAL]18:35:19 66666666666

#### 校正打印时间

	//修改TIME_DEVIATION可以校正日志打印时间，单位纳秒
	TIME_DEVIATION