因为下面的内容会分模块介绍源码，所以这里为了方便，首先介绍源码的目录结构 在OpenLayers 3官网的下载页面下载我们在开发工程中需要的文件(如：v3.17.1.zip)，注意如果需要编译源代码，需要下载包含编译功能的文件包：https://github.com/openlayers/ol3/releases 下载指定release版本的源码，注意是Source code (zip)或者Source code (tar.gz)。 - apidoc是ol3的api文档，打开ol.html就可以在浏览器中离线使用，当然也可以在官网中查看api； - build是ol3编译过的文件，工程开发中可以直接使用，下部分的案例是基于离线的源码的； - closure-library是google的closure库文件夹； - css里面只有ol.css一个文件，是定义ol3的全局样式，项目开发中需要引入； - doc提供给我们一些的案例，打开quickstart.html即可看到快速开始的案例； - examples是比较丰富的例子，和官网中的examples一样； - ol就是我们要分析的源码文件夹； - ol.ext是ol3所要使用的js库。

ol/ol文件夹下是我们分析的源码，分析基本思路：文件夹下的文件是公用的部分(A部分)，文件夹是分部分写的(B部分)。

0.底层基础

0.1 ol.js

第一行就可以看出，ol.js提供全局的第一命名空间ol

goog.provide('ol');

唯一的一个方法是：继承

ol.inherits = function(childCtor, parentCtor) { childCtor.prototype = Object.create(parentCtor.prototype); childCtor.prototype.constructor = childCtor; };

0.2 object.js

goog.provide('ol.Object'); goog.provide('ol.ObjectEvent'); goog.provide('ol.ObjectEventType'); goog.require('ol.Observable'); goog.require('ol.events'); goog.require('ol.events.Event'); goog.require('ol.object');

ol命名空间下所有的基本对象，比如map对象，feature矢量地图对象，都应该建立在ol.Object基础上。如：

---

map.js

ol.Object.call(this); ol.inherits(ol.Map, ol.Object);

feature.js

ol.Object.call(this); ol.inherits(ol.Feature, ol.Object);

---

通过这行代码：

ol.inherits(ol.Object, ol.Observable);

我们发现ol.Object继承ol.Observable Observable.js

ol.inherits(ol.Observable, ol.events.EventTarget);

我们发现ol.Observable继承ol.EventTarget； 这样，我们可以知道继承ol.Object后也就继承了基础事件ol.events。

0.3 events.js

ol3的基础事件

goog.provide('ol.events'); goog.provide('ol.events.EventType'); goog.provide('ol.events.KeyCode'); goog.require('ol.object');

提供的所有基础事件

ol.events.EventType = { CHANGE: 'change', CLICK: 'click', DBLCLICK: 'dblclick', DRAGENTER: 'dragenter', DRAGOVER: 'dragover', DROP: 'drop', ERROR: 'error', KEYDOWN: 'keydown', KEYPRESS: 'keypress', LOAD: 'load', MOUSEDOWN: 'mousedown', MOUSEMOVE: 'mousemove', MOUSEOUT: 'mouseout', MOUSEUP: 'mouseup', MOUSEWHEEL: 'mousewheel', MSPOINTERDOWN: 'mspointerdown', RESIZE: 'resize', TOUCHSTART: 'touchstart', TOUCHMOVE: 'touchmove', TOUCHEND: 'touchend', WHEEL: 'wheel' };

我们分析一下提供的几个方法

ol.events.bindListener_ = function(listenerObj) {}; ol.events.listen = function(target, type, listener, opt_this, opt_once) {}; ol.events.unlisten = function(target, type, listener, opt_this) {}; ol.events.unlistenAll = function(target) {};

其中方法名末尾带有”_”为私有方法，不带的为提供出去的共有方法。

0.4 math.js

提供基础的数学运算方法，角度转化弧度函数如：

ol.math.toRadians = function(angleInDegrees) { return angleInDegrees * Math.PI / 180; };

0.5 animation.js

提供bounce、pan、rotate、zoom四种方法

0.6 collection.js

对ol命名空间下的对象集合的操作。

goog.provide('ol.Collection'); goog.provide('ol.CollectionEvent'); goog.provide('ol.CollectionEventType'); goog.require('ol.events.Event'); goog.require('ol.Object'); ol.CollectionEventType = { ADD: 'add' REMOVE: 'remove' };

继承

ol.inherits(ol.CollectionEvent, ol.events.Event); ol.inherits(ol.Collection, ol.Object);

方法举例：

ol.Collection.prototype.remove = function(elem) { var arr = this.array_; var i, ii; for (i = 0, ii = arr.length; i < ii; ++i) { if (arr[i] === elem) { return this.removeAt(i); } } return undefined; };

0.7 uri.js

通过url加载地图，其中params包含请求地图的宽、高、分辨率、地图范围

ol.uri.appendParams = function(uri, params) { var qs = Object.keys(params).map(function(k) { return k + '=' + encodeURIComponent(params[k]); }).join('&'); // remove any trailing ? or & uri = uri.replace(/[?&]$/, ''); // append ? or & depending on whether uri has existing parameters uri = uri.indexOf('?') === -1 ? uri + '?' : uri + '&'; return uri + qs; };