12基于qualifiers选择Mapping方法

　　如果MapStruct在将A类型转换为B类型时，匹配到多个映射方法【这些映射方法的入参都是A类型，返回值是B类型】。则程序会报编译错误，MapStruct会给出相应的提示。
　　我们先来看个具体的例子。
　　实体类型定义如下：DatapublicclassOriginalRelease｛privateStringtitle；｝DatapublicclassGermanRelease｛privateStringtitle；｝
　　我们有个工具类支持将title转换成德语和英语。publicclassTitles｛将title转换为德语paramtitlereturnpublicStringtransTitle2German（Stringtitle）｛returnGerman：title；｝将title转换为英语paramtitlereturnpublicStringtransTitle2English（Stringtitle）｛returnEnglish：title；｝｝
　　Mapper类定义如下：Mapper（usesTitles。class）publicinterfaceReleaseMapper｛GermanReleasetoGerman（OriginalReleaserelease）；｝
　　上述代码编译后，会报如下错误：
　　AmbiguousmappingmethodsfoundformappingpropertyStringtitletoString：StringTitles。transTitle2German（Stringtitle），StringTitles。transTitle2English（Stringtitle）。Seehttps：mapstruct。orgfaqambiguousformoreinfo。
　　大概意思就是：MapStruct在将OriginalRelease。title转换为GermanRelease。title时。匹配到2个方法，分别是：StringTitles。transTitle2German（Stringtitle）和StringTitles。transTitle2English（Stringtitle）。
　　MapStruct无法决定使用哪个方法进行转换，因此报错。
　　针对上面的场景，MapStruct提供了qualifiers机制，供程序员明确指定使用哪个方法进行转换。
　　qualifiers机制提供了两种方式：qualifiedBy和qualifiedByName。下面我们分别来介绍这两种用法。
　　1、qualifiedBy
　　（1）首先我们需要定义注解，该注解用于标识我们的转换方法（MappingMethod）；QualifierTarget（ElementType。METHOD）Retention（RetentionPolicy。CLASS）publicinterfaceToGerman｛｝QualifierTarget（ElementType。METHOD）Retention（RetentionPolicy。CLASS）publicinterfaceToEnglish｛｝关于定义的注解，这里说三点：
　　（1）该注解必须使用Qualifier标注；
　　（2）该注解只能作用于方法；
　　（3）该注解RetentionPolicy为RetentionPolicy。CLASS
　　（2）使用定义的注解标注转换方法（MappingMethod）；
　　如此一来，注解和转换方法就建立了对应关系。publicclassTitles｛ToGermanpublicStringtransTitle2German（Stringtitle）｛returnGerman：title；｝ToEnglishpublicStringtransTitle2English（Stringtitle）｛returnEnglish：title；｝｝
　　（3）在Mapper中使用注解，指定转换方法。
　　为MappingqualifiedBy指定对应的注解，用于表示使用其标注的转换方法进行转换。Mapper（usesTitles。class）publicinterfaceReleaseMapper｛ReleaseMapperINSTANCEMappers。getMapper（ReleaseMapper。class）；Mapping（targettitle，qualifiedByToGerman。class）GermanReleasetoGerman（OriginalReleaserelease）；Mapping（targettitle，qualifiedByToEnglish。class）EnglishReleasetoEnglish（OriginalReleaserelease）；｝
　　注意：这里的usesTitles。class是必须加上的，否则MapStruct会报找不到对应注解标注的转换方法。
　　（4）生成的Mapper实现类的代码publicclassReleaseMapperImplimplementsReleaseMapper｛privatefinalTitlestitlesnewTitles（）；OverridepublicGermanReleasetoGerman（OriginalReleaserelease）｛if（releasenull）｛returnnull；｝GermanReleasegermanReleasenewGermanRelease（）；germanRelease。setTitle（titles。transTitle2German（release。getTitle（）））；returngermanRelease；｝OverridepublicEnglishReleasetoEnglish（OriginalReleaserelease）｛if（releasenull）｛returnnull；｝EnglishReleaseenglishReleasenewEnglishRelease（）；englishRelease。setTitle（titles。transTitle2English（release。getTitle（）））；returnenglishRelease；｝｝
　　2、qualifiedByName
　　（1）使用Named注解为转换方法设置别名。publicclassTitles｛Named（toGerman）publicStringtransTitle2German（Stringtitle）｛returnGerman：title；｝Named（toEnglish）publicStringtransTitle2English（Stringtitle）｛returnEnglish：title；｝｝
　　（2）在Mapper中使用别名，指定转换方法。
　　为MappingqualifiedBy指定对应的别名，用于表示使用其标注的转换方法进行转换。Mapper（usesTitles。class）publicinterfaceReleaseMapper｛ReleaseMapperINSTANCEMappers。getMapper（ReleaseMapper。class）；Mapping（targettitle，qualifiedByNametoGerman）GermanReleasetoGerman（OriginalReleaserelease）；Mapping（targettitle，qualifiedByNametoEnglish）EnglishReleasetoEnglish（OriginalReleaserelease）；｝
　　注意：这里的usesTitles。class是必须加上的，否则MapStruct会报找不到对应别名标注的转换方法。