Rails+Builder.生成不带实体的 XML 输出

Question

如何使 Builder 不编码“śćż”和其他此类字符。 我想要的是“całość”按字面意思打印在 XML 文档中。 示例：

xml.instruct! :xml, :version => '1.0', :encoding => 'utf-8'
xml.Trader( :'xmlns:xsi' => "http://www.w3.org/2001/XMLSchema-instance",
            :'xmlns:xsd' => "http://www.w3.org/2001/XMLSchema") do
  xml.Informacje do
    xml.RodzajPaczki 'całość'
    xml.Program 'mine'
    xml.WersjaProgramu '1.0'
  end
end

输出：

<?xml version="1.0" encoding="utf-8"?> 
<Trader xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> 
 <Informacje>  
  <RodzajPaczki>ca&#322;o&#347;&#263;</RodzajPaczki> 
    <Program>mine</Program> 
    <WersjaProgramu>1.0</WersjaProgramu> 
  </Informacje>
</Trader> 

całość 应为 całość。 我看到了像 xml.RodzajPaczki {|t| 这样的伪解决方案t << 'całość' } 但它无法正常工作。它将“całość”突出到文档的左侧。

Answer 1

这就是正在发生的事情。正如我们所知，默认情况下 Builder 会转义非 ASCII 字符，例如 całość 中的字符。您还提到了一种可能的修复方法，那就是：

xml.RodzajPaczki {|t| t << 'całość' }

不幸的是，当您将一个块传递给 RodzajPaczki 元素时，Builder 假定会有一些内部 xml，因此它会添加一个新行并应用缩进。当然，在我们的例子中，只有内部文本，没有 xml，因此我们会得到一些难看的输出，例如：

<RodzajPaczki>
całość      </RodzajPaczki>

有一个简单的方法和一个更难的方法来解决这个问题。首先是简单的方法。

将缩进配置为零

然后您可以使用上面的修复xml.RodzajPaczki {|t| t << 'całość' } 一切都会按预期工作，但输出不会被漂亮地打印出来，它实际上会全部在一行上：

<?xml version="1.0" encoding="UTF-8"?><Trader xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><Informacje><RodzajPaczki>całość</RodzajPaczki><Program>mine</Program><WersjaProgramu>1.0</WersjaProgramu></Informacje></Trader>

如果您希望它具有良好的格式，您可以通过外部漂亮的打印机运行它。

如果您只是必须有漂亮的打印输出并且不想转义，我们需要稍微修补 Builder。这是解决此问题的更困难的方法。

修补构建器

我们需要修补 XmlMarkup 对象的初始化程序以添加额外的选项 :escape。同时，我们修补 XmlBase 对象以将此新选项作为参数。我们将此新选项默认为 true，以维持默认行为。然后，我们修补 XmlBase 上的 text! 方法，以使用我们的新选项来决定是否应该转义文本。它看起来是这样的：

module Builder
  class XmlBase
    def initialize(indent=0, initial=0, encoding='utf-8', escape=true)
      @indent = indent
      @level  = initial
      @encoding = encoding.downcase
      @escape = escape
    end

    def text!(text)
      if @escape
        _text(_escape(text))
      else
        _text(text)
      end
    end
  end

  class XmlMarkup
    def initialize(options={})
      indent = options[:indent] || 0
      margin = options[:margin] || 0
      encoding = options[:encoding] || 'utf-8'
      escape = options[:escape]
      if escape == nil
        escape = true
      end
      super(indent, margin, encoding, escape)
      @target = options[:target] || ""
    end
  end
end

我们现在可以通过以下方式使用新修补的构建器（请注意，当我们构造 XmlMarkup 对象时，我们会传入新的 ： escape 选项（值为 false）：

xml = Builder::XmlMarkup.new(:target=>STDOUT, :indent=>3, :encoding => 'utf-8', :escape => false)
xml.instruct! :xml, :version => '1.0', :encoding => 'UTF-8'
xml.Trader(:'xmlns:xsi' => "http://www.w3.org/2001/XMLSchema-instance", :'xmlns:xsd' => "http://www.w3.org/2001/XMLSchema") do 
  xml.Informacje do
    xml.RodzajPaczki('całość')
    xml.Program('mine')
    xml.WersjaProgramu('1.0')
  end
end

输出如下：

<?xml version="1.0" encoding="UTF-8"?>
<Trader xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <Informacje>
      <RodzajPaczki>całość</RodzajPaczki>
      <Program>mine</Program>
      <WersjaProgramu>1.0</WersjaProgramu>
   </Informacje>
</Trader>

根据需要，文本不会转义。请注意，该补丁会将这种非转义行为应用于所有文本，因此，如果您只想对某些文本进行非转义，而其他文本仍进行转义，则需要在更大程度上修补 Builder。

Answer 2

我无法使用我的设置复制此内容。您使用什么版本的 ruby​​/rails/builder？

Answer 3

我可以毫无问题地输出“całość”（Ruby 1.9.2，Builder 3.0.0）。
手册页 http://builder.rubyforge.org/ 建议设置 $KCODE 到 'UTF8' （参见页面的最后），但我认为这是针对 Ruby 1.8 的。
我的文件中的内容类似于：

#!/usr/bin/ruby -wE UTF-8:UTF-8
# encoding: UTF-8

require 'builder'
...

xml = Builder::XmlMarkup.new( :target => target, :indent => 2 )
xml.instruct! :xml, :version => '1.0', :encoding => 'UTF-8'
...

Answer 4

中的评论Rails 票证 #1446 表明这可能会在 Builder 3.0.0 中修复。不过我自己还没有尝试过。