この記事では、BSON データを逆シリアル化するときに Go 構造內のエクスポートされていないフィールドをゼロ値にリセットする mgo/bson パッケージの動作について説明します。このメカニズムは、決定論的な逆シリアル化結果を保証するための mgo パッケージの組み込み設計であり、構成を通じて無効にすることはできません。この記事では、サンプル コードを使用してこの現(xiàn)象を示し、対策を示します。

mgo/bson.アンマーシャルと非エクスポートフィールドのゼロ化

labix.org/v2/mgo とその基盤となる labix.org/v2/mgo/bson パッケージを使用して、BSON データを MongoDB データベースから Go 構造に逆シリアル化する場合、一般的な現(xiàn)象として、ターゲット構造內のエクスポートされていないフィールドが、逆シリアル化前にデータがすでに含まれている場合でも、ゼロ値にリセットされます。これは、bson.Unmarshal がエクスポートされたフィールドにデータを設定する前に構造全體をゼロ設定することを意味します。

次の Go 構造體の定義とコード例を考えてみましょう。

パッケージメイン

輸入 （
    「fmt」
    「labix.org/v2/mgo/bson」
）

// Sub はエクスポートされたフィールドを含む補助構造體 type Sub struct{ Int int }

// プレーヤー構造には、エクスポートされたフィールド Name とエクスポートされていないフィールド unexpInt、unexpPoint が含まれています
タイプ プレーヤー構造體 {
    名前文字列
    unexpInt int // エクスポートされない整數(shù)フィールド unexpPoint *Sub // エクスポートされないポインター フィールド}

関數(shù) main() {
    // Name フィールド dta のみを含む、MongoDB から取得した BSON データをシミュレートします。 err := bson.Marshal(bson.M{"name": "ANisus"})
    エラーの場合 != nil {
        パニック(えー)
    }

    // Player インスタンスを初期化し、値 p をエクスポートされていないフィールドに割り當てます:= &Player{unexpInt: 12, unexpPoint: &Sub{Int: 42}}

    fmt.Printf("Before Unmarshal: % v\n", p) //デシリアライズ前の p のステータスを出力 //BSON デシリアライズを実行 err = bson.Unmarshal(dta, p)
    エラーの場合 != nil {
        パニック(えー)
    }
    fmt.Printf("After Unmarshal: % v\n", p) //逆シリアル化後の p のステータスを出力}

上記のコードを実行すると、出力でこの動作が明確に示されます。

アンマーシャル前: &{名前: unexpInt:12 unexpPoint:0xc0000140a0}
アンマーシャル後: &{Name:ANisus unexpInt:0 unexpPoint:<nil>}</nil>

出力からわかるように、bson.Unmarshal 操作の後、Name フィールドは BSON データから正しく設定されましたが、unexpInt フィールドは 12 から 0 (ゼロ値) に変更され、unexpPoint フィールドは有効なポインターから (ゼロ値) に変更されました。

設計原則: Unmarshal がエクスポートされていないフィールドをクリアするのはなぜですか?

この動作は mgo/bson の欠陥ではなく、仕様によるものです。 mgo/bson パッケージのソース コード (たとえば、構造體の逆シリアル化を処理する decode.go ファイル) によれば、ターゲット構造體の値は、フィールドにデータが設定される前に明示的にゼロ値にリセットされます。

この設計の主な目的は、Unmarshal() 操作の結果が入力 BSON データのみに依存し、Unmarshal が呼び出される前のターゲット構造體の以前の狀態(tài)の影響を受けないようにすることです。これにより、逆シリアル化プロセスが確定的かつ予測可能になり、ターゲット構造のプリセット値によって引き起こされる潛在的なデータの不整合やデバッグの困難を回避できます。言い換えれば、mgo/bson は、各 Unmarshal が空の狀態(tài)から結果を構築できるように、「クリーンな」逆シリアル化操作を提供することを目的としています。

対応戦略とベストプラクティス

これは mgo/bson パッケージの組み込み動作であり、これを無効にするオプションは提供されていないため、エクスポートされていないフィールドのクリアを直接防ぐことはできません。ただし、次の戦略でこのメカニズムに対抗できます。

1. エクスポートされていないフィールドの永続性に依存しないようにする:最も簡単な解決策は、フィールドの値を BSON データからロードする必要がある場合、または逆シリアル化中にその値を維持する必要がある場合、そのフィールドをエクスポートされたフィールドとして設計する必要があることです。エクスポートされていないフィールドは通常、內部狀態(tài)管理に使用され、外部データが逆シリアル化されたときに値が保持されることは期待できません。

2. データの段階的な処理: 一時構造を使用した逆シリアル化 構造に BSON からロードする必要があるエクスポートされたフィールドが含まれており、元の値を保持する必要がある、または他のソースから設定する必要があるエクスポートされていないフィールドがいくつかある場合は、次の方法を使用できます。

   • エクスポートされたすべてのフィールドのみを含む一時構造を定義します。
   • BSON データをこの一時構造に逆シリアル化します。
   • 次に、一時構造內のデータをターゲット構造インスタンスに手動でコピーします。これにより、ターゲット構造內のエクスポートされていないフィールドの元の値が保持されます。

    // PlayerBSON は BSON 逆シリアル化に使用され、エクスポートされたフィールドのみが含まれます type PlayerBSON struct {
       Name string `bson:"name"` // フィールド名が BSON ドキュメントと一致することを確認してください}
   
   func main_workaround() {
       dta、err := bson.Marshal(bson.M{"name": "ANisus"})
       エラーの場合 != nil {
           パニック(えー)
       }
   
       p := &Player{unexpInt: 12, unexpPoint: &Sub{Int: 42}}
       fmt.Printf("アンマーシャル前 (回避策): % v\n", p)
   
       // 1. 一時構造インスタンスを作成します tempPlayerBSON := &PlayerBSON{}
   
       // 2. BSON データを一時構造體に逆シリアル化します err = bson.Unmarshal(dta, tempPlayerBSON)
       エラーの場合 != nil {
           パニック(えー)
       }
   
       // 3. 一時構造のデータを、元の Player インスタンスのエクスポートされたフィールド p.Name = tempPlayerBSON.Name にコピーします。
   
       fmt.Printf("アンマーシャル後 (回避策): % v\n", p)
   }

   main_workaround 関數(shù)を実行すると、出力は次のようになります。

   アンマーシャル前 (回避策): &{Name: unexpInt:12 unexpPoint:0xc0000140e0}
   アンマーシャル後 (回避策): &{Name:ANisus unexpInt:12 unexpPoint:0xc0000140e0}

   ご覧のとおり、unexpInt と unexpPoint の値は正常に保持されています。

3. 後処理: アンマーシャル後にエクスポートされていないフィールドを再設定します。 アンマーシャル後に他の手段 (データベースからのクエリ、計算による生成、構成からの読み取りなど) で非エクスポート フィールドの値を再設定できる場合は、最初にアンマーシャルを実行してから、これらの非エクスポート フィールドの値を復元または設定する後処理ステップを実行できます。

4. さまざまな目的に応じてさまざまな構造を使用します。複雑なアプリケーションの場合は、データベースまたはネットワーク送信専用の構造 (通常、すべてのフィールドは BSON タグを使用してエクスポートされたフィールドです) と、アプリケーションの內部ビジネス ロジック用の構造 (エクスポートされていないフィールドを含めることができます) を定義できます。データがアプリケーション境界に出入りするときに、これら 2 つの構造間で明示的な変換を実行します。

要約する

mgo/bson.Unmarshal が BSON データを逆シリアル化するとき、まずターゲット Go 構造體のすべてのフィールド (エクスポートされていないフィールドを含む) をゼロ値にリセットします。これは、逆シリアル化結果の決定性を保証するために mgo パッケージによって採用された組み込み設計であり、構成を通じて無効にすることはできません。この動作を理解することは、堅牢な Go アプリケーションを作成するために重要です。開発者は、特定のニーズに基づいて、非エクスポート フィールドの永続化への依存を回避したり、逆シリアル化に一時的な構造を使用したり、逆シリアル化後に非エクスポート フィールドを再設定したりすることで、効果的に対応する必要があります。

以上がmgo/bson.Unmarshal の非エクスポートフィールドに対する処理メカニズムと応答戦略の詳細內容です。詳細については、PHP 中國語 Web サイトの他の関連記事を參照してください。