當開始一個新項目或增加新的功能到現(xiàn)有的項目，你可以通過在應用程序中使用已經(jīng)存在的庫來節(jié)省開發(fā)時間。為了做到這一點，你必須理解庫的 API（應用編程接口），那就是：庫中有哪些方法可以調用，如何調用。你可能沒有這個庫的源代碼，但作者肯定有記載的 API 以及詳細介紹了如何使用它。

作為一個例子，我們將使用谷歌的 API 的 urlshortener 編寫一個小程序：你可以嘗試一下在 http://goo.gl/ 輸入一個像 "http://www.destandaard.be" 這樣的URL，你會看到一個像 "http://goo.gl/O9SUO" 這樣更短的 URL 返回，也就是說，在 Twitter 之類的服務中這是非常容易嵌入的。谷歌 urlshortener 服務的文檔可以在 "http://code.google.com/apis/urlshortener/" 找到。(第 19 章，我們將開發(fā)自己版本的 urlshortener)。

谷歌將這項技術提供給其他開發(fā)者，作為 API 我們可以在我們自己的應用程序中調用（釋放到指定的限制）。他們也生成了一個 Go 語言客戶端庫使其變得更容易。

備注：谷歌讓通過使用 Google API Go 客戶端服務的開發(fā)者生活變得更簡單，Go 客戶端程序自動生成于 Google 庫的 JSON 描述。更多詳情在項目頁面查看。

下載并安裝 Go 客戶端庫: 將通過 go install 實現(xiàn)。但是首先要驗證環(huán)境變量中是否含有 GOPATH 變量，因為外部源碼將被下載到 $GOPATH/src 目錄下并被安裝到 $GOPATH/PKG/"machine_arch"/ 目錄下。

我們將通過在終端調用以下命令來安裝 API:

go install google.golang.org/api/urlshortener/v1

go install 將下載源碼，編譯并安裝包

使用 urlshortener 服務的 web 程序: 現(xiàn)在我們可以通過導入并賦予別名來使用已安裝的包：

import  "google.golang.org/api/urlshortener/v1"

現(xiàn)在我們寫一個 Web 應用(參見第 15 章 4-8 節(jié))通過表單實現(xiàn)短地址和長地址的相互轉換。我們將使用 template 包并寫三個處理函數(shù)：root 函數(shù)通過執(zhí)行表單模板來展示表單。short 函數(shù)將長地址轉換為短地址，long 函數(shù)逆向轉換。

要調用 urlshortener 接口必須先通過 http 包中的默認客戶端創(chuàng)建一個服務實例 urlshortenerSvc：

urlshortenerSvc, _ := urlshortener.New(http.DefaultClient)

我們通過調用服務中的 Url.Insert 中的 Do 方法傳入包含長地址的 Url 數(shù)據(jù)結構從而獲取短地址：

url, _ := urlshortenerSvc.Url.Insert(&urlshortener.Url{LongUrl: longUrl}).Do()

返回 url 的 Id 便是我們需要的短地址。

我們通過調用服務中的 Url.Get 中的 Do 方法傳入包含短地址的Url數(shù)據(jù)結構從而獲取長地址：

url, error := urlshortenerSvc.Url.Get(shwortUrl).Do()

返回的長地址便是轉換前的原始地址。

示例 9.9 urlshortener.go

package main

import (
     "fmt"
     "net/http"
     "text/template"

     "google.golang.org/api/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(`
<html><body>
<h1>URL SHORTENER</h1>
{{if .}}{{.}}<br /><br />{{end}}
<form action="/short" type="POST">
Shorten this: <input type="text" name="longUrl" />
<input type="submit" value="Give me the short URL" />
</form>
<br />
<form action="/long" type="POST">
Expand this: http://goo.gl/<input type="text" name="shortUrl" />
<input type="submit" value="Give me the long URL" />
</form>
</body></html>
`))
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))
}

執(zhí)行這段代碼：

go run urlshortener.go

通過瀏覽 http://localhost:8080/ 的頁面來測試。

為了代碼的簡潔我們并沒有檢測返回的錯誤狀態(tài)，但是在真實的生產(chǎn)環(huán)境的應用中一定要做檢測。

將應用放入 Google App Engine，我們只需要在之前的代碼中作出如下改變：

package main -> package urlshort
func main() -> func init()

創(chuàng)建一個和包同名的目錄 urlshort，并將以下兩個安裝目錄復制到這個目錄：

google.golang.org/api/urlshortener
google.golang.org/api/googleapi

此外還要配置下配置文件 app.yaml，內容如下：

application: urlshort
version: 0-1-test
runtime: go
api_version: 3
handlers:
- url: /.*
script: _go_app

現(xiàn)在你可以去到你的項目目錄并在終端運行：dev_appserver.py urlshort

在瀏覽器打開你的 Web應用：http://localhost:8080。

鏈接

上一篇：12.8 使用接口的實際例子：fmt.Fprintf下一篇：4.1 文件名、關鍵字與標識符

在线观看不卡亚洲电影_亚洲妓女99综合网_91青青青亚洲娱乐在线观看_日韩无码高清综合久久

9.11 在 Go 程序中使用外部庫

鏈接