目標

echoのインストールから初期設定からサーバーの起動までを行う
DBからの取得は次回に実施する

echo

GoのWebフレークワークの１つ
WebフレームワークとしてはGinが有名ではあるが、近年は注目を集めている様子がある。
スター数などは全然Ginのほうが圧倒的な状況でもある。
採用理由は、ベースの使い方は同じなのでトレンドっぽさで選択した。

参考: https://go.libhunt.com/compare-gin-vs-echo

echoを導入する

利用環境についてはこちら
https://qiita.com/dsricekun/items/33968201abdc2992671d

STEP1 echoモジュールを取得

コンテナ内でモジュールを取得する

go get github.com/labstack/echo/v4

STEP2 サーバー起動設定

サーバー起動したときにポートに1323番を使用するのでdocker-compose.ymlを見直す

version: '3'
services:
  go_echo:
    container_name: go_echo
    build:
      context: ./echo/
    volumes:
      - ./echo:/go/src/app
    tty: true
    environment:
      - TZ=Asia/Tokyo
    ports:
      - 1323:1323

  go_echo_db:
    image: mysql:5.7
    container_name: mysql_host
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: echo
      MYSQL_USER: docker
      MYSQL_PASSWORD: docker
      TZ: 'Asia/Tokyo'
    command: mysqld --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
    volumes:
      - ./database/data:/var/lib/mysql
    ports:
      - 3306:3306

今までの構成に新しくmain.goを追加する

tree.nathanfriend.io
What is this?
database
echo
  main.go(new)
  go.mod
  Dockerfile
docker-compose.yml
database
echo
  main.go(new)
  go.mod
  Dockerfile
docker-compose.yml
.
├── database
├── echo/
│   ├── main.go(new)
│   ├── go.mod
│   └── Dockerfile
└── docker-compose.yml

main.goはechoのチュートリアルに従って次の実装をする

package main

import (
	"github.com/labstack/echo/v4"
	"net/http"
)

func main() {
	server := echo.New()
	server.GET("/", func(ctx echo.Context) error {
		return ctx.String(http.StatusOK, "Hello, World")
	})

	server.Logger.Fatal(server.Start(":1323"))
}

コンテナ内でサーバー起動を行う

コマンド
go run main.go

実行結果はこちら

/go/src/app # go run main.go

   ____    __
  / __/___/ /  ___
 / _// __/ _ \/ _ \
/___/\__/_//_/\___/ v4.10.2
High performance, minimalist Go web framework
https://echo.labstack.com
____________________________________O/_______
                                    O\
⇨ http server started on [::]:1323

出力が確認できたらブラウザから「http://localhost:1323 」にアクセスする
正常に設定できていたら

の出力確認ができる。

出力確認ができたらechoの導入は成功になる

echoを触っていくための構成を少し整理

本格的な構成は仕様を整理してからになるが、さすがにあまりイケていないので構成を整理する
ここからはechoファルダ内のみの構成を記載する。
全体図が気になる方はgithubのアクセスURLを記載するのでそちらを見てください。
URL： https://github.com/dsrice/go_echo/tree/part2

.
├── controllers/
│   └── hello.go
├── infra/
│   └── server.go
└── main.go

各役割を説明すると

controllersディレクトリ: EPの実処理にあたるコントローラー置き場
hello.go: 暫定で用意するコントローラー　controllersパッケージになるのでファイル名にはcontrollerはつけない
infraディレクトリ: 環境関連ファイル置き場
server.go: ルーティングなどサーバーに関する処理をまとめるファイル
main.go: サーバーの起動といった起動処理をまとめるファイル

hello.go

package controllers

import (
	"github.com/labstack/echo/v4"
	"net/http"
)

type HelloController struct{}

func NewHelloController() *HelloController {
	return &HelloController{}
}
func (controller *HelloController) GetMessage(ctx echo.Context) error {
	return ctx.String(http.StatusOK, "Hallow World!")
}

server.go

package infra

import (
	"app/controllers"
	"github.com/labstack/echo/v4"
)

type Server struct {
	Echo *echo.Echo
}

func NewServer() *Server {
	return &Server{
		Echo: echo.New(),
	}
}

func (server *Server) Start() {
	server.Echo.GET("/", controllers.NewHelloController().GetMessage)

	server.Echo.Start(":1323")
}

main.go

package main

import "app/infra"

func main() {
	server := infra.NewServer()
	server.Start()
}

終わりに

今回はechoを導入してチュートリアルに沿った簡単な実装を対応した。
echoが使えるようになったので次回から公式ドキュメントを参考に設定を追加していこうと考えている

参考文献