<p>Go言語のインストールから、プロジェクトを作り実行するところまで行います。<br>Goのプロジェクト作成と実行は簡単です！<br><br></p><h2 id="h17af2c0069">Goのダウンロード</h2><p>英語ですが、公式サイトに分かり易い正規のインストール手順が載っています。<br>公式サイト <a href="https://go.dev/doc/install" target="_blank" rel="noopener noreferrer">https://go.dev/doc/install</a><br><br>環境によってダウンロードするファイルが異なるので、自分の環境用のファイルをダウンロードしましょう。<br></p><h2 id="h52f04b7006">Goのインストール（Windows）</h2><p>ダウンロードしたファイルを開き、ボタンをクリックしていればインストールできます。<br></p><h2 id="hec7c09af4e">Goのインストール（Linux）</h2><h3 id="hde6bc4b4c7">tar.gzファイルのあるパスに移動する</h3><p>WSL2であれば、エクスプローラーのアドレスに<code>\\wsl$</code>を入力し、ダウンロードしたファイルをwsl2の環境に移動します。<br>もしくは、コマンドプロンプトを開き、ダウンロードしたファイルがあるパスに移動し、<code>wsl</code>コマンドでWSL2を起動します。<br></p><h3 id="hd8d793506b">インストール</h3><p>コマンドはダウンロードしたファイルのバージョンによって変わります。<br>例として書いてはいますが、実際に打つ際のコマンドはダウンロードしたバージョンと合わせてください。（公式サイトからコピペすればOKです。）</p><pre><code>tar -C /usr/local -xzf go1.17.7.linux-amd64.tar.gz</code></pre><h4 id="hcf83e1357e"><br></h4><h3 id="hfc58d39f14">環境変数を追加する</h3><p><span style="color:#202224">$HOME/.profileファイルに追記します。</span><br><span style="color:#202224">今回に限った話しではないのですが、.profileの変更を反映するには、再ログインか</span><code>source ファイル名</code><span style="color:#202224">コマンドの入力が必要です。</span></p><pre><code>export PATH=$PATH:/usr/local/go/bin</code></pre><p><br></p><h2 id="h1ad2c7a880">Goのバージョン確認</h2><pre><code>go version</code></pre><p><br></p><h2 id="hf4de4dfcf7">Goのプロジェクト作成</h2><h3 id="haf03dce536">ディレクトリ作成</h3><p>このディレクトリが、goのプロジェクトのディレクトリになります。<br>Linuxなら、<code>mkdir ディレクトリ名</code>で作成できます。<br></p><h3 id="hac62686dde">Goプロジェクト化する</h3><p>Goプロジェクトにしたいディレクトリのパスで、以下のコマンドを入力しましょう。<br>成功すると、ディレクトリ配下にgo.mod ファイルが作成されます。<br>以降はパッケージをインポートする度に、自動でgo.modが更新されます。</p><pre><code>go mod init モジュール名</code></pre><p>無駄なインポートを消したいときは<code>go mod tidy</code>を打つと整理してくれます。<br><br></p><h2 id="hf3ba3d553f">Goプロジェクトの中身を作る</h2><p>最小の構成に必要なのは、1つのgoファイルです。<br>ディレクトリ配下にmain.goファイルを作成し、コードを書きましょう。<br>Linuxの場合は<code>touch main.go</code>コマンドです。</p><pre><code>package main

import (
	"fmt"
)

func main() {
	fmt.Println("Hello, world")
}</code></pre><p><br></p><h2 id="h74e8940f56">Goプロジェクトを実行する</h2><p>ディレクトリの配下でコマンドを打ちます。</p><pre><code>go run main.go</code></pre><p><br>こちらのコマンドでも実行できて、より楽ちんです。</p><pre><code>go run .</code></pre>

Go言語のインストールから、プロジェクトを作り実行するところまで行います。
Goのプロジェクト作成と実行は簡単です！

【Go言語】インストール・プロジェクト作成・実行

<p>Go入門の内容のうち、変数についてまとめています。<br></p><h2 id="h735564b51f">変数とは</h2><p>変数は、ある型1つと、それに合った値1つを保持するものです。<br>例えばstring型の変数は、文字列である"a"を保持できます。逆に、数字の1などを保持することはできません。<br></p><h2 id="ha72dc2ed0d">宣言</h2><p>基本的には、関数内で変数の宣言を行います。<br><br>main.go例</p><pre><code>package main

import "fmt"

func&nbsp;main() {
	s := "a"
	
	fmt.Println(s)
}</code></pre><p><br>宣言の方法はいくつかあるので、次はそれを挙げていきます。<br></p><h3 id="h74d09af4e7">変数名 := 値</h3><p>最も使うパターンです。<br>上のmain.go例で使っているのもこれです。<br>宣言と代入を行っていて、最もシンプルに書けます。<br><br>型名が省略されていますが、型は値から自動で推測されます。</p><ul><li>値が<code>""</code>で囲まれている（=値が文字列） → string型</li><li>値が数字 → int型</li><li>値が<code>true</code>または<code>false</code> → bool型</li></ul><p><br>右辺が値ではなく、<code>変数名 := 関数名(引数)</code>というパターンもあります。この場合は、関数の宣言で値の型が決まっています。<br></p><h3 id="hd41bcae2be">var 変数名 型名</h3><p>例</p><pre><code>var s string</code></pre><p><br>このパターンのように初期値の無い宣言を行うと、値には型のゼロ値が入ります。&nbsp;&nbsp;<br>型によってゼロ値は異なり、string型は""（=空文字）、int型は0です。<br></p><h3 id="h3783e16025">var 変数名 型名 = 値</h3><pre><code>var s string = "a"</code></pre><p><br></p><h3 id="h0744029054">var 変数名 = 値</h3><pre><code>var s = "a"</code></pre><p><br></p><h2 id="h613c75ff61">複数の変数を宣言</h2><pre><code>s, t := "a", "b"

var s, t string

var s, t string = "a", "b"

var s,t = "a", "b"

var (
	s string
	t = "a"
)</code></pre><p><br></p>

Go入門の内容のうち、変数についてまとめています。
変数とは、ある型1つと、それに合った値1つを保持するものです。例えばstring型の変数は、文字列である"a"を保持できます。逆に、数字の1などを保持することはできません。

【Go言語】入門 変数

<p>htmlやjsonを返すGo言語のWebアプリの作り方をご紹介したいと思います。<br><br>WEBアプリのフレームワークは複数ありますが、代表的なものは<strong>echo</strong>と<strong>gin</strong>です。</p><ul><li>gin : 55.6k stars</li><li>eco : 21.6k stars</li></ul><p><br>今回はstarが多い<strong>gin</strong>を利用します。<br>基本的なコーディングはどちらのフレームワークでも変わらないので、<strong>echo</strong>を用いる方も参考になるかもしれません。<br><br></p><h2 id="h178a657758">最小の構成</h2><p>main.goとgo.modだけでサーバーを起動することができます。</p><ul><li>go.mod作成 → <code>go mod init 任意のプロジェクト名</code></li><li>ginインストール → <code>go get github.com/gin-gonic/gin</code></li></ul><p>起動コマンドはいつも通りの<code>go run main.go</code>もしくは<code>go run .</code>です。<br><br>main.go</p><pre><code>package main

import (
	"github.com/gin-gonic/gin"
	"net/http"
)

func main() {
	// Engineインスタンスを生成する
	r := gin.Default()

	// エンドポイントと処理を結び付ける
	r.GET("/ping", func(c *gin.Context) {
		c.JSON(http.StatusOK, gin.H{"message": "pong"})
	})

	// 起動時のポート番号を指定する
	r.Run(":8080")
}</code></pre><p><br></p><h3 id="haec4bf430a">動作確認方法</h3><p>上の構成で起動している間に<code>http://localhost:8080/ping</code>にアクセスすると、<code>{"message": "pong"}</code>が返ってきます。<br>ブラウザのバーに上記のURLをコピペすれば、動作を確認できます。<br><br></p><h2 id="hb60110d317">エンドポイントの増やし方</h2><p>先程はGETメソッドのpingパスの処理のみを定義しました。<br>この章では、エンドポイントの増やし方をご紹介します。<br></p><h3 id="h43058d64f2">メソッドの種類</h3><pre><code>r.GET("/ping", func(c *gin.Context) {
	c.JSON(http.StatusOK, gin.H{"message": "pong"})
})</code></pre><p>どのメソッドであっても<code>r.メソッド名</code>で指定をします。</p><ul><li>GET</li><li>POST</li><li>PUT</li><li>DELETE</li></ul><p><br></p><h3 id="hc18f4de171">パスの指定</h3><p><code>/ping</code>のように"/"始まりで記述します。<br><br>パスパラメータを利用する場合は、<code>/ping/:id/:name</code>のように「:パラメータ名」形式で指定します。<br>この例の様に複数のパスパラメータを利用できます。<br><code>/ping/30/taro</code>にアクセスしたとすると、idには"30"が、nameには"taro"が入ります。<br><br></p><h2 id="h347090d1af">処理で各種パラメータを利用する</h2><p>以下の3つのパラメータを取得する方法を説明いたします。</p><ul><li>クエリパラメータ</li><li>パスパラメータ</li><li>フォームパラメータ</li></ul><p>加えて、リクエスト情報全体の取得方法も書いています。<br></p><h3 id="h929d25d495">クエリパラメータ</h3><pre><code>r.GET("/ping", func(c *gin.Context) {
	id := c.Query("id")
	c.JSON(http.StatusOK, gin.H{"message": id})
})</code></pre><p>パスが<code>/ping?id=30&amp;name=taro</code>だとすると「?」以降がクエリパラメータです。<br>このパスにリクエストが来た場合、<code>r.GET("/ping"</code>の後に記述した処理が実行されます。<br>つまり、クエリパラメータの情報は<code>"/ping"</code>部分に含める必要は無いということです。<br><br>取得はQueryメソッドで行います。<br>このコード例で<code>/ping?id=30</code><span style="font-family: Monaco, Courier New, monospace">リクエストが来ると、idにstring型の"30"が入ります。</span><br></p><h3 id="he43452be7f">パスパラメータ</h3><pre><code>r.GET("/ping/:id", func(c *gin.Context) {
	id := c.Param("id")
	c.JSON(http.StatusOK, gin.H{"message": id})
})</code></pre><p>取得はParamメソッドで行います。<br>パスパラメータを利用する場合は、「/:パラメータ名」をエンドポイントのパスに含める必要があります。<br></p><h3 id="h6e245b3b30">フォームパラメータ</h3><pre><code>r.POST("/ping", func(c *gin.Context) {
	id := c.PostForm("id")
	c.JSON(http.StatusOK, gin.H{"message": id})
})</code></pre><p>取得はPostFormメソッドで行います。<br>これはあまり使わないと思います。<br></p><h3 id="hb0d488bcb1">リクエスト情報を取得する</h3><p>gin.Context型の変数から、 http.Request型の変数を取得できます。<br>RequestからボディやURLなど全ての情報を持ってこれます。<br>フォームパラメータを複数取得する場合などは、こちらを使いましょう。</p><pre><code>r.POST("/ping", func(c *gin.Context) {
	request := c.Request()
	c.JSON(http.StatusOK, gin.H{"message": request.URL.String()})
})</code></pre><p><br>request.Bodyとすればボディを取得できますが、これはstring型ではなくio.ReadCloser型なので注意が必要です。<br>string型にするには以下のように書きます。</p><pre><code>// body は[]byte型
body, err := io.Readall(c.Request().Body)

s:= string(body)</code></pre><p><br></p><h2 id="h4f556b8d95">レスポンスの設定</h2><p>レスポンスを定義しているのは以下の部分です。</p><pre><code>c.JSON(http.StatusOK, gin.H{"message": request.URL.String()})
})</code></pre><p><br>c.メソッド名で記述していて、他にもメソッドがいくつかあります。<br>主に使いそうなのは下の3つです。</p><ul><li>JSON</li><li>String</li><li>HTML</li></ul><p><br>Stringは <code>c.String(http.StatusOK, "hoge")</code>のように書きます。<br><br>HTMLを利用する場合には、htmlファイルを作成しておき、事前にHTMLを読み込む関数を呼ぶ必要があります。</p><pre><code>func main() {
	r := gin.Default()

	// templatesディレクトリ配下のhtmlを読み込む
	r.LoadHTMLGlob("templates/*")
	
	r.GET("/ping", func(c *gin.Context) {
		c.HTML(http.StatusOK, "ping.html", gin.H{
			"message": "pong",
		})
	})
	router.Run(":8080")
}</code></pre><p><br>c.HTMLメソッドの第2引数では、htmlファイル名を渡します。読み込んだディレクトリパスに指定したファイルが存在しなければ、レスポンスでHTMLを返せません。<br><br>第3引数（gin.H~）では、htmlに埋め込む値を記述しています。なので埋め込む値が無ければ、中身は無くても（<code>gin.H{}</code>）大丈夫です。<br><br></p><h2 id="ha2dbecf43d">各処理に共通の値を渡す</h2><pre><code>type Config struct{
	Message string
	// 色々入れる
}

func main() {
	r := gin.Default()

	// 実際はconst定数や環境変数に設定した値を入れる
	config := Config{}

	// 関数の外の変数configを、変数内で利用できる
	r.GET("/ping", func(c *gin.Context) {
		m := config.Message

		c.JSON(http.StatusOK, gin.H{"message": m})
	})

	// 他のルーティングも書く

	router.Run(":8080")
}</code></pre><p><br></p><h2 id="h8a7a42092b">パッケージ構成を変更する</h2><p>業務で扱う場合は、MVCやクリーンアーキテクチャを用いることになると思います。</p>

Go言語×ginによるWebアプリの作り方を紹介しています。コピペするだけで使える最小構成から、始めています。

記事一覧