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

StormZhu · · 97 次点击 · · 开始浏览    

接着上一篇的golang分布式存储 读书笔记(1)——流操作之GetStream封装,这次要讲的是上传文件并保存,使用restfulPUT方法,书中封装了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()构造一个writerreader,再初始化一个通道c,最后使用writerc构造一个PutStream指针对象返回。

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

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

同时这个PutStream需要实现io.Writerio.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.Copyr中的内容复制到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语言实现》

本文来自:简书

感谢作者:StormZhu

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

97 次点击  
加入收藏 微博
暂无回复
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
  • 图片支持拖拽、截图粘贴等方式上传