104.9. 使用 charset

从 Camel 2.9.3
开始，charset 选项允许在消费者和制作者端点上配置文件的编码。例如，如果您读取 utf-8 文件，并希望将文件转换为 iso-8859-1，您可以：

from("file:inbox?charset=utf-8")
  .to("file:outbox?charset=iso-8859-1")

您还可以在路由中使用 convertBodyTo。在以下示例中，我们仍然以 utf-8 格式输入文件，但我们希望以 iso-8859-1 格式将文件内容转换为字节数组。然后，让 bean 处理数据。在使用当前 charset 将内容写入 outbox 文件夹之前。

from("file:inbox?charset=utf-8")
  .convertBodyTo(byte[].class, "iso-8859-1")
  .to("bean:myBean")
  .to("file:outbox");

如果您在消费者端点上省略了 charset，则 Camel 不知道文件的 charset，默认情况下将使用 "UTF-8"。但是，您可以配置 JVM 系统属性，以覆盖并使用键 org.apache.camel.default.charset 的不同默认编码。

在以下示例中，如果文件不在 UTF-8 编码中，这可能会有问题，这是读取文件的默认编码。
在编写文件时，内容已转换为字节数组，因此将内容直接写入原样（没有任何进一步编码）。

from("file:inbox")
  .convertBodyTo(byte[].class, "iso-8859-1")
  .to("bean:myBean")
  .to("file:outbox");

您还可以在编写文件时覆盖和控制编码动态，方法是使用密钥 Exchange.CHARSET_NAME 在交换上设置属性。例如，在下面的路由中，我们使用消息标头中的值设置属性。

from("file:inbox")
  .convertBodyTo(byte[].class, "iso-8859-1")
  .to("bean:myBean")
  .setProperty(Exchange.CHARSET_NAME, header("someCharsetHeader"))
  .to("file:outbox");

我们建议更加简单，因此如果您选择具有相同编码的文件并希望以特定编码写入文件，则优先在端点上使用 charset 选项。

请注意，如果您明确在端点上配置了 charset 选项，则会使用该配置，而不考虑 Exchange.CHARSET_NAME 属性。

如果您有一些问题，那么您可以在 org.apache.camel.component.file 上启用 DEBUG 日志记录，在使用特定 charset 读取/写入文件时 Camel 日志。
例如，以下路由将记录以下内容：

from("file:inbox?charset=utf-8")
  .to("file:outbox?charset=iso-8859-1")

和日志：

DEBUG GenericFileConverter           - Read file /Users/davsclaus/workspace/camel/camel-core/target/charset/input/input.txt with charset utf-8
DEBUG FileOperations                 - Using Reader to write file: target/charset/output.txt with charset: iso-8859-1