用Ruby+Builder创建XML应用

用Ruby+Builder创建XML应用

一、 简介

  自从去年php?name=Ruby" onclick="tagshow(event)" class="t_tag">Ruby on Rails问世后,人们对php?name=Ruby" onclick="tagshow(event)" class="t_tag">Rubyphp?name=%B1%E0%B3%CC%D3%EF%D1%D4" onclick="tagshow(event)" class="t_tag">编程语言的兴趣似乎稳定地增长起来。Rails已经帮助人们看到了什么是php?name=Ruby" onclick="tagshow(event)" class="t_tag">Ruby:一种非常体面的,易学的且使用中充满了乐趣的语言,甚至适合于工业级应用软件的开发。php?name=Ruby" onclick="tagshow(event)" class="t_tag">Ruby出现在几乎与php?name=Java" onclick="tagshow(event)" class="t_tag">Java差不多的年代,但是直到如今它才引起人们的关注。

  Ruby当然也引起我的注意!最近,我发现自己使用Ruby的时间多于Java了,因为它可以帮助我更快地编码-实现相同的工作,但是击键次数却更少。我简直怀疑我是否实际完全放弃了Java而转向了Ruby。读完本文时,你就会明白其中的原因。

  Builder是一个轻量级的XML构建器,它最初来源于Rails工程。现在,它是一个你可以从RubyForge下载的独立的Ruby库。

  本文将介绍如何安装Builder,然后用在Ruby中使用Builder创建XML文档,而不需要Rails。当然,我不会涉及Builder的所有特征,但是对于本文中的内容已经足够。当然,你可以参考Builder的在线文档加以详细分析。

  二、 安装Ruby和Builder

  首先,让我们转到Ruby下载页面。你可以在这个地址下载当前的稳定的发行版本。如果你使用的是Windows平台,那么安装Ruby的最容易的方法是使用一键式Ruby安装程序(版本1.8.2);如果使用其它平台,你可以使用1.8.3版本,这是一个经tar和gzip压缩的文件。(顺便说,1.8.2版本是推荐适合于Rails的,而1.8.4版本还处于预览发行阶段)。你可以通过在命令行上输入"ruby-v"来测试你的安装。如果Ruby有回应,那么你可能成功了;如果操作系统出现某些提示,那么很可能你的安装出了问题。

  迄今为止,安装Builder的最容易的方法是使用RubyGems,这是一个针对Ruby的极好的包管理程序。在此我仅作简介。首先,下载RubyGems,然后运行"Ruby setup.rb"。在安装RubyGems后,在某个外壳程序中输入下列语句:

gem install builder

  如果一切顺利,你应该看见下列响应:

Attempting local installation of 'builder'
Local gem file not found: builder*.gem
Attempting remote installation of 'builder'
Updating Gem source index for: http://gems.rubyforge.org
Successfully installed builder-1.2.4
Installing RDoc documentation for builder-1.2.4...

  在Ruby和Builder都到位后,你就可以开始工作了。

  三、 初步使用Builder

  首先,我将通过交互的Ruby或irb向你展示有关Builder的一些基本功能。在一个外壳程序中,激活irb,并关掉标准提示符(为易读起见):

  irb --simple-prompt

  现在,让我们在irb中输入下列语句(加粗的部分)来创建一些XML。

>> require 'builder'
=> ...
>> x = Builder::XmlMarkup.new(:target => $stdout, :indent => 1)
<inspect/>
=> #<IO:0x279e7e8>

  以require开头的一行装载(或试图装载)库Builder。(通常,如果发现一个库,那么这个语句将返回true)。接下来的一行通过调用XmlMarkup中的新方法创建对象x。":target => stdout"参数指示输出内容将被写向标准输出控制台,而参数":indent=>1"意味着XML输出形式将被缩进一个空格字符。

  顺便说一下,当一个名字,例如":target"以冒号开头时,这意味着,它是一个符号,或更确切地说,是一个Ruby Symbol类的对象。它代表对象的名称;而在没有冒号时它代表对象的值。

  你可以使用实例(接收者)x来调用其它方法(如instruct!):

>> x.instruct!
<?xml version="1.0" encoding="UTF-8"?>
=> #<IO:0x279e7e8>

  这将生成一个具有一些缺省假属性的XML声明。该方法名后面的感叹号概要性地指出,该方法将适当地修改接收者(receiver),如果无任何变化的话则返回nil。下面生成一个XML注释:

>> x.comment! "greetings"
<!-- greetings -->
=> #<IO:0x279e7e8>

  注意,这个方法把一个空格字符插在注释文本的前后。

  下面解释怎样创建一个元素。跟在接收者后面的名字也是元素名并且是大小写敏感的:

>> x.Hello "World!"
<Hello>World!</Hello>
=> #<IO:0x279e7e8>

  下面是一种在Hello元素上创建属性的方法:

>> x.Hello("World!", "type" => "global")
<Hello type="global">World!</Hello> #<IO:0x279e7e8>

  第一个参数是元素的内容,第二个参数使用一个"global"值生成属性类型。

  下面的irb示例向你展示了如何把元素内容放在元素内。其中,date元素包含3个子元素:year,month和day;并且子元素被创建于大括号中。

>> x.date {
?> x.year "2006"
>> x.month "01"
>> x.day "01"
>> }
<date>
<year>2006>year>
<month>01>month>
<day>01>day>
<date>
=> #>IO:0x279e7e8>
>>

  这些irb示例实际隐藏了用Ruby编写原始的XML的明显特征。下面的示例向你展示更为复杂些的Builder应用。
四、 编写一个哈希作为XML标注

  通过使用Builder,程序favs.rb将创建一个称为favorites的哈希(hash),然后把它作为XML写出:

#!/usr/bin/ruby
require 'builder'
favorites = {
'candy' => 'Neccos', 'novel' => 'Empire of the Sun', 'holiday' => 'Easter'
}
xml = Builder::XmlMarkup.new( :target => $stdout, :indent => 2 )
xml.instruct! :xml, :version => "1.1", :encoding => "US-ASCII"
xml.favorites do
favorites.each do | name, choice |
xml.favorite( choice, :item => name )
end
end

  使用Ruby运行favs.rb,其输出将是:

<?xml version="1.1" encoding="US-ASCII"?>
<favorites>
<favorite item="candy">Neccos<favorite>
<favorite item="holiday">Easter<favorite>
<favorite item="novel">Empire of the Sun<favorite>
<favorites>

  最上面一行代码找到Ruby解释器(#!/usr/bin/ruby)的位置。然后,装载Builder库。接着,通过三个名字/值对定义favorites哈希。在此,Builder对象xml被实例化。instruct!方法通过使用一个显式的目标和假属性创建一个XML文档声明(尽管文档可以被作为XML 1.0传递,但是,我在该方法中把版本改为1.1仅为说明实现原理)。

  在此,在favorites上调用了一个块(block)(注意,你可以用括号方式来代替上面的"do……end"语句)。对于哈希中的每一对值,都是通过把该哈希名作为一个属性并且把哈希值作为元素内容来创建的。你可能猜出,用这种方式使用Builder可以非常方便地帮助把大量的名字/值对导出到XML中。

  五、 创建有效的XHTML文档

  最后,我将再讨论一下使用Builder编写有效的XHTML文档的其它的方法和技术。下面是创建这种文档的一个程序(xhtml.rb):

#!/usr/bin/ruby
require 'builder'
x = Builder::XmlMarkup.new(:target => $stdout, :indent => 1)
x.instruct!
x.declare! :DOCTYPE, :html, :PUBLIC, "-//W3C//DTD XHTML 1.0 Strict//EN", "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"
x.html( "xmlns" => "http://www.w3.org/1999/xhtml" ) {
x.head {
x.title "XHTML 1.0 example"
x.style("type"=>text/css" ) { x.text! "h1{font-family:tahoma,sans-serif;font-size:18pt;color:blue}body{font-family:georgia,serif}"
}
}
x.body {
x.h1 "Hello from Builder"
x.p "A Ruby library that facilitates the programatic generation of XML."
x.p { |y| y <<"Methods of interest from <code<Builder::XmlMarkup</code> }
x.ul {
x.li "cdata!"
x.li "comment!"
x.li "declare!"
x.li "instruct!"
x.li "new"
}
x.p{ |y| y << "Methods of interest from "; x.code "Builder::XmlBase"; y << ":" }
x.ul {
x.li "<<"
x.li "new"
x.li "text!"
}
}
}


  通过使用符号和字符串,Declare!方法产生一个相应于XHTML 1.0文档类型定义的文档类型声明。style元素用于指定一个类型属性,然后使用text!方法创建了一些CSS。这里选择了把内容放在第一个参数中,见下面代码片断:

x.style("h1 {font-family:tahoma,sans-serif;font-size:18pt;color:blue} body{font-
family:georgia,serif}", "type"=>"text/css" )

  这里,可能最有趣的代码是那些创建混合内容的段(paragraph)的代码行(在文本中嵌入了代码元素)。两个语句都使用了块参数|y|,然后使用<<方法把文本添加到它上面。第一个语句把标签嵌入到文本中;第二个语句用代码创建标签,语句之间用分号分开。
Builder是我所发现的用来生成XML标注的最容易使用的工具集之一。尽管本文仅涉及到它的一些简单应用,但却为你在实际工作中使用Builder打好了基础