Bagaimana cara mengkonfigurasi penyandian di Maven?

Ketika saya menjalankan maven installproyek multi-modul maven saya, saya selalu mendapatkan output berikut:

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

Jadi, saya mencari sedikit di Google, tetapi yang bisa saya temukan adalah saya harus menambahkan:

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

... ke pom.xml saya. Tapi itu sudah ada di sana (pada orang tua pom.xml).

Mengkonfigurasi <encoding>untuk maven-resources-plugin atau maven-compiler-plugin juga tidak memperbaikinya.

Jadi apa masalahnya?

Oke, saya menemukan masalahnya.

Saya menggunakan beberapa plugin pelaporan. Dalam dokumentasi failafe-maven-plugin ( http://maven.apache.org/plugins/maven-failsafe-plugin/integration-test-mojo.html ) Saya menemukan, bahwa <encoding>konfigurasi - tentu saja - menggunakan ${project.reporting.outputEncoding}secara default . Jadi saya menambahkan properti sebagai elemen anak dari projectelemen dan semuanya baik-baik saja sekarang:

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

Lihat juga http://maven.apache.org/general.html#encoding-warning

Ini akan menjadi tambahan dari sebelumnya, jika seseorang menemui masalah dengan huruf skandik yang tidak diselesaikan dengan solusi di atas.

Jika file sumber java mengandung huruf skandis, mereka harus ditafsirkan dengan benar oleh Java yang digunakan untuk kompilasi . (mis. huruf skandik yang digunakan dalam konstanta)

Walaupun file disimpan dalam UTF-8 dan Maven dikonfigurasi untuk menggunakan UTF-8, System Java yang digunakan oleh Maven masih akan menggunakan standar sistem (mis. Pada Windows: cp1252).

Ini akan terlihat hanya menjalankan tes melalui pakar (mungkin mencetak nilai-nilai konstanta ini dalam tes. Huruf-huruf skandik yang dicetak akan menunjukkan sebagai '<?>') Jika tidak diuji dengan benar, ini akan merusak file kelas sebagai hasil kompilasi dan menjadi dibiarkan tanpa disadari.

Untuk mencegah hal ini, Anda harus mengatur Java yang digunakan untuk kompilasi untuk menggunakan pengkodean UTF-8. Tidak cukup untuk memiliki pengaturan penyandian di maven pom.xml, Anda perlu mengatur variabel lingkungan: JAVA_TOOL_OPTIONS = -Dfile.encoding = UTF8

Juga, jika menggunakan Eclipse di Windows, Anda mungkin perlu mengatur pengkodean yang digunakan selain ini (jika Anda menjalankan tes individu melalui eclipse).

Jika Anda menggabungkan jawaban di atas, akhirnya pom.xml yang dikonfigurasi untuk UTF-8 akan tampak seperti itu.

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>

Tampaknya orang-orang mencampur encoding konten dengan encoding file / sumber daya yang dibangun. Memiliki sifat maven saja tidak cukup. Setelah -Dfile.encoding=UTF8tidak efektif. Untuk menghindari masalah dengan penyandian, Anda harus mengikuti aturan sederhana berikut ini

1. Setel pengkodean pakar, seperti dijelaskan di atas:

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

2. Selalu atur penyandian secara eksplisit, saat bekerja dengan file, string, IO dalam kode Anda. Jika Anda tidak mengikuti aturan ini, aplikasi Anda bergantung pada lingkungan. The -Dfile.encoding=UTF8persis bertanggung jawab untuk konfigurasi lingkungan run-time, tapi kita tidak harus bergantung padanya. Jika Anda memiliki ribuan klien, diperlukan lebih banyak upaya untuk mengonfigurasi sistem dan menemukan masalah karenanya. Anda hanya memiliki ketergantungan tambahan padanya yang dapat Anda hindari dengan mengaturnya secara eksplisit. Sebagian besar metode di Jawa yang menggunakan pengkodean default ditandai sebagai usang karena itu.

3. Pastikan konten yang Anda kerjakan, juga dalam pengkodean yang sama, yang Anda harapkan. Jika tidak, langkah-langkah sebelumnya tidak masalah! Misalnya file tidak akan diproses dengan benar, jika penyandiannya bukan UTF8 tetapi Anda mengharapkannya. Untuk memeriksa penyandian file di Linux:

$ file --mime F_PRDAUFT.dsv

4. Memaksa klien / server mengatur pengkodean secara eksplisit dalam permintaan / tanggapan, berikut adalah contohnya:

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

Semoga ini bermanfaat bagi seseorang.

Coba ini:

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

Dalam kasus saya, saya menggunakan maven-dependency-pluginjadi untuk menyelesaikan masalah, saya harus menambahkan properti berikut:

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

Lihat Apache Maven Resources Plugin / Menentukan skema pengkodean karakter