介绍
Golang是一种令人兴奋的语言,但新手可能会被新的语法和各种框架所淹没。基础知识入门可能会成为一项挑战。
在这个例子中,我想展示创建功能API所需的最少代码。我们将开发一个简单的API,为基本模型提供创建,读取,更新和删除(CRUD)功能。使用和对象关系映射(ORM)工具,我们将能够快速更新我们的数据模型,所有数据模型都在100行代码之下。所以让我们开始吧。
入门
Gin Web框架
由于我们将通过HTTP提供我们的API,因此我们需要一个Web框架来处理路由并提供请求。有许多框架可用,具有不同的功能和性能指标。在这个例子中,我们将使用Gin框架https://github.com/gin-gonic/gin 。由于速度和简单性,Gin是API开发的一个很好的框架。
首先,让我们在$ GOPATH / src / simple-api中为我们的服务创建一个新文件夹,然后添加一个main.go文件,如下所示
package main
import “fmt”
func main() {
fmt.Println(“Hello World”)
}
在我们继续学习前,让我们测试一下,确保一切正常运行。
$ go run main.go
Hello World
程序运行正常。现在让我们使用Gin框架将它变成一个Web应用程序。
package main
import “github.com/gin-gonic/gin”
func main() {
r := gin.Default()
r.GET(“/”, func(c *gin.Context) {
c.String(200, “Hello World”)
})
r.Run()
}
保存并运行它
$ go run main.go
[GIN-debug] [WARNING] Running in “debug” mode. Switch to “release” mode in production.
— using env: export GIN_MODE=release
— using code: gin.SetMode(gin.ReleaseMode)
[GIN-debug] GET / → main.main.func1 (3 handlers)
[GIN-debug] Environment variable PORT is undefined. Using port :8080 by default
[GIN-debug] Listening and serving HTTP on :8080
[GIN] 2016/12/02–14:57:52 | 200 | 33.798µs | ::1 | GET /
Hello World
成功!!!
我们正在构建一个API,但不是一个Web应用程序,所以让我们将其切换到JSON响应
package main
import “github.com/gin-gonic/gin”
func main() {
r := gin.Default()
r.GET(“/”, func(c *gin.Context) {
c.JSON(200, gin.H{
“message”: “Hello World”,
})
})
r.Run() // listen and server on 0.0.0.0:8080
}
保存文件,重新运行并刷新浏览器,您应该看到我们的JSON 消息
{“message”:“Hello World”}
GORM的数据持久性
现在让我们看看我们的持久层。对于本节我们将使用本地的基于SQLite文件的数据库开始。稍后我们将切换到使用MySql来证明。
Gorm http://jinzhu.me/gorm/是一个用于go的对象关系映射(ORM)框架。它大大简化了模型到数据库的映射和持久化。尽管我不是大型复杂系统的ORM的忠实拥趸,但他们对原型开发新的绿地应用程序确实很有效。Gorm在Go领域是一个非常受欢迎的工具,我们将在这里看看它。
为了解决gorm问题,我们将把我们刚写的Gin代码换掉,并且演示一下gorm的功能。学习完这块,我们会将Gin重新添加到应用程序中。
让我们开始一个小例子。
package main
import (
“github.com/jinzhu/gorm”
_ “github.com/jinzhu/gorm/dialects/sqlite”
)
func main() {
db, _ := gorm.Open(“sqlite3”, “./gorm.db”)
defer db.Close()
}
如果你现在运行这个程序,你会在你的文件系统中看到一个名为gorm.db的新文件。这是我们的数据库文件系统将在应用程序中使用。虽然我们可以看到我们的应用程序正在运行,而且gorm正在被使用,但我们的系统还没有完成。让我们添加更多的代码。
package main
import (
“fmt”
“github.com/jinzhu/gorm”
_ “github.com/jinzhu/gorm/dialects/sqlite”
)
type Person struct {
ID uint `json:”id”`
FirstName string `json:”firstname”`
LastName string `json:”lastname”`
}
func main() {
db, _ := gorm.Open(“sqlite3”, “./gorm.db”)
defer db.Close()
p1 := Person{FirstName: “John”, LastName: “Doe”}
p2 := Person{FirstName: “Jane”, LastName: “Smith”}
fmt.Println(p1.FirstName)
fmt.Println(p2.LastName)
}
在这里,我们刚刚添加了一个简单的Person结构,并在使用它们打印出值之前创建了一些实例。请记住,Person结构中的字段需要以大写字母开头,因为Go定义这些是公共字段。
现在我们已经有了一个可以使用Gorm的对象。
package main
import (
“fmt”
“github.com/jinzhu/gorm”
_ “github.com/jinzhu/gorm/dialects/sqlite”
)
type Person struct {
ID uint `json:”id”`
FirstName string `json:”firstname”`
LastName string `json:”lastname”`
}
func main() {
db, _ := gorm.Open(“sqlite3”, “./gorm.db”)
defer db.Close()
db.AutoMigrate(&Person{})
p1 := Person{FirstName: “John”, LastName: “Doe”}
p2 := Person{FirstName: “Jane”, LastName: “Smith”}
db.Create(&p1)