Go with での可変量関数の習得
Variadic Functions in Golang - The power of with()

Go with での可変量関数の習得

この記事は英語から機械翻訳されたものであり、不正確な内容が含まれている可能性があります。 詳細はこちら
元の言語を表示

Goでは、fmtを使用して可変異位関数が導入されることがよくあります。プリント() または合計() 例。しかし、 実際のプロジェクト、可変異位関数の最も強力な使用法の1つは、 機能オプションパターン — With の使用() オブジェクト作成のためのスタイルヘルパー。

このパターンにより、コンストラクターは次のようになります。

  • より読みやすく
  • 拡張が容易
  • 組み込みの検証でより安全


Goの可変量関数とは何ですか?

可変量関数は、 可変数の引数.これは、 省略記号 (...) 最後のパラメータの型の前。

func sum(numbers ...int) int {
    total := 0
    for _, num := range numbers {
        total += num
    }
    return total
}

fmt.Println(sum(1, 2, 3)) // 6
fmt.Println(sum(1,2))     // 3        

この場合、数値はスライスです ([]整数)、渡す引数の数を柔軟に調整できます。


実際の使用: With による機能オプション()

現実の世界では、Go プロジェクトが小規模にとどまることはめったにありません。時間が経つにつれて、コンストラクターは 膨張 パラメータを付けて — おそらく、API を呼び出すための小さなツールとして始まったのかもしれません。

最初は、HTTP クライアントの作成は簡単でした。

NewClient("https://api.example.com")        

しかし、��件が積み重なると、コンストラクターは 膨張:

  • 必要な ベース URL.
  • あなたは タイムアウト.
  • あなたは API トークン 認証用。
  • あなたは投げます 再試行回数 信頼性のために。
  • たぶん カスタム HTTP トランスポート プロキシサポート用。

これで、一度クリーンな呼び出しは次のようになります。

NewClient("https://api.example.com", 5*time.Second, "Bearer token", nil, true, 3)        

一見すると... これらのパラメータは何を意味するのでしょうか?

  • nilはヘッダーまたはカスタムトランスポートですか?
  • 真は再試行またはデバッグを有効にすることですか?
  • 途中でパラメータをもう1つ追加するとどうなりますか?

それは、 説明書なしでIKEAの家具を組み立てる — ピースはすべてそこにありますが、それぞれのピースがどこに行くかを思い出すために、常にマニュアルをめくっています。


解決

さて、想像してみてください リファクタリング これは、() 関数オプションパターン。クライアントのセットアップが突然 文章のように読める:

client := NewClient(
    WithBaseURL("https://api.example.com"),
    WithTimeout(5*time.Second),
    WithHeader("Authorization", "Bearer token"),
)        

もう推測する必要はありません:

  • 自己文書化 — すべてのオプションは、それが何をしているのかを正確に教えてくれます。
  • 順序に依存しない — 何も壊さずに組み合わせて組み合わせます。
  • 将来性 — 新しい WithRetries を追加します。(3) 既存のコードに触れることなく。

それは単によりクリーンなコードに関するものではありません 会話のように感じられるコードでは、設定を読み、関数シグネチャを探すことなく意図を即座に理解できます。

🔗 完全な動作例を見たいですか?

👉 GitHub で完全なコードを表示する


可変異位関数の利点と限界

長所

  • よりクリーンで読みやすいコンストラクタ
  • 複数の関数なしでオプションの引数をサポート
  • 既存の通話を中断することなく簡単に拡張できます
  • オプションごとの検証を許可します

短所

  • 余分なスライス割り当てによるわずかなオーバーヘッド
  • 構造なしで追加されたオプションが多すぎると誤用される可能性があります


ベストプラクティス

  1. 可変量パラメータを 終わり コンストラクタの。
  2. それぞれを() 自己完結型&検証済み.
  3. すべてのロジックを New... にダンプしないでください — 各オプションに独自のフィールドを処理させます。
  4. で利用可能なドキュメント() 他の開発者にとって明確なオプション。


結論

Go の可変異数関数は、初心者のトリックをはるかに超えています。とペアリングすると、() 機能オプションパターンの場合、それらは 強力な設計ツール 保守可能でスケーラブルでクリーンな Go API を構築するためのものです。

🔗 完全な動作例を見たいですか? 私は GitHubリポジトリ 示す:

  • 再試行を伴う HTTP クライアント
  • TLS 証明書の処理
  • カスタムヘッダーを使用した GET および POST リクエスト

👉 GitHub で完全なコードを表示する

💬 使用しましたか で() Goプロジェクトで?コメントであなたの経験を共有してください!


コメントを閲覧または追加するには、サインインしてください

Aslam Mullaさんのその他の記事

他の人はこちらも閲覧されています