官方文档地址->：文档地址

一、概述

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/

2. go env来查看和验证go的环境信息，例如我的部分配置信息如下：

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 >=1.15 

2. 版本检查

go version 

3. go get 安装

go get -u -b github.com/druidcaesa/ztool

4. go mod安装

require github.com/druidcaesa/ztool

四、字符串操作工具

<font size="3">使用<font color="red"> ztool.StrUtils</font>调用对应的方法，ztool.StrUtils是字符串操作的核心类</font>

五、时间操作工具

<font size="3">使用<font color="red"> ztool.DateUtils</font>调用对应的方法，ztool.DateUtils是时间用用的核心类</font>

ztool.DateUtils的返回类型是个struct以下是对结构体的说明，ztool.DateUtils可使用链式方法调用

type DateTime struct {
    t            time.Time //go的时间类型封装
    weekStartDay common.Weekday //一周的开始时间设定
}

六、加密操作工具

<font size="3">使用<font color="red"> ztool.EncryptionUtils</font>调用对应的方法，ztool.EncryptionUtils是加密工具的核心类</font>

七、Http客户端

<font size="3">使用<font color="red"> ztool.HttpUtils</font>调用对应的方法，ztool.HttpUtils是http客户端工具的核心类</font>

• request结构体是自定义结构体，里面有原http的request的对应封装

// 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>

九、身份验证

<font size="3">使用<font color="red"> ztool.IDCardUtils</font>,现在支持大陆15位、18位身份证</font>