一、 简介
自从去年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应用。