Wie konfiguriere ich die Codierung in Maven?

Wenn ich maven installmein Multi-Module-Maven-Projekt ausführe, erhalte ich immer die folgende Ausgabe:

[WARNING] File encoding has not been set, using platform encoding UTF-8, i.e. build is platform dependent!

Also habe ich ein bisschen gegoogelt, aber alles was ich finden kann ist, dass ich hinzufügen muss:

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

... zu meiner pom.xml. Aber es ist schon da (beim Elternteil pom.xml).

Die Konfiguration <encoding>für das Maven-Resources-Plugin oder das Maven-Compiler-Plugin behebt das Problem ebenfalls nicht.

Also, was ist das Problem?

OK, ich habe das Problem gefunden.

Ich verwende einige Berichts-Plugins. In der Dokumentation des fehlersicheren Maven-Plugins ( http://maven.apache.org/plugins/maven-failsafe-plugin/integration-test-mojo.html ) habe ich festgestellt, dass die <encoding>Konfiguration - natürlich - ${project.reporting.outputEncoding}standardmäßig verwendet wird . Also habe ich die Eigenschaft als untergeordnetes Element des projectElements hinzugefügt und jetzt ist alles in Ordnung:

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
</properties>

Siehe auch http://maven.apache.org/general.html#encoding-warning

Dies wäre zusätzlich zu den vorherigen, wenn jemand auf ein Problem mit skandischen Buchstaben stößt, das mit der obigen Lösung nicht gelöst werden kann.

Wenn die Java-Quelldateien skandische Buchstaben enthalten, müssen sie von dem zum Kompilieren verwendeten Java korrekt interpretiert werden . (zB skandische Buchstaben in Konstanten)

Selbst wenn die Dateien in UTF-8 gespeichert sind und der Maven für die Verwendung von UTF-8 konfiguriert ist, verwendet das vom Maven verwendete System Java weiterhin den Systemstandard (z. B. in Windows: cp1252).

Dies ist nur sichtbar, wenn die Tests über Maven ausgeführt werden (möglicherweise werden die Werte dieser Konstanten in Tests gedruckt. Die gedruckten Skandalbuchstaben werden als '<?>' Angezeigt). Wenn sie nicht ordnungsgemäß getestet werden, werden die Klassendateien als Kompilierungsergebnis beschädigt unbemerkt gelassen.

Um dies zu verhindern, müssen Sie das zum Kompilieren verwendete Java für die Verwendung der UTF-8-Codierung festlegen . Es reicht nicht aus, die Codierungseinstellungen in der maven pom.xml zu haben. Sie müssen die Umgebungsvariable festlegen: JAVA_TOOL_OPTIONS = -Dfile.encoding = UTF8

Wenn Sie Eclipse unter Windows verwenden, müssen Sie möglicherweise die zusätzlich verwendete Codierung festlegen (wenn Sie einen einzelnen Test über Eclipse ausführen).

Wenn Sie die obigen Antworten kombinieren, sollte schließlich eine für UTF-8 konfigurierte pom.xml so aussehen.

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

    <modelVersion>4.0.0</modelVersion>

    <groupId>YOUR_COMPANY</groupId>
    <artifactId>YOUR_APP</artifactId>
    <version>1.0.0-SNAPSHOT</version>

    <properties>
        <project.java.version>1.8</project.java.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    </properties>

    <dependencies>
        <!-- Your dependencies -->
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.7.0</version>
                <configuration>
                    <source>${project.java.version}</source>
                    <target>${project.java.version}</target>
                    <encoding>${project.build.sourceEncoding}</encoding>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-resources-plugin</artifactId>
                <version>3.0.2</version>
                <configuration>
                    <encoding>${project.build.sourceEncoding}</encoding>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

Es scheint, dass Leute eine Inhaltscodierung mit einer erstellten Datei- / Ressourcencodierung mischen. Es reicht nicht aus, nur Maven-Eigenschaften zu haben. Mit -Dfile.encoding=UTF8nicht wirksam. Um Probleme mit der Codierung zu vermeiden, sollten Sie die folgenden einfachen Regeln befolgen

1. Stellen Sie die Maven-Codierung wie oben beschrieben ein:

<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>

2. Stellen Sie die Codierung immer explizit ein, wenn Sie mit Dateien, Zeichenfolgen und E / A in Ihrem Code arbeiten. Wenn Sie diese Regel nicht befolgen, hängt Ihre Anwendung von der Umgebung ab. Das ist -Dfile.encoding=UTF8genau für die Konfiguration der Laufzeitumgebung verantwortlich, aber wir sollten uns nicht darauf verlassen. Wenn Sie Tausende von Clients haben, ist es aufwändiger, Systeme zu konfigurieren und Probleme zu finden. Sie haben nur eine zusätzliche Abhängigkeit davon, die Sie vermeiden können, indem Sie sie explizit festlegen. Die meisten Methoden in Java, die eine Standardcodierung verwenden, werden aufgrund dessen als veraltet markiert.

3. Stellen Sie sicher, dass der Inhalt, mit dem Sie arbeiten, auch dieselbe Codierung aufweist, die Sie erwarten. Ist dies nicht der Fall, spielen die vorherigen Schritte keine Rolle! Zum Beispiel wird eine Datei nicht korrekt verarbeitet, wenn ihre Codierung nicht UTF8 ist, Sie es aber erwarten. So überprüfen Sie die Dateicodierung unter Linux:

$ file --mime F_PRDAUFT.dsv

4. Erzwingen Sie die explizite Codierung von Clients / Servern in Anforderungen / Antworten. Hier einige Beispiele:

@Produces("application/json; charset=UTF-8")
@Consumes("application/json; charset=UTF-8")

Hoffe, dass dies für jemanden nützlich sein wird.

Versuche dies:

<project>
  ...
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-resources-plugin</artifactId>
        <version>2.7</version>
        <configuration>
          ...
          <encoding>UTF-8</encoding>
          ...
        </configuration>
      </plugin>
    </plugins>
    ...
  </build>
  ...
</project>

In meinem Fall habe ich das maven-dependency-pluginso verwendet, um das Problem zu beheben, musste ich die folgende Eigenschaft hinzufügen:

  <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

Siehe Apache Maven Resources Plugin / Angeben eines Zeichenkodierungsschemas