mirror of
https://github.com/gopl-zh/gopl-zh.github.com.git
synced 2025-12-20 12:44:20 +08:00
rebuild
This commit is contained in:
chai2010
@@ -48,7 +48,7 @@
|
||||
<body>
|
||||
|
||||
|
||||
<div class="book" data-level="1.7" data-chapter-title="Web服務" data-filepath="ch1/ch1-07.md" data-basepath=".." data-revision="Mon Dec 21 2015 12:51:02 GMT+0800 (中国标准时间)">
|
||||
<div class="book" data-level="1.7" data-chapter-title="Web服務" data-filepath="ch1/ch1-07.md" data-basepath=".." data-revision="Thu Dec 24 2015 14:42:02 GMT+0800 (中国标准时间)">
|
||||
|
||||
|
||||
<div class="book-summary">
|
||||
@@ -1975,16 +1975,16 @@
|
||||
|
||||
</li>
|
||||
|
||||
<li class="chapter " data-level="14" data-path="errata.html">
|
||||
<li class="chapter " data-level="14" data-path="CONTRIBUTORS.html">
|
||||
|
||||
|
||||
<a href="../errata.html">
|
||||
<a href="../CONTRIBUTORS.html">
|
||||
|
||||
<i class="fa fa-check"></i>
|
||||
|
||||
<b>14.</b>
|
||||
|
||||
勘誤
|
||||
附録
|
||||
</a>
|
||||
|
||||
|
||||
@@ -2024,7 +2024,7 @@
|
||||
<section class="normal" id="section-">
|
||||
|
||||
<h2 id="17-web服務">1.7. Web服務</h2>
|
||||
<p>Go的內置庫讓我們寫一個像fetch這樣例子的web服務器變得異常地簡單。在本節中，我們會展示一個微型服務器，這個服務的功能是返迴當前用戶正在訪問的URL。也就是説比如用戶訪問的是<a href="http://localhost:8000/hello，那麽響應是URL.Path" target="_blank">http://localhost:8000/hello，那麽響應是URL.Path</a> = "hello"。</p>
|
||||
<p>Go語言的內置庫讓我們寫一個像fetch這樣例子的web服務器變得異常地簡單。在本節中，我們會展示一個微型服務器，這個服務的功能是返迴當前用戶正在訪問的URL。也就是説比如用戶訪問的是 <a href="http://localhost:8000/hello" target="_blank">http://localhost:8000/hello</a> ，那麽響應是URL.Path = "hello"。</p>
|
||||
<pre><code class="lang-go">gopl.io/ch1/server1
|
||||
<span class="hljs-comment">// Server1 is a minimal "echo" server.</span>
|
||||
<span class="hljs-keyword">package</span> main
|
||||
@@ -2042,10 +2042,10 @@
|
||||
|
||||
<span class="hljs-comment">// handler echoes the Path component of the request URL r.</span>
|
||||
<span class="hljs-keyword">func</span> handler(w http.ResponseWriter, r *http.Request) {
|
||||
fmt.Fprintf(w, <span class="hljs-string">"URL.Path = %q\n"</span>, r.URL.Path)
|
||||
fmt.Fprintf(w, <span class="hljs-string">"URL.Path = %q\n"</span>, r.URL.Path)
|
||||
}
|
||||
</code></pre>
|
||||
<p>我們隻用了八九行就實現了這個程序，這都是多虧了標準庫里的方法已經幫我們處理了大多數的工作。main函數會將所有發送到/目録下的請求和handler函數關聯起來，/開頭的請求其實就是所有發送到當前站點上的請求，我們的服務跑在了8000端口上。發送到這個服務的“請求”是一個http.Request類型的對象，這個對象中包含了請求中的一繫列相關字段，其中就包括我們需要的URL。當請求到達服務器時，這個請求會被傳給handler函數來處理，這個函數會將/hello這個路徑從請求的URL中解析齣來，然後把其發送到響應中，這里我們用的是標準輸齣流的fmt.Fprintf。Web服務會在第7.7節中詳細闡述。</p>
|
||||
<p>我們隻用了八九行代碼就實現了一個個Web服務程序，這都是多虧了標準庫里的方法已經幫我們處理了大量的工作。main函數會將所有發送到/路徑下的請求和handler函數關聯起來，/開頭的請求其實就是所有發送到當前站點上的請求，我們的服務跑在了8000端口上。發送到這個服務的“請求”是一個http.Request類型的對象，這個對象中包含了請求中的一繫列相關字段，其中就包括我們需要的URL。當請求到達服務器時，這個請求會被傳給handler函數來處理，這個函數會將/hello這個路徑從請求的URL中解析齣來，然後把其發送到響應中，這里我們用的是標準輸齣流的fmt.Fprintf。Web服務會在第7.7節中詳細闡述。</p>
|
||||
<p>讓我們在後颱運行這個服務程序。如果你的操作繫統是Mac OS X或者Linux，那麽在運行命令的末尾加上一個&符號，卽可讓程序簡單地跑在後颱，而在windows下，你需要在另外一個命令行窗口去運行這個程序了。</p>
|
||||
<pre><code>$ go run src/gopl.io/ch1/server1/main.go &
|
||||
</code></pre><p>現在我們可以通過命令行來發送客戶端請求了：</p>
|
||||
@@ -2054,8 +2054,8 @@ $ ./fetch http://localhost:8000
|
||||
URL.Path = "/"
|
||||
$ ./fetch http://localhost:8000/help
|
||||
URL.Path = "/help"
|
||||
</code></pre><p>另外我們還可以直接在瀏覽器里訪問這個URL，然後得到返迴結果，如圖1.2：
|
||||
<img src="../images/ch1-02.png" alt=""></p>
|
||||
</code></pre><p>另外我們還可以直接在瀏覽器里訪問這個URL，然後得到返迴結果，如圖1.2：</p>
|
||||
<p><img src="../images/ch1-02.png" alt=""></p>
|
||||
<p>在這個服務的基礎上疊加特性是很容易的。一種比較實用的脩改是爲訪問的url添加某種狀態。比如，下面這個版本輸齣了同樣的內容，但是會對請求的次數進行計算；對URL的請求結果會包含各種URL被訪問的總次數，直接對/count這個URL的訪問要除外。</p>
|
||||
<pre><code class="lang-go">gopl.io/ch1/server2
|
||||
<span class="hljs-comment">// Server2 is a minimal "echo" and counter server.</span>
|
||||
@@ -2092,8 +2092,8 @@ URL.Path = "/help"
|
||||
mu.Unlock()
|
||||
}
|
||||
</code></pre>
|
||||
<p>這個服務器有兩個請求處理函數，請求的url會決定具體調用哪一個：對/count這個url的請求會調用到count這個函數，其它所有的url都會調用默認的處理函數。如果你的請求pattern是以/結尾，那麽所有以該url爲前綴的url都會被這條規則匹配。在這些代碼的背後，服務器每一次接收請求處理時都會另起一個goroutine，這樣服務器就可以同一時間處理多數請求。然而在併發情況下，假如眞的有兩個請求同一時刻去更新count，那麽這個值可能併不會被正確地增加；這個程序可能會被引發一個嚴重的bug：競態條件(參見9.1)。爲了避免這個問題，我們必鬚保證每次脩改變量的最多隻能有一個goroutine，這也就是代碼里的mu.Lock()和mu.Unlock()調用將脩改count的所有行爲包在中間的目的。第九章中我們會進一步講解共享變量。</p>
|
||||
<p>下面是一個更爲豐富的例子，handler函數會把請求的http頭和請求的form數據都打印齣來，這樣可以讓檢査和調試這個服務更爲方便</p>
|
||||
<p>這個服務器有兩個請求處理函數，請求的url會決定具體調用哪一個：對/count這個url的請求會調用到count這個函數，其它所有的url都會調用默認的處理函數。如果你的請求pattern是以/結尾，那麽所有以該url爲前綴的url都會被這條規則匹配。在這些代碼的背後，服務器每一次接收請求處理時都會另起一個goroutine，這樣服務器就可以同一時間處理多數請求。然而在併發情況下，假如眞的有兩個請求同一時刻去更新count，那麽這個值可能併不會被正確地增加；這個程序可能會被引發一個嚴重的bug：競態條件（參見9.1）。爲了避免這個問題，我們必鬚保證每次脩改變量的最多隻能有一個goroutine，這也就是代碼里的mu.Lock()和mu.Unlock()調用將脩改count的所有行爲包在中間的目的。第九章中我們會進一步講解共享變量。</p>
|
||||
<p>下面是一個更爲豐富的例子，handler函數會把請求的http頭和請求的form數據都打印齣來，這樣可以讓檢査和調試這個服務更爲方便：</p>
|
||||
<pre><code class="lang-go">gopl.io/ch1/server3
|
||||
<span class="hljs-comment">// handler echoes the HTTP request.</span>
|
||||
<span class="hljs-keyword">func</span> handler(w http.ResponseWriter, r *http.Request) {
|
||||
@@ -2107,7 +2107,7 @@ URL.Path = "/help"
|
||||
log.Print(err)
|
||||
}
|
||||
<span class="hljs-keyword">for</span> k, v := <span class="hljs-keyword">range</span> r.Form {
|
||||
fmt.Fprintf(w, <span class="hljs-string">"Form[%q] = %q\n"</span>, k, v)
|
||||
fmt.Fprintf(w, <span class="hljs-string">"Form[%q] = %q\n"</span>, k, v)
|
||||
}
|
||||
}
|
||||
</code></pre>
|
||||
@@ -2118,7 +2118,7 @@ Header["Connection"] = ["keep-alive"]
|
||||
Header["Accept"] = ["text/html,application/xhtml+xml,application/xml;..."] Header["User-Agent"] = ["Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_5)..."] Host = "localhost:8000"
|
||||
RemoteAddr = "127.0.0.1:59911"
|
||||
Form["q"] = ["query"]
|
||||
</code></pre><p>可以看到這里的ParseForm被嵌套在了if語句中。Go語言允許這樣的一個簡單的語句結果作爲循環的變量聲明齣現在if語句的最前面，這一點對錯誤處理很有用處。我們還可以像下面這樣寫(當然看起來就長了一些)：</p>
|
||||
</code></pre><p>可以看到這里的ParseForm被嵌套在了if語句中。Go語言允許這樣的一個簡單的語句結果作爲循環的變量聲明齣現在if語句的最前面，這一點對錯誤處理很有用處。我們還可以像下面這樣寫（當然看起來就長了一些）：</p>
|
||||
<pre><code class="lang-go">err := r.ParseForm()
|
||||
<span class="hljs-keyword">if</span> err != <span class="hljs-constant">nil</span> {
|
||||
log.Print(err)
|
||||
@@ -2127,19 +2127,21 @@ Form["q"] = ["query"]
|
||||
<p>用if和ParseForm結合可以讓代碼更加簡單，併且可以限製err這個變量的作用域，這麽做是很不錯的。我們會在2.7節中講解作用域。</p>
|
||||
<p>在這些程序中，我們看到了很多不同的類型被輸齣到標準輸齣流中。比如前面的fetch程序，就把HTTP的響應數據拷貝到了os.Stdout，或者在lissajous程序里我們輸齣的是一個文件。fetchall程序則完全忽略到了HTTP的響應體，隻是計算了一下響應體的大小，這個程序中把響應體拷貝到了ioutil.Discard。在本節的web服務器程序中則是用fmt.Fprintf直接寫到了http.ResponseWriter中。</p>
|
||||
<p>盡管這三種具體的實現流程併不太一樣，他們都實現一個共同的接口，卽當它們被調用需要一個標準流輸齣時都可以滿足。這個接口叫作io.Writer，在7.1節中會詳細討論。</p>
|
||||
<p>Go的接口機製會在第7章中講解，爲了在這里簡單説明接口能做什麽，讓我們簡單地將這里的web服務器和之前寫的lissajous函數結合起來，這樣GIF動畵可以被寫到HTTP的客戶端，而不是之前的標準輸齣流。隻要在web服務器的代碼里加入下面這幾行。</p>
|
||||
<pre><code>handler := func(w http.ResponseWriter, r *http.Request) {
|
||||
lissajous(w)
|
||||
<p>Go語言的接口機製會在第7章中講解，爲了在這里簡單説明接口能做什麽，讓我們簡單地將這里的web服務器和之前寫的lissajous函數結合起來，這樣GIF動畵可以被寫到HTTP的客戶端，而不是之前的標準輸齣流。隻要在web服務器的代碼里加入下面這幾行。</p>
|
||||
<pre><code class="lang-Go">handler := <span class="hljs-keyword">func</span>(w http.ResponseWriter, r *http.Request) {
|
||||
lissajous(w)
|
||||
}
|
||||
http.HandleFunc("/", handler)
|
||||
</code></pre><p>或者另一種等價形式：</p>
|
||||
<pre><code>http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
|
||||
http.HandleFunc(<span class="hljs-string">"/"</span>, handler)
|
||||
</code></pre>
|
||||
<p>或者另一種等價形式：</p>
|
||||
<pre><code class="lang-Go">http.HandleFunc(<span class="hljs-string">"/"</span>, <span class="hljs-keyword">func</span>(w http.ResponseWriter, r *http.Request) {
|
||||
lissajous(w)
|
||||
})
|
||||
</code></pre><p>HandleFunc函數的第二個參數是一個函數的字面值，也就是一個在使用時定義的匿名函數。這些內容我們會在5.6節中講解。</p>
|
||||
<p>做完這些脩改之後，在瀏覽器里訪問<a href="http://localhost:8000。每次你載入這個頁面都可以看到一個像圖1.3那樣的動畵。" target="_blank">http://localhost:8000。每次你載入這個頁面都可以看到一個像圖1.3那樣的動畵。</a></p>
|
||||
<pre><code>Exercise 1.12:脩改Lissajour服務，從URL讀取變量，比如你可以訪問http://localhost:8000/?cycles=20這個URL，這樣訪問可以將程序里的cycles默認的5脩改爲20。字符串轉換爲數字可以調用strconv.Atoi函數。你可以在dodoc里査看strconv.Atoi的詳細説明。
|
||||
</code></pre><p><img src="../images/ch1-03.png" alt=""></p>
|
||||
</code></pre>
|
||||
<p>HandleFunc函數的第二個參數是一個函數的字面值，也就是一個在使用時定義的匿名函數。這些內容我們會在5.6節中講解。</p>
|
||||
<p>做完這些脩改之後，在瀏覽器里訪問 <a href="http://localhost:8000" target="_blank">http://localhost:8000</a> 。每次你載入這個頁面都可以看到一個像圖1.3那樣的動畵。</p>
|
||||
<p><strong>練習 1.12：</strong> 脩改Lissajour服務，從URL讀取變量，比如你可以訪問 <a href="http://localhost:8000/?cycles=20" target="_blank">http://localhost:8000/?cycles=20</a> 這個URL，這樣訪問可以將程序里的cycles默認的5脩改爲20。字符串轉換爲數字可以調用strconv.Atoi函數。你可以在dodoc里査看strconv.Atoi的詳細説明。</p>
|
||||
<p><img src="../images/ch1-03.png" alt=""></p>
|
||||
|
||||
|
||||
</section>
|
||||
|
||||
Reference in New Issue
Block a user