• 用Ruby+Builder创建XML应用
    时间:2008-12-02   作者:佚名   出处:互联网

      一、 简介

    自从去年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应用。

    网友留言/评论

    我要留言/评论