ZTool一款Go语言非常好用开发工具集

druidcaesa · · 1659 次点击 · · 开始浏览    
这是一个创建于 的文章,其中的信息可能已经有所发展或是发生改变。

# 官方文档地址->:[文档地址](https://termites.gitee.io/zbook-blog) # 一、概述 **ZTool是在上个gotool的基础上延伸过来的,因为gotoo这个项目中间存在很多第三方库的依赖,然而第三方库停止更新,中间存在很多bug没有维护,造成工具包中间同样存在很多问题** **最终经过考虑,停止维护gotool重新开一个工程,ztool不进行任何的第三方库依赖,进行开发。同时经过两年多的实际项目开发总结,将业务底层代码抽离,抽出了由,字符串、时间、随机id、http客户端、加密等工具集,同时我们也欢迎广大go爱好者进行pr,同时我们也开辟了pr通道** # 二、简介 **ZTool是一个小巧而快捷工具库,通过方法封装,降低相关API的学习成本,提高工作效率,让使用GO语言开发编写代码更加优雅。** **ZTool中的工具方法来自我们长达两年的多使用go语言进行实际项目开发总结而来,它涵盖了GO开发中常用的方法,它既是大型项目开发中解决小问题的利器,也是小型项目中的效率担当;** **ZTool它节省了开发人员对项目中公用类和公用工具方法的封装时间,使开发专注于业务,同时可以最大限度的避免封装不完善带来的bug。** # 三、安装 1. go开发环境安装 * 安装包下载地址:[官方地址:https://go.dev/dl/](https://go.dev/dl/) * 如果无法打开请使用备选地址:[备选地址:https://go.dev/dl/](https://go.dev/dl/) 2. go env来查看和验证go的环境信息,例如我的部分配置信息如下: ```shell GO111MODULE="on" GOARCH="amd64" GOBIN="" GOCACHE="/Users/Janus/Library/Caches/go-build" GOENV="/Users/Janus/Library/Application Support/go/env" GOMODCACHE="/Users/Janus/gopath/pkg/mod" GONOPROXY="github.com" GONOSUMDB="github.com" GOPATH="/Users/Janus/gopath" GOPRIVATE="github.com" GOPROXY="https://goproxy.cn,direct" GOROOT="/usr/local/go" GOSUMDB="sum.golang.org" GOTOOLDIR="/usr/local/go/pkg/tool/darwin_amd64" ``` <font color="red">注意:GO111MODULE必须是开启开启状态,若为开启请自行google或百度解决</font> ### 2、ztool工具包安装 1. 版本要求 ```go go >=1.15 ``` 2. 版本检查 ```go go version ``` 3. go get 安装 ```shell go get -u -b github.com/druidcaesa/ztool ``` 4. go mod安装 ```shell require github.com/druidcaesa/ztool ``` # 四、字符串操作工具 <font size="3">使用<font color="red"> ztool.StrUtils</font>调用对应的方法,ztool.StrUtils是字符串操作的核心类</font> | 方法 |参数说明| 说明 | | :----: |:----: | :----: | |[SnakeString](#_2、驼峰转蛇形)|string|驼峰转蛇形,返回类型为string| |[CamelString](#_3、蛇形转驼峰)|string|蛇形转驼峰,返回类型为string| |[HasBlank](#_4、不可见字符串判空)|string|不可见字符串判空,返回bool类型| |[HasEmpty](#_5、判断是否是空字符串)|string|判断是否是空字符串(""),返回bool类型| |[RemoveSuffix](#_6、删除文件后缀获取文件名)|string|删除文件后缀获取文件名,返回string| |[RemovePrefix](#_7、获取文件拓展名)|string|获取文件拓展名,返回string| |[EncodeHexString](#_8、字符串16进制编码)|string|字符串16进制编码,返回string| |[DecodeHexString](#_9、16进制转字符串)|string|16进制转字符串,返回(string,error)| # 五、时间操作工具 <font size="3">使用<font color="red"> ztool.DateUtils</font>调用对应的方法,ztool.DateUtils是时间用用的核心类</font> **ztool.DateUtils的返回类型是个struct以下是对结构体的说明,ztool.DateUtils可使用链式方法调用** ```go type DateTime struct { t time.Time //go的时间类型封装 weekStartDay common.Weekday //一周的开始时间设定 } ``` | 方法 |参数说明| 说明 | | :----: |:----: | :----: | |[Now](#_2、获取当前时间)|无参|获取当前时间,返回类型为DateTime结构体| |[Format](#_3、格式化时间)|...string可选参数|格式化时间,返回类型是string 字符串| |[SetTime](#_4、设置时间方法)|...time.Time可选时间类型参数|设置时间,需要传入time.Time,返回类型为DateTime结构体| |[OperationDay](#_5、时间计算按天加减)|int 参数为int|按照天对时间进行加减,参数可正负,返回类型为DateTime结构体| |[OperationMoon](#_6、时间计算按月加减)|int 参数为int|按照月对时间进行加减,参数可正负,返回类型为DateTime结构体| |[OperationYears](#_7、时间计算按年加减)|int 参数为int|按照年对时间进行加减,参数可正负,返回类型为DateTime结构体| |[StartOfHour](#_8、获取当前时间小时的开始时间)|无参|获取当前时间的开始时间,返回类型为DateTime结构体| |[StartTimeOfDay](#_9、获取当天的开时间)|无参|获取当天的开时间,返回类型为DateTime结构体| |[StartOfMinute](#_10、获取分钟的开始)|无参|获取分钟的开始,返回类型为DateTime结构体| |[StartOfWeek](#_11、获取一周的开时间)|无参|获取一周的开时间,返回类型为DateTime结构体| |[StartOfMonth](#_12、获取当月的开始时间)|无参|获取当月的开始时间 ,返回类型为DateTime结构体| |[SetWeekStartDay](#_13、设置一周的开始时间是那天)|common.Monday|设置一周的开始时间是那天 ,返回类型为DateTime结构体| |[StartOfQuarter](#_14、获取当前季度的开始时间)|无参|获取当前季度的开始时间 ,返回类型为DateTime结构体| |[StartOfYear](#_15、获取本年度开始时间)|无参|获取本年度开始时间 ,返回类型为DateTime结构体| |[EndOfMinute](#_16、获取当前分钟结束时间)|无参|获取当前分钟结束时间 ,返回类型为DateTime结构体| |[EndOfHour](#_17、获取当前小时的结束时间)|无参|获取当前小时的结束时间 ,返回类型为DateTime结构体| |[EndOfDay](#_18、获取今天的结束时间)|无参|获取今天的结束时间 ,返回类型为DateTime结构体| |[EndOfWeek](#_19、获取本周结束时间)|无参|获取本周结束时间 ,返回类型为DateTime结构体| |[EndOfMonth](#_20、获取本月结束时间)|无参|获取本月结束时间 ,返回类型为DateTime结构体| |[EndOfQuarter](#_21、获取本季度结束时间)|无参|获取本季度结束时间 ,返回类型为DateTime结构体| |[EndOfYear](#_22、获取本年度结束时间)|无参|获取本年度结束时间 ,返回类型为DateTime结构体| |[Parse](#_23、字符串格式化时间)|...string|字符串格式化时间 ,返回类型为DateTime结构体| # 六、加密操作工具 <font size="3">使用<font color="red"> ztool.EncryptionUtils</font>调用对应的方法,ztool.EncryptionUtils是加密工具的核心类</font> | 方法 |参数说明| 说明 | | :----: |:----: | :----: | |AesEncrypt|string,...string|AES加密方法,返回类型为(string,error)| |AesDecrypt|string,...string|AES解密方法,返回类型为(string,error)| |DesDecrypt|string,...string|DES解密方法,返回类型为(string,error)| |DesDecrypt|string,...string|DES解密方法,返回类型为(string,error)| |Md5Encode|string|Md5签名方法,返回类型为string| |Md5Check|string,string|Md5Check,返回类型为boole| # 七、Http客户端 <font size="3">使用<font color="red"> ztool.HttpUtils</font>调用对应的方法,ztool.HttpUtils是http客户端工具的核心类</font> | 方法 |参数说明| 说明 | | :----: |:----: | :----: | |Get|string,...interface{}|发送GET请求,返回类型为(string, error)| |Post|string,...interface{}|发送POST请求,返回类型为(string, error)| |Put|string,...interface{}|发送PUT请求,返回类型为(string, error)| |Delete|string,...interface{}|发送DELETE请求,返回类型为(string, error)| |UploadFilePath|url, filename, filePath string|文件上传,返回类型为(string, error)| |NewRequest|无参|获取request,返回类型为request 结构体| * request结构体是自定义结构体,里面有原http的request的对应封装 ```go // Request request subject type Request struct { //request client cli *http.Client //Timeout setting timeout time.Duration //request handler headers map[string]string //request parameters data interface{} //logger turn on logger bool //specifies the cookie jar jar http.CookieJar //For details of the agent, please refer to the official documentation proxy func(*http.Request) (*url.URL, error) //CheckRedirect specifies the policy for handling redirects checkRedirect func(req *http.Request, via []*http.Request) error //cookies setting cookies map[string]string //set request method method string //set request url url string tlsClientConfig *tls.Config disableKeepAlive bool transport *http.Transport debug bool } ``` # 八、加密工具 <font size="3">使用<font color="red"> ztool.IdUtils</font>调用对应的方法,ztool.IdUtils是ID生成工具的核心类</font> | 方法 |参数说明| 说明 | | :----: |:----: | :----: | |RandomUUID|无参|带有"-"的UUID,返回类型为(string,error)| |SimpleUUID|无参|不带"-"的UUID,返回类型为(string,error)| |GenerateSnowflakeId|无参|SnowFlake算法的ID,返回类型为int| # 九、身份验证 <font size="3">使用<font color="red"> ztool.IDCardUtils</font>,现在支持大陆15位、18位身份证</font> | 方法 |参数说明| 说明 | | :----: |:----: | :----: | |Check|string|全局校验身份证,返回类型为(bool, error)| |GetProvinceByIdCard|string|获取身份证所在地,string| |IsValidCard|string|身份证是否符合18或者15位,返回类型为(bool, error)| |Convert15To18|string|15位转18位,返回类型为string| |GetBirthByIdCard|string|获取生日,返回类型为(string, error)| |GetAgeByIdCard|string|获取年龄,返回类型为int| |GetYearByIdCard|string|获取出生年,返回类型为string| |GetMonthByIdCard|string|获取出生月,返回类型为string| |GetDayByIdCard|string|获取出生日,返回类型为string| |GetSex|string|获取性别,返回类型为int|

有疑问加站长微信联系(非本文作者))

入群交流(和以上内容无关):加入Go大咖交流群,或添加微信:liuxiaoyan-s 备注:入群;或加QQ群:692541889

1659 次点击  ∙  2 赞  
加入收藏 微博
暂无回复
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
  • 图片支持拖拽、截图粘贴等方式上传