要想让大家学习如何使用App Engine开发，其实总结里的文章完全可以入门了，不过如果能有实际的例子，大家学起来肯定更带劲。所以，根据Google大牛Nick和Facebook大牛Bret的文章和代码，准备就如何使用Google App Engine开发博客系统做一个专题。在学完本专题之后，你就可以自己在Google App Engine上面搭建博客，并根据自己的需求修改代码了。

下面说一下这个专题的几个特点:

• 使用Google App Engine开发
• 使用Facebook的开源框架Tornado
• 使用HTML5与CSS3
• 加入最新的WEB 2.0功能

好了，大家期待吧～

App Engine应用·

国人开发的几个基于Google App Engine的Twitter应用

[视频]Google App Engine成功案例分析-Giftag

Google App Engine网站推荐

Google App Engine优秀网站介绍：spy

App Engine经验

3P机器人制作小结

App Engine教程

[跟康爷学GAE]显示最新访客留言

[跟康爷学GAE]存储用户的留言（附GAE数据结构的介绍）

[跟康爷学GAE]访客留言的Form和表单获取

[跟康爷学GAE]显示当前访问的登录用户

[跟康爷学GAE]GAE的Hello World程序(3)

[跟康爷学GAE]GAE的Hello World程序(2)

[跟康爷学GAE]GAE的Hello World程序(1)

[跟康爷学GAE]GAE教程计划的目录

[跟康爷学GAE]一些准备工作

[跟康爷学GAE]如何注册Google App Engine(修改)

[跟康爷学GAE]如何注册Google App Engine

Google App Engine教程计划

中文版Google App Engine入门指南(教程完整版）

中文版Google App Engine入门指南

关于Google App Engine的HTTP header长度问题

Google App Engine第三天资料及笔记

Google App Engine第二天资料及笔记

Google App Engine第一天资料

App Engine新闻

Google App Engine for Java SDK 1.2.2发布

App Engine正式支持JAVA

Google App Engine重大更新：缩小限制

Google App Engine的最新更新（090212）

Google App Engine SDK Version 1.1.8发布

Google App Engine支持HTTPS

Google App Engine更新：可创建10个应用

App Engine图书

《Google App Engine in Action》下载和介绍

《Developing with Google App Engine》

博客主要将是介绍Google App Engine的最新功能，App Engine的教程，App Engine与android，iPhone应用，HTML5以及一些我的思考，如果你感兴趣的话，可以在Twitter上Follow @lookon，或者订阅我的博客: http://feeds.feedburner.com/areyoulookon

请大家多关注接力网站上面的通知，或者在Twitter上面follow lookon。不会上Twitter的去 http://twitese.appspot.com/

Google Wave马上又要发放100000个邀请了，具体的邀请政策可以看ReadWriteWeb的文章。如果你想第一时间收到我的邀请或者提名，欢迎留下你的EMail或者在Twitter上回复我。（我的Twitter:@lookon)

本文为Google Wave中文入门文档，会持续更新的，希望大家多多宣传~

一、Google Wave界面介绍

1.主界面

下面是主界面的截图，基本上Google Wave里面的所有内容都在这个界面上了：（所有面板都是可以最小化的）

2.导航面板

在主界面的左上方，有一个导航面板(Navigation Panel)，和GMail里的导航类似，包括Inbox，Active（活跃的wave），All，By Me，History，Spam，Settings，Trash以及保存的搜索结果和文件夹。注意，Google Wave文档说，这里的所有导航链接都是搜索结果页其实。

3.联系人面板

在导航面板下面，是联系人面板（Contacts Panel），在这个面板里，将会显示你的Google Wave联系人（据悉，这次公开的测试中，联系人将直接是你的Google Contact里的联系人）

a.点击自己的头像，然后点击Change Photo，就可以改头像了（这个头像就是你在GMail里的头像）

b.联系人可以在搜索（见截图）

c.点击好友的头像，可以查看他的信息，也可以直接ping他（ping就是发起私聊）

d.你可以修改你的状态，和GMail里的状态不同步

3.搜索面板

搜索面板很简单，就是完成各种搜索的。

I 搜索命令大致有下面几个：

a.tag，比如搜索tag:中文

b.by，比如搜索by:me

c.with，比如搜索with:public，with:areyoulookon@wavesandbox.com

d.in，比如搜索in:Google（就是搜索Google这个文件夹里的所有wave）

这些命令可以联合起来一起使用，比如搜索

google wave tag:中文 by:me with:public in:Google

II 在搜索结果中点击wave就是打开，ctrl+点击就是在新面板中打开（于是两个wave可以共存）。可以使用Move to将wave移到某个文件夹下。

III 按住shift，可以选择多个wave进行操作

4.Wave面板

Wave面板里面有很多操作，可以回复，重放Wave的对话（Playback），归档（Achieve）等等。Wave面板可以最大化，那样就可以获得几乎全屏的视野了。

二、Google Wave快捷键

下面是一些主要的快捷键，具体内容如果你有了wave账号后，在里面我建了帮助文档了。

三、Google Wave常见问题

哪里有Google Wave的文档？

这篇博客就算是中文的入门文档了吧。。Google Wave的开发人员说，他们也不晓得什么算文档，不过这里有Google Wave协议的文档：http://www.waveprotocol.org/whitepapers

哪里有Google Wave示例代码？

http://wave-samples-gallery.appspot.com/ （其实是几乎所有机器人和小工具的app gallery）

如何公开我的Wave？

先将public@a.gwave.com添加为好友，然后在Wave中将public@a.gwave.com添加为参与者，那么你的Wave就公开了。

如何和其他人分享一个wave？

三个方法。1.直接将这个wave拖到其他wave中，会自动生成一个链接；2.使用ctrl+l，粘帖这个wave的id，也可以创建一个链接（这种方法可以改链接的名字）；3.直接将你的wave公开

如何看所有公开的Wave？

Inbox中不能看到你没参与的公开Wave，想要看其他的公开Wave，可以搜索with:public，这就是看所有公开Wave的方法。

Google Wave支持的浏览器？

Chrome 3.0 Chromium 4.0.212.0，Firefox 3.0 ，IE + Google Chrome Frame ，Safari（以及Gears 0.5.21.0）

Google Wave申请的地址？

开发人员 http://ow.ly/rLNj 非开发人员 http://ow.ly/rLNo （建议都去填开发人员的那个）

如何在Google Wave中添加超链接？

三种方法：1.使用G+插件，将Google搜索中的链接添加到wave；2.使用ctrl+L添加链接（也可以点击link按钮）3.拖拽wave到另一个wave中

如何给一个wave添加tag?

只要点一下在wave左下角的tag旁边的+，然后输入tag，回车即可

如何汇报bug?

汇报bug的地址：http://code.google.com/p/google-wave-resources/issues/list

广告时间：如果你喜欢看美女图片，并且使用Twitter，那么欢迎你在twitter上follow @ppperson （之所以会研究Flickr的API，也是因为这两天另一个著名的图片存储服务商Twitpic挂了）。当然也欢迎大家在twitter上跟随@lookon

一、申请API key

出于安全性的考虑，Flickr需要每个使用API的用户申请API key，凭着这个API key和相应的secret，你才能使用Flickr的API服务。

申请地址：http://www.flickr.com/services/api/keys/apply/

点击Apply for a Non-Commerical key，填写完信息后（你必须有一个yahoo邮箱，然后需要登录），就能获得一个API key和相应的Secret了。

二、配置API key信息

申请完之后，我们点击Edit key details，有一个东西是必需要填的，就是我们的Authentication Type。由于我使用的是Google App Engine进行编程，所以就勾选了Web Application，你也可以根据需要进行勾选，还有两个选择是Desktop Application和Mobile Application。

选了Web Application之后，我就必须再填写一个Callback URL，这个就是用户授权后，需要返回到我们的web应用的地址，用来获取用户的auth_token以及做更多的事情。

三、使用Flickr Authentication API的主要流程

下面我们来看看如何获得API授权以及如何使用API服务的大致过程：

1. 跳转页面到Flickr的用户授权页
2. （用户登录Flickr）用户在Flickr上同意授权
3. Flickr将页面跳转到你预先设定好的Callback URL
4. 你在Callback URL页面中，获得用户的auth_token，存储或缓存这个auth_token
5. 使用用户的auth_token调用Flickr的API服务

四、一些具体实现的细节

1.用户授权页的地址格式

用户需要访问一个你的应用一一确定的授权地址来授权你的应用，这个地址格式是：

http://flickr.com/services/auth/?api_key=[api_key]&perms=[perms]&api_sig=[api_sig]

其中[api_key]就是你申请来的API key，[perms]是授权的权限，可以是write，read或者delate，一般都选write。api_sig是一个比较复杂的东西，将在后面具体叙述。

2.用户授权后跳转到Callback URL后的操作

用户在授权页面授权了之后，Flickr会将页面跳转到你预先设定好的Callback URL，并且带上一个frob参数。比如，你的Callback URL是http://viewr.com/auth.php，那么Flickr将会发来一个HTTP GET请求，地址为http://viewr.com/auth.php?frob=abcxyz，frob的值是随机的，你需要在程序端获取这个frob参数值。

接下来的事情就是，你向Flickr发送一个HTTP GET请求，用来获得用户的auth_token，这个请求中必须有frob值，而且必须是在Callback URL收到请求后立刻发送，frob有时间限制的，过期的frob将失效。

下面是获取用户auth_token的请求地址：

http://flickr.com/services/rest/?method=flickr.auth.getToken&api_key=1234567890&frob=abcxzy&api_sig=3f3870be274f6c49b3e31a0c6728957f

api_token和前面一样，frob就是在Callback URL中获得的那个frob，api_sig还是后面讲解。

发送请求后，Flickr将会返回用户的auth_token值，没有其他内容，你只要保存即可。

3.使用用户的auth_token调用API

有了用户的授权后，便能获得用户的auth_token，然后调用Flickr Authentication API。注意，这个auth_token必须和你的API key结合才能使用，这样就保证了API不会被盗用和滥用。

根据Flickr API的文档，选择适当的方法，便可以进行不同的操作了，下面举个例子，用来获取用户信息：

发送HTTP Post请求到

http://flickr.com/services/rest/?method=flickr.people.getInfo&api_key=1234567890&auth_token=334455&api_sig=4f3870be274f6c49b3e31a0c6728957f

就能得到Flickr用户的信息了，其中method的值可以参见Flickr的API文档，api_key如前，auth_token就是你保存的用户的auth_token。

4.如何进行签名

前面说到api_sig是个负责的东西，这里就讲解下如何生成这个签名（api_sig）：

a.将参数按字典顺序进行排序

比如，前面用户授权页的地址中有api_key和perms两个参数，那么经过排序后的结果是

api_key=[api_key]，perms=write

b.将Secret和这些参数合起来

这里的Secret是你申请API key的时候一起得到的那个Secret，然后再和排过序的参数合起来，变成

Secretapi_key[api_key]permswrite

c.计算这个字符串的md5() hash值，并转为16进制

于是就得到了api_sig的值，也就是说，api_sig是由你的Secret以及所需参数一起生成的一个签名，缺一不可。

d.Python实现

下面是一个Python语言的生成签名的实现

def sign(dictionary):

        """Calculate the flickr signature for a set of params.

        data

            a hash of all the params and values to be hashed, e.g.

            “{"api_key":"AAAA", "auth_token":"TTTT", "key":

            u"value".encode(‘utf-8′)}“

        """

        data = [secret] #你的Secret值

        #dictonary就是参数的字典表示，如{"api_key":"aaa","auth_token":"bbb"}

        for key in sorted(dictionary.keys()):

            data.append(key)

            datum = dictionary[key]

            if isinstance(datum, unicode):

                raise IllegalArgumentException("No Unicode allowed, "

                        "argument %s (%r) should have been UTF-8 by now"

                        % (key, datum))

            data.append(datum)

        md5_hash = md5.new()

        md5_hash.update(”.join(data))

        return md5_hash.hexdigest()

五、有用的资源链接

照例给出一些很哟用的资源链接：

1.Flickr API官方文档：http://www.flickr.com/services/api/

2.申请Flickr API key的地址：http://www.flickr.com/services/api/keys/apply/

3.Flickr Authentication API使用的官方介绍：http://www.flickr.com/services/api/auth.spec.html

4.Flickr API的Python类库：http://www.stuvel.eu/projects/flickrapi

注意事项，Flickr API调用过程中，必须全部使用utf-8编码。

1.订阅Feed

如果一个Feed支持PubSubHubbub协议，那么在feed中将会告诉你，托管这个feed的hub的地址。比如，在http://www.google.com/reader/shared/areyoulookon的feed中，有<link rel="hub" href="http://pubsubhubbub.appspot.com/"/>，这就表示，这个feed由pubsubhubbub.appspot.com这个hub进行托管，也就是说，你需要向pubsubhubbub.appspot.com请求获得这个feed的实时更新情况。

下面详细讲讲如何订阅（还是以那个greader share的feed做例子）：

1.发送订阅请求

pubsubhubbub.appspot.com是pubsubhubbub始作俑者，两位Google工程师之一的某人完成，由于他是Google App Engine团队的，所以利用GAE开发了一个hub，为大家也为Google提供了方便。订阅更新的地址是：

http://pubsubhubbub.appspot.com/subscribe

那么，要订阅上面那个feed，需要向这个地址Post哪些参数呢？主要是下面四个参数（以及应该填的值）：

– hub.mode = subscribe|unsubscribe （是订阅还是取消订阅）

– hub.verify = sync

– hub.callback = http://domain.tld/your/callback （callback就是说，你用来接收这个hub传来的信息的网址，这个很重要，就是你处理更新的应用的地址）

– hub.topic = http://www.google.com/reader/public/atom/user/16797483721654978846/state/com.google/broadcast（这个就是我们要订阅的feed源，取名为topic，大家要适应）

好了，下面不管使用何种程序语言，你只要向http://pubsubhubbub.appspot.com/subscribe 发送含有上面四个参数和值的Post请求，就完成了订阅Feed的70%的工作了。你也可以到http://pubsubhubbub.appspot.com/subscribe 去试玩一下，无需编程。

2.验证你的订阅

pubsubhubbub协议规定，并不是所有发往hub的订阅请求都能通过，当你订阅了一个topic后，hub服务器会给你的callback网址发来一个HTTP GET请求，获得正确的响应后，才能订阅成功。（这是为了防止你用错误的callback地址，让hub服务器进行DDoS攻击）。

当我们按照1里面的步骤，发送了订阅请求（HTTP POST）后，hub服务器会给callback网站发来一个HTTP GET请求，参数如下：

– hub.mode = subscribe|unsubscribe
– hub.topic = http://www.google.com/reader/public/atom/user/16797483721654978846/state/com.google/broadcast
– hub.challenge = a-random-string （这个很重要，就是验证的字符串，你的callback网址需要记录它）

如果你的callback网址接到这个请求后，能返回输出hub.challenge的值的话，并且是一个成功的响应（status code是200），那么订阅就成功了！

2.处理更新内容

订阅成功以后，如果订阅源发生了更新，按照我们上次PubSubHubbub工作原理及使用入门介绍的，hub服务器将会获得通知，然后立刻发送HTTP POST请求到我们订阅的callback网址，请求的内容是xml格式的（基本类似于标准的atom格式），里面包含了更新的内容，下面就是你使用各种方式，处理这段xml字符串，为你所用了。

3.有用的链接和代码

那篇让我看懂如何使用PubSubHubbub的文章：Getting Started with PubSubHubbub

订阅Feed的WEB接口：http://pubsubhubbub.appspot.com/subscribe

PubSubHubbub主页：http://pubsubhubbub.googlecode.com/

如何更好地开发PubSubHubub：http://code.google.com/p/pubsubhubbub/wiki/BestPractices

Google App Engine的示例代码：http://code.google.com/p/pubsubhubbub/source/browse/#svn/trunk/subscriber （重要！这个基本是1/3的reader2twitter代码了）

之前有一段时间，Google App Engine使用Twitter API的过程中，遇到Twitter拒绝来自App Engine的请求的尴尬情况，所以基于App Engine的Twitter应用很少有。但是，Twitter最终还是解决了问题，于是Twitter应用便开始繁荣起来。

1.Twitgether

这是一个很好的服务，由@c9开发，主要功能是，GMail中的Twitter Gadget。GMail Labs提供添加gadget的功能，加上Twitgether的不错的界面，使得GMail里面看推，发推都比较方便了。强烈推荐GMail爱好者使用。

2.Reader2Twitter

这是由我开发的一个Twitter应用，主要功能是，实时同步你的Google Reader分享到Twitter，支持Basic和OAuth两种认证方式，并且可以自定义同步方式和同步格式。推荐Google Reader爱好者使用。

3.sms4twitter

飞信用户有好东西用了，这是由@rockcody开发的GAE应用，主要功能是利用飞信来更新你的Twitter，以后将会有更多功能。

4.twitter2renren

这是一款同步Twitter到人人网的App Engine程序，如果你是校内网的忠实用户，那么可以尝试一下这个服务。

5.推特中文圈

强力推荐！国人制作的饭否界面Twitter网页程序，实现了基本所有Twitter的必须功能，并对Twitter中文用户进行了分类，如果你没有好的使用Twitter的方法的话，请使用推特中文圈。

6.Twitalker

如果你是Gtalk重度用户，那么这款服务很适合你。Twitalker是一款Twitter第三方应用，提供推特Gtalk机器人服务，通过添加TwiTalker在Gtalk上的帐号您可以方便地在Gtalk上更新自己的推特和接收好友消息。也是基于Google App Engine的。

非常好的地方：

1.自动显示图片和视频

跟FriendFeed一样，可以看图片，也可以预览Youtube视频

2.添加组

可以添加小组，而且在小组中添加成员很简单，输入用户名的开头字母，会出现一堆提示用户

3.你可以mute一个用户，而不是follow，只是看不到他的更新

4.贴心的dm

收到私信后，将会在右上方出现对话框，可以进行回复。

5.自动不用fan qiang

最后，目前需要邀请码，先到先得，留下你的email，低调传播@@

也可以在twitter上回复我你的邮箱，我的twitter:lookon

注：你可以尝试这个邀请码：daringbaking

如果这个邀请码无法使用的话，目前已经本博客已经没有邀请码了，不好意思:)

1.支持OAuth认证

如果你能翻墙的话，那么就使用这种方式认证吧，因为这样可以在下次登录后，获得你的reader2twitter配置信息。而且更安全，也能在twitter中显示来源。

2.支持自定义发推

你可以使用三个参数进行自定义你的同步到Twitter的推，{title}，{url} 和 {comment}。分别指的是标题，链接和你的评论。比如你可以使用下面的格式进行自定义：

【GR分享】{title} {url}

{title} {url} || {comment}

3.支持三种同步方式

目前支持了三种不同的同步方式

a.同步所有的共享

b.只同步有评论的共享

c.只同步Note（将不会显示链接）

c的这个同步方式就意味着，你可以在Google Reader里面发推，这是多么high的一件事，无需任何插件！