OpenLayers心得文档

OpenLayers项目分析——（一）项目介绍

网址： http://www.openlayers.org/ 

　　OpenLayers 是由 MetaCarta公司开发的， 用于WebGIS客户端的JavaScript包，目前的最高版本是2.5 V，通过BSD License 发行。它实现访问地理空间数据的方法都符合行业标准，比如OpenGIS的WMS和WFS规范， OpenLayers采用纯面向对象的JavaScript方式开发，同时借用了Prototype框架和Rico库的一些组件。 

　　采用OpenLayers作为客户端不存在浏览器依赖性。由于OpenLayers采用JavaScript语言实现，而应用于Web浏览器中的DOM（文档对象模型）由JavaScript实现，同时，Web浏览器（比如IE，FF等）都支持DOM 。 

　　OpenLayers APIs采用动态类型脚本语言JavaScript编写，实现了类似与Ajax功能的无刷新更新页面，能够带给用户丰富的桌面体验（它本身就有一个Ajax类，用于实现Ajax功能）。 

　　目前，OpenLayers所能够支持的Format有： XML、 GML、GeoJSON 、 GeoRSS、JSON、KML 、WFS、WKT( Well-Known Text )。在OPenlayers.Format名称空间下的各个类里，实现了具体读／写这些Format的解析器。 

　　OpenLayers所能够利用的地图数据资源“丰富多彩”，在这方面提供给拥护较多的选择，比如 WMS、WFS 、 GoogleMap、KaMap、 MS VirtualEarth、WorldWind 等等。当然，也可以用简单的图片作为源。 

第一次使用OpenLayers： 

　　 先 到它的官方网站 http://www.openlayers.org 下载他的压缩包，解压后可以看到其中的一些目录和文件，拷贝目录下的OpenLayer.js、根目录下的lib目录、根目录下的img目录到你网站的Scripts目录下（当然，这个只是例子，您网站的目录结构您自己说得算，只要保证OpenLayers.js，/lib，/img在同一目录中即可）。  然后， 创建一个index.html作为查看地图的页面，导入OpenLayers.js和你将要创建的js 。 

　　我们以加载WMS和GML文件为例。　 

         var lon = 5;     // x-axis coodinate in map units 

        var lat = 40;    // y-axis coordinate in map units 

        var zoom = 5;    // number of zoom levels 

         var map, layer;   

　　　　 //声明变量map、layer；等同于 var map = null; var layer = null; 

         map = new OpenLayers.Map('map'); 

        // 实例化一个地图类OpenLayers.Map 

         layer = new OpenLayers.Layer.WMS( "OpenLayers WMS",  

                    "http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} ); 

        // 以WMS的格式实例化图层类OpenLayers.Layer 

         map.addLayer(layer); 

        map.zoomToExtent(newOpenLayers.Bounds(-3.922119,44.335327, 

         4.866943,49.553833)); 

　　　　//在Map对象上加载Layer对象，并用 map.zoomToExtent 函数使地图合适地显示 

　　　　 map.addLayer(new OpenLayers.Layer.GML("GML", "gml/polygon.xml")); 

　　　　 //再在刚加载的WMS文件上，加载一GML文件 

　　剩下的工作就是，加上一些控件 OpenLayers.Control 之类的东西，比如 LayerSwitcher等。它们会在地图浏览的“窗口”上增加一些工具栏或是“按钮”，增加互动性和功能性。 

当然， Openlayers中的东西远不止这些，至于它的框架分析、APIs实现机制，会在后续文章中说出。写这个的过程，也是一个学习的过程，其中难免有不妥之处，热烈欢迎大家批评指正，相互交流。 

OpenLayers 项目完整分析——（二）源代码总体结构分析

　　通过前面的项目介绍，我们大概已经知道 Openlayers是什么，能够做什么，有什么意义。接下来我们分析它怎么样，以及怎样实现的等问题。 

　　这个图是从它的文档上截取的，旨在从感官上认识一下OpenLayers的类。下面分别介绍（文档中的类是按字母顺序排列的，也按这个顺序说吧）： 

　　我们看到在类的顶层“高高在上”的是OpenLayers，它为整个项目实现提供名称空间（JavaScript语言没有名称空间一说，但是它确实有自己的机制实现类似的功能，后面会说明），它直接拥有一常量  VERSION_NUMBER，以标识版本。 

　 　 Ajax： 顾名思义，用于实现Ajax功能，只是OpenLayers的开发者们把它单独写到一个类里了，其中用到了Prototype.js框架里的一些东西。同时，设计的时候也考虑了跨浏览器的问题。 

　　 BaseTypes： 这里定制了OpenLayers中用到的 string，number  和  function。比如，OpenLayers. String. startsWith，用于测试一个字符串是否一以另一个字符串开头；OpenLayers. Number. limitSigDigs，用于整数的有效数位；OpenLayers. Function.bind，用于把某一函数绑定于对象等等。 

　　 Console： OpenLayers.Console，此名称空间用于调试和把错误等输出到“控制台”上，需要结合使用../Firebug/firebug.js。 

　　 Control： 我们通常所说的控件类，它提供各种各样的控件，比如上节中说的图层开关 LayerSwitcher，编辑工具条EditingToolbar等等。加载控件的例子 ： 

        class = new OpenLayers.Map('map', { controls: [] }); 

　　　　map.addControl(new OpenLayers.Control.PanZoomBar()); 

　　　　map.addControl(new OpenLayers.Control.MouseToolbar()); 

　　 Events： 用于实现OpenLayers的事件机制。具体来说， OpenLayers中的事件分为两种，一种是浏览器事件，例如mouseup,mousedown之类的；另外一种是自定义的，如addLayer之类的。 OpenLayers中的事件机制是非常值得我们学习的，后面将具体讨论。 

　　 Feature： 我们知道：Feature是 geography 和attributes的集合。在OpenLayers中，特别地OpenLayers.Feature 类由一个marker 和一个lonla组成。 

OpenLayers. Feature.WFS与OpenLayers. Feature. Vector继承于它。 

　 　Format： 此类用于读／写各种格式的数据，它的子类都分别创建了各个格式的解析器。这些格式有： XML、 GML、GeoJSON 、 GeoRSS、JSON、KML 、WFS、WKT( Well-Known Text )。 

　 　 Geometry： 怎么翻译呢，几何？是对地理对象的描述。它的子类有Collection、Curve、LinearRing、LineString、MultiLineString、MultiPoint、MultiPolygon、Point、Polygon、Rectangle、Surface，正是这些类的实例，构成了我们看到的地图。需要说明的是， Surface 类暂时还没有实现。 

　 　Handler： 这个类用于处理序列事件，可被激活和取消。同时，它也有命名类似于浏览器事件的方法。当一个 handler 被激活，处理事件的方法就会被注册到浏览器listener ，以响应相应的事件；当一个handler被取消，这些方法在事件中也会相应的被取消注册。Handler通过控件control被创建，而control通过icon表现。 

　　 Icon： 在计算机屏幕上以图标的形式呈现，有url、尺寸size和位置position３个属性。一般情况，它与  OpenLayers.Marker结合应用，表现为一个 Marker。 

　 　Layer： 图层。 

　　 Map： 网业中动态地图。它就像容器，可向里面添加图层Layer和控件Control。实际上，单个Map是毫无意义的，正是Layer和Control成就了它。 

　　 Marker： 它的实例是 OpenLayers.LonLat 和OpenLayers.Icon的集合。通俗一点儿说， Icon附上一定的经纬度就是Marker。 

它们的组合关系是： 

　　 Popup： 地图上一个小巧的层，实现地图“开关”功能。使用例子： 

　　　　　　 Class = new OpenLayers.Popup("chicken", 

                   new OpenLayers.LonLat(5,40), 

                   new OpenLayers.Size(200,200), 

                   "example popup", 

                   true); 

　　　　　　map.addPopup(popup); 

　 　Renderer ： 渲染类。 在OpenLayers中，渲染功能是作为矢量图层的一个属性存在的，我们称之为渲染器，矢量图层就是通过这个渲染器提供的方法将矢量数据显示出来。以SVG 和VML为例，继承关系是这样的： 　　　　 

至于 OpenLayers. Renderer. Elements为什么要存在，以及它的渲染机制，后面会说。 

　　 Tile： 设计这个类用于指明单个“瓦片”Tile，或者更小的分辨率。Tiles存储它们自身的信息，比如url和size等。它的类继承关系如下： 

　 　Util：“ 跑龙套”的类。 

　　写到这里，可以看到OpenLayers 的类缠绕的挺麻烦的，接下来的文章将从代码部分分析更细部的东西。 

OpenLayers 项目分析——（三）BaseTypes

    先说基类型BaseTypes下，OpenLyers构建的“自己”的类。它们分别是：OpenLayers. LonLat、OpenLayers. Pixel、OpenLayers.Size、OpenLayers. Element、OpenLayers. Bounds和OpenLayers. Class。下面分别介绍：

　　OpenLayers. LonLat：经纬度类，其实例为地图提供一经度、纬度对，即位置。有两个属性lon（x-axis coodinate ）和lat（y-axis coordinate ）。这里说明一下，怎么经纬度又与x轴坐标、y轴坐标纠缠在一起？是这样：当地图是在地理坐标投影下，它就是经纬度；不然就是地图上的x／y轴坐标。除构造函数外，实现了五个函数：

toShortString:function()　把坐标转换为字符串；

clone:function()　　复制一个LonLat对象；

Add:function(lon,lat)　　改变现有地图的位置；

　　return new OpenLayers.LonLat(this.lon + lon, this.lat + lat);

equals:function(ll)　　判断传入的lon，lat对是否与当前的相等；

wrapDateLine:function(maxExtent)　　复制下(lon,lat)，指定为边界的最大范围。

　　OpenLayers. Pixel：像素类，在显示器上以(x,y)坐标的的形式呈现像素位置。有两个属性x坐标、y坐标，提供四个成员函数：

clone:function() 拷贝像素；

equals:function(px)  判断两像素是否相等；

add:function(x,y) 　改变(x,y)使其成为新像素；

return new OpenLayers.Pixel(this.x + x, this.y + y);

offset:function(px)　　调用add()使像素位置发生偏移。

　　newPx = this.add(px.x, px.y);

　　OpenLayers.Size：也有两个属性，宽度width、高度height。实现了两个成员函数：clone:function()和equals:function(sz)不多说了。

　　OpenLayers. Element：在这个名称空间下，开发者写了好多API，有visible、toggle、hide、show、remove、getHeight、getDimensions和getStyle，以实现元素的显示、隐藏、删除、取得高度，取得范围等功能。以getHeight函数为例我们看看它的代码：

　　/**

     * APIFunction: getHeight

     *  

     * Parameters:

     * element - {DOMElement}

     * 

     * Returns:

     * {Integer} The offset height of the element passed in

     */

    getHeight: function(element) {

        element = OpenLayers.Util.getElement(element);

        return element.offsetHeight;

    }

这里涉及到文档对象模型DOM的一些东西，函数本身很简单，最后返回元素的高度。

　　OpenLayers. Bounds：在这个类中，数据以四个浮点型数left, bottom, right, top 的格式存储，它是一个像盒子一样的范围。它实现了三个描述一个Bound的函数：toString、toArray和toBBOX。其中，toString的代码如下：

　　/** 

     * APIMethod: toString

     * 

     * Returns:

     * {String} String representation of bounds object. 

     *          (ex."left-bottom=(5,42) right-top=(10,45)")

     */

    toString:function() {

        return ( "left-bottom=(" + this.left + 

                 + " right-top=(" + this.right + 

    }

结果类似于"left-bottom=(5,42) right-top=(10,45)"

　　三个Bound数据来源函数：fromString、fromArray和fromSize；

五个获取对象属性的函数：getWidth、getHeight、getSize、getCenterPixel、getCenterLonLat；

余下还有：add:function(x,y)，extend:function(object)，containsLonLat，containsPixel，contains，intersectsBounds，containsBounds，determineQuadrant，wrapDateLine。以函数extend为例，看看源码。

　　　　extend:function(object) {

        var bounds = null;

        if (object) {

            switch(object.CLASS_NAME) {

                case "OpenLayers.LonLat":    

                    bounds = new OpenLayers.Bounds    (object.lon, object.lat, object.lon, object.lat);

                    break;

                case "OpenLayers.Geometry.Point":

                    bounds = new OpenLayers.Bounds(object.x, object.y,object.x, object.y);

                    break;                 

                case "OpenLayers.Bounds":   

                    bounds = object;

                    break;

            }

            if (bounds) {

                if ( (this.left == null) || (bounds.left < thi                     s.left)) {

                     this.left = bounds.left;}

                if ( (this.bottom == null) || (bounds.bottom <                     this.bottom) ) {

                    this.bottom = bounds.bottom;} 

                if ( (this.right == null) || (bounds.right > t                    his.right) ) {

                    this.right = bounds.right;}

                if ( (this.top == null) || (bounds.top > this.                    top) ) { 

                    this.top = bounds.top;}

            }

        }

    }

可以看出，对Bounds的扩展可以有三种形式：point, lonlat, 或者bounds，计算的条件是零坐标是在屏幕的左上角。

　　OpenLayers. Class：这个类是OpenLayers 中的“大红人”，只要创建其他类就得用它，同时也实现了多重继承。用法如下：

　　单继承创建：class = OpenLayers.Class(prototype);

　　多继承创建：class = OpenLayers.Class(Class1, Class2, prototype);

    净说底层类了，对js内置类的扩展下回写。 

欢迎转载，请注明出处。

　　OpenLayers不仅“自己”写了一些底层的类，像上回说的那些都是。同时也定制了一些JS的一些内置类，即对JS内置类的扩展。这个扩展主要包含3类：String，Number，Function，存在于BaseTypes.js文件中。

　　String：

OpenLayers对string类型定制了８个方法，分别是startsWith、contains、trim和camelize；还有另外４个方法：String. startsWith、String. contains、String.trim和String. Camelize，它们将会在3.0Version中被删除，可能是以前版本遗留下来的，这里就不说它们了。

　　//Test whether a string starts with another string. 

　　startsWith: function(str, sub) {

    return (str.indexOf(sub) == 0);

    }

　　//Test whether a string contains another string.

    contains: function(str, sub) {

        return (str.indexOf(sub) != -1);

    }

    //Removes leading and trailing whitespace characters from a string.

    trim: function(str) {

        return str.replace(/^\\s*(.*?)\\s*$/, "$1");    

    }

   //Camel-case a hyphenated string.

　 //Ex."chicken-head"becomes"chickenHead

   //and"-chicken-head"becomes"ChickenHead".

   // “骆驼”化带有连字符的字符串。

   camelize: function(str) {

        var oStringList = str.split('-');

        var camelizedString = oStringList[0];

        for (var i = 1; i < oStringList.length; i++) {

            var s = oStringList[i];

            camelizedString += s.charAt(0).toUpperCase() + s.substring(1);

        }

        return camelizedString;

    }

Number：

项目仅对number类型扩展了一个方法OpenLayers. Number. limitSigDigs（还有一个方法Number. limitSigDigs，同样在3.0中会删除）。

    //Limit the number of significant digits on an integer.

    limitSigDigs: function(num, sig) {

        var fig;

        if(sig > 0) {

            fig = parseFloat(num.toPrecision(sig));

        } else {

            fig = 0;

        }

        return fig;

    }

Function：

扩展了两个方法bind 和bindAsEventListener（同样存在Function.bind和Function. bindAsEventListener两个被“遗弃”的函数）。

    //Bind a function to an object.  

    //Method to easily create closures with'this' altered.

    bind: function(func, object) {

        // create a reference to all arguments past the second one

        var args = Array.prototype.slice.apply(arguments, [2]);

        return function() {

            // Push on any additional arguments from the actual function call.

            // These will come after those sent to the bind call.

            var newArgs = args.concat(

                Array.prototype.slice.apply(arguments, [0])

            );

            return func.apply(object, newArgs);

        };

    }

    //Bind a function to an object, and configure it to receive the event

    //object as first parameter when called. 

    bindAsEventListener: function(func, object) {

        return function(event) {

            return func.call(object, event || window.event);

        };

    }

这里说说这两个方法。

首先看看bind方法，这是一个能够被Function的实例得到的方法，如下所示：

Function.prototype.bind = function() {

var _method = this, args = [], object = arguments[0];

for (var i = 1; i < arguments.length; i++)

args.push(arguments[i]);

return function(moreargs) {

for (var i = 0; i < arguments.length; i++)

args.push(arguments[i]);

return  _method.apply(object, args);

}

};

_method 代表Function实例自身，bind可接收多个参数，不过它绑定是是第一个参数，该参数是一个function或者是调用环境，后面的都是执行函数的参数。

Function.prototype.bindAsEventListener = function(object) {

var  _method = this;

return function(event) {

return  _method.call(object, event || window.event);

}

};

这里只是将object作为_method 引用的环境，就是说现在可以在object对象中这样使用,

object. _method （event||window.event）。

也许你注意到了Funtion扩展的两个方法一个用到了call而另一个用的是apply，其实这两个并没有什么太大的区别，只是参数传递的形式不同，如若没有参数要传递，那么这两个是一样的：

apply(obj[,argumentsArray]),call(obj[,arg1[,arg2…]])。 

OpenLayers项目分析——（四）空间数据的组织与实现

　　提到数据，先思考几个问题： 

　　GIS，核心是什么？数据？平台？服务？　　 

　　空间数据的特征、表达方式？ 

　　地理数据的模型（结构）？ 

　　在OpenLayers空间数据的实现主要存在 OpenLayers. Geometry类及其子类中。我们先看下面的 两个图片，表现了这些类的继承关系。从图上可以清楚的看出MultiPoint、Polygon和MultiLineString 这三个类实现了多重继承，即直接继承于Geometry类，又继承于Collection类（为什么要这样实现？）。 

　　 OpenLyers对于Geometry对象的组织是这样的，其实最 基础 的就是点，然后MultiPoint由点构成，继承自Openlayers.Geometry.Collection,而LinearRing,LineString均由Point构 成， 

Polygon由OpenLayers.Geometry.LinearRing构成。OpenLyers在解析数据时候，将所有的面、线包含的点全部都对象化为Openlayers.Geometry.Point。有人测试这里面存在问题：解析矢量数据慢，甚至在点数多的情况下，会使浏览器“崩溃”掉。想想是有道理的：OpenLyers在解析数据时候，将所有的面、线包含的点全部都对象化为点对象t，并首先将所有的对象读取到内存，得到一个Feature的集合，然后将这个集合提交给渲染器进行渲染。这样渲染起来当然慢了。至于为什么要这样，可能是 OpenLayers项目本身在标准上，在框架结构上做的比较好，更细部的东西还得优化呀。可话又说回来，OpenLayers作为一个优秀的开源JS框架，学习借鉴的意义要比应用的意义大吧。 　 

　　下面以Point和Collection为例来说明其内部实现过程，先看Point。 

　　我们知道一个点就是一个坐标对(x,y)嘛，当然它得有两个属性x，y。在point类里，提供了六个成员函数，分别是 clone、distanceTo、equals、move、rotate和resize。看看计算两点距离的函数是怎么写的： 

distanceTo: function(point) { 

        var distance = 0.0; 

        if ( (this.x != null) && (this.y != null) &&  

             (point != null) && (point.x != null) && (point.y != null) ) {              

             var dx2 = Math.pow(this.x - point.x, 2); 

             var dy2 = Math.pow(this.y - point.y, 2); 

             distance = Math.sqrt( dx2 + dy2 ); 

        } 

        return distance; 

    } 

　　在collection集合对象中，可以存放同一类型的地理对象，也可以放不同的地理对象。定义了一个属性 component ，以数组对象的形式存储组成 collection对象的“组件”。别的不说了，看一个获取集合大小的函数 getLength ： 

    getLength: function() { 

        var length = 0.0; 

        for (var i = 0; i < this.components.length; i++) {

            length += this.components[i].getLength(); 

        } 

        return length; 

    } 

　　 细心的朋友也许会发现，每一个基类都有一个 destroy 函数。它是 OpenLayers实现的垃圾回收机制，以防止内存泄露，优化性能： 

　　  /* APIMethod: destroy 

     * Destroy this geometry. 

     */ 

    destroy: function () { 

        this.components.length = 0; 

        this.components = null; 

    } 。 

OpenLayers项目分析——（五） 数据解析——以GML为例

　　前面也提到过，OpenLayers设计是符合标准的，有良好的框架结构和实现机制，非常值得学习。OpenLayers支持的格式比较多，有XML、GML、GeoJSON、GeoRSS、JSON、KML、WFS等。这回主要以GML为例来看OpenLayers 数据的解析过程。

　　先来了解一下GML：

　　GML (Geography Markup Language)即地理标识语言，它由OGC（开放式地理信息系统协会）于1999年提出，目前版本是3.0。GML是XML在地理空间信息领域的应用。利用GML可以存储和发布各种特征的地理信息，并控制地理信息在Web浏览器中的显示。地理空间互联网络作为全球信息基础架构的一部分，已成为Internet上技术追踪的热点。许多公司和相关研究机构通过Web将众多的地理信息源集成在一起，向用户提供各种层次的应用服务，同时支持本地数据的开发和管理。GML可以在地理空间Web领域完成了同样的任务。GML技术的出现是地理空间数据管理方法的一次飞跃。

　　介绍一篇文章：GML3．0的WebGlS研究。

　　我们从总体上来把握一下OpenLayers对于GML数据的解析，首先通过调用得到GML文本数据，然后通过Formate.GML类的read方法来解析这个文本，解析得到Geometry对象，然后Geometry对象用相应的渲染器画出来。其实解析得到还是那些基本的Point呀、LineString呀之类的Geometry对象，就是我们在地图上看到的那些内容。

　　下面看其实现过程：

　　//read()函数读取数据，获取特征列表

    read: function(data) {

        if(typeof data == "string") { 

            data = OpenLayers.Format.XML.prototype.read.apply(this, [data]);

        }

        var featureNodes = this.getElementsByTagNameNS　　　　　　　　　　　(data.documentElement,this.gmlns,   this.featureName);

        var features = [];

        for(var i=0; i            var feature = this.parseFeature(featureNodes[i]);

            if(feature) {

                features.push(feature);

            }

        }

        return features;

    }

　　//函数parseFeature()是OpenLayers中GML数据格式解析的核心，就是它创建地理对象　

    //和其属性。   　　　　　　   　　

　　//实际上，每一个Foramt 子类都实现了这个成员函数，完成类似的功能。

    parseFeature: function(node) {

        // only accept on geometry per feature - look for highest "order"

        var order = ["MultiPolygon", "Polygon

                     "MultiLineString", "LineString

                     "MultiPoint", "Point"];

        var type, nodeList, geometry, parser;

        for(var i=0; i            type = order[i];

            nodeList = this.getElementsByTagNameNS(node, this.gmlns, type);

            if(nodeList.length > 0) {

                // only deal with first geometry of this type

                var parser = this.parseGeometry[type.toLowerCase()];

                if(parser) {

                    geometry = parser.apply(this, [nodeList[0]]);

                } else {

                    OpenLayers.Console.error("Unsupported geometry type: " +

                                             type);

                }

                // stop looking for different geometry types

                break;

            }

        }        

        // construct feature (optionally with attributes)

        var attributes;

        if(this.extractAttributes) {

            attributes = this.parseAttributes(node);

        }

        var feature = new OpenLayers.Feature.Vector(geometry, attributes);

        // assign fid - this can come from a "fid" or "id" attribute

        var childNode = node.firstChild;

        var fid;

        while(childNode) {

            if(childNode.nodeType == 1) {

                fid = childNode.getAttribute("fid") ||

                      childNode.getAttribute("id");

                if(fid) {

                    break;

                }

            }

            childNode = childNode.nextSibling;

        }

        feature.fid = fid;

        return feature;

    }

　　剩下就是由具体的函数parse and　bulid基本的地理对象（还有Attribute），包括point、multipoint、linestring、multilinestring、polygon、multipolygon等，然后在write出来。

结合前面的“OpenLayers空间数据的组织”，我们可以看到OpenLayers在解析获取GML数据的时候，比如涉及到面、线的时候，总是以点为基础构建的。有的朋友做过测试，说这时候，直接用SVG画出来，性能上会好很多（具体没测试过，不想多说什么）。

OpenLayers项目分析——（六）数据渲染分析

　 实际上，OpenLayers的整个表现过程是这样的：通过调用获取数据，然后各种格式的解析器解析数据，在用所谓的渲染器渲染后加到图层上，最后再结合相应的控件表现出来，成为一幅我们看到的“动态”地图。 

　　这里主要讨论 OpenLayers. Renderer这个类及其子类。 

　　Renderer类提供了一些虚方法，以供其子类继承，像 setExtent 、 drawFeature 、 drawGeometry 、 eraseFeatures 、 eraseGeometry 等。 

　　 Elements 继承 Renderer，具体实现渲染的类又继承Renderer类。之所以这样设计，是因为不同的矢量格式数据需要共享相应的函数，在 Elements 这个类中封装一下。这个类的核心是 drawGeometry 和 drawGeometryNode 两个函数。其中 drawGeometry 调用了 drawGeometryNode ，创建出基本的地理对象。 

    drawGeometry: function(geometry, style, featureId) { 

        var className = geometry.CLASS_NAME; 

        if ((className == "OpenLayers.Geometry.Collection") || 

            (className == "OpenLayers.Geometry.MultiPoint") || 

            (className == "OpenLayers.Geometry.MultiLineString") || 

            (className == "OpenLayers.Geometry.MultiPolygon")) { 

            for (var i = 0; i < geometry.components.length; i++) {

                this.drawGeometry(geometry.components[i], style, featureId); 

            } 

            return; 

        }; 

        //first we create the basic node and add it to the root 

        var nodeType = this.getNodeType(geometry); 

        var node = this.nodeFactory(geometry.id, nodeType, geometry); 

        node._featureId = featureId; 

        node._geometryClass = geometry.CLASS_NAME; 

        node._style = style; 

        this.root.appendChild(node); 

        //now actually draw the node, and style it 

         this.drawGeometryNode(node, geometry); 

    } 

　　渲染器的继承关系这样的： 

　　具体实现渲染的方法在 OpenLayers. Renderer.SVG 和 OpenLayers. Renderer.VML两个类中实现的，就是实现 Elements 提供的虚方法，比如 drawPoint 、 drawCircle 、 drawLineString 、 drawLinearRing 、 drawLine 、 drawPolygon 、 drawSurface 等 。以 drawCircle 为例看看具体的实现过程： 

    drawCircle: function(node, geometry, radius) { 

        if(!isNaN(geometry.x)&& !isNaN(geometry.y)) { 

            var resolution = this.getResolution(); 

            node.style.left = (geometry.x /resolution).toFixed() - radius; 

            node.style.top = (geometry.y /resolution).toFixed() - radius; 

            var diameter = radius * 2; 

            node.style.width = diameter; 

            node.style.height = diameter; 

        } 

    } 

OpenLayers项目分析——（七）地图表现

        一开始看到OpenLayers，就有一个问题。就是它作为WebGIS的前端，通俗地说，是“显示”地图的。那么，它显示的地图是什么，是怎么显示的，又是怎么实现的？——暂且把这个问题叫做地图表现。我觉得最关键的就是Map类，把这个类分析清楚了，问题就解决了一大半了。

　　前面第一回里说过怎么实例化一个地图，怎么向地图里加图层加控件。其实，地图是这样的，它就像一个容器，可以盛东西。要分析它光理解这些还不够，我们要知道这个容器是怎么做出来的，及具体都有什么功能。

　　Map类有两个常量：Z_INDEX_BASE和EVENT_TYPES，不说了，可顾名而思其意。再看它定义的一些属性：div（The element that contains the map）、baseLayer（The currently selected base layer）、events（An events object that handles all events on the map）。是这样，web页的div通过以id或name的形式获得map对象，然后layers和control在加载到map上，表现为地图。顺便说一句，控件control和事件event是相关联的，这以后会说。

　OpenLayers.Map类提供了两种实例化方式，举例来看：

 　// create a map with default options in an element with the id "map1"

     var map = new OpenLayers.Map("map1");

     // create a map with non-default options in an element with id "map2"

　//Optional object with properties to tag onto the map.

     var options = {

          maxExtent: new OpenLayers.Bounds(-200000, -200000, 200000, 200000),

          maxResolution: 156543,

          units: 'meters',

          projection: "EPSG:41001"

      };

      var map = new OpenLayers.Map("map2", options);

  　　OpenLayers.Map类实现的函数APIMethod是分组的，比如Layer Functions、Control Functions、Popup Functions、Container Div Functions、Zoom, Center, Pan Functions、Layer Options、Baselayer Functions、Zooming Functions、Translation Functions。其中，最关键的是Layer Functions和Control Functions，因为就是Layer对象和Control对象构成了map的主体。下面从每组函数中挑选出一两个来，看看具体实现过程。

　　Layer Functions：

就看addLayer函数吧，下面的addLayers就是调用的它，代码如下：

    addLayer: function (layer) {

        for(var i=0; i < this.layers.length; i++) {

            if (this.layers[i] == layer) {

                var msg = "You tried to add the layer: " + layer.name + 

                          " to the map, but it has already been added";

                OpenLayers.Console.warn(msg);

                return false;

            }

        }            

        layer.div.style.overflow = "";

        this.setLayerZIndex(layer, this.layers.length);

        if (layer.isFixed) {

            this.viewPortDiv.appendChild(layer.div);

        } else {

            this.layerContainerDiv.appendChild(layer.div);

        }

        this.layers.push(layer);

        layer.setMap(this);

        if (layer.isBaseLayer)  {

            if (this.baseLayer == null) {

                // set the first baselaye we add as the baselayer

                this.setBaseLayer(layer);

            } else {

                layer.setVisibility(false);

            }

        } else {

            layer.redraw();

        }

        this.events.triggerEvent("addlayer");

    }

可以看到其中涉及到layer的一些方法，下一回具体介绍OpenLayers. Layer类。

　　Control Functions：

    addControl: function (control, px) {

        this.controls.push(control);

        this.addControlToMap(control, px);

    }

可以看出，添加控件的过程是由controls.Push()和addControlToMap()两个函数共同完成的。

    addControlToMap: function (control, px) {

        // If a control doesn't have a div at this point, it belongs in the

        // viewport.

        control.outsideViewport = (control.div != null);

        control.setMap(this);

        var div = control.draw(px);

        if (div) {

            if(!control.outsideViewport) {

                div.style.zIndex = this.Z_INDEX_BASE['Control'] +

                                    this.controls.length;

                this.viewPortDiv.appendChild( div );

            }

        }

    }

　　Popup Functions：这组函数和上两组函数相似，是在地图上添加或删除Popup 对象。

　　Zoom, Center, Pan Functions：

　　　　//Allows user to pan by a value of screen pixels

　　    pan: function(dx, dy) {

        // getCenter

        var centerPx = this.getViewPortPxFromLonLat(this.getCenter());

        // adjust

        var newCenterPx = centerPx.add(dx, dy);

        // only call setCenter if there has been a change

        if (!newCenterPx.equals(centerPx)) {

            var newCenterLonLat = this.getLonLatFromViewPortPx(newCenterPx);

            this.setCenter(newCenterLonLat);

        }

   }

　Zooming Functions:

这里就看看放大缩小函数吧。

    zoomIn: function() {

        this.zoomTo(this.getZoom() + 1);

    }

    zoomOut: function() {

        this.zoomTo(this.getZoom() - 1);

    }

显然，zoomIn和zoomOut都使用了getZoom方法，放大就是让zoom加１，缩小减１。

OpenLayers项目分析——（八）地图表现（续）

　　上一回说到OpenLayers.Map类，这回介绍组成Map的主体部分OpenLayers. Layer类，先从其实现细节上分析，看它是怎么设计出来的。关于它许许多多的子类，即各种图层，想单独写一篇。

　　OpenLayers. Layer提供了一个EVENT_TYPES常量，用于支持关于图层的应用事件类型，这些事件有"loadstart", "loadend", "loadcancel", "Visibilitychanged"。

　　它“固有”的３个属性：id,name,div。其中，id和name是layer的身份，在对图层进行操作的时候，就是用它们标志的。至于div，大家都制知道，DOM元素，用于存放图层。

　　定义的map、event属性，是图层对象对map、event对象的引用；projection属性，设置默认情况下，地图的投影，同时也设置maxExtent, maxResolution, 和units 。

　　来看看构造函数：

     * name - {String} The layer name

     * options - {Object} Hashtable of extra options to tag onto the layer

     */

    initialize: function(name, options) {

        this.addOptions(options);

        this.name = name;

        if (this.id == null) {

            this.id = OpenLayers.Util.createUniqueID(this.CLASS_NAME + "_");

            this.div = OpenLayers.Util.createDiv();

            this.div.style.width = "100%";

            this.div.style.height = "100%";

            this.div.id = this.id;

            this.events = new OpenLayers.Events(this, this.div, 

                                                this.EVENT_TYPES);

        }

        if (this.wrapDateLine) {

            this.displayOutsideMaxExtent = true;

        }

    }

OpenLayers中每一个类的构造函数都是以initialize命名的。

　　再看看其成员函数：

　　destroy函数，相当于析构函数；

　　onMapResize，removeMap　虚函数，提供给子类继承；

　　//移动函数

　　moveTo:function(bounds, zoomChanged, dragging) {

        var display = this.visibility;

        if (!this.isBaseLayer) {

            display = display && this.inRange;

        }

        this.display(display);

    }

　　下面一组函数是Baselayer Functions函数，就是layer是Baselayer 的话，所用的函数。

比如，initResolutions、getResolution、getExtent等。

　　通过这两次的分析，可以发现，Map和Layers的关系：它们是相互引用的。实际上是这样，OpenLayers的Map类主要包含了对每个图层的引用，对每个控件的引用，对事件的引用，对装载容器的引用（其实就是那些map上层的div）以及对pop的引用，而其自身又包含有大量的方法和属性。图层主要包含了对map的引用，对自身div容器的引用以及事件的引用，而图层自身又包含了大量的属性和方法。map引用了layer，而layer又引用了map，这里就直接形成了循环引用关系。

　　这样的组成和关联关系，每动一下，就会涉及到大量的对象，影响了性能。

OpenLayers项目分析——（九）控件

　　OpenLayers中的控件，是通过加载到地图上而起作用的，也算地图表现的一部分。同时，控件需要对地图发生作用，所以每个控件也持有对地图（map对象）的引用。

　　前面说过，控件是于事件相关联的。具体的说就是控件的实现是依赖于事件绑定的，每个OpenLayers.Control及其子类的实例都会持有一个handler的引用的。

　　那么，怎么来创建并添加一个控件呢？用下面的语句：

　　//实例化一个控件

　　var control1 = new OpenLayers.Control({div: myDiv});

　　//向地图中添加控件

　　var map = new OpenLayers.Map('map', { controls: [] });

　　map.addControl(control1 );

对一些常用的OpenLayers控件，项目本身都封装好了，用下面的语句添加：

　　map.addControl(new OpenLayers.Control.PanZoomBar());

　　map.addControl(new OpenLayers.Control.MouseToolbar());

  　map.addControl(new OpenLayers.Control.LayerSwitcher({'ascending':false}));

  　map.addControl(new OpenLayers.Control.Permalink());

 　 map.addControl(new OpenLayers.Control.Permalink('permalink'));

 　 map.addControl(new OpenLayers.Control.MousePosition());

  　map.addControl(new OpenLayers.Control.OverviewMap());

    map.addControl(new OpenLayers.Control.KeyboardDefaults());

　　先看看OpenLayers. Control基类的实现过程，再选择几个典型的子类分析一下。

　　OpenLayers. Control：

　　//设置控件的map属性，即控件所引用的地图

    setMap: function(map) {

        this.map = map;

        if (this.handler) {

            this.handler.setMap(map);

        }

    }

　　//drew方法，当控件准备显示在地图上是被调用。当然，这个方法只对有图标的控件起　

　　//作用。

    draw: function (px) {

        if (this.div == null) {

            this.div = OpenLayers.Util.createDiv();

            this.div.id = this.id;

            this.div.className = this.displayClass;

        }

        if (px != null) {

            this.position = px.clone();

        }

        this.moveTo(this.position);        

        return this.div;

    }

　　前面说过，OpenLayers.Control及其子类的实例都是会持有一个handler的引用的，因为每个控件起作用时，鼠标事件都是不一样的，这需要动态的绑定和接触绑定。在OpenLayers.Control中是通过active和deactive两个方法实现，就是动态的激活和注销。

　　//激活方法

    activate: function () {

        if (this.active) {

            return false;

        }

        if (this.handler) {

            this.handler.activate();

        }

        this.active = true;

        return true;

    }

　　//注销方法

    deactivate: function () {

        if (this.active) {

            if (this.handler) {

                this.handler.deactivate();

            }

            this.active = false;

            return true;

        }

        return false;

    }

　　再来看OpenLayers.Control的子类，即各类“特色”控件。选鹰眼控件OpenLayers. Control. OverviewMap和矢量编辑工具条控件OpenLayers. Control. EditingToolbar来说。

　　顺便说一句，OpenLayers中的控件有些是需要图标的，像EditingToolbar，有些是不需要的，像OpenLayers. Control. DragPan。

　　OpenLayers. Control. OverviewMap：

　　“鹰眼”实际上也是地图导航的一种形式，在外部形态上跟图层开关控件有点儿像。

添加鹰眼控件的语句：

  　map.addControl(new OpenLayers.Control.OverviewMap());

　　在它实现的成员函数中，draw函数是核心，继承基类OpenLayers.Control，在地图中显示这个控件。

　　此控件关联了一些浏览器事件，比如

    rectMouseDown: function (evt) {

        if(!OpenLayers.Event.isLeftClick(evt)) return;

        this.rectDragStart = evt.xy.clone();

        this.performedRectDrag = false;

        OpenLayers.Event.stop(evt);

    }。

　　OpenLayers. Control. EditingToolbar：

　　OpenLayers从2.3版就对矢量编辑进行了支持，就是图上右上角几个图标。完成点、线、面的编辑功能。

　　同样，它也是用drew方法激活：

    draw: function() {

        Var　div　= OpenLayers.Control.Panel.prototype.draw.apply(this, arguments);

        this.activateControl(this.controls[0]);

        return div;

    }

　　下面的代码是使用此控件的具体过程：

　　Var  map, layer;    

     map = new OpenLayers.Map( 'map', { controls: [] } );

     layer = new OpenLayers.Layer.WMS( "OpenLayers WMS", 

             "http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );

     map.addLayer(layer);

     vlayer = new OpenLayers.Layer.Vector( "Editable" );

     map.addLayer(vlayer);

     map.addControl(new OpenLayers.Control.PanZoomBar());

     map.addControl(new OpenLayers.Control.EditingToolbar(vlayer));

     map.setCenter(new OpenLayers.LonLat(lon, lat), zoom);

OpenLayers项目分析——（十）事件机制分析

　　OpenLayers中的事件封装是其一大亮点，非常值得学习。说到事件机制，在宏观上不得不涉及控件OpenLayers.Control类、OpenLayers. Marker类、OpenLayers.Icon类等。是这样，在外观上控件通过Marker和Icon表现出来，而事件包含在控件之后，用他们自己的话说就是：The controls that wrap handlers define the methods that correspond to these abstract events 。顺便再说一句，控件实现的核心是handler类，每个控件中都包含对handler的引用，通过active和deactive两个方法，实现动态的激活和注销。

　　OpenLayers中的事件有两种：一种是浏览器事件（比如onclick，onmouseup等），另一种是自定义的事件。自定义的事件像addLayer ,addControl等，不象浏览器事件会绑定相应的dom节点，它是与layer、map等关联的。

　　OpenLayers中支持的浏览器事件类型有（以常量的形式提供的）：　

    BROWSER_EVENTS: [

        "mouseover", "mouseout

        "mousedown", "mouseup", "mousemove", 

        "click", "dblclick

        "resize", "focus", "blur" ]　

  　看看构造函数的的实现过程：

    initialize: function (object, element, eventTypes, fallThrough) {

        this.object     = object;

        this.element    = element;

        this.eventTypes = eventTypes;

        this.fallThrough = fallThrough;

        this.listeners  = {};

        // keep a bound copy of handleBrowserEvent() so that we can

        // pass the same function to both Event.observe() and .stopObserving()

        this.eventHandler = OpenLayers.Function.bindAsEventListener(

            this.handleBrowserEvent, this

        );

        // if eventTypes is specified, create a listeners list for each 

        // custom application event.

        if (this.eventTypes != null) {

            for (var i = 0; i < this.eventTypes.length; i++) {

                this.addEventType(this.eventTypes[i]);

            }

        }

        // if a dom element is specified, add a listeners list 

        // for browser events on the element and register them

        if (this.element != null) {

            this.attachToElement(element);

        }

    }

　　可以这样理解：

　　initialize（object, element, eventTypes, fallThrough）方法会将以数组eventTypes的每个元素为key建立哈希表listeners，表中每个键对应一个数组。还会给this.eventHandler赋值，它实际只是一个包装了triggerEvent事件触发函数的方法，所有的事件，包括浏览器事件和自定义事件都是通过它来中转的。然后initialize将所有的浏览器事件放入listeners中，并为其绑定相应的dom节点element和this.eventHandler事件处理函数OpenLayers.Event.observe(element, eventType, this.eventHandler)，节点上事件触发的时候会把事件传给this.eventHandler，它调用triggerEvent，从而将事件传出来。

　　来看其他的成员函数：

　　addEventType：Add a new event type to this events object；

　　attachToElement：把浏览器事件关联到相应的DOM元素上；

　　register： Register an event on the events object.

        register: function (type, obj, func) {

           if (func != null) {

               if (obj == null)  {

                  obj = this.object;

              }

            var listeners = this.listeners[type];

            if (listeners != null) {

                listeners.push( {obj: obj, func: func} );

            }

        }

    }

其中，func参数是预先定义的回调函数。

　　unregister：注销方法；

　　remove：Remove all listeners for a given event type. 

　　triggerEvent：Trigger a specified registered event。

OpenLayers分析——（十一）体系结构

好久没来更新了，感觉仍有点儿兴奋……

以前做的一些OpenLayers的分析，又整理了一下——以前弄的图片没有显示，现在基本可以了，发上来，如果有需要了解的朋友可以瞅瞅。

写的不好，请大家原谅了，呵呵……

   一般来说，我们了解一个事物，先是从轮廓、外观结构去认识，然后再从内部更细部的去探究。拿做软件来说吧（就比如OpenLayers），先是在文档设计它的框架体系，有个总体的结构，然后是各个模块的设计，再下来就是具体写代码等。如果要分析一个做好的项目，恰恰与此相反，从具体的代码中分析总结出系统框架（想当初，开发者在开发OpenLayers 的时候，带有项目框架的开发文档会是人手一册的吧）。总结它的框架结构，由于本人水平有限，觉得很难，能写到哪儿算哪儿吧。

　这张图基本上把OpenLayers的体系结构勾勒出来了，也就是我们看到的浏览器上地图的内部抽象表示。

图上最底层的是OpenLayers的数据源Image、GML等等，实际上，它们都是OpenLayers.Layer的子孙类。这些数据经过渲染器OpenLayers.Renderer渲染，然后显示在地图的图层Layer上。我们把整个地图看作一个容器，这个地图容器中还有一些特别的层和控件等。除此之外，还有绑定在Map和Layer上的一系列的待请求的事件。