Come configurare la codifica in Maven?

Quando corro maven installsul mio progetto maven multi modulo ho sempre il seguente output:

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

Quindi, ho cercato su Google un po ', ma tutto quello che posso trovare è che devo aggiungere:

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

... al mio pom.xml. Ma è già lì (nel genitore pom.xml).

Anche la configurazione <encoding>per il plugin maven-resources o il plugin-compilatore maven non lo risolve.

Allora, qual'è il problema?

OK, ho trovato il problema.

Uso alcuni plugin di segnalazione. Nella documentazione del plugin failafe-maven ( http://maven.apache.org/plugins/maven-failsafe-plugin/integration-test-mojo.html ) ho scoperto che la <encoding>configurazione, ovviamente, utilizza ${project.reporting.outputEncoding}di default . Quindi ho aggiunto la proprietà come elemento figlio projectdell'elemento e ora tutto va bene:

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

Guarda anche http://maven.apache.org/general.html#encoding-warning

Questo sarebbe in aggiunta al precedente, se qualcuno incontra un problema con lettere scandal che non è stato risolto con la soluzione sopra.

Se i file sorgente java contengono lettere scandali, devono essere interpretati correttamente da Java utilizzato per la compilazione . (ad esempio lettere scandiche utilizzate nelle costanti)

Anche se i file sono memorizzati in UTF-8 e Maven è configurato per utilizzare UTF-8, il sistema Java utilizzato da Maven utilizzerà comunque l'impostazione predefinita del sistema (ad es. In Windows: cp1252).

Questo sarà visibile solo eseguendo i test tramite Maven (possibilmente stampando i valori di queste costanti nei test. Le lettere scandiche stampate mostrerebbero '<?>') Se non testate correttamente, questo danneggerebbe i file di classe come risultato della compilazione ed essere lasciato inosservato.

Per evitare ciò, è necessario impostare Java utilizzato per la compilazione per utilizzare la codifica UTF-8. Non è sufficiente avere le impostazioni di codifica in maven pom.xml, è necessario impostare la variabile di ambiente: JAVA_TOOL_OPTIONS = -Dfile.encoding = UTF8

Inoltre, se si utilizza Eclipse in Windows, potrebbe essere necessario impostare la codifica utilizzata in aggiunta a questa (se si esegue un test individuale tramite eclipse).

Se si combinano le risposte sopra, finalmente un pom.xml configurato per UTF-8 dovrebbe apparire così.

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>

Sembra che le persone mescolino una codifica dei contenuti con una codifica di file / risorse incorporata. Avere solo proprietà maven non è abbastanza. Non -Dfile.encoding=UTF8avendo efficacia. Per evitare problemi con la codifica è necessario seguire le seguenti semplici regole

1. Imposta la codifica Maven, come descritto sopra:

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

2. Imposta sempre la codifica in modo esplicito, quando lavori con file, stringhe, IO nel tuo codice. Se non si segue questa regola, l'applicazione dipende dall'ambiente. Il-Dfile.encoding=UTF8 è esattamente responsabile di configurazione dell'ambiente di run-time, ma non dobbiamo dipendere da esso. Se hai migliaia di client, ci vuole uno sforzo maggiore per configurare i sistemi e trovare i problemi a causa di ciò. Hai solo una dipendenza aggiuntiva che puoi evitare impostandola esplicitamente. La maggior parte dei metodi in Java che utilizzano una codifica predefinita sono contrassegnati come obsoleti a causa di essa.

3. Assicurati che anche il contenuto con cui stai lavorando sia nella stessa codifica che ti aspetti. In caso contrario, i passaggi precedenti non contano! Ad esempio un file non verrà elaborato correttamente, se la sua codifica non è UTF8 ma te lo aspetti. Per verificare la codifica dei file su Linux:

$ file --mime F_PRDAUFT.dsv

4. Forza la codifica dei client / server in modo esplicito nelle richieste / risposte, ecco alcuni esempi:

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

Spero che questo sia utile a qualcuno.

Prova questo:

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

Nel mio caso stavo usando maven-dependency-plugincosì per risolvere il problema che ho dovuto aggiungere la seguente proprietà:

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

Vedi Apache Maven Resources Plugin / Specifica di uno schema di codifica dei caratteri