マッパーを作成するにはアノテーションを付与するだけです。異なるプロパティへのマッピング、複数ソースからのマッピング、ネストされたBeanのマッピング、既存のインスタンスへのマッピングなども可能です。

DI Frameworkを使用していない場合は、org.mapstruct.factory.Mappersクラス経由で Mapper インスタンスを取得可能です。CDIやSpring Frameworkを使用している場合は、適切コンポーネントモデルを指定したアノテーションを付与することで、マッパーをインジェクション可能です。

マッピングでは属性の型が異なるケースがあります。MapStructでは、多くの場合、型変換を自動的に処理します。マッピングが単純ではない場合は、カスタムマッピングの追加や手動実装したマッパーを利用することが可能です。

コレクションのマッピングはソースコレクションを反復処理して各要素をターゲットコレクションにマッピングします。型が異なる場合、変換のフォーマットを指定することもできます。また、コレクションのマッピング戦略を4つのタイプから指定することが可能です。

Streamのマッピングでは、ソース型とターゲット型に応じて、Iterable インタフェースか配列に暗黙的に変換可能です。

列挙型同士、列挙型からString、Stringから列挙型といったマッピングが可能です。名前変換のルール（サフィックス、プレフィックス、大文字小文字変換など）を指定したカスタムマッピングも可能です。

デフォルトでは、ターゲットのインスタンスの生成はコンストラクターが利用されます。マッパーアノテーションのusesを利用することで、ターゲットとしてファクトリメソッドで生成したインスタンスを利用することが可能です。

高度なマッピング機能では、

• デフォルト値や定数
• 式（現状は、Javaのみ）
• デフォルト式(nullの場合のみ動作。Javaのみ)
• サブクラスマッピング
• null値マッピング戦略
• nullコレクションマッピング戦略
• 条件付きマッピング
• 例外ハンドリング

などが利用可能です。

既に定義されているマッピングを利用して、

• マッピングの継承
• 逆マッピング
• マッピングの共有

が利用可能です。

• マッピングカスタマイズ方法として、
• 自動出力されたメソッドに対してカスタマイズ処理を追加するデコレータ
• マッピングの前後で呼び出されるコールバックメソッド

などが利用可能です。

MapStruct SPIを実装することで、

• アクセサが通常とは異なる命名のクラスであっても、マッピングが可能
• 特定のクラスだけマッピングを除外
• カスタム列挙型の命名／変換戦略

などが利用可能です。

MapStruct は、サードパーティのライブラリから既に定義されているアノテーションを操作できる柔軟性を備えています。しかし、類似機能を持っているlombokと連携する場合は、バージョンの制約、アノテーションプロセッサの調整が必要なので注意が必要です。