パッケージの分割

前節までで 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 を呼び出しています。