从这一点来说Google Earth客户端是我们时代的技术标志。Google Earth并非是第一个地球浏览客户端,而且与它的先驱、不为人知的Keyhole非常相似。但是凭着Google的大名以及基础版对最终用户免费,它完成了市场渗透并得到公认――这是另一个值得大书特书的有趣话题。
本文只有一个基本使命:即向你展示在servlet和Google Earth客户端之间发送和接收信息是多么的容易。有了这种程度的交互,你就能用基本的Java编程技能创建设想的服务。
使用许可及竞争者
截至本文发稿时Google Earth还处于beta阶段(版本号3.0.0616),许可证是商业的(见客户端的帮助部分)。如果你想寻求等价的开源范例,我建议你去关注优秀的Nasa World Wind(Nasa世界风)项目
基础知识
Google Earth客户端以第二版的锁位标记语言(KML)解析XML数据,它有一个专用的命名空间。庞大的KML配置信息可能会影响到GUI显示,开发这种需要平衡利弊的应用的难点在于需要了解更多的KML细节而不是编程技巧。KML实体的简要列表包括:
*Placements(位置),标明在地球上的坐标
*Folders(夹子),帮助组织其它的特征信息
*Documents(文档),存放可能包含风格元素的folder的容器
*Image overlays(图片叠加),用来添加图片
*Network links(网络链接),描述在何处以及如何与服务器或者servlet(本文采用的方式)连接
本文为了简化的目的,主要探讨了folder、placement和network-link元素的使用;此外还用folder定义了一段旅程(tour),它里面包含了一系列的placement。
在Windows上安装了Google Earth后,文件扩展名KML和MIME(Multipurpose Internet Mail Extensions,多用途网络邮件扩展)类型“application/keyhole”即被注册。这意味着只要点击KML文件或通过TCP/IP接收“application/keyhole”MIME类型的文件就会激活Google Earth客户端。
如果返回的KML文本为:
<Folder><name>Hello World [127.0.0.1] </name></Folder>
则程序将显示如下内容:
图1 Hello World folder的GUI显示
要想激活Earth客户端,只需浏览适当的URL地址--就好比从资源地址(http://localhost:8080/Tour/hello)下载HelloServlet源程序。这样就能激活doGet()方法,然后重定向到doPost()方法,在所有的Web浏览器里都会看到以下结果:
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
doPost(request, response);
}
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
response.setContentType("application/keyhole");
PrintWriter out = response.getWriter();
String message ="<Folder><name>Hello World ["
+ request.getRemoteAddr()+ "]</name></Folder>";
out.println(message);
}
不要小看这段简单的代码,里面的方法暗藏着玄机。服务器可以作为各种数据类型和Google Earth之间的中介。不妨设想像这样一个场景:在旅程数据中包含有不同的XML方言,在返回响应前由服务器完成扩展风格语言(Extensible Stylesheet Language)的转换。再进一步,服务器可以选择返回哪一种响应,以允许个性化处理。KML文档实体允许风格定义,可根据IP地址范围改变风格,使得不同的用户看到的风格可能会不一样。
作为实践,我们将从使用Google Earth和输出KML文件开始。在Google Earth的顶部是Add菜单,可以在这里添加placement、folder和image overlay,然后用File菜单保存生成的KML文件。我强烈推荐编辑导出的XML文件以了解改动对Google Earth的影响。好了,让我们开始与这位世界之王共舞!
了解城市定位
本节给出一个面向教学的应用:一个用来教授学生城市名称与地理位置间关系的程序。我们将创建一个以类似于抽签的方式将城市位置随机发送给客户端的servlet。城市的位置(placement)用KML表示。Placement实体里封装了HTML链接,将用户引导到相关的有趣站点。这样我们就可以使用户在Web浏览器和Google Earth间进行交互。
学生可以通过在鼠标置于链接之上时出现的菜单中选择Refresh来选择下一个placement,如图2所示。
图2 刷新网络链接生成一个新位置(在这里是伦敦)时的GUI显示
我们这个应用的后台处理用到了network-link(网络链接)实体,network-link从http://location加载数据文件。将此文件存于桌面并双击,Google Earth开始运行,并从服务器端加载下面的KML代码段。
City.kml
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://earth.google.com/kml/2.0">
<NetworkLink>
<description>Refresh me</description>
<name>Random City</name>
<visibility>1</visibility>
<open>1</open>
<refreshVisibility>1</refreshVisibility>
<flyToView>1</flyToView>
<Url>
<href>http://location </href>
</Url>
</NetworkLink>
</kml>
该配置中的实体含义为:
*visibility(可见性),定义了网络链接是否可见
*open(展开),说明是否展开标签
*refreshVisibility(刷新可见性),定义是否取代用户对刷新位置可见性的设定
*flyToView(巡视),如果设为1,用户可以在View窗口“飞越”位置上空
许多实体通常都可以跨根元素使用(如description)。注意标签名是大小写敏感的,所以编码时要小心以免出现难以排查的错误。在我看来,各标签值与它们对GUI的交互作用关系并不总是符合逻辑的,因此你可能对任何新的KML代码段的运用都需要花些时间。
注意
在默认情况下,Firefox、Opera和IE浏览器对于从Web上接收的扩展名为kml的文件反应是不同的。激活网络链接文件最通用的方法是避免服务器将KML文件初始化,并允许用户将文件下载到桌面,这样就能通过双击来启动它们。另一种更好的方法是将KML文件嵌入到JSP(JavaServer Pages)页面里并允许JSP页面返回“application/keyhole”MIME类型的KML代码段。假使对内容类型做修改并去掉XML模式,city.jsp就成了city.kml文件。
该代码的开头为:
<%response.setContentType("application/keyhole");%>
<NetworkLink>回到前面的代码,servlet返回了一个在description元素中带有HTML代码的placement。为遵守XML规范,我们将HTML代码段放入<!CDATA[]]>分割标签中,以避免使XML解析器混淆:
<Placemark>
<name>London</name>
<description>
<![CDATA[<a href="http://www.visitlondon.com/choose_site/?OriginalURL=/">London</a>]]>
</description>
<address>London, UK</address>
<styleUrl>root://styleMaps#default+nicon=0x304+hicon=0x314</styleUrl>
<Point>
<coordinates>-0.1261969953775406,51.50019836425783,50</coordinates>
</Point>
</Placemark>
在placement里出现了三个新实体:
*address(地址),包含地址的逻辑标签
*styleUrl,定义在此处要显示的图片
*Point/coordinates(点/坐标),位置的柱面坐标
Servlet通过以下代码生成一个随机的placement响应:
manager.KMLRenderOfRandomPlacement();
我们的整个应用都是最基础的,servlet没有保持跟踪状态。Management类根据数据的组织重画各个窗口。Manager.java的init方法将数据加载到property bean数组中。显然,真实的应用需要与数据库通信,象iBATIS或Hibernate这样的持久层管理框架将会很有用。placement bean用来为返回的placement准备数据,该bean有一个代表其自身的属性点。当开发者对KML编程的细节以及如何到达Google Earth GUI中的某个点有了更多的了解之后,就可以对此模型进行扩充。
下面的QuizServlet是对Manager.java的轻量封装,该servlet对每个post或get请求都返回一个有效的KML响应。
QuizServlet.java
package test.google.earth.servlet;
import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.ServletException;
import javax.servlet.http.*;
import javax.servlet.ServletConfig;
import test.google.earth.manager.Manager;
public class QuizServlet extends HttpServlet
{
private Manager manager;
public void init(ServletConfig config) throws ServletException {
super.init(config);
this.manager= new Manager();
manager.init();
}
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
doPost(request, response);
}
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
response.setContentType("application/keyhole");
PrintWriter out = response.getWriter();
out.println(manager.KMLRenderOfRandomPlacement());
}
}
Manager.java
package test.google.earth.manager;
import java.util.Random;
import test.google.earth.bean.PlacementBean;
import test.google.earth.bean.PointBean;
public class Manager {
private PlacementBean[] cityArray;
private String styleURL;
private String open;
private Random generator;
private int idx;
public Manager(){}
public void init(){
this.styleURL="root://styleMaps#default+nicon=0x304+hicon=0x314";
th