Bietet die it@M Codeformatter Regeln für Java als Artefakt an, sodass diese von Spotless automatisiert während des Maven Builds geprüft (mvn spotless:check
) bzw. umgesetzt (mvn spotless:apply
) werden können.
java_codestyle_formatter.xml herunterladen und speichern und anschließend in der IDE importieren.
Die gängigen Java IDE's unterstützen den Import von Eclipse XML Profilen.
In den Einstellungen (Window
- Preferences
) im Reiter Java / Codestyle / Formatter
mittels Import
die Datei importieren und anschließend mit Apply and Close
übernehmen.
In den Einstellungen (File
- Settings
) im Reiter Editor / Code Style / Java
unter den Scheme Actions
mittels Import Scheme - Eclipse XML Profile
die Datei importieren und anschließend mit Apply
übernehmen und Close
das Fenster schließen.
In VS Code kann direkt auf das XML aus dem Repository in den Workspace Settings verwiesen werden.
<project>/.vscode/settings.json
:
{
"java.format.settings.url": "https://raw.githubusercontent.com/it-at-m/itm-java-codeformat/main/formatter/src/main/resources/itm-java-codeformat/java_codestyle_formatter.xml"
}
Maven Plugin spotless-maven-plugin
hinzufügen:
<plugin>
<groupId>com.diffplug.spotless</groupId>
<artifactId>spotless-maven-plugin</artifactId>
<version>2.28.0</version>
<dependencies>
<dependency>
<groupId>de.muenchen.oss</groupId>
<artifactId>itm-java-codeformat</artifactId>
<version>${itm-codeformat.version}</version>
</dependency>
</dependencies>
<configuration>
<java>
<includes>
<include>src/main/java/**/*.java</include> <!-- Check application code -->
<include>src/test/java/**/*.java</include> <!-- Check application tests code -->
</includes>
<eclipse>
<file>itm-java-codeformat/java_codestyle_formatter.xml</file>
</eclipse>
<trimTrailingWhitespace/>
<endWithNewline/>
</java>
</configuration>
<executions>
<execution>
<goals>
<goal>check</goal>
</goals>
</execution>
</executions>
</plugin>
Dadurch wird beim Build automatisch der Code auf Einhaltung der Formatierungsregeln überprüft (Goal check
).
Weitere Einstellungen siehe offizielle Plugin-Dokumentation.
Eine Anwendung der Formatierungsregeln (-> Formattieren) kann manuell über mvn spotless:apply
durchgeführt werden.
Eine Überprüfung der Formatierungsregeln kann ebenso manuell über mvn spotless:check
durchgeführt werden.
Bei Änderungswünschen bzw. Änderungsbedarf bitte ein Issue erstellen.