golang中的RPC調用伺服器方法

這是一個建立於 的文章，其中的資訊可能已經有所發展或是發生改變。

原文連結，參考Golang中文文檔：http://docscn.studygolang.com/pkg/net/rpc/#NewServer

rpc 包提供了一個方法來通過網路或者其他的I/O串連進入對象的外部方法. 一個server註冊一個對象， 標記它成為可見物件類型名字的服務。註冊後，對象的外部方法就可以遠程調用了。一個server可以註冊多個 不同類型的對象，但是卻不可以註冊多個相同類型的對象。

只有滿足這些標準的方法才會被遠程調用視為可見；其他的方法都會被忽略：

- 方法是外部可見的。- 方法有兩個參數，參數的類型都是外部可見的。- 方法的第二個參數是一個指標。- 方法有傳回型別錯誤

事實上，方法必須看起來類似這樣

func (t *T) MethodName(argType T1, replyType *T2) error

T，T1和T2可以被encoding/gob序列化。 不管使用什麼編解碼，這些要求都要滿足。 （在未來，這些要求可能對自訂的編解碼會放寬）

方法的第一個參數代表調用者提供的參數；第二個參數代表返回給調用者的參數。方法的傳回值，如果是非空的話 就會被作為一個string返回，用戶端會error像是被errors.New調用返回的一樣。如果error返回的話， 返回的參數將會被送回給用戶端。

服務斷可以使用ServeConn來處理單個串連上的請求。更通用的方法，伺服器可以製造一個網路監聽，然後調用 Accept，或者對一個HTTP監聽，處理HandleHTTP和http.Serve。

用戶端希望使用服務來建立串連，然後在串連上調用NewClient來建立串連。更方便的方法就是調用Dial(DialHTTP) 來建立一個新的網路連接（一個HTTP串連）。用戶端獲得到的對象有兩個方法，Call和Go，指定的參數有：服務和方法 指向參數的指標，接受返回結果的指標。

call方法等待遠程調用完成，但Go方法是非同步呼叫call方法，使用Call通道來標誌調用完成。

除非有明確制定轉碼器，否則預設使用encoding/gob來傳輸資料。

這是個簡單的例子，伺服器希望對外服務出Arith對象：

package servertype Args struct {A, B int}type Quotient struct {Quo, Rem int}type Arith intfunc (t *Arith) Multiply(args *Args, reply *int) error {*reply = args.A * args.Breturn nil}func (t *Arith) Divide(args *Args, quo *Quotient) error {if args.B == 0 {return errors.New("divide by zero")}quo.Quo = args.A / args.Bquo.Rem = args.A % args.Breturn nil}

服務端調用（使用HTTP服務）：

arith := new(Arith)rpc.Register(arith)rpc.HandleHTTP()l, e := net.Listen("tcp", ":1234")if e != nil {log.Fatal("listen error:", e)}go http.Serve(l, nil)

在這個時候，用戶端可以看見服務“Arith”，並且有“Arith.Multiply”方法和“Arith.Divide”方法。 調用其中一個，用戶端首先串連服務：

client, err := rpc.DialHTTP("tcp", serverAddress + ":1234")if err != nil {log.Fatal("dialing:", err)}

當它要調用遠程服務的時候：

// Synchronous callargs := &server.Args{7,8}var reply interr = client.Call("Arith.Multiply", args, &reply)if err != nil {log.Fatal("arith error:", err)}fmt.Printf("Arith: %d*%d=%d", args.A, args.B, reply)

or

// Asynchronous callquotient := new(Quotient)divCall := client.Go("Arith.Divide", args, quotient, nil)replyCall := <-divCall.Done// will be equal to divCall// check errors, print, etc.

服務端的實現需要為用戶端提供一個簡單的，型別安全服務。

也就是當服務端register了某個對象，就可以調用掛在這個對象上的所有方法