updated documentation
This commit is contained in:
41
README.md
41
README.md
@ -2,13 +2,34 @@
|
|||||||
|
|
||||||
Additional DefaultAccessorNamingStrategy to support fluent API withXYZ setters.
|
Additional DefaultAccessorNamingStrategy to support fluent API withXYZ setters.
|
||||||
|
|
||||||
|
[](https://github.com/mapstruct/mapstruct/blob/master/LICENSE.txt)
|
||||||
|
|
||||||
|
[](https://github.com/mapstruct/mapstruct-idea/actions?query=workflow%3ACI+branch%3Amaster)
|
||||||
|
[](https://codecov.io/gh/mapstruct/mapstruct-idea)
|
||||||
|
|
||||||
|
* [What is MapStruct?](#what-is-mapstruct)
|
||||||
|
* [Features](#features)
|
||||||
|
* [Usage](#usage)
|
||||||
|
* [Example](#example)
|
||||||
|
* [Requirements](#requirements)
|
||||||
|
* [Building from Source](#building-from-source)
|
||||||
|
* [Licensing](#licensing)
|
||||||
|
|
||||||
|
## What is MapStruct?
|
||||||
|
|
||||||
|
MapStruct is a Java [annotation processor](https://docs.oracle.com/javase/6/docs/technotes/guides/apt/index.html) for the generation of type-safe and performant mappers for Java bean classes.
|
||||||
|
|
||||||
|
To learn more about MapStruct have a look at the [mapstruct](https://github.com/mapstruct/mapstruct) repository or the [website](https://mapstruct.org/)
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
Mapstruct default naming strategy detects the methods `withFirstName` and `withLastName` (see example below) as extra
|
Mapstruct default naming strategy detects the methods `withFirstName` and `withLastName` (see example below) as extra
|
||||||
target fields and therefore cause an error, when the mapper is annotated with
|
target fields and therefore cause an error, when the mapper is annotated with
|
||||||
`unmappedTargetPolicy = ReportingPolicy.ERROR`.
|
`unmappedTargetPolicy = ReportingPolicy.ERROR`.
|
||||||
|
|
||||||
The additional naming strategy makes Mapstruct ignore the withXYZ setters.
|
The additional naming strategy makes Mapstruct ignore the withXYZ setters.
|
||||||
|
|
||||||
## Installation
|
## Usage
|
||||||
|
|
||||||
To use the extended naming strategy, just include it as project dependency alongside with mapstruct.
|
To use the extended naming strategy, just include it as project dependency alongside with mapstruct.
|
||||||
|
|
||||||
@ -18,12 +39,12 @@ To use the extended naming strategy, just include it as project dependency along
|
|||||||
<dependency>
|
<dependency>
|
||||||
<groupId>org.mapstruct</groupId>
|
<groupId>org.mapstruct</groupId>
|
||||||
<artifactId>mapstruct</artifactId>
|
<artifactId>mapstruct</artifactId>
|
||||||
<version>1.4.2.Final</version>
|
<version>1.5.5.Final</version>
|
||||||
</dependency>
|
</dependency>
|
||||||
<dependency>
|
<dependency>
|
||||||
<groupId>de.muehlencord.mapstruct</groupId>
|
<groupId>de.muehlencord.mapstruct</groupId>
|
||||||
<artifactId>mapstruct-support</artifactId>
|
<artifactId>mapstruct-support</artifactId>
|
||||||
<version>1.4.2</version>
|
<version>1.5.5</version>
|
||||||
</dependency>
|
</dependency>
|
||||||
</dependencies>
|
</dependencies>
|
||||||
```
|
```
|
||||||
@ -71,3 +92,17 @@ public class Person {
|
|||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
The MapStruct plugin requires Java 11 or later
|
||||||
|
|
||||||
|
## Building from Source
|
||||||
|
mapstruct-support uses maven as build system. Simple execute
|
||||||
|
|
||||||
|
```shell
|
||||||
|
mvn clean install
|
||||||
|
```
|
||||||
|
|
||||||
|
## Licensing
|
||||||
|
|
||||||
|
The MapStruct plugin is licensed under the Apache License, Version 2.0 (the "License"); you may not use it except in compliance with the License. You may obtain a copy of the License at https://www.apache.org/licenses/LICENSE-2.0.
|
||||||
|
|||||||
4
copyright.txt
Normal file
4
copyright.txt
Normal file
@ -0,0 +1,4 @@
|
|||||||
|
Contributors
|
||||||
|
============
|
||||||
|
|
||||||
|
Joern Muehlencord - https://github.com/jomu78
|
||||||
4
pom.xml
4
pom.xml
@ -67,9 +67,9 @@
|
|||||||
<build>
|
<build>
|
||||||
<plugins>
|
<plugins>
|
||||||
<plugin>
|
<plugin>
|
||||||
<artifactId>maven-release-plugin</artifactId>
|
|
||||||
<groupId>org.apache.maven.plugins</groupId>
|
<groupId>org.apache.maven.plugins</groupId>
|
||||||
<version>3.0.0-M6</version>
|
<artifactId>maven-release-plugin</artifactId>
|
||||||
|
<version>3.0.1</version>
|
||||||
</plugin>
|
</plugin>
|
||||||
</plugins>
|
</plugins>
|
||||||
</build>
|
</build>
|
||||||
|
|||||||
Reference in New Issue
Block a user