2023年11月28日发(作者：)
MAPGIS VirtualEarth帮助文档
MAPGIS VirtualEarth帮助文档
目录
目录..............................................................................................................................................- 2 -
1 概述..............................................................................................................................- 3 -
2 开发环境介绍..............................................................................................................- 3 -
2.1开发环境................................................................................................................- 3 -
2.2开发软件---- 4 -
3 MAPGIS VirtualEarth二次开发技术........................................................................- 14 -
3.1 JavaScript脚本语言.............................................................................................- 14 -
3.2 Java语言...............................................................................................................- 16 -
3.3 HTML语言..........................................................................................................- 18 -
3.4 JSP技术................................................................................................................- 19 -
3.5 数据库（SQL Server/Oracle）..........................................................................- 20 -
3.6 XML语言.............................................................................................................- 21 -
- 2 -
MAPGIS VirtualEarth帮助文档
1 概述
MAPGIS VirtualEarth是中地数码拥有自主产权的一套显示三维地球的软件，它依托
MapGIS平台为基础，基于Java applet技术和JOGL技术开发。采用面向Internet的分布式
计算技术，支持跨平台、跨网络的大型网络应用系统的集成。
为了方便用户的二次开发，下面将会从开发环境、开发中涉及的主要技术等方面入手，
详细的说明MAPGIS VirtualEarth二次开发的有关事项。
2 开发环境介绍
MAPGIS VirtualEarth二次开发的环境是基于开发工具MyEclipse 6.0、开发语言JAVA、
Applet、OpenGL的。这些工具和技术是当下J2EE开发的主流技术，具有各自的特点，有
助于用户更好地进行MAPGIS VirtualEarth的二次开发。在开发之前需要配置开发环境，设
置环境变量。配置好环境后，就能利用功能强大的JAVA工具及技术开发WEB项目。
2.1开发环境
开发环境配置如下：
1、操作系统：WindowsXP、 Windows2003 Server（推荐）
2、浏览器： IE 6.0 及以上版本
3、环境支持：jdk1.6及以上、tomcat5.0及以上
4、数据库： SQL Server 、Oracle
2.1.1 MAPGIS VirtualEarth的开发环境
MAPGIS VirtualEarth的开发环境配置如下：
1. 按上述配置开发环境，安装好JDK1.6和tomcat5.0后，正确配置好环境变量。
2. 开发语言：JAVA和JavaScript。
3. 二次开发工具：Eclipse3.2，MyEclipse5.0，MyEclipse6.0、其他插件。如果不习惯英
文版的Eclipse，可以用相应版本的汉化包汉化，便于开发。
4. 准备好地图数据和相关的点位信息数据，并参照相关的配置文档配置好GIS服务器、
相关数据和数据服务器。示例中自带地图数据和点位信息数据，点位信息数据以SQL
Server数据库文件形式存放。如果使用自带的点位信息数据时，要将
VirtualEarthDemoDatabase_附加到本地SQL Server 2000数据库里。
5. 如果有用户自定义数据，则站点开发过程中须保持GIS服务器（MapGisIMSSvr）呈
启动状态。
2.1.2 MAPGIS VirtualEarth的开发语言
MAPGIS VirtualEarth开发的语言为JAVA语言。
- 3 -
MAPGIS VirtualEarth帮助文档
JAVA语言由Sun公司推出，是一个支持网络计算的面向对象程序设计语言。JAVA语
言吸收了Smalltalk语言和C++语言的优点，并增加了其它特性，如支持并发程序设计、网
络通信、和多媒体数据控制等。
2.1.3 MAPGIS VirtualEarth所用的文件类型
MAPGIS VirtualEarth中用到的文件类型和重要文件如下表所示：
表2-1 JAVA开发环境文件类型
文件扩展名 用途及说明
.java Java文件。
.class Java文件编译后的文件。
.jar Java归档文件，存放各种java文件的压缩包。
.htm 静态网页文件。
.css 样式文件,存放网站样式的样式表。
.js Javascript 编写的脚本文件。
.jsp 内含java 代码的文件，网站后台处理文件。
网站配置文件。
.与 使用Hibernate的数据库表映射文件。
.
使用Hibernate操纵数据库的文件，即数据库连接。
2.2开发软件---Eclipse
Eclipse是一种通用工具平台——普遍适用的开放式扩展IDE。它提供了功能丰富的开
发环境，众多插件能够无缝集成到Eclipse平台中的工具。Eclipse的体系结构如下图：
- 4 -
MAPGIS VirtualEarth帮助文档
图3-1 Eclipse的体系结构图
Eclipse的设计思想是：一切皆为插件。Eclipse的核心是非常小的，其他所有的功能都
以插件的形式附加到这个Eclipse核心之上。这样的功能插件包括它的图形API(称为
SWT/JFace)、Java开发环境插件(简称JDT)、插件开发环境(简称PDE)等。Eclipse对插件的
协同工作提供了良好的支持，不仅安装简单，而且还可以无缝结合。
Eclipse是开放源码的。对于程序员，Eclipse的开放源码让他们阅读最顶级的Java源码，
学习最优秀的Java技术。
下面就开始介绍如何在Eclipse里新建一个WEB站点，流程如下：
1. 打开Eclipse，其开始界面如图3-2。
图3-2 Eclipse启动时界面
2. 在初次启动Eclipse时会跳出一个对话框，提示选择工作空间，用来存Eclipse项目
的文件。如图3-3，选择路径后单击“确定”就可以启动Eclipse。如果想下次启动
时不出现该窗口，则勾选对话框最下面的“将此值用作缺省值并且不再询问”选项。
- 5 -
MAPGIS VirtualEarth帮助文档
启动后的界面如图3-4。
图3-3 选择工作空间页面
图3-4 Eclipse工作环境
3. 新建网站项目：选择文件Æ新建Æ项目，跳出如图3-5所示对话框。
4. 点击“向导”下的MyEclipse，选择J2EEProjects下的WebProject，如图3-6。
- 6 -
MAPGIS VirtualEarth帮助文档
图3-5 Eclipse中新建项目对话框
图3-6 选择Web Project新建Web工程
- 7 -
MAPGIS VirtualEarth帮助文档
5. 点击“下一步”，在跳出的对话框中的Project Name栏内输入项目名，例如填入
newjavap，如图3-7。Location栏指项目存放的目录，默认存放在选择的工作空间中，
一般不需要更改。如要特殊情况下需要更改时，请把Use default location的钩去掉，
点击Directory栏的Browse按钮，选择路径。
图3-7 输入新工程名
6. 点击“完成”，新的WEB站点创建成功。完成后的界面如图3-8。
图3-8 新建工程后的工作页面
- 8 -
MAPGIS VirtualEarth帮助文档
7. 此时在包资源管理中右键点击站点，选择新建Æ文件，在弹出的对话框中根据站点
的需要新建文件（如图3-9）；也可以选择新建Æ其他，在弹出的对话框中选择要新
建的文件模板。
图3-9 新建文件页面
在如下的对话框中，选择站点目录（WebRoot），将新建的文件保存到该站点目录下。
图3-10 选择父文件夹对话框
- 9 -
MAPGIS VirtualEarth帮助文档
输入文件名和后缀名，根据不同的后缀名建立不同的文件类型。网站启动时需要一
个起始页，可以是.htm文件或者是.jsp文件。在此可新建一个文件作为站点
的起始页（如图3-11）。
图3-11 输入文件名
8. 文件建好后，可以在编辑区打开文件进行编程，实现所需要的功能。例如，搭建一
个简单的示例，即在起始页中写入如下代码：
图3-12 中添加代码
9. 修改配置文件，在该文件中为站点进行相关的配置。如图，给站点设置起始
页。
图3-13 配置
- 10 -
MAPGIS VirtualEarth帮助文档
10. 站点搭建完成后，需要进行站点部署。点击按钮，弹出如下图3-14所示窗口，
在“Project”中选择项目newjavap；点击“Add”按钮，出现下图3-15界面，在“Server”
中选择tomcat5，在“Deploy type”中选择Exploded Archive，点击“完成”按钮；
再点击“确定”按钮即可（如图3-16）。
图3-14 部署步骤一
图3-15 部署步骤二
- 11 -
MAPGIS VirtualEarth帮助文档
图3-16 部署步骤三
注：部署站点的同时， Tomcat服务器自动为WEB站点设置好虚拟目录，默认情
况下虚拟目录名与项目名相同。
11. 站点部署后，需要运行站点。先启动Tomcat5.5，即点击
的向下三角符号启动（如
图3-17），然后点击启动Eclipse的内置浏览器，在地址栏输入localhost:8080/
（如图3-18），再在虚拟目录中选择站点运行，运行后的界面如图3-19。站点运行
过程中可能需要调试程序，具体的调试方法将在后面的“程序调试方法”章节中讲
述。
图3-17 启动Tomcat服务器
- 12 -
MAPGIS VirtualEarth帮助文档
图3-18打开Tomcat首页
图3-19 运行网站页面
注意：如果需要修改程序后运行站点，最好重启Tomcat服务器，再点击内置浏览
器浏览。不然运行结果可能还是修改前的结果。
在Eclipse里新建一个WEB站点的过程如上所述，如果需要了解更详细的信息，可以
参考Eclipse的帮助文件。
- 13 -
MAPGIS VirtualEarth帮助文档
3 MAPGIS VirtualEarth二次开发技术
3.1 JavaScript脚本语言
JavaScript是一种通用的、基于原型的、面向对象的脚本语言，它的设计目标是在不占
用很多系统和网络资源的情况下提供一种可以嵌入不同的应用程序的通用代码。它不需要依
赖于特定的机器和操作系统，即它是独立于操作平台的。
JavaScript的核心对象如表4-1所示：
表4-1 JavaScript的核心对象
对象 描述
Array 表述数组。
Boolean 表述布尔值。
Date 表述日期。
Function 指定了一个可编译为函数的字符串 JavaScript 代码。
Math 提供了基本的数学常量和函数；如其 PI 属性包含了π的值。
Number 表述实数数值。
Object 包含了由所有 JavaScript 对象共享的基本功能。
RegExp
String 表述了一个 JavaScript 字符串。
表述了一个正则表达式；同时包含了由所有正则表达式对象的共享的静
态属性。
表4-2 JavaScript表单对象
JavaScript表单对象如表4-2所示：
对象 描述
Button HTML 表单中的一个按钮。
允许用户从像复选框、单选钮、选择列表等这样的表单元素中输入文本做
出选择。
HTML 表单中的一个不可见文本对象。 Hidden
Select 对象的一个选项。 Option
HTML 表单中的一个文本域，其中的值以星号(*)显示。 Password
HTML 表单中的一组单选钮。 Radio
HTML 表单中的一个重置按钮。 Reset
Checkbox HTML 表单中的一个复选框。
Form
Select HTML 表单中的一个选择列表。
Submit HTML 表单中的一个提交按钮。
Text HTML 表单中的一个文本输入域。
Textarea HTML 表单中的一个多行输入域。
JavaScript语句如表4-3所示：
表4-3 JavaScript语句
- 14 -
MAPGIS VirtualEarth帮助文档
break
该语句用于结束当前的 while 或 for 循环，并将程序控制权交给循环后面
的语句。
comment 作者书写的文字，用于解释脚本的作用。注释将被解释器忽略。
continue
delete 删除一个对象的属性或数组中的一个元素。
do...while 一直执行其中包含的语句，直到测试条件为假。内含语句至少被执行一次。
export 允许一个签字的脚本向其它签字或未签字的脚本提供属性、函数和对象。
该语句用于中止 while 或 for 循环中一块语句的执行，并且直接执行下一
次循环。
该语句用于创建由三个可选表达式组成的循环，用分号隔开，外面包有圆括
号，后面跟着一块将要在循环中执行的语句。
该语句用于遍历一个对象的所有属性的特定变量。对于每个属性，JavaScript
都将执行特定的语句。
该语句用于声明一个带有指定参数的 JavaScript 函数。可以接受的参数包
括字符串、数值和对象。
该语句用于在指定条件为真的情况下执行一组语句。如果条件为假的话，则
可执行另外一组语句。
允许脚本引入其它签字脚本已经导出的属性、函数和对象。 import
提供一个表示符，和 break 或 continue 一起使用可标明程序应该继续执行
的流程。
该语句用于指定函数的返回值。 return
允许程序计算一个表达式，并试图将表达式的值与某个 case 标签匹配。 switch
该语句用于声明变量，可选赋初值。 var
该语句用于创建一个计算某表达式的循环，如果该表达式为真的话，则持续
执行一块语句。
该语句用于为一组语句建立缺省的对象。 with
for
in
function
if...else
labeled
while
JavaScript窗口对象如表4-4所示：
表4-4 JavaScript窗口对象
对象 描述
- 15 -
MAPGIS VirtualEarth帮助文档
Frame
可以在同一屏幕上显示多个互不干涉的可滚动框架的窗口，每个框架有其
自己的 URL 。
包含了一组客户已经在窗口中浏览过的 URL 的信息。 History
包含了当前 URL 的信息。 Location
包含了描述显示屏幕和颜色的属性。 screen
描述了一个浏览器窗口或框架。这是每个 document、Location 和 History
对象组的顶级对象。
Window
JavaScript示例如图4-1所示：
图4-1 JavaScript示例
3.2 Java语言
Java语言是在1995年由Sun M1cmsystems公司提出的一种编程语言，它具有了革
命化的“编写一次，随处运行”的跨平台能力，并具有强大的网络能力。
- 16 -
MAPGIS VirtualEarth帮助文档
Java之所以能够“编写一次，到处运行”，其原因就在于Java虚拟机（Java Virtual
Machine，JVM）。JVM位于Java程序和用户的计算机系统之间，如下图所示。
所谓虚拟机，其实在现实中并不存在，而是计算机的一种抽象设计，是由计算机程序来
实现的。Java虚拟机，指的就是一种知道Java语言的各种指令，并能够将这些指令翻译成
用户计算机所能理解的指令的计算机程序，也就是一种“抽象计算机”。
Java语言在执行时既被解释又被编译，这是由JVM结构所决定的。用户编写的Java程
序首先被编译成能在Java虚拟机上运行的虚拟指令，编译后的Java程序像用其他任何语言
编写的程序一样，被当成可执行文件，不同的是，这种可执行文件必须运行于JVM上。JVM
在不同的系统中以同样的方式工作，因此Java程序不必为每种平台单独进行编译。JVM为
不同的平台解释Java程序，所有和移植有关的问题都在JVM中得到解决，这样用户的Java
程序在理论上就可以不加修改地运行在任何拥有JVM的平台上。
Java语言的特点：
a) 简单（Simple）
b) 面向对象（Object-oriented）
c) 分布式（Distributed）
d) 健壮性（Robust）
e) 安全性（Secure）
f) 中性结构（Architecture-neutral）
g) 可移植（Portable）
h) 解释型（Interpreted）
i) 高性能（High performance）
j) 多线程（Multithteaded）
k) 动态（Dynamic）
- 17 -
MAPGIS VirtualEarth帮助文档
3.3 HTML语言
HTML语言是Hypertext Markup Language(超文本标记语言)的缩写，是一种通用的描述
文档结构的语言。它通过在用户文档中加入特定的控制字符或命令，使文档能够按照用户期
望的格式输出。HTML语言主要用于客户端的页面设计。
二次开发中HTML常用标签，如表4-5所示：
表4-5 HTML中常用标签
标签名 标签
字体标签
图片标签
有列表标签
块级元素 网页框架标签