golang分布式存储 读书笔记(2)——流操作之PutStream封装

接着上一篇的golang分布式存储 读书笔记(1)——流操作之GetStream封装，这次要讲的是上传文件并保存，使用restful的PUT方法，书中封装了PutStream结构。

接口设计

客户端上传数据时向接口服务器发送PUT请求，请求的url为/objects/<object_name>。

同样接口服务器向数据服务器转发PUT请求，请求的url为/objects/<object_name>。数据服务器在本地指定文件夹（D:/objects/）下创建<object_name>文件，将PUT的内容写入文件中。

目录结构

在GOPATH/src目录下，目录结构为：

go-storage
    apiServer
        objects
            get.go
            put.go
        apiServer.go
    dataServer
        dataServer.go

数据服务器实现

dataServer代码

数据服务器的put接口和get接口很类似，只不过将读文件改为了写文件。

package main

import (
    "net/http"
    "io"
    "os"
    "log"
    "strings"
)

const (
    objectDir = "D:/objects/"
)

func Handler(w http.ResponseWriter, r *http.Request) {
    m := r.Method
    log.Println(m)
    if m == http.MethodGet {
        // get(w, r)
        return
    } else if m == http.MethodPut {
        put(w, r)
        return
    }
    w.WriteHeader(http.StatusMethodNotAllowed)
}

func put(w http.ResponseWriter, r *http.Request) {
    // 提取文件名
    fname := strings.Split(r.URL.EscapedPath(), "/")[2]
    log.Println(fname)
    // 创建文件
    f, e := os.Create(objectDir + fname)
    if e != nil {
        log.Println(e)
        w.WriteHeader(http.StatusInternalServerError)
        return
    }
    defer f.Close()
    // 往文件写入数据
    io.Copy(f, r.Body)
}

func main() {
    http.HandleFunc("/objects/", Handler)
    http.ListenAndServe(":8889", nil)
}

io.Copy(f, r.Body)将r.body的数据写入f中，其中r.Body实现了io.ReadCloser接口，f实现了io.Writer接口。最后要记得关闭文件。

测试

使用Restlet Client发送PUT请求进行测试。

测试数据服务器.png

往http://localhost:8889/objects/1.txt发送PUT请求，可以看到本地确实生成了1.txt文件。

接口服务器实现

版本一

实现PUT请求

可以使用http.NewRequest构造一个PUT请求，使用http.Client构造一个客户端进行发送。

例如：

request, _ := http.NewRequest("PUT","http://127.0.0.1:8889/objects/"+object, reader)
client := http.Client{}
r, e := client.Do(request) // 发送并接受请求

完整代码如下：

package main

import (
    "net/http"
    "io"
    "strings"
    "go-storage/apiServer/objects"
    "log"
)
const dataServerAddr = "http://localhost:8889/objects/"

func Handler(w http.ResponseWriter, r *http.Request) {
    m := r.Method
    if m == http.MethodGet {
        // get(w, r)
        return
    } else if m == http.MethodPut {
        put(w, r)
        return
    }
    w.WriteHeader(http.StatusMethodNotAllowed)
}

func put(w http.ResponseWriter, r *http.Request) {
    defer r.Body.Close()
    object := strings.Split(r.URL.EscapedPath(), "/")[2]
    request, _ := http.NewRequest("PUT",dataServerAddr + object, r.Body)
    client := http.Client{}
    resp, e := client.Do(request) // 发送并接受请求
    if e == nil && resp.StatusCode != http.StatusOK {
        w.WriteHeader(http.StatusNotFound)
        log.Printf("dataServer return http code %d", resp.StatusCode)
        return
    }
    defer resp.Body.Close()
    io.Copy(w, resp.Body)
}
func main() {

    http.HandleFunc("/objects/", Handler)
    http.ListenAndServe(":8888", nil)
}

测试

接口服务器测试.png

往http://localhost:8888/objects/2.txt发送PUT请求，可以看到本地确实生成了2.txt文件。

版本二——封装版本

书上的代码实现的相对复杂一点，将整个操作封装成了一个PutStream的结构体，先看结构体的具体成员：

type PutStream struct {
    writer *io.PipeWriter
    c      chan error
}

可以看到其中一个成员是io.PipeWriter类型，这类似于linux中的管道，一端写入，一读取读取，这里是为了在两个协程之间建立连接，这里使用channel并不好使。

另一个成员是channel类型，因为子协程不能有返回值，所以这里用通道传递错误。

PutStream的构造函数如下：

func NewPutStream(server, object string) *PutStream {
    reader, writer := io.Pipe() // 通过管道将 两个协程 联系起来 (用channel应该也可以把？)
    c := make(chan error)
    go func() {
        request, _ := http.NewRequest("PUT", "http://"+server+"/objects/"+object, reader)
        client := http.Client{}
        r, e := client.Do(request) // 如果 reader一直没有数据，是不是 Do就会阻塞？
        if e == nil && r.StatusCode != http.StatusOK {
            e = fmt.Errorf("dataServer return http code %d", r.StatusCode)
        }
        c <- e
    }()
    return &PutStream{writer, c}
}

先使用io.Pipe()构造一个writer和reader，再初始化一个通道c，最后使用writer和c构造一个PutStream指针对象返回。

中间开启了一个子协程，该协程构造一个http.NewRequest，并使用http.Client构造客户端发送请求。其中request构造的时候使用了管道的读端reader，此时该管道的读端并没有数据，但是http.NewRequest构造request的时候并不会阻塞，而是会阻塞在client.Do(request)这句代码，直到管道的写端写入数据。

如果得到的响应出错了，将错误写入管道c中。

同时这个PutStream需要实现io.Writer和io.Writer接口：

// 实现了 io.Writer接口
func (w *PutStream) Write(p []byte) (n int, err error) {
    return w.writer.Write(p)
}
// 关闭流并得到错误
func (w *PutStream) Close() error {
    w.writer.Close() // io.PipeWriter 关闭， reader也会关闭？ client.Do(request)才能结束？
    return <-w.c
}

由于功能是要上传并保存一个对象，所以实现一个StoreObject方法来调用PutStream。

func StoreObject(r io.Reader, object string) (int, error) {
    stream := NewPutStream(data_server, object)

    // 会阻塞，直到r中收到 EOF，stream实现了io.Writer接口
    io.Copy(stream, r) // 将r的内容拷贝的  stream 中，stream有数据的时候，他对应的reader也就有了数据
    // 会阻塞到 stream中的c channel收到消息
    e := stream.Close()
    if e != nil {
        return http.StatusInternalServerError, e
    }
    return http.StatusOK, nil
}

新建一个PutStream指针类型的stream，由于它实现了io.Writer接口，所以可以调用io.Copy将r中的内容复制到stream中，其实就是写入到管道的写端。最后关闭流，管道写端写入也就结束，读端也读取结束，子协程的发送也就结束了。

其实该版本的实现和版本一是一样的，只不过多了一个子协程，多使用了io.Pipe管道。

看起来其实版本一更加简单、直接。暂时也看不出封装的优势，也许在后面功能越来越复杂的时候，就可以体现这个优势。个人感觉这个封装还是比较优雅。

完整代码

package objects, put.go

package objects

import (
    "net/http"
    "fmt"
    "io"
)

type PutStream struct {
    writer *io.PipeWriter
    c      chan error
}

const (
    data_server = "127.0.0.1:8889"
)

func StoreObject(r io.Reader, object string) (int, error) {
    stream := NewPutStream(data_server, object)

    // 会阻塞到 r中收到 EOF  stream实现了io.Writer接口
    io.Copy(stream, r) // 将r的内容拷贝的  stream 中，stream有数据的时候，他对应的reader也就有了数据
    // 会阻塞到 stream中的c channel收到消息
    e := stream.Close()
    if e != nil {
        return http.StatusInternalServerError, e
    }
    return http.StatusOK, nil
}

func NewPutStream(server, object string) *PutStream {
    reader, writer := io.Pipe() // 通过管道将 两个协程 联系起来 (用channel应该也可以把？)
    c := make(chan error)
    go func() {
        request, _ := http.NewRequest("PUT", "http://"+server+"/objects/"+object, reader)
        client := http.Client{}
        r, e := client.Do(request) // 如果 reader一直没有数据，是不是 Do就会阻塞？
        if e == nil && r.StatusCode != http.StatusOK {
            e = fmt.Errorf("dataServer return http code %d", r.StatusCode)
        }
        c <- e
    }()
    return &PutStream{writer, c}
}

// 实现了 io.Writer接口
func (w *PutStream) Write(p []byte) (n int, err error) {
    return w.writer.Write(p)
}

func (w *PutStream) Close() error {
    w.writer.Close() // io.PipeWriter 关闭， reader也会关闭？ client.Do(request)才能结束？
    return <-w.c
}

package main, apiServer.go

package main

import (
    "net/http"
    "io"
    "strings"
    "go-storage/apiServer/objects"
    "log"
)
const dataServerAddr = "http://localhost:8889/objects/"

func Handler(w http.ResponseWriter, r *http.Request) {
    m := r.Method
    if m == http.MethodGet {
        // get(w, r)
        return
    } else if m == http.MethodPut {
        put(w, r)
        return
    }

    w.WriteHeader(http.StatusMethodNotAllowed)
}

func put(w http.ResponseWriter, r *http.Request) {
    // object 要保存的对象名
    object := strings.Split(r.URL.EscapedPath(), "/")[2]
    c, e := objects.StoreObject(r.Body, object)
    if e != nil {
        log.Println(e)
    }
    w.WriteHeader(c)
}

func main() {

    http.HandleFunc("/objects/", Handler)
    http.ListenAndServe(":8888", nil)
}

测试过程同版本一。

疑问

• 如果传输一个4g的文件，到底需不需要占用4g内容？在上一篇文章中我认为这种流操作可以减小内存占用，但是现在不太确定。

参考

《分布式对象存储--原理架构及Go语言实现》