Go后台项目实战

本项目完全使用原生开发，没有使用任何WEB框架(如：gin，beego，Martini等)，和ORM(如：gorm,xorm,beego)

三层架构

三层架构(3-tier architecture) 通常意义上的三层架构就是将整个业务应用划分为：界面层（User Interface layer）、业务逻辑层（Business Logic Layer）、数据访问层（Data access layer）。区分层次的目的即为了“高内聚低耦合”的思想。在软件体系架构设计中，分层式结构是最常见，也是最重要的一种结构。

控制层/界面层

因为我的项目中并没有写WEB页面，所以就拿控制层来说，就是将你的请求从页面传到后台代码

服务层/业务逻辑层

针对具体问题的操作，也可以说是对数据层的操作，对数据业务逻辑处理。（关键在于由原始数据抽象出逻辑数据）能够提供interface\API层次上所有的功能。，“中间业务层”的实际目的是将“数据访问层”的最基础的存储逻辑组合起来，形成一种业务规则

持久层/数据访问层

该层所做事务直接操作数据库，针对数据的增添、删除、修改、查找等。（关键在于粒度的把握）要保证“数据访问层”的中的函数功能的原子性！即最小性和不可再分。“数据访问层”只管负责存储或读取数据就可以了。

Controller组合封装

Controller"基类"封装，主要提供了一个保存文件的方法，主要用于form-data请求

type Controller struct {
	Data interface{}
}

type FileInfoTO struct {
	//图片id -- 暂时没有用
	ID int64
	//缩略图路径 -- 暂时没有用
	CompressPath string
	//原图路径 ,保存数据库的路径
	Path string
	//原始的文件名
	OriginalFileName string
	//存储文件名 如：uuidutil
	FileName string
	//文件大小
	FileSize int64
}

//解析Form-data中的文件，不管上传的文件的字段名(fieldname)是什么，都会解析
func (p *Controller) SaveFiles(r *http.Request,relativePath string) []*FileInfoTO {
	r.ParseMultipartForm(32 << 20)
	m := r.MultipartForm
	if m == nil {
		log.Println("not multipartfrom !")
		return nil
	}
	fileInfos := make([]*FileInfoTO,0)

	filePath := constant.BASE_IMAGE_ADDRESS + relativePath
	utils.MakeDir(filePath)

	//files := m.File["files"] //根据上传文件时指定的字段名(fieldname)获取FileHeaders
	for _,fileHeaders := range m.File { //遍历所有的所有的字段名(fieldname)获取FileHeaders
		for _,fileHeader := range fileHeaders{
			file,err := fileHeader.Open()
			if err != nil {
				log.Println(err)
				return fileInfos
			}
			defer file.Close()
			name,err := utils.RandomUUID()
			if err != nil {
				log.Println(err)
				return fileInfos
			}
			fileType := utils.Ext(fileHeader.Filename,".jpg")
			newName := name.String() + fileType
			dst,err := os.Create(filePath + newName)
			if err != nil {
				log.Println(err)
				return fileInfos
			}
			fileSize,err := io.Copy(dst,file)
			if err != nil {
				log.Println(err)
				return fileInfos
			}
			fileInfos = append(fileInfos, &FileInfoTO{Path:relativePath + newName,OriginalFileName:fileHeader.Filename,FileName:newName,FileSize:fileSize})
		}
	}
	return fileInfos
}

ApiController主要用于用户体系的一个登陆状态的信息获取，根据请求中的session获取服务端保存的用户信息，如果你的后台分用户体系和管理端用户体系，并且这两个用户体系分别存储在两个表中，这时你还可以定义一个BackController 

type ApiController struct {
	Controller
}

func (p *ApiController) GetUserId(w http.ResponseWriter,r *http.Request) uint {
	user := p.GetUser(w,r)
	if user == nil {
		return 0
	}
	return user.ID
}

func (p *ApiController) GetUser(w http.ResponseWriter,r *http.Request) *entity.User {
	session := GlobalSession().SessionStart(w,r)
	if session == nil {
		return nil
	}
	key_user := session.Get(constant.KEY_USER)
	if user,ok := key_user.(*entity.User);ok{
		return user
	}
	return nil
}

database

持久层的实现：https://blog.csdn.net/cj_286/article/details/80363796

http

http server的实现：https://blog.csdn.net/cj_286/article/details/80256988

Router

路由处理的实现，其实也就是一个转发的功能

type RouterHandler struct {
}

var mux = make(map[string]func(http.ResponseWriter,*http.Request))

func (p *RouterHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
	fmt.Println(r.URL.Path)
	if fun, ok := mux[r.URL.Path]; ok {
		fun(w, r)
		return
	}
	//静态资源
	if strings.HasPrefix(r.URL.Path,constant.STATIC_BAES_PATH){
		if fun, ok := mux[constant.STATIC_BAES_PATH]; ok {
			fun(w, r)
			return
		}
	}
	http.Error(w, "error URL:"+r.URL.String(), http.StatusBadRequest)

}

func (p *RouterHandler) Router(relativePath string, handler func(http.ResponseWriter, *http.Request)) {
	mux[relativePath] = handler
}

session

如果有登录功能，所以需要用到session来记住用户的状态，以下是session技术实现的主要类型与接口定义，(摘自：https://github.com/astaxie/build-web-application-with-golang/blob/master/zh/06.0.md)，会话过期时间可以自行设置，如果设置为一小时，在停止会话一小时后session就会过期，该session就会被自动删除，如果回话都保持在一小时之内就可以一直访问，session不会过期

//主要用于session的管理，过期处理等
type Manager struct {
	cookieName string
	lock sync.Mutex
	provider Provider
	maxLifeTime int64
}
//用于提供session存储方式的一个接口标准，可以用于提供session储存在内存、文件、数据库等方式
type Provider interface {
	SessionInit(sid string)(Session,error)
	SessionRead(sid string)(Session,error)
	SessionDestroy(sid string) error
	SessionGC(maxLifeTime int64)
}
//用于对session一些基本操作的定义
type Session interface {
	Set(key, value interface{}) error
	Get(key interface{}) interface{}
	Delete(key interface{}) error
	SessionID()string
}

静态资源

静态资源处理需要用到http.FileServer和http.StripPrefix函数，http.FileServer通常要跟http.StripPrefix结合使用

http.StripPrefix函数的作用之一，就是在将请求定向到你通过参数指定的请求处理处之前，将特定的prefix从URL中过滤出去。下面是一个浏览器或HTTP客户端请求资源的例子：

/static/example.png

StripPrefix 函数将会过滤掉/static/，并将修改过的请求定向到http.FileServer所返回的Handler中去，因此请求的资源将会是： 

/example.png

http.FileServer 返回的Handler将会进行查找，并将与文件夹或文件系统有关的内容以参数的形式返回给你（在这里你将"static"作为静态文件的根目录）。因为你的"example.txt"文件在静态目录中，你必须定义一个相对路径去获得正确的文件路径。

根据需要定制访问路径

http.Handle("/tmpfiles/",http.StripPrefix("/tmpfiles/", http.FileServer(http.Dir("/tmp"))))

FileServer 已经明确静态文件的根目录在"/tmp"，但是我们希望URL以"/tmpfiles/"开头。如果有人请求"/tempfiles/example.txt"，我们希望服务器能将文件发送给他。为了达到这个目的，我们必须从URL中过滤掉"/tmpfiles", 而剩下的路径是相对于根目录"/tmp"的相对路径。如果我们按照如上做法，将会得到如下结果：

/tmp/example.png

演示

粗略的设计了几个API，以下就是访问API的请求与响应截图，以下除了注册和登录不会去检测session，其它API都会检测，要求登录才可以访问。

未登录状态下调用添加意见反馈接口

登录状态下调用添加意见反馈接口

访问静态资源

项目地址：https://github.com/xiaojinwei/cgo

参考：https://studygolang.com/articles/9197

          https://github.com/astaxie/build-web-application-with-golang/blob/master/zh/06.0.md