一个使用Ruby on Rails开发LBS网站的简单实例

cheungmine

2011-7

这几天一直在学习使用Ruby on Rails(RoR)，想建立一个功能全面一点的LBS(Location Based Service)网站。但是对于我这个RoR的初学者（仅有几天时间）来说，毕竟太复杂了。因此本文试图简化原来的设计思路，抛弃一切权限管理，仅仅对数据表中的坐标位置进行插入和更新。也就是，使用表单提交用户坐标位置信息，地图页面定时刷新获取这些信息并显示在地图上。通过这个例子，来熟悉RoR的编程，熟悉ArcGIS Online Map。掌握Ajax在RoR中的一般用法(RJS)。

关键词：Ruby, RoR, MySQL, LBS, Ajax, RJS, ArcGIS Online Map, Dojo

0 安装RubyOnRails

Windows环境下一键安装RubyOnRails开发环境

1）直接点击链接下载：

http://rubyforge.org/frs/download.php/29867/InstantRails-2.0-win.zip

2）或者进入下载页面，选择要安装的版本：http://rubyforge.org/frs/?group_id=904

3）在Windows下安装InstantRails-2.0-win, 解压到无空格的英文路径下即可,如C:\。然后双击C:\InstantRails-2.0-win\InstantRails.exe文件即可启动InstantRails。

4）因为我总是喜欢使用MySQL，因此要手动把文件C:\InstantRails-2.0-win\mysql\bin\libmySQL.dll复制到目录C:\InstantRails-2.0-win\ruby\bin\。这个应该算InstantRails安装包的一个小缺陷吧。

2）开发用到的工具软件

1 创建Rails项目

从InstantRails进入Ruby命令行，输入清单1的命令：

图1：打开Ruby命令行

清单1：创建项目gis

C:\InstantRails-2.0-win\rails_apps>rails -d mysql gis
cd gis
ruby script/server

第1行创建项目，第2行切换到项目中，第3行启动gis服务。点击浏览 http://127.0.0.1:3000/就可以看到网站正确地建立了，如图2：

图2：RoR默认网站

2 创建数据库

从InstantRails进入Ruby命令行：

清单2：创建项目数据库

cd gis
gis>mysql -u root –p
mysql> create database gis_dev;
mysql> create database gis_test;
mysql> create database gis;
mysql> exit;
gis>

当提示Enter Password:时，直接回车。编辑\rails_apps\gis\config\database.yml文件，修改数据库名：gis_development=>gis_dev，gis_production=>gis。

3 导入数据表(locations)

从InstantRails->Configure->Database (via PhpMyAdmin)，使用以下脚本创建gis_dev中的数据表。

清单3：创建gis_dev数据库表locations

drop table if exists locations;
create table locations (id int not null auto_increment,user_id int not null,recv_time timestamp default current_timestamp not null,x_long decimal(12,7) null,y_lat decimal(12,7) null,z_elev decimal(12,3) null,velocity decimal(10,0) null,accel decimal(10,0) null,direction decimal(10,4) null,pitch decimal(10,4) null,roll decimal(10,4) null,battery decimal(3,0) null,confidence decimal(3,0) null,message varchar(200) null,primary key (id)
);

说明：
    user_id：用户id
    recv_time：收到信息的时间，这是个数据库自动填充时间的字段
    x_long：经度deg
    y_lat：纬度deg
    z_elev：高度m
    velocity：速度m/s
    accel：加速度
    direction：方向角度
    pitch：俯仰角度
    roll：倾斜角度
    battery：电池电量0-100
    confidence：信号强度0-100，似乎用signal更好一些
    message：短消息，提供呼叫信息功能
选择数据库gis_dev，在选择SQL标签页，将上面的SQL脚本粘帖到框中，最后按右下角的【执行】按钮。如图3所示：

图3：使用PhpMyAdmin创建数据表

4 生成location模型

进入Ruby命令行，切换到gis目录，输入下面的命令，在一行中输入：
清单4：创建locations Model

ruby script/generate scaffold Location user_id:int recv_time:datetime x_long:decimal y_lat:decimal z_elev:decimal  velocity:decimal accel:decimal direction:decimal pitch:decimal roll:decimal battery:decimal confidence:decimal message:string

访问地址：http://localhost:3000/locations 应该看到正确的网页。如果上面的脚本执行的结果不正确，我们进入目录，删除它的执行结果，也就是删除下面的文件或目录：
    C:\InstantRails-2.0-win\rails_apps\gis\app\controllers\locations_controller.rb
    ...\gis\app\models\location.rb
    ...\gis\app\views\locations\
然后重新执行命令。现在我们可以通过http://localhost:3000/locations/new创建新的location：

图4：创建location的界面

5 建立网站首页

清单5：创建home/index

$ ruby script/generate controller home index
$ rm public/index.html

$ 代表命令行当前目录提示符：C:\InstantRails-2.0-win\rails_apps\gis>，下同。这样就新建了一个名为home的controller和该controller下的名为index的action。第2行删除默认的首页。然后加入指定的默认首页：
在 config/routes.rb 文件中，将 # map.root :controller => "welcome" 改为：
map.root :controller => "home"
默认首页文件变为：...\gis\app\views\home\index.html.erb。访问地址为：http://localhost:3000/

我们用预先建好的使用了ArcGIS Online Map的网页替换掉\home\index.html.erb，替换之后的index.html.erb见清单6。

清单6：网站首页文件index.html.erb

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html> 
<head><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><meta http-equiv="X-UA-Compatible" content="IE=7,IE=9" /><!--The viewport meta tag is used to improve the presentation and behavior of the samples on iOS devices--><meta name="viewport" content="initial-scale=1, maximum-scale=1,user-scalable=no"/><title>LBS Test Map</title><link rel="stylesheet" type="text/css" href="http://serverapi.arcgisonline.com/jsapi/arcgis/2.4/js/dojo/dijit/themes/claro/claro.css"><style type="text/css">html,body {height:100%;width:100%;margin:0;}body {background-color:#FFF;overflow:hidden;font-family:"Trebuchet MS";}#mainWindow {width:100%;height:100%;margin:0px;padding:0;}#header {border:solid 0px #FFF;border-bottom:1px solid #AEAEAE;background-color:#EEF2FB;color:#CD853F;font-size:10pt;text-align:center;height:80px;margin:0px;padding:0;			}#subheader {font-size:small;color:#CD853F;}#rightPane {background-color:#FFF;border:none;width:300px;overflow:hidden;margin:0px;padding:0;}#mapDiv {background-color:#FFF;border:solid 1px #AEAEAE;margin:0px;padding:0;}#measurementPaneDiv {background-color:#FFF;border:solid 1px #B8B8B8;height:130px;overflow:hidden;margin:0px;padding:0;}#measurementDiv {background-color:#FFF;font-size:10pt;height:100%;overflow:hidden;margin:0px;padding:0;}        </style><script type="text/javascript">var djConfig = {parseOnLoad: true};</script><script type="text/javascript" src="http://serverapi.arcgisonline.com/jsapi/arcgis/?v=2.4"></script><script type="text/javascript">dojo.require("dijit.dijit"); // optimize: load dijit layerdojo.require("dijit.layout.BorderContainer");dojo.require("dijit.layout.ContentPane");dojo.require("esri.map");dojo.require("esri.dijit.Measurement");        dojo.require("esri.dijit.Scalebar");dojo.require("esri.toolbars.draw");dojo.require("esri.dijit.OverviewMap");var map, spatialRef, initExtent;// init on loadfunction initGCS_WGS_1984(){// 4326 = GCS_WGS_1984spatialRef = new esri.SpatialReference({wkid:4326});// china extentinitExtent = new esri.geometry.Extent(65, 9, 145, 55, spatialRef);map = new esri.Map("mapDiv");map.setExtent(initExtent);dojo.connect(map, 'onLoad', function(map) {var scalebar = new esri.dijit.Scalebar({map: map, scalebarUnit: "metric"});dojo.connect(dijit.byId('mapDiv'), 'resize', resizeMap);						initToolbar(map);// add the overview map var overviewMapDijit = new esri.dijit.OverviewMap({map: map, visible:false});overviewMapDijit.startup();});var basemapUrl = "http://server.arcgisonline.com/ArcGIS/rest/services/ESRI_StreetMap_World_2D/MapServer";var basemap = new esri.layers.ArcGISTiledMapServiceLayer(basemapUrl);map.addLayer(basemap);}// init on loadfunction initWGS_1984_Web_Mercator_Auxiliary_Sphere() {// 102100 = WGS_1984_Web_Mercator_Auxiliary_SpherespatialRef = new esri.SpatialReference({"wkid": 102100});// china extentinitExtent = new esri.geometry.Extent({"xmin":-32971876.5210848,"ymin":2044843.3806844242,"xmax":-23921732.37212246,"ymax":7127600.013534156,"spatialReference":{"wkid":102100}});map = new esri.Map("mapDiv", {extent:initExtent, wrapAround180:true});dojo.connect(map, 'onLoad', function(map) {var scalebar = new esri.dijit.Scalebar({map: map, scalebarUnit: "metric"});dojo.connect(dijit.byId('mapDiv'), 'resize', resizeMap);						initToolbar(map);// add the overview map var overviewMapDijit = new esri.dijit.OverviewMap({map: map, visible:false});overviewMapDijit.startup();});var basemapUrl = "http://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer";var basemap = new esri.layers.ArcGISTiledMapServiceLayer(basemapUrl);map.addLayer(basemap);var referenceUrl = "http://server.arcgisonline.com/ArcGIS/rest/services/Reference/World_Boundaries_and_Places/MapServer";var referenceLayer = new esri.layers.ArcGISTiledMapServiceLayer(referenceUrl);map.addLayer(referenceLayer);			}// resize mapfunction resizeMap() {var resizeTimer;clearTimeout(resizeTimer);			resizeTimer = setTimeout(function(){map.resize(); map.reposition();}, 500);}function initToolbar(map) {//define a new line symbol and point symbol to use for measure toolsvar pms = new esri.symbol.PictureMarkerSymbol("images/flag.png", 24, 24);pms.setOffset(9,11);var sls = new esri.symbol.SimpleLineSymbol(esri.symbol.SimpleLineSymbol.STYLE_DOT,new dojo.Color([255,0,0,.55]), 4);var measurement = new esri.dijit.Measurement({map: map,lineSymbol:sls,pointSymbol:pms}, dojo.byId('measurementDiv'));measurement.startup();	 measurement.setTool("area", true);}// show map on load dojo.addOnLoad(initGCS_WGS_1984);	 // dojo.addOnLoad(initWGS_1984_Web_Mercator_Auxiliary_Sphere);	</script>
</head>
<body class="claro"><div id="mainWindow" dojotype="dijit.layout.BorderContainer" design="headline" gutters="false"><div id="header" dojotype="dijit.layout.ContentPane" region="top"><h1>A Test for RoR with ArcGIS Online Map</h1></div><!-- header --><div id="mapDiv" dojotype="dijit.layout.ContentPane" region="center"></div><!-- mapDiv --><div id="rightPane" dojotype="dijit.layout.BorderContainer" region="right" gutters="false"><div id="admin_div" dojotype="dijit.layout.ContentPane" style="height:100%;" region="center"></div><!-- admin_div --><div id="measurementPaneDiv" dojotype="dijit.layout.ContentPane" region="bottom"><div id="measurementDiv" style="height:100%;"></div></div><!-- measurementPaneDiv --></div><!-- rightPane --></div><!-- mainWindow -->
</body>
</html>

本文把HTML代码、css、js放在一起，是为了说明上的方便，实际当中应分开放置。关于如何使用ArcGIS Online Map和ArcGIS JSAPI编程请参考下面的网址：

http://help.arcgis.com/en/webapi/javascript/arcgis/help/jsapi_start.htm
此时我们再浏览http://localhost:3000/，显示如图5所示：

图5：网站（gis）的首页

6 用RJS查询locations

我的设想是设置一个定时器，不断地查询locations表，把获得的记录显示右边的空白处（<div id="admin_div" ></div>），同时把坐标点显示在地图（map）上。当我们访问http://localhost:3000/locations，会显示locations数据表的全部信息，因此我们就想办法把这个表显示在admin_div处，这就需要引入Ajax，或者称为RJS(Ruby-generated JavaScript)的东西。请参考我转载的一篇文章（RubyOnRails with Ajax），那里面详细讨论了RJS技术的实现原理和方法。

6.1 添加定时器查询数据库

为此我们首先添加一个链接到清单6中（\home\index.html.erb），当用户点击这个链接，admin_div就显示查询的结果。添加链接之后的代码如下：

清单7：修改index.html.erb，红色粗体的部分是我新增的代码

<div id="header" dojotype="dijit.layout.ContentPane" region="top">Click this link to show the current <%= link_to_remote "locations", :update => 'admin_div', :url => {:controller=>"locations", :action =>"list_by"} %>.
</div>
<!-- header -->

上面清单7代码中，:url => {:controller=>"locations", :action =>"list_by"}指明链接的位置：controller和action。我们知道在locations controller中并没有list_by这个action，我手动把这个list_by添加到locations_controller.rb中，不要修改其他任何部分，见清单8：

清单8：给locations_controller.rb添加list_by，红色粗体的部分是我新增的代码

class LocationsController < ApplicationController# GET /locations# GET /locations.xmldef index@locations = Location.find(:all)respond_to do |format|format.html # index.html.erbformat.xml  { render :xml => @locations }endend# add by medef list_byredirect_to :action => "index"end

另外为了支持RJS，我们还需要把<%= javascript_include_tag :defaults %>添加到index.html.erb中：

清单9：添加RJS声明

...
</style>
<%= javascript_include_tag :defaults %>
<script type="text/javascript">
...

现在我们浏览http://localhost:3000/并点击 locations链接后，界面显示如下：

图6：增加了RJS后的首页

到目前为止，locations链接是您见到的惟一触发器。Ajax 还有许多其他的可用武器，一些由用户驱动，而另一些由程序事件驱动，如时钟。它是一个像闹钟一样并不需要用户干预的东西。可以用 Ajax 的 periodically_call_remote 方法定期更新时钟。更改 index.html.erb 代码如清单10（仅仅修改红色黑体部分）：

清单10：修改index.html.erb，增加periodically_call_remote

<div id="header" dojotype="dijit.layout.ContentPane" region="top"><h1>A Test for RoR with ArcGIS Online Map</h1><%= periodically_call_remote :update => 'admin_div',   :url => {:controller=>"locations", :action =>"list_by"},  :frequency => 3.0 %>
</div>
<!-- header -->

重新浏览http://localhost:3000/，现在发现admin_div被每3秒自动更新一次。此时我们打开一个新的浏览器并定位到http://localhost:3000/locations/new，创建一个新的location，可以在http://localhost:3000/页面看到Listing locations发生了变化，我们新增加的记录被添加到了底部：

图7：自动更新Listing locations

接下来的工作主要是页面的重构和美化。说实在的，这的确耗去了我很多时间。重构之后的页面改变了某些div的id，对部分网页代码也做了调整。最终的成果就是看起来如图8的样子：

图8：最终的gis主页

6.2 为定时器添加启动（Start Monitor）和暂停（StopMonitor）的方法

我们设想用户可以控制periodically_call_remote定时器的启动和停止。因此需要修改一下Ruby代码。修改后的代码如下：

清单11：控制periodically_call_remote定时器的启动和停止代码

<head>......<%= javascript_include_tag :defaults %><script type="text/javascript">......var myMonitor = true;var myUpdater = null;PeriodicalExecuter.prototype.resume = function(){if(!this.timer)this.registerCallback();};function startMonitor()	{if (myUpdater != null){myUpdater.resume();}}function stopMonitor() {if (myUpdater != null){myUpdater.stop();}}</script>
</head>
<body class="claro"><%= periodically_call_remote(:variable => "myUpdater",:condition => "myMonitor == true",:update => "locations_div",:url => {:controller=>"locations", :action =>"list_by"},:frequency => 5,:complete => "new Effect.Highlight('locations_div');refreshLocations(dojo.byId('tb_users'));") %><div id="mainWindow" dojotype="dijit.layout.BorderContainer" design="headline" gutters="false">......<div id="locations_div" dojotype="dijit.layout.ContentPane" region="center"></div><!-- locations_div -->......</div>
</body>

:variable => "myUpdater", 指明new PeriodicalExecuter返回变量名。
:condition => "myMonitor == true", 指明触发器回调函数运行的条件。
:update => "locations_div", 指明要更新的div id。就是上文的(admin_div），我改了名字。
:url => {:controller=>"locations", :action =>"list_by"}, 指明控制器和反应器名称。
:frequency => 5, 指定定时器间隔5秒
:complete => "...." 指明链接加载完毕onComplete执行的代码，我们的JavsScript代码可以放在这里。
我增加了下面的代码：
    PeriodicalExecuter.prototype.resume = function(){
        if(!this.timer)
            this.registerCallback();
    };
因为PeriodicalExecuter是...\gis\public\javascripts\prototype.js中的JS对象。PeriodicalExecuter只有stop方法，为此我们需要增加了启动定时器的重启方法resume()。
比较清单11中蓝色的代码和运行后查看浏览器源代码中的显示（我做了排版编辑）：

清单12：查看浏览器源代码

myUpdater = new PeriodicalExecuter(function(){if (myMonitor == true) {new Ajax.Updater('locations_div', '/locations/list_by',{asynchronous:true, evalScripts:true, onComplete:function(request) {new Effect.Highlight('locations_div');refreshLocations(dojo.byId('tb_users'));}, parameters:'authenticity_token=' + encodeURIComponent('314268a80fbdca6f758e7bd120507c12a10c4698')});}},5);

只要能操作 PeriodicalExecuter的实例myUpdater和控制boolean变量myMonitor就可以 控制periodically_call_remote定时器。为此我们需要修改Ruby产生的默认代码，这个过程称为override。默认的代码没有返回myUpdater，因此我们需要修改默认的代码。找到这个文件：

C:\InstantRails-2.0-win\rails_apps\gis\app\helpers\application_helper.rb。

修改application_helper.rb文件以和下面的清单13一致：

清单13：重载periodically_call_remote，以支持返回变量

# Methods added to this helper will be available to all templates in the application.
module ApplicationHelperdef periodically_call_remote(options = {})variable = options[:variable] ||= 'poller'frequency = options[:frequency] ||= 10code = "#{variable} = new PeriodicalExecuter(function(){#{remote_function(options)}}, #{frequency})"javascript_tag(code)end
end

最后，我们调用myUpdater.stop()停止定时器，调用myUpdater.resume()重启定时器。示例主页中，表格定时会变黄色，就是定时器启动的情况下，Ajax代码： new Effect.Highlight('locations_div')
作用的效果。当我们按Draw Point按钮时，我们会发现浏览器上部出现了一个输入表：

图9：locations/new的RJS实现

这又是另外一个Ajax的例子。读者可以自己在主页的源代码（index.html.erb）中揣摩（http://localhost:3000/locations/new）。

7 ArcGIS JavaScriptAPI编程

7.1 ArcGIS Online地图服务

本文用的地图是ESRI的在线地图服务的地图数据。使用这个服务不需要客户端装任何东西。ArcGIS Online Map Server使用REST(Representational State Transfer)的对象访问协议。REST，表述性状态转移，只要使用网址，就可以很容易地创建、发布和使用“REST风格”的网络服务。相比REST之前的简单对象访问协议（SOAP），REST是轻量级的，使用简便、灵活。REST是各层次开发者利用ArcGISServer创建自定义应用的最简便方法。其实质是用URI（统一的资源标识，它是以某种统一的标准化的方式标识资源的一串字符串）描述互联网上的资源，所以没有开发工具的限制。

使用ArcGIS JSAPI可以快速的创建交互式的地图RIA应用——RIA（Rich Internet Applications）富互联网应用，具有高度互动性、丰富用户体验以及功能强大的客户端。基于REST API，我们可以为用户提供查询，显示要素等服务。利用叠加GP服务，可以为用户提供专业的分析结果。

7.2 如何显示一个ArcGIS Online地图

更多的资源请参考：http://help.arcgis.com/en/webapi/javascript/arcgis/help/jsapi_start.htm

本文的例子在：C:\InstantRails-2.0-win\rails_apps\gis\app\views\home\index.html.erb。

1）创建一个文本文件，复制下面的代码到文件中，然后文件保存为:arcgis-demo.html。

清单14：arcgis-demo.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html> 
<head><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><title>ArcGIS Online Map Simplest Demo - cheungmine</title><link rel="stylesheet" type="text/css" href="http://serverapi.arcgisonline.com/jsapi/arcgis/2.4/js/dojo/dijit/themes/claro/claro.css"><style type="text/css">html,body {height:100%;width:100%;margin:0;}body {background-color:#FFF;overflow:hidden;font-family:"Trebuchet MS";}#mainWindow {width:100%;height:100%;margin:0px;padding:0;}#mapDiv {background-color:#FFF;border:solid 1px #AEAEAE;margin:0px;padding:0;}</style><%= javascript_include_tag :defaults %><script type="text/javascript">var djConfig = {parseOnLoad: true};</script><script type="text/javascript" src="http://serverapi.arcgisonline.com/jsapi/arcgis/?v=2.4"></script><script type="text/javascript">dojo.require("dijit.dijit"); // optimize: load dijit layerdojo.require("dijit.layout.BorderContainer");dojo.require("dijit.layout.ContentPane");dojo.require("esri.map");dojo.require("esri.dijit.Scalebar");dojo.require("esri.toolbars.draw");dojo.require("esri.dijit.OverviewMap");var map, spatialRef, initExtent;// init on loadfunction initGCS_WGS_1984() {// 4326 = GCS_WGS_1984spatialRef = new esri.SpatialReference({wkid:4326});// china extent: Longitude(65～145), Latitude(9~55)initExtent = new esri.geometry.Extent(65, 9, 145, 55, spatialRef);map = new esri.Map("mapDiv");map.setExtent(initExtent);dojo.connect(map, 'onLoad', function(map) {var scalebar = new esri.dijit.Scalebar({map: map, scalebarUnit: "metric"});dojo.connect(dijit.byId('mapDiv'), 'resize', resizeMap);						initToolbar(map);// add the overview map var overviewMapDijit = new esri.dijit.OverviewMap({map: map, visible:false});overviewMapDijit.startup();});var basemapUrl = "http://server.arcgisonline.com/ArcGIS/rest/services/ESRI_StreetMap_World_2D/MapServer";var basemap = new esri.layers.ArcGISTiledMapServiceLayer(basemapUrl);map.addLayer(basemap);}// init on loadfunction initWGS_1984_Web_Mercator_Auxiliary_Sphere() {// 102100 = WGS_1984_Web_Mercator_Auxiliary_SpherespatialRef = new esri.SpatialReference({"wkid": 102100});// china extentinitExtent = new esri.geometry.Extent({"xmin":-32971876.5210848,"ymin":2044843.3806844242,"xmax":-23921732.37212246,"ymax":7127600.013534156,"spatialReference":{"wkid":102100}});map = new esri.Map("mapDiv", {extent:initExtent, wrapAround180:true});dojo.connect(map, 'onLoad', function(map) {var scalebar = new esri.dijit.Scalebar({map: map, scalebarUnit: "metric"});dojo.connect(dijit.byId('mapDiv'), 'resize', resizeMap);						initToolbar(map);// add the overview map var overviewMapDijit = new esri.dijit.OverviewMap({map: map, visible:false});overviewMapDijit.startup();});var basemapUrl = "http://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer";var basemap = new esri.layers.ArcGISTiledMapServiceLayer(basemapUrl);map.addLayer(basemap);var referenceUrl = "http://server.arcgisonline.com/ArcGIS/rest/services/Reference/World_Boundaries_and_Places/MapServer";var referenceLayer = new esri.layers.ArcGISTiledMapServiceLayer(referenceUrl);map.addLayer(referenceLayer);			}// resize mapfunction resizeMap() {var resizeTimer;clearTimeout(resizeTimer);			resizeTimer = setTimeout(function(){map.resize(); map.reposition();}, 500);}// show map on load // dojo.addOnLoad(initGCS_WGS_1984);	 dojo.addOnLoad(initWGS_1984_Web_Mercator_Auxiliary_Sphere);</script>
</head>
<body class="claro"><div id="mainWindow" dojotype="dijit.layout.BorderContainer" design="headline" gutters="false"><div id="mapDiv" dojotype="dijit.layout.ContentPane" region="center"></div><!-- mapDiv --><!-- mainWindow -->
</body>
</html>

2）使用浏览器打开这个文件，就可以看到Web地图了。

图10：arcgis-demo.html展示的ArcGIS Online Map

7.3 ArcGIS JSAPI 使用了Dojo这个著名的Ajax开源JavaScript库

为什么是dojo?
1）Dojo宽松的使用许可
2）Dojo功能全面，事件设计模式、矢量图形支持、显示效果、widgets、Ajax、JSON等都是ArcServer客户端开发所需要的，并且Dojo利于扩展，方便Mashup应用
3）客户端有丰富的图表

参考:
http://dojotoolkit.org

http://dojocampus.org

8 安装和使用示例代码

本文的示例代码

下载地址：http://download.csdn.net/source/3459994

8.1 安装并配置RoR环境

1) 下载InstantRails-2.0-win.zip:

http://rubyforge.org/frs/download.php/29867/InstantRails-2.0-win.zip

2) 解压到 C:\ 下. 主目录名默认为:C:\InstantRails-2.0-win\InstantRails.exe

3) 此步可以忽略，下面的cpy-mysql-db.bat批处理中执行了这个过程：复制libmySQL.dll. 开始->运行 cmd:

copy C:\InstantRails-2.0-win\mysql\bin\libmySQL.dll C:\InstantRails-2.0-win\ruby\bin\

4) 运行 C:\InstantRails-2.0-win\InstantRails.exe, 如果提示Apache端口被占用, 如下图：

图11：Apache端口错误消息

编辑修改下面的文件:

       C:\InstantRails-2.0-win\apache\conf\httpd.conf
将80改为81
       Listen 80=>81
       ...
       Port 80=>81

8.2 部署gis网站

1) 把gis.rar解压到 C:\InstantRails-2.0-win\rails_apps\ 目录下, 运行下面的批处理文件:

C:\InstantRails-2.0-win\rails_apps\gis\cpy-mysql-db.bat
这样我们的gis站点和MySQL数据库就部署好了.

2) 启动gis网站. 运行 C:\InstantRails-2.0-win\InstantRails.exe

图12：InstantRails主界面

选择[I.]->Rails Applications->Manage Rails Application...，弹出下面的对话框，左边勾选 gis 检查框, 右边按 Start with Mongrel 启动gis网站服务。

图13：Rails程序管理器

3) 打开浏览器, 输入网址 http://localhost:3000/ 或http://127.0.0.1:3000/,即可看到网站主页.

图14：gis网站主页

8.3 使用gis网站

打开2个浏览器A和B, 都定位到网站主页: http://127.0.0.1:3000/

1) 浏览器A（IE7）模拟GPS点生成过程

按浏览器A的页面上部的 Draw Point 按钮, 然后在地图上的某个位置处点击, 再按页面上部的 Sumbit 按钮, 即把当前的记录提交到了后台数据库, 过几秒, 就可以看到这个黑点出现在地图上的点击处, 同时右边的表格中多了一条记录.

图15：模拟生成GPS点的过程

2)浏览器B（FireFox5）模拟监控者的画面

对于浏览器A中的操作, 5秒之后都会出现在浏览器B的主页上. 反之亦然.

图16：模拟监控者届面

9 关于Ruby、RoR的一些展望

本文写作时采用的是Ruby1.8.6和Rails2.0.2。显然这个版本已经过时了。但是因为InstantRails的存在，这个版本对于初学者特别合适。

Ruby是一门特别简单而功能强大的解释型语言。它一经推出，即风靡了整个业界。它是一个解释型语言。在脚本语言家族中，早期的Ruby版本，据说速度较慢。对于高性能、高度保密的需求上，可以用C语言的库来扩展它。2009年1月30日，ruby 1.9.1的正式版本如期发布！ 1.9.1是ruby 1.9系列以来的第一个production ready的版本，这也标志着Ruby社区从此迈向了1.9的时代。ruby 1.9是ruby发展历史上的一个里程碑版本：

1）ruby 1.9首次引入字节码即时编译技术，可以大大提高ruby本身的性能。根据之前的综合评测来看，1.9的性能大约是1.8.6的三倍左右，性能追上了Python。

2）ruby 1.9正式支持内核多线程机制，可以大大提高ruby作为服务端程序的并发处理能力。

3）ruby 1.9还引入了纤程这样的多任务并发处理机制，提供了轻量级并发处理能力。

因此，Ruby的一门很有潜力的新语言。Ruby on Rails（RoR）是近几年开始流行的新一代Web开发框架语言，其易用、敏捷的特性受到很多Web开发人员的瞩目。Rails是基于Ruby之上的开发动态Web的首选框架。在Web2.0时代，RoR是快速开发RIA应用的首选语言。RoR尤其适合于快速架构跨平台的各种类型的Web网站、开发云计算平台的RIA入口等等。

Ruby可以用于书写RoR的服务页面程序；也可以用Ruby脚本管理网络、服务器；Ruby也用于对象胶，组合各种系统服务、功能模块等等。

RoR结合Nginx（Nginx已经成为世界第三大Web服务器）在Linux平台上，可以以极小的代价开发和部署支持海量并发请求的、高性能的、可扩展的网站和云计算服务。利用C语言扩展Ruby后台模块，利用多核、异步、线程池等技术，可以满足高可靠性、可扩展性、服务逻辑隐藏等需求，同时使实现异步的、长时间、高负载的Web后台运算或云计算服务成为可能。

附录1: gis 主页源代码

清单15: ...\gis\app\views\home\index.html.erb

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html> 
<head><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><meta http-equiv="X-UA-Compatible" content="IE=7,IE=9" /><!--The viewport meta tag is used to improve the presentation and behavior of the samples on iOS devices--><meta name="viewport" content="initial-scale=1, maximum-scale=1,user-scalable=no"/><title>RoR with LBS Demo - cheungmine</title><link rel="stylesheet" type="text/css" href="http://serverapi.arcgisonline.com/jsapi/arcgis/2.4/js/dojo/dijit/themes/claro/claro.css"><style type="text/css">html,body {height:100%;width:100%;margin:0;}body {background-color:#FFF;overflow:hidden;font-family:"Trebuchet MS";}#mainWindow {width:100%;height:100%;margin:0px;padding:0;}#header {border:solid 0px #FFF;border-bottom:1px solid #AEAEAE;background-color:#FFF;color:#CD853F;font-size:10pt;text-align:center;height:90px !important;height:80px;margin-bottom:3px;padding:0;			}#new_location_div {border:solid 0px #FFF;background-color:#FFF;color:#CD853F;font-size:10pt;text-align:center;overflow:hidden;height:60px;margin-left:10px;padding:0;}#menusDiv {border:solid 0px #FFF;background-color:#FFF;color:#CD853F;font-size:10pt;text-align:right;height:30px;overflow:hidden;margin-right:20px;padding:0;			}#rightPane {background-color:#FFF;border:solid 1px #AEAEAE;width:400px;overflow:hidden;margin:0px;padding:0;}#mapDiv {background-color:#FFF;border:solid 1px #AEAEAE;margin:0px;padding:0;}#measurementPaneDiv {background-color:#FFF;border:solid 0px #B8B8B8;height:130px;overflow:hidden;margin:0px;padding:0;display:yes;}#measurementDiv {background-color:#FFF;border:solid 0px #B8B8B8;font-size:10pt;height:100%;overflow:hidden;margin:0px;padding:0;}#locations_div {background-color:#FFF;height:100%;border: 0;margin: 0;padding:0;}		#tb_users {border-collapse:collapse;}#tb_users th {font-size:8pt;white-space:nowrap;}#tb_users td {border:1px solid #EEF2FB;font-size:8pt;white-space:nowrap;}#new_users {border-collapse:collapse;height:48px;}#new_users th {font-color:#000;font-size:8pt;white-space:nowrap;height:16px;margin: 0;padding:0;}#new_users td {border:0px solid #EEF2FB;font-size:8pt;white-space:nowrap;height:22px;margin: 0;padding:0;}a { text-decoration: none; }h2, h3 { margin: 0 0 20px; text-shadow: 2px 2px #fff; }h2 { font-size: 28px; }h3 { font-size: 22px; }pre { background: #fff; width: 460px; padding: 10px 20px; border-left: 5px solid #ccc; margin: 0 0 20px; }input { margin: 0; padding: 0; }.button {padding: 3px 5px;display: inline;background: #ABC url(button.png) repeat-x bottom;border: none;color: #fff;cursor: pointer;font-weight: bold;border-radius: 3px;-moz-border-radius: 3px;-webkit-border-radius: 3px;text-shadow: 1px 1px #666;}.button:hover {background-position: 0 center;}.button:active {background-position: 0 top;position: relative;top: 1px;padding: 3px 5px 2px;}.button.red { background-color: #e50000; }.button.purple { background-color: #9400bf; }.button.green { background-color: #58aa00; }.button.orange { background-color: #ff9c00; }.button.blue { background-color: #2c6da0; }.button.black { background-color: #333; }.button.white { background-color: #fff; color: #000; text-shadow: 1px 1px #fff; }.button.small { font-size: 75%; padding: 3px 7px; }.button.small:active { padding: 4px 7px 2px; background-position: 0 top; }.button.large { font-size: 125%; padding: 7px 12px; }.button.large:active { padding: 8px 12px 6px; background-position: 0 top; }</style><%= javascript_include_tag :defaults %><script type="text/javascript">var djConfig = {parseOnLoad: true};</script><script type="text/javascript" src="http://serverapi.arcgisonline.com/jsapi/arcgis/?v=2.4"></script><script type="text/javascript">dojo.require("dijit.dijit"); // optimize: load dijit layerdojo.require("dijit.layout.BorderContainer");dojo.require("dijit.layout.ContentPane");dojo.require("esri.map");dojo.require("esri.dijit.Measurement");        dojo.require("esri.dijit.Scalebar");dojo.require("esri.toolbars.draw");dojo.require("esri.dijit.OverviewMap");var map, toolbar, spatialRef, initExtent, defaultPointSymbol, defaultLineSymbol, defaultFillSymbol;// init on loadfunction initGCS_WGS_1984() {// 4326 = GCS_WGS_1984spatialRef = new esri.SpatialReference({wkid:4326});// china extentinitExtent = new esri.geometry.Extent(65, 9, 145, 55, spatialRef);map = new esri.Map("mapDiv");map.setExtent(initExtent);dojo.connect(map, 'onLoad', function(map) {var scalebar = new esri.dijit.Scalebar({map: map, scalebarUnit: "metric"});dojo.connect(dijit.byId('mapDiv'), 'resize', resizeMap);						initToolbar(map);// add the overview map var overviewMapDijit = new esri.dijit.OverviewMap({map: map, visible:false});overviewMapDijit.startup();});var basemapUrl = "http://server.arcgisonline.com/ArcGIS/rest/services/ESRI_StreetMap_World_2D/MapServer";var basemap = new esri.layers.ArcGISTiledMapServiceLayer(basemapUrl);map.addLayer(basemap);}// init on loadfunction initWGS_1984_Web_Mercator_Auxiliary_Sphere() {// 102100 = WGS_1984_Web_Mercator_Auxiliary_SpherespatialRef = new esri.SpatialReference({"wkid": 102100});// china extentinitExtent = new esri.geometry.Extent({"xmin":-32971876.5210848,"ymin":2044843.3806844242,"xmax":-23921732.37212246,"ymax":7127600.013534156,"spatialReference":{"wkid":102100}});map = new esri.Map("mapDiv", {extent:initExtent, wrapAround180:true});dojo.connect(map, 'onLoad', function(map) {var scalebar = new esri.dijit.Scalebar({map: map, scalebarUnit: "metric"});dojo.connect(dijit.byId('mapDiv'), 'resize', resizeMap);						initToolbar(map);// add the overview map var overviewMapDijit = new esri.dijit.OverviewMap({map: map, visible:false});overviewMapDijit.startup();});var basemapUrl = "http://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer";var basemap = new esri.layers.ArcGISTiledMapServiceLayer(basemapUrl);map.addLayer(basemap);var referenceUrl = "http://server.arcgisonline.com/ArcGIS/rest/services/Reference/World_Boundaries_and_Places/MapServer";var referenceLayer = new esri.layers.ArcGISTiledMapServiceLayer(referenceUrl);map.addLayer(referenceLayer);			}// resize mapfunction resizeMap() {var resizeTimer;clearTimeout(resizeTimer);			resizeTimer = setTimeout(function(){map.resize(); map.reposition();}, 500);}function initToolbar(map) {// create symbol for drawingdefaultPointSymbol = new esri.symbol.SimpleMarkerSymbol(esri.symbol.SimpleMarkerSymbol.STYLE_CIRCLE, 11,new esri.symbol.SimpleLineSymbol(esri.symbol.SimpleLineSymbol.STYLE_SOLID,new dojo.Color([255,255,255]), 2),new dojo.Color([10,10,10, 1]));// create toolbartoolbar = new esri.toolbars.Draw(map);dojo.connect(toolbar, "onDrawEnd", addLocation);//define a new line symbol and point symbol to use for measure toolsvar pms = new esri.symbol.PictureMarkerSymbol("images/flag.png", 24, 24);pms.setOffset(9,11);var sls = new esri.symbol.SimpleLineSymbol(esri.symbol.SimpleLineSymbol.STYLE_DOT,new dojo.Color([255,0,0,.55]), 4);var measurement = new esri.dijit.Measurement({map: map,lineSymbol:sls,pointSymbol:pms}, dojo.byId('measurementDiv'));measurement.startup();// measurement.setTool("distance", true);}// show map on load dojo.addOnLoad(initGCS_WGS_1984);	 // dojo.addOnLoad(initWGS_1984_Web_Mercator_Auxiliary_Sphere);// add location to database when onDrawEnd firedfunction addLocation(geometry) {dojo.byId("inLong").value = geometry.x;dojo.byId("inLat").value = geometry.y;var type = geometry.type;			if (type === "point" || type === "multipoint") {symbol = toolbar.markerSymbol;}else if (type === "line" || type === "polyline") {symbol = toolbar.lineSymbol;}else {symbol = toolbar.fillSymbol;}map.graphics.add(new esri.Graphic(geometry, symbol));}function isValidValue(val) {if (val==null || val=="")return false;return true;}// user location classfunction userLocation(user_id, recv_time, x_long, y_lat, z_elev, message) {this.valid = false;this.id = user_id;this.recv = recv_time;this.x = x_long;this.y = y_lat;this.z = z_elev;this.msg = message;if (isValidValue(this.id) && isValidValue(this.recv) && isValidValue(this.x) && isValidValue(this.y)){this.valid = true;			}}// add user location to mapfunction addMapGraphics(user) {if (!user.valid)return;				var pt = new esri.geometry.Point(user.x, user.y, spatialRef);var graphic = new esri.Graphic(pt, defaultPointSymbol);map.graphics.add(graphic);}// refresh locationsfunction refreshLocations(tb) {// clear old firstclearMapGraphics();// we get table object and get its all tdsvar rows=tb.rows;for(i=1; i<rows.length; i++){cols = rows[i].cells;var user = new userLocation(cols[0].innerHTML, cols[1].innerHTML, cols[2].innerHTML, cols[3].innerHTML, cols[4].innerHTML, cols[12].innerHTML);addMapGraphics(user);				}}function clearMapGraphics() {map.graphics.clear();}var myMonitor = true;var myUpdater = null;PeriodicalExecuter.prototype.resume = function(){if(!this.timer)this.registerCallback();};function startMonitor()	{if (myUpdater != null){myUpdater.resume();}}function stopMonitor() {if (myUpdater != null){myUpdater.stop();}}</script>
</head>
<body class="claro"><%= periodically_call_remote(:variable => "myUpdater",:condition => "myMonitor == true",:update => "locations_div",:url => {:controller=>"locations", :action =>"list_by"},:frequency => 5,:complete => "new Effect.Highlight('locations_div');refreshLocations(dojo.byId('tb_users'));") %><div id="mainWindow" dojotype="dijit.layout.BorderContainer" design="headline" gutters="false"><div id="header" dojotype="dijit.layout.ContentPane" region="top"><div id="new_location_div" dojotype="dijit.layout.ContentPane" region="center"></div><div id="menusDiv" dojotype="dijit.layout.ContentPane" region="bottom"><a href="#" class="button green" οnclick="startMonitor();">Start Monitor</a><a href="#" class="button red" οnclick="stopMonitor();">Stop Monitor</a><%= link_to_remote("Draw Point",{:update => "new_location_div",:url => {:controller=>"locations", :action =>"new"},:complete => "toolbar.activate(esri.toolbars.Draw.POINT);"},{ :class => "button orange"} ) %><a href="#" class="button orange" οnclick="clearMapGraphics();">Clear Graphics</a></div></div><!-- header --><div id="mapDiv" dojotype="dijit.layout.ContentPane" region="center"></div><!-- mapDiv --><div id="rightPane" dojotype="dijit.layout.BorderContainer" region="right" gutters="false" splitter="true"><div id="locations_div" dojotype="dijit.layout.ContentPane" region="center"></div><!-- locations_div --><div id="measurementPaneDiv" dojotype="dijit.layout.ContentPane" region="bottom"><div id="measurementDiv" style="height:100%;"></div></div><!-- measurementPaneDiv --></div><!-- rightPane --></div><!-- mainWindow -->
</body>
</html>

附录2: 参考文献

1) AgileWebDevelopmentWithRails-3rdEd.pdf
2) building_dynamic_web_2.0_websites_with_ruby_on_rails.pdf
3) OReilly.Ajax.on.Rails.Dec.2006.chm
4) Enterprise Integration with Ruby - A Pragmatic Guide.pdf
5) OReilly.Dojo.The.Definitive.Guide.Jun.2008.pdf
6) ArcGIS JavaScript API开发—初级篇_白明.pdf

全文完

作者：张亮

2011年7月21日深夜于上海