用Go语言构建微服务(2)创建第一个微服务 - Go语言中文社区

用Go语言构建微服务(2)创建第一个微服务


在博客系列的第2部分中,我们将:

·        设置Go工作区

·        构建第一个微服务

·        使用GorillaWeb ToolkitHTTP上提供一些JSON

为了专注于Go基础知识,我们会稍后在DockerSwarm上部署它。

介绍

    虽然通过HTTP提供JSON并不是进行内部服务或外部通信的唯一选择,但我们将在本系列博文中关注HTTPJSON。当您的服务的外部消费者是另一个系统时,使用RPC机制和协议缓冲区等二进制消息格式可以成为服务间通信或外部通信,是非常有趣的选择。Go内置支持RPC,值得关注。但是,现在我们将重点关注go内置的http软件包Gorilla Web Toolkit来提供HTTP 

    需要考虑的另一方面是:许多有用的框架(安全性,跟踪......)依赖于HTTP头来传输参与者之间正在进行的请求的状态。稍后的博客文章中将看到的例子是:如何在HTTP标头中传递关联标识和OAuth承载。虽然其他协议肯定支持类似的机制,但许多框架都是以HTTP为基础构建的,但我努力做到保持集成尽可能简单。

设置GO工作区

如果您已是经验丰富的Go开发人员,请随意跳过本节。在我看来,Go工作空间的结构需要花一些时间适应。在习惯于将项目的根作为工作空间根的地方后,Go约定如何正确地构建工作空间,以便编译器能够找到源代码和依赖关系有点不合常规,将源代码放在/ src文件夹下及子目录下。强烈建议在开始之前阅读官方指南本文。希望我有。

安装SDK

在编写第一行代码之前(或者查看完整的源代码),需要安装GoSDK。建议遵循官方指南,它应该足够简单。

建立开发环境。

在博客系列中,将使用刚刚安装的用于构建和运行的内置GoSDK工具,并遵循设置Go工作区的惯用方式。

1.在工作区创建根文件夹

所有命令都基于OS XLinux开发环境。如果您正在运行Windows,请根据需要修改说明。

mkdir ~/goworkspace
cd goworkspace
export GOPATH=`pwd`
在这里,我们创建了一个根文件夹,然后将环境变量GOPATH指定到该文件夹。这是工作空间的根目录,所编写的Go源代码或将使用的第三方库将存放在这。建议将这个GOPATH添加到.bash_profile或类似的文件中,这样每次打开新的控制台窗口时,都不必重置它。

2.为项目创建文件夹和文件

当前我们位于工作空间的根目录中(例如,与GOPATH env var中指定的文件夹相同),请执行以下语句:

mkdir -p src/github.com/callistaenterprise

如果您想遵循并自己编写代码,请执行以下命令:

cd src/github.com/callistaenterprise
mkdir -p goblog/accountservice
cd goblog/accountservice
touch main.go
mkdir service

或者,您可以克隆包含示例代码的git存储库并切换到分支P2。从上面创建的src /github.com / callistaenterprise文件夹中,执行:

git clone https://github.com/callistaenterprise/goblog.git
cd goblog
git checkout P2

请记住 -$ GOPATH/src/github.com/callistaenterprise/goblog项目的根文件夹,实际存储在github上。

现在应该有足够的结构来让我们开始。GoIDE中打开main.go在为本博客系列编写代码时,我正在使用IntelliJIDEA及其出色的Golang插件。其他流行的选择似乎是Eclipse(带Go插件)AtomSublimevimJetBrains新的专用商业Gogland IDE

创建服务MAIN.GO

如您所期望,main函数正是Go程序的入口。让我们创建更多的代码来获得可以真实构建和运行的东西:

package main

import (
        "fmt"
        )
        
var appName = "accountservice"

func main() {
    fmt.Printf("Starting %vn", appName)
}

现在,来运行它。确认当前路径为$ GOPATH/src/github.com/callistaenterprise/goblog/accountservice及子文件夹中

> go run *.go
Starting accountservice
>
就是这样!该程序将打印并退出。接下来,添加第一个HTTP端点!

构建HTTP WEB服务器

注意:这些HTTP示例的基础知识来自一篇出色的博客文章

为了保持整洁,我们将所有HTTP服务相关文件放入service文件夹中。


/ services文件夹中创建文件webserver.go

package service

import (
        "net/http"
        "log"
)

func StartWebServer(port string) {

        log.Println("Starting HTTP service at " + port)
        err := http.ListenAndServe(":" + port, nil)    // Goroutine will block here

        if err != nil {
                log.Println("An error occured starting HTTP listener at port " + port)
                log.Println("Error: " + err.Error())
        }
}

使用内置的net / http包来执行ListenAndServe,它在指定的端口上启动HTTP服务器。

修改main.go指定端口调用StartWebServer函数:

package main

import (
        "fmt"
        "github.com/callistaenterprise/goblog/accountservice/service"  // NEW
)

var appName = "accountservice"

func main() {
        fmt.Printf("Starting %vn", appName)
        service.StartWebServer("6767")           // NEW
}
再次运行:

> go run *.go
Starting accountservice
2017/01/30 19:36:00 Starting HTTP service at 6767

现在一个简单的HTTP服务器,在本地主机6767端口监听。访问一下:

> curl http://localhost:6767
404 page not found

404正是我们期待的,因为还没有发布路由信息。Ctrl+ C停止Web服务器。

添加第一条路由

现在是时候从服务器实际提供服务了。首先使用Go 结构声明我们的第一条路由,然后使用它来填充Gorilla路由器。在 service文件夹中,创建routes.go

package service

import "net/http"

// Defines a single route, e.g. a human readable name, HTTP method and the
// pattern the function that will execute when the route is called.
type Route struct {
	Name        string
	Method      string
	Pattern     string
	HandlerFunc http.HandlerFunc
}

// Defines the type Routes which is just an array (slice) of Route structs.
type Routes []Route

// Initialize our routes
var routes = Routes{

	Route{
		"GetAccount",                                     // Name
		"GET",                                            // HTTP method
		"/accounts/{accountId}",                          // Route pattern
		func(
                            
                            版权声明:本文来源CSDN,感谢博主原创文章,遵循 CC 4.0 by-sa 版权协议,转载请附上原文出处链接和本声明。
原文链接:https://blog.csdn.net/jato333/article/details/80572709
站方申明:本站部分内容来自社区用户分享,若涉及侵权,请联系站方删除。
  • 发表于 2019-08-27 15:59:18
  • 阅读 ( 1217 )
  • 分类:Go

0 条评论

请先 登录 后评论

官方社群

GO教程

猜你喜欢