抽象ドキュメントパターン

オブジェクト指向の構造設計パターン。緩い型付けのキーバリューストアでオブジェクトを整理し、型付けされたビューを使用してデータを公開します。このパターンの目的は、型安全性のサポートを失うことなく、新しいプロパティをオブジェクトツリーにオンザフライで追加できる、強く型付けされた言語でコンポーネント間の高度な柔軟性を実現することです。このパターンは、特性を使用して、クラスのさまざまなプロパティをさまざまなインターフェイスに分離します。^[1]「ドキュメント」という用語は、ドキュメント指向データベースに由来しています。

ドキュメントは、いくつかのプロパティを含むオブジェクトです。プロパティは、たとえば数値や文字列などの値、または他のドキュメントのリストである可能性があります。すべてのプロパティは、キーを使用して参照されます。^{[2]ドキュメントツリーをトラバースするときに、ユーザーは次のレベルの}実装クラスを作成するために使用するコンストラクターを指定します。実装は、多くの場合、Document インターフェースを拡張するさまざまな特性の結合であり、プロパティの設定と取得を独自に処理できます。

インターフェイス「Document」では、プロパティは「put」メソッドを使用して編集でき、「get」メソッドを使用して読み取り、サブドキュメントは「children」メソッドを使用してトラバースできると規定されています。「children」メソッドでは、子が持つべきデータのマップを指定して子の型付きビューを生成できるメソッドへの機能参照が必要です。マップは元のマップへのポインターである必要があります。これにより、ビューの変更が元のドキュメントにも影響します。

実装は、異なるプロパティを記述する複数の特性インターフェースから継承できます。複数の実装で同じマップを共有することもできますが、パターンが実装の設計に課す唯一の制限は、「BaseDocument」から継承したプロパティを除いてステートレスで なければならないことです。

インターフェースドキュメント
    put(キー: 文字列、値: オブジェクト): オブジェクト
    get(キー:文字列):オブジェクト
    子(キー: String、コンストラクタ: Map<String, Object> -> T): T[]

抽象 クラスBaseDocument: Document
    プロパティ: Map<String, Object>

    コンストラクター(プロパティ: Map<String, Object>)
        this->properties := プロパティ

    put(key : String, value : Object)を実装します: Object
         this->properties->put(key, value)を返します

    get(key : String) : Object
        を実装し、 this->properties->get(key)を返します。

    children(key : String, コンストラクター : Map<String, Object> -> T)
        を実装します: T[] var result := new T[]

        var children := this->properties->get(key) castTo Map<String, Object>[]
         foreach ( child in children )
            結果[] := コンストラクタ->適用(子)

        結果
を返す

抽象ドキュメント パターンを使用すると、開発者は構成設定などの変数を型指定されていないツリー構造に保存し、型指定のビューを使用してドキュメントを操作できます。内部ドキュメント構造に影響を与えずに、新しいビューまたはビューの代替実装を作成できます。この利点は、より疎結合なシステムになることですが、プロパティの継承型が必ずしも確実ではないため、キャスト エラーのリスクも高まります。

抽象ドキュメント パターンの完全な実装は、https://java-design-patterns.com/patterns/abstract-document/ で入手できます。主要なクラスを簡単に紹介します。

ドキュメント.java

パブリックインターフェイスDocument { Object put ( String key 、Object value ); Object get ( String key ); < T > Stream < T > children ( String key 、Function < Map < String 、Object > 、T >コンストラクター); ); }   
        
      
      
                 
    

ベースドキュメント.java

public abstract class AbstractDocument implements Document { private final Map < String , Object > properties ; protected AbstractDocument ( Map < String , Object > properties ) { Objects . requireNonNull ( properties , "プロパティ マップは必須です" ); this . properties = properties ; } @Override public Void put ( String key , Object value ) { properties . put ( key , value ); return null ; } @Override public Object get ( String key ) { return properties . get ( key ); } @Override public < T > Stream < T > children ( String key , Function < Map < String , Object > , T >コンストラクター) { return Stream . ofNullable ( get ( key )) . filter ( Objects :: nonNull ) . map ( el -> ( List < Map < String , Object >> ) el ) . findAny () . stream () . flatMap ( Collection :: stream ) . map (コンストラクター); } }      
        
        
         
          
    
    
          
         
         
    
    
        
         
        
    
             
         
                
                    
                
                
                
                
  

使用法.java

var carProperties = ...; var car = new Car ( carProperties ); String model = car . getModel (). orElseThrow ()); int price = car . getPrice (). orElseThrow ()); var parts = car . getParts ();