Jak skonfigurować kodowanie w Maven?

Kiedy uruchamiam maven installprojekt maven z wieloma modułami, zawsze otrzymuję następujące dane wyjściowe:

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

Więc trochę googlowałem, ale wszystko, co mogę znaleźć, to to, że muszę dodać:

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

... do mojego pom.xml. Ale już tam jest (u rodzica pom.xml).

Konfigurowanie <encoding>wtyczki maven-resources-plugin lub wtyczki maven-compiler również nie naprawia tego.

Więc w czym problem?

OK, znalazłem problem.

Korzystam z niektórych wtyczek raportujących. W dokumentacji wtyczki failafe-maven-plugin ( http://maven.apache.org/plugins/maven-failsafe-plugin/integration-test-mojo.html ) stwierdziłem, że <encoding>konfiguracja - oczywiście - używa ${project.reporting.outputEncoding}domyślnie . Dodałem więc właściwość jako element potomny projectelementu i wszystko jest teraz w porządku:

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

Zobacz też http://maven.apache.org/general.html#encoding-warning

Byłoby to dodatkiem do poprzedniego, jeśli ktoś napotka problem ze skandalicznymi literami, który nie został rozwiązany za pomocą powyższego rozwiązania.

Jeśli pliki źródłowe Java zawierają skandynawskie litery, muszą zostać poprawnie zinterpretowane przez język Java używany do kompilacji . (np. skandynawskie litery używane w stałych)

Nawet jeśli pliki są przechowywane w UTF-8, a Maven jest skonfigurowany do używania UTF-8, System Java używany przez Maven nadal będzie używał domyślnych ustawień systemu (np. W Windows: cp1252).

Będzie to widoczne tylko podczas uruchamiania testów za pomocą maven (możliwe wydrukowanie wartości tych stałych w testach. Wydrukowane skandynawskie litery byłyby pokazane jako „<?>”). Nieprawidłowe przetestowanie spowodowałoby uszkodzenie plików klasy jako wyniku kompilacji i pozostawiony niezauważony.

Aby temu zapobiec, musisz ustawić Javę używaną do kompilacji, aby używała kodowania UTF-8. Nie wystarczy mieć ustawienia kodowania w maven pom.xml, musisz ustawić zmienną środowiskową: JAVA_TOOL_OPTIONS = -Dfile.encoding = UTF8

Ponadto, jeśli używasz Eclipse w systemie Windows, może być konieczne ustawienie dodatkowo kodowania (jeśli uruchamiasz indywidualny test przez Eclipse).

Jeśli połączysz powyższe odpowiedzi, w końcu powinien wyglądać plik pom.xml skonfigurowany dla UTF-8.

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>

Wygląda na to, że ludzie mieszają kodowanie treści z wbudowanym kodowaniem plików / zasobów. Posiadanie tylko właściwości maven nie wystarczy. Mając na -Dfile.encoding=UTF8nie skuteczne. Aby uniknąć problemów z kodowaniem, należy przestrzegać następujących prostych zasad

1. Ustaw kodowanie maven, jak opisano powyżej:

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

2. Zawsze ustawiaj kodowanie jawnie, gdy pracujesz z plikami, łańcuchami, IO w swoim kodzie. Jeśli nie zastosujesz się do tej reguły, Twoja aplikacja zależy od środowiska. -Dfile.encoding=UTF8Dokładnie jest odpowiedzialny za konfigurację środowiska run-time, ale nie powinno zależeć od niego. Jeśli masz tysiące klientów, konfigurowanie systemów i znajdowanie problemów z tego powodu wymaga więcej wysiłku. Masz tylko dodatkową zależność, której możesz uniknąć, ustawiając go jawnie. Większość metod w Javie, które używają domyślnego kodowania, są z tego powodu oznaczone jako przestarzałe.

3. Upewnij się, że zawartość, z którą pracujesz, jest również w tym samym kodowaniu, czego oczekujesz. Jeśli tak nie jest, poprzednie kroki nie mają znaczenia! Na przykład plik nie zostanie poprawnie przetworzony, jeśli jego kodowanie nie jest zgodne z UTF8, ale można się tego spodziewać. Aby sprawdzić kodowanie plików w systemie Linux:

plik $ --mime F_PRDAUFT.dsv

4. Wymuś jawne kodowanie zestawów klientów / serwerów w żądaniach / odpowiedziach, oto przykłady:

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

Mam nadzieję, że będzie to dla kogoś przydatne.

Spróbuj tego:

<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>

W moim przypadku użyłem go maven-dependency-pluginw celu rozwiązania problemu musiałem dodać następującą właściwość:

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

Zobacz Wtyczka zasobów Apache Maven / Określanie schematu kodowania znaków