21.11. 使用 charset

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 处理数据。在使用当前字符集将内容写入 outbox 文件夹之前。

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

如果您省略了消费者端点上的 charset，则 Camel 不知道文件的字符集，默认情况下将使用 "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 属性如何，都会使用该配置。

如果您有一些问题，您可以使用特定的 charset 在 org.apache.camel.component.file 上启用 DEBUG 日志记录，在文件读/写时进行 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