diff --git a/README.md b/README.md index 9daaf80..c5e60e5 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@ ## 翻译进度 -9.9 [通过 git 打包和安装](eBook/09.9.md) +9.10 [Go 的外部包和项目](eBook/09.10.md) ## 支持本书 diff --git a/eBook/09.10.md b/eBook/09.10.md index bba36ce..b355c9b 100644 Binary files a/eBook/09.10.md and b/eBook/09.10.md differ diff --git a/eBook/09.11.md b/eBook/09.11.md index b954d48..c8bdd43 100644 --- a/eBook/09.11.md +++ b/eBook/09.11.md @@ -1,4 +1,6 @@ -#9.11 在Go程序中使用外部库 +# 9.11 在 Go 程序中使用外部库 + +219 (本节我们将创建一个web应用和它的Google App Engine版本,在第19和21章分别说明,当你阅读到这些章节时可以再回到这个例子。) 当开始一个新项目或增加新的功能到现有的项目,你可以通过在应用程序中使用已经存在的库来节省开发时间。为了做到这一点,你必须理解库的API(应用编程接口),那就是:库中有哪些方法可以调用,如何调用。你可能没有这个库的源代码,但作者肯定有记载的API以及详细介绍了如何使用它。 @@ -13,7 +15,7 @@ 将通过go install实现。但是首先要验证环境变量中是否含有GOPATH变量,因为外部源码将被下载到$GOPATH/src目录下并被安装到$GOPATH/PKG/"machine_arch"/目录下。 我们将通过在终端调用以下命令来安装API: - + go install google-api-go-client.google.com/hg/urlshortener/v1 go install将下载源码,编译并安装包 @@ -26,25 +28,25 @@ go install将下载源码,编译并安装包 现在我们写一个web应用(参见第十五章4-8节)通过表单实现短地址和长地址的相互转换。我们将使用template包并写三个处理函数:root函数通过执行表单模板来展示表单。short函数将长地址转换为短地址,long函数逆向转换。 要调用urlshortener接口必须先通过http包中的默认客户端创建一个服务实例urlshortenerSvc: - + urlshortenerSvc, _ := urlshortener.New(http.DefaultClient) 我们通过调用服务中的Url.Insert中的Do方法传入包含长地址的Url数据结构从而获取短地址: - + url, _ := urlshortenerSvc.Url.Insert(&urlshortener.Url{LongUrl: longUrl}).Do() - + 返回url的Id便是我们需要的短地址。 我们通过调用服务中的Url.Get中的Do方法传入包含短地址的Url数据结构从而获取长地址: - + url, error := urlshortenerSvc.Url.Get(shwortUrl).Do() - + 返回的长地址便是转换前的原始地址。 实例 9.9 [urlshortener.go](examples/chapter_9/urlshortener.go) - package main import ( “fmt” “net/http” “text/template” rlshortener “google-api-go-client.googlecode.com/hg/urlshortener/v1” ) func main() { http.HandleFunc(“/”, root) http.HandleFunc(“/short”, short) http.HandleFunc(“/long”, long) http.ListenAndServe(“localhost:8080”, nil) } // the template used to show the forms and the results web page to the user var rootHtmlTmpl = template.Must(template.New(“rootHtml”).Parse(`

URL SHORTENER

{{if .}}{{.}}

{{end}}
Shorten this:

Expand this: http://goo.gl/
`)) func root(w http.ResponseWriter, r *http.Request) { rootHtmlTmpl.Execute(w, nil) } func short(w http.ResponseWriter, r *http.Request) { longUrl := r.FormValue(“longUrl”) urlshortenerSvc, _ := urlshortener.New(http.DefaultClient) url, _ := urlshortenerSvc.Url.Insert(&urlshortener.Url{LongUrl: longUrl,}).Do() rootHtmlTmpl.Execute(w, fmt.Sprintf(“Shortened version of %s is : %s”, longUrl, url.Id)) } - func long(w http.ResponseWriter, r *http.Request) { shortUrl := “http://goo.gl/” + r.FormValue(“shortUrl”) urlshortenerSvc, _ := urlshortener.New(http.DefaultClient) url, err := urlshortenerSvc.Url.Get(shortUrl).Do() if err != nil { fmt.Println(“error: %v”, err) return } rootHtmlTmpl.Execute(w, fmt.Sprintf(“Longer version of %s is : %s”, shortUrl, url.LongUrl)) } 编译这段代码: 6g -I $GOPATH/pkg/linux_amd64 urlshortener.go + package main import ( “fmt” “net/http” “text/template” rlshortener “google-api-go-client.googlecode.com/hg/urlshortener/v1” ) func main() { http.HandleFunc(“/”, root) http.HandleFunc(“/short”, short) http.HandleFunc(“/long”, long) http.ListenAndServe(“localhost:8080”, nil) } // the template used to show the forms and the results web page to the user var rootHtmlTmpl = template.Must(template.New(“rootHtml”).Parse(`

URL SHORTENER

{{if .}}{{.}}

{{end}}
Shorten this:

Expand this: http://goo.gl/
`)) func root(w http.ResponseWriter, r *http.Request) { rootHtmlTmpl.Execute(w, nil) } func short(w http.ResponseWriter, r *http.Request) { longUrl := r.FormValue(“longUrl”) urlshortenerSvc, _ := urlshortener.New(http.DefaultClient) url, _ := urlshortenerSvc.Url.Insert(&urlshortener.Url{LongUrl: longUrl,}).Do() rootHtmlTmpl.Execute(w, fmt.Sprintf(“Shortened version of %s is : %s”, longUrl, url.Id)) } + func long(w http.ResponseWriter, r *http.Request) { shortUrl := “http://goo.gl/” + r.FormValue(“shortUrl”) urlshortenerSvc, _ := urlshortener.New(http.DefaultClient) url, err := urlshortenerSvc.Url.Get(shortUrl).Do() if err != nil { fmt.Println(“error: %v”, err) return } rootHtmlTmpl.Execute(w, fmt.Sprintf(“Longer version of %s is : %s”, shortUrl, url.LongUrl)) } 编译这段代码: 6g -I $GOPATH/pkg/linux_amd64 urlshortener.go 链接这段代码: 6l -L $GOPATH/pkg/linux_amd64 urlshortener.6 执行这段代码:./6.out (确认是否有其他的应用运行在http://localhost:8080,如果有这步将失败)通过浏览http://localhost:8080/的页面来测试。 @@ -59,4 +61,4 @@ go install将下载源码,编译并安装包 application: urlshort version: 0-1-test runtime: go api_version: 3 handlers: - url: /.* script: _go_app 现在你可以去到你的项目目录并在终端运行:dev_appserver.py urlshort -在浏览器打开你的web应用:http://localhost:8080 \ No newline at end of file +在浏览器打开你的web应用:http://localhost:8080 diff --git a/eBook/directory.md b/eBook/directory.md index 27ec3e9..3750f52 100644 --- a/eBook/directory.md +++ b/eBook/directory.md @@ -83,6 +83,7 @@ - 9.8 [自定义包的目录结构、go install 和 go test](09.8.md) - 9.9 [通过 git 打包和安装](09.9.md) - 9.10 [Go 的外部包和项目](09.10.md) + - 9.11 [在 Go 程序中使用外部库](09.11.md) - 第10章:结构(struct)与方法(method) - 第11章:接口(interface)与反射(reflection)