パッケージの分割
前節までで myapp モジュールを初期化しました。ここからは、モジュールの中身を パッケージ に分割し、機能ごとにフォルダを分けて整理していきます。冒頭で触れたとおり、Goでは同じフォルダに置いたファイルが1つのパッケージとして扱われ、フォルダを分けることで別のパッケージに切り離せます。ここでは、myapp の中に計算ロジック専用の calculator パッケージを追加します。
1. フォルダ構成
次のような構成で、計算ロジックを別パッケージに切り出す例を見ます。
myapp/
├── go.mod
├── main.go
└── calculator/
└── calculator.go
main.go はエントリポイント、calculator/calculator.go は計算ロジックを分離したパッケージです。以降、提供側の calculator/calculator.go → 利用側の main.go の順に実装していきます。
2. 提供側の実装
本節では、まずcalculator パッケージが Add / Multiply 関数を提供する側の実装を書きます。ファイルの先頭に package パッケージ名 を宣言することで、そのファイルの所属パッケージを示します。書き方は以下のとおりです。
package パッケージ名
// 関数などの定義
以下が calculator/calculator.go の実装です。
package calculator
func Add(a, b int) int {
return a + b
}
func Multiply(a, b int) int {
return a * b
}
コードを解説します。
package calculator
calculator/calculator.go の先頭で package calculator を宣言しています。これで、このフォルダのファイルはすべて calculator パッケージに属することを Go に伝えます。
3. 利用側の実装と実行
続いて、main.go から calculator パッケージを呼び出す側のコードを書きます。他パッケージの関数を呼ぶには、import にモジュール名 + フォルダ名を書き、パッケージ名.関数名 の形で呼び出します。書き方は以下のとおりです。
import "モジュール名/フォルダ名"
パッケージ名.関数名(引数)
以下が main.go の実装です。
package main
import (
"fmt"
"github.com/example/myapp/calculator"
)
func main() {
fmt.Println(calculator.Add(3, 5))
fmt.Println(calculator.Multiply(3, 5))
}
実行すると以下のような実行結果が表示されます。
8
15
calculator.Add(3, 5) の結果 8、calculator.Multiply(3, 5) の結果 15 が出力されました。パッケージを分けても、正しく import して呼び出せていることが分かります。
コードを解説します。
import (
"fmt"
"github.com/example/myapp/calculator"
)
main.go からは、import にモジュール名 + フォルダ名(github.com/example/myapp/calculator)を書くことで、calculator パッケージを読み込めます。標準ライブラリの fmt と分けて書くのが慣習で、間に空行を1つ入れます。
fmt.Println(calculator.Add(3, 5))
他パッケージの関数は パッケージ名.関数名 の形で呼び出します。ここでは calculator.Add(3, 5) で calculator パッケージの Add を呼び出しています。