Google Wave已经公测一个月了，再全世界范围内都掀起了一股索要Google Wave的热潮。做为一个有思想的程序员，除了为Google Wave自身的新特性感动兴奋和赞叹以外， 我们还好奇Google Wave 提供的API能干些什么。
说一句题外话：Google Wave计划引入类似IPhone的应用商店(AppStore)的模式，提高开发着的积极性，为开发者带来收入。嘿嘿，所以无论从兴趣上，还是从现实上，研究开发Google Wave的第三方应用都是有价值的！ o(∩_∩)o
如果您没有接触过Google Wave，流牛木马在这里推荐您先阅读这两个网页，再来看流牛木马的开发讲解。
关于Google Wave是什么： Google Wave，新Web时代的沟通平台（多图，视频）
关于Google Wave能干什么： Google Wave试用体验与Google的野心
如果您已经了解完Google Wave的基础，OK，我们开始吧。
Google Wave API能干什么？
- 开发机器人(Robots API)
您刚才从上面的文章了解到，Wave是用来多人协作的。在多人协作的工作中，有一些工作是可以交给程序来做的。比如，或许您想在Wave中敲入 : ) 时，机器人可以自动帮你转换成图片
；在比如， 或许当您想当你编辑完Wave进行保存时，机器人可以自动帮你翻译为制定的语言；或许您想当您在Wave中分享代码时，机器人能够帮你把代码高亮；或许您还想当您新建Wave，机器人可以自动帮你将信息发布到Twitter上(或让机器人通过邮件/短信方式通知其他参与者？)等等等等。
要完成上面例子中的功能，您只需要把相应的Wave机器人像普通的参与者(participants)一样添加到Wave中，机器人就可以工作了。机器人可以和普通人类参与者一样，监听Wave的各种状态、阅读、修改Wave的信息。
简单地说： 人类能在Wave上干什么，机器人就能在Wave上干同样的事——只要您为它编写好程序逻辑。
很好玩吧？ 嗯，Google Wave API当中的第一套API就是关于机器人的。使用这些API, 您可以发挥出您的编程特长，写出完成各种各样功能的机器人, 提交到官方，供全世界的Wave用户使用。
- 开发嵌入Wave的网页部件(Gadgets API)
当您看完上面两篇介绍Wave的文章时，您一定会感到非常惊叹。同时也许您也会想：好像功能还不太全，我能不能再给他补充一些的功能？比如画板、投票、统计、电话会议、地图标记等团队协作中常用的功能，Wave都没有自带。再如常见的“奥运倒计时”“天气预报”等无聊功能，再如一些“中国特色”的功能，比如偷菜、斗地主、抢车位……
是的，就是这样。Wave提供了一些列优秀的特性，通过API, 您可以充分发挥您的想象，让您开发的Gadgets使用这些特性，更加完美。
相信大家对Gadgets已经很熟悉了，前段时间流行过；不过值得注意的是：使用了Wave API、引入了Wave的一些特性、并嵌入到Wave里的Gadgets, 可比传统网页上的Gadgets惊艳多了！ - 将Wave嵌入其他网页(Embed API)：
这个API是最简单的，但很可能是将来使用的人最多的。它的功能很简单：将已有的一个Wave嵌入到其他网页：比如您的博客。不过现阶段这个API用处不大，因为Wave用户太少了，并且IE是不支持Google Wave的——就算您嵌入到您的博客文章里，能看到的人也是少数。
Google Wave 各种API的开发示例
- Robots API
在了解Robots API之前，您必须了解Google的云计算平台——Google App Engine (GAE)，因为Google 只支持您将机器人部署在GAE上。GAE的开发和使用非常简单，流牛木马在这里就不介绍了，请读者自行阅读这里、这里和这里 ，如果还不明白，可以直接咨询我。 o(∩_∩)o
GAE目前只支持两种语言： Java和Python。 我非常喜欢Python的优雅。下面就举一个Python的例子好了(其实Java我也不会*_*)。
使用Python和Robots API开发Wave的机器人，需要以下步骤：
1. 搭建Google AppEngine的开发环境
2. checkout Robots API的代码，并import到项目中
3. 添加事件的Handler (处理函数)
4. 部署。
实例代码：
from waveapi import events
from waveapi import model
from waveapi import robot
def OnParticipantsChanged(properties, context):
"""当参与者发生变化时，执行的函数"""
added = properties['participantsAdded']
for p in added:
Notify(context)
def OnRobotAdded(properties, context):
"""当机器人刚被添加时，执行的事件"""
root_wavelet = context.GetRootWavelet()
root_wavelet.CreateBlip().GetDocument().SetText("我是机器人，我开始工作了！")
def Notify(context):
root_wavelet = context.GetRootWavelet()
root_wavelet.CreateBlip().GetDocument().SetText("有新朋友来了！")
if __name__ == '__main__': """为这个机器的属性(profile)赋值。分别是:机器人名称、机器人头像、版本号、地址"""
myRobot = robot.Robot('appName',
image_url='http://appName.appspot.com/icon.png',
version='1',
profile_url='http://appName.appspot.com/') """以下是添加Handler,对[参与者变化]和[机器人添加]这两个事件赋予相应的处理函数。"""
myRobot.RegisterHandler(events.WAVELET_PARTICIPANTS_CHANGED, OnParticipantsChanged)
myRobot.RegisterHandler(events.WAVELET_SELF_ADDED, OnRobotAdded)
myRobot.Run() - Gadgets API
如果您有过开发传统Gadgets的经历， 您开发Gadgets会觉得非常信息： 在开发常规Gadgets时那些与后台交互的数据操作，全部由Wave的API来实现了，方便到家！
大家知道，Gadgets主要就是Javascript。 那么好，开发Wave的Gadgets也只需要以下两个步骤：
1. 首先是一个Gadgets
2. 引入Wave Gadgets API(纯Javascript),在您的Gadgets中使用这些Javascript函数，与Wave进行交互。
下面的示例代码展示的Gadgets中，提供了两个按钮：点击第一个按钮可以将当前count变量的值加1，并更新保存到Wave中；第二个按钮重置count的值为0. 注意：这里的count您可以理解为“服务器变量”，它由Wave的api来记录。
<?xml version="1.0" encoding="UTF-8" ?> <Module> <ModulePrefs title="State Example" height="120">
<Require feature="wave" />
</ModulePrefs>
<Content type="html">
<![CDATA[
<div id="content_div" style="height: 50px;"></div>
<script type="text/javascript"> var div = document.getElementById('content_div'); //用户点击按钮时， 在本wave中获取到[count]变量的值，加1，记录。 function buttonClicked() { var value = parseInt(wave.getState().get('count', '0')); wave.getState().submitDelta({'count': value + 1}); } //当状态变更时，在wave中获取到[count]变量的值，并显示。如果[count]变量不存在，显示为0. function stateUpdated() { if(!wave.getState().get('count')) { div.innerHTML = "The count is 0." } else { div.innerHTML = "The count is " + wave.getState().get('count'); } } //初始化：判断这个Gadgets是不是包含在Wave的容器内，如果是则进行初始化。 function init() { if (wave && wave.isInWaveContainer()) { wave.setStateCallback(stateUpdated); } } gadgets.util.registerOnLoadHandler(init); //重置[count]变量的值为0 function resetCounter(){ wave.getState().submitDelta({'count': '0'}); } </script> <input type=button value="Click Me!" id="butCount" onClick="buttonClicked()"> <input type=button value="Reset" id="butReset" onClick="resetCounter()"> ]]> </Content> </Module>
- Embed API
呵呵，这个就非常没技术含量了，直接上示例代码：
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:v="urn:schemas-microsoft-com:vml">
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8"/>
<title>Google Wave Embed API Example: Simple Wave</title>
<script src="http://wave-api.appspot.com/public/embed.js" type="text/javascript"></script>
<script type="text/javascript"> //寥寥数行，就把一个已有的Wave插入到了某网页的一个叫做"waveframe"的div中
function initialize() {
var wavePanel = new WavePanel('http://wave.google.com/a/wavesandbox.com/');
wavePanel.loadWave('wavesandbox.com!w+waveID');
wavePanel.init(document.getElementById('waveframe'));
}
</script>
</head>
<body onload="initialize()">
<div id="waveframe" style="width: 500px; height: 100%"></div>
</body>
</html>
这里是DEMO页 ： http://file2.ws/hosted/2/53472/1.htm ，不过前文说了，现在Wave处于半公测阶段，您需要Google Wave的开发者帐号才能看到哦！
怎么样，很简单吧？ 呵呵， 赶快一起投入到Google Wave的开发当中吧！
如果您有一些好的创意，尤其是关于Robots与Gadgets的，请告诉我，我非常有兴趣与大家一起探讨。o(∩_∩)o
转载请著名版权： 流牛木马 @ 博客园
本文地址: http://www.cnblogs.com/azure/archive/2009/11/13/GoogleWaveAPI.html
