用Ruby＋Builder创建XML应用

　　一、 简介

　　自从去年Ruby on Rails问世后，人们对Ruby编程语言的兴趣似乎稳定地增长起来。Rails已经帮助人们看到了什么是Ruby：一种非常体面的，易学的且使用中充满了乐趣的语言，甚至适合于工业级应用软件的开发。Ruby出现在几乎与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应用。