20.4 建造你自己的 Hello world 应用

现在让我们建造一个像 20.3 节中的 demo 一样的应用，但这次我们会探索得更深一些。

20.4.1 映像结构 (map-structure)：创造一个简单的 http-handler

创建一个目录，并给它起一个你的应用程序特有的名字，如：helloapp。这个应用程序的所有文件都在这个目录中。在这个目录中再创建一个名为 hello 的目录。这将包含我们的 hello 包的 Go 源代码文件。然后在 hello 目录下，创建一个名为 helloworld2.go 的文件，并赋予其以下内容（事实上与上文中的 demo 应用几乎相同）：

Listing 20.2 helloworld2_version1.go:

package hello
import (
    "fmt"
    "net/http"
)
func init() {
    http.HandleFunc("/", handler)
}
func handler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprint(w, "Hello, world!")
}

注意包的名称：在编写独立的 Go 程序时，我们会把这段代码放在 package main 中，但 Go GAE Runtime 提供了 main 包和 HTTP Listener，所以你应该把你的代码放在你选择的包中，此时指的是 hello 包。其次，由于 Go App Engine 应用程序通过 Web 服务器与外部世界进行通信，所以编写这些应用程序非常像编写独立的 Go Web 应用程序（见第 15 章）。所以我们导入 http 包，并为我们的应用程序中使用的不同url 模式定义处理函数。我们没有 main() 函数，所以处理程序的设置必须移到 init() 函数中去。另外，网络服务器本身的启动是由 GAE 为我们完成的。我们的 Go 包 hello 对任何请求的响应是发送一个包含 “Hello, world!”的消息。

20.4.2 创建配置文件 app.yaml

所有的 GAE 应用程序都需要一个 yaml 配置文件 app.yaml，它包含了 GAE 的应用程序元数据（yaml 是一种文本文件格式，经常用于开源项目，更多信息见 www.yaml.org）。另外，这个文件告诉 App Engine 服务要使用哪个运行时，哪些 URL 应该由我们的 Go 程序处理。你可以从演示程序中复制一个 app.yaml 文件，把它放在映像 helloapp 里面，并删除 favicon.ico 的 handler。

应用程序的映像/文件结构应该如下：

helloapp\     // map of the GAE application
app.yaml     // configuration file
hello\         // map containing the source files
helloworld2.go

只有app.yaml是必须的名字，映像、Go文件和包的名字可以有不同的选择，但按照惯例，它们的名字是一样的或类似的，根映像的后缀是 app。 app.yaml 由 AppEngine 读取和解释，AppEngine 以下时间段内托管和执行你的程序：

• 当您将您的应用程序上传到 AppEngine 以使其被托管。
• 当它被执行时。
• 当用户访问它时。

它可以包含注释，前面有一个 #，并包含以下语句：

application: helloworld
version: 1
runtime: go
api_version: 3
# routing-table: routing of different urls to different types of handlers
handlers:
- url: /.*
  script: _go_app

app.yaml 中的 application: value helloworld 是您的应用程序标识符。这个值在开发过程中可以是任何东西；以后在向 App Engine 注册您的应用程序时，您将选择一个唯一的标识符（在所有 GAE 应用程序中唯一）并更新这个值。

version 表示您的应用程序正在运行的版本：事实上，GAE 可以并行地运行您的应用程序的几个版本，但其中一个必须被指定为默认版本。它可以包含字母数字字符，以及连字符。因此，你可以运行一个测试版本，如T2-31 和一个生产版本 P2-1。

runtime 是编写应用程序的语言（其他允许的值是 Java 和 Python）。如果你在上传应用软件的新版本之前调整它，App Engine 将保留以前的版本，并让你使用管理控制台回退到以前的版本。

api_version 是本 SDK 中使用的 Go API 的版本；它们可能与以前的版本不兼容。你可以在以前的 api_version SDK 中构建你的应用程序的早期版本；如果 GAE 仍然允许，它们可以继续运行，但通常有一个时间限制，而你应该将你的应用程序更新到新的api版本：bin map中的gofix工具可能能够完成大部分所需的更新。

handler 部分是循环表 (routing table)：它告诉 GAE 如何将发送到服务器上的请求映射到代码中。对于每一个传入的请求 url 模式（本地开发时在 http://localhost:8080/ 之后的部分，在云端运行时在 http://appname.appspot.com/ 之后的部分）与 url 后面的正则表达式相匹配。

对于第一个匹配的 url 模式，相应的脚本会被执行。在我们的例子中，每一个路径与正则表达式 /.* 相匹配的 URL 请求（即：所有 URL）都应该由 Go 程序处理。_go_app 值是 dev_appserver.py 识别的一个神奇字符串；生产的 App Engine 服务器会忽略它。

如果你看一下演示的 helloworld 应用程序的 app.yaml 文件，你会发现它在处理程序中包含一个初始部分：

handlers:
- url: /favicon\.ico
  static_files: favicon.ico
  upload: favicon\.ico
- url: /.*
  script: _go_app

一些文件 (static_files) ，如图片，不会改变（在这个例子中是图片favicon.ico）。这些文件可以放在不同的 AppEngine 服务器上的一种共同缓存中，使它们能够更快地提供给用户。如果您的应用程序有许多这样的文件，把它们放在一个单独的目录中，按惯例命名为 static。

upload 表示当您部署应用程序时，什么必须上传到云端；例如，如果它包含 images/(*.ico|*.gif|*.jpg)，它将把本地 images 目录内所有这些类型的文件上传到 AppEngine 服务器。

正如我们将看到的，大多数 GAE 应用程序也使用模板文件，这些文件可以存储在根应用程序地图中，或在一个特殊的目录 tmpl 中。

因此，一个 GAE 应用程序的一般结构可能是：

yourapp\         // map of the GAE application
        app.yaml // configuration file
        yourpackage\ // map containing the source files
            package1.go
            …
        tmpl\ // map containing template files
            root.html
            update.html
            …
        static\ // map containing static files
            yourapp.ico
            …

与 demo 一样，在控制台窗口中进入包含 helloapp 的映像，并发出如下命令：dev_appserver.py helloapp

或者你可以通过任何一个映像的 console 窗口并且唤醒：

dev_appserver.py /path_to_map_helloapp/helloapp

在这两种情况下，网络服务器现在都在运行，并监听 8080 端口的请求。通过在你的网络浏览器中访问以下 URL 来测试该应用程序：http://localhost:8080/

你应该看到： Hello, world!

在服务器控制台，出现以下文字：

$ dev_appserver.py helloapp
INFO 2011-10-31 08:54:29,021 appengine_rpc.py:159] Server: appengine.google.com
INFO 2011-10-31 08:54:29,025 appcfg.py:463] Checking for updates to the SDK.
INFO 2011-10-31 08:54:29,316 appcfg.py:481] The SDK is up to date.
WARNING 2011-10-31 08:54:29,316 datastore_file_stub.py:512] Could not read datastore
data from /tmp/dev_appserver.datastore
INFO 2011-10-31 08:54:29,317 rdbms_sqlite.py:58] Connecting to SQLite database ‘’
with file ‘/tmp/dev_appserver.rdbms’
INFO 2011-10-31 08:54:29,638 dev_appserver_multiprocess.py:637] Running application
helloworld on port 8080: http://localhost:8080
        <-(A)
INFO 2011-10-31 08:56:13,148 __init__.py:365] building _go_app
        <-(B)
INFO 2011-10-31 08:56:15,073 __init__.py:351] running _go_app
INFO 2011-10-31 08:56:15,188 dev_appserver.py:4143] “GET / HTTP/1.1” 200 -
        <-(C)

在 (A) 处服务器准备好了，在 (B) 处服务器编译并运行 Go 程序，在 (C) 处我们的应用程序的请求进来了，此时 HTML 输出页面被提供到服务器上。

当服务器被终止或尚未启动，而客户端请求网址 http://localhost:8080/，浏览器在FireFox 中会打印出这样的信息：

Unable to connect Firefox can’t establish a connection to the server at localhost:8080.

20.4.3 迭代开发

开发应用的服务器会观察你的文件中的变化，当你更新你的源代码时（编辑+保存），它重新编译它们并重新启动你的本地应用；不需要重新启动 dev_appserver.py

现在试试：让 Web 服务器运行，然后编辑 helloworld2.go，将 “Hello, world!” 改为其他内容。重新加载 http://localhost:8080/，就可以看到变化了：这和编写 Rails 或 Django 应用程序一样，都是动态运行的。

要关闭 Web 服务器，确保终端窗口处于活动状态，然后按 Ctrl+C（或适当的用于控制台的 “break “键）：

INFO 2011-10-31 08:56:21,420 dev_appserver.py:4143] “GET / HTTP/1.1” 200 -
INFO 2011-10-31 08:57:59,836 __init__.py:365] building _go_app <-(D)
INFO 2011-10-31 08:58:00,365 __init__.py:351] running _go_app
INFO 2011-10-31 08:58:00,480 dev_appserver.py:4143] “GET / HTTP/1.1” 200 -
^CINFO 2011-10-31 08:58:32,769 dev_appserver_main.py:665] Server interrupted by user,
terminating <-(E)

这可以从上面第一个列表之后的服务器控制台输出中看到：在 (D) 处，apperver 看到 Go 的源代码被改变了，并重新编译；在 (E) 处，服务器被终止了。

20.4.4. 与 GoClipse IDE 的集成

a) 窗口/首选项/Go：

将所有内容指向 GAE 的 Go 根目录

b) 运行/外部工具/外部工具配置/选择程序：

​ 制作新的配置：点击 New 按钮。 ​ 名称：GAE ​ 位置：/home/user/google_appengine/dev_appserver.py ​ 工作目录：/home/user/workspace/bedilly/src/pkg/helloapp ​ 参数： home/user/workspace/bedilly/src/pkg/helloapp ​ 应用/运行

通过配置一个外部工具，部署你的应用程序也很容易：http://code.google.com/p/goclipse/wiki/DeployingToGoogleAppEngineFromEclipse

链接

• 目录
• 上一节：安装 Go App Engine SDK
• 下一节：使用用户服务和探索其 API