https://github.com/xiaomi/go-fds

Next-generation fds golang sdk
https://github.com/xiaomi/go-fds

fds go s3

Last synced: about 2 months ago
JSON representation

Next-generation fds golang sdk

• Host: GitHub
• URL: https://github.com/xiaomi/go-fds
• Owner: XiaoMi
• License: apache-2.0
• Created: 2019-08-14T03:44:21.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2023-12-21T10:03:44.000Z (about 1 year ago)
• Last Synced: 2024-06-21T04:38:17.537Z (7 months ago)
• Topics: fds, go, s3
• Language: Go
• Homepage:
• Size: 1.1 MB
• Stars: 14
• Watchers: 16
• Forks: 12
• Open Issues: 0
• Metadata Files:
  • Readme: README-cn.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# go-fds

小米文件存储FDS(File Storage Service) Go SDK.

# 简介

因为接口已经固定，[旧SDK](https://github.com/XiaoMi/galaxy-fds-sdk-golang)已经不容易改动，但是存在一些问题，是重构无法解决的，比如：

1. 内存不友好，旧SDK中，对object读写都是通过byte数组的形式，如果object较大，并且用户并发的写入，则会占用较大内存，并不能像Java SDK中使用InputStreamming那样友好。在Go语言中，提供了类似的机制，io.Reader io.Writer，这是输入输出的一种使用共识。

2. 添加新的API较为困难，旧SDK每添加一个新的API都需要考虑过多的内在逻辑，写过多的冗余代码，新SDK则只需要几行代码就可以完成添加功能，大部分重复逻辑已经简化。

3. 交互使用略显困难，比如在PutObject时，可以指定metadata或者Header，但是旧SDK这方面不易操作。新SDK通过反射的方式，解决了可选输入的问题。

4. 接口、包命名不符规范，在Go语言中，有较为严格的命名规范，比如包命名必须是小写，函数命名不能带_，如果带了是勉强可以通过运行的，但是这不符合规范。

另外，除了上面几个新SDK具有的优点之外，新版SDK参照S3和OSS的sdk设计，我也为这个SDK提供了并发的upload和download。

最后，auth.go里面的signature方法是直接使用了旧SDK中的代码。

## 安装

`go get -u github.com/XiaoMi/go-fds`

## 用法

```go

package main

import (

	"log"

	"os"

	"github.com/XiaoMi/go-fds/fds"

	"github.com/XiaoMi/go-fds/fds/manager"

)

func main() {

	conf, _ := fds.NewClientConfiguration(os.Getenv("GO_FDS_TEST_ENDPOINT"))

	client := fds.New(os.Getenv("GO_FDS_TEST_ACCESS_KEY_ID"), os.Getenv("GO_FDS_TEST_ACCESS_KEY_SECRET"), conf)

	downloader := manager.NewDownloader(client, 1024*1024, 10, true)

	request := &manager.DownloadRequest{

		GetObjectRequest: fds.GetObjectRequest{

			BucketName: "hellodf",

			ObjectName: "build.log",

		},

		FilePath: "/home/XiaoMi/tmp/build.log",

	}

	err := downloader.Download(request)

	if err != nil {

		log.Fatalln(err)

	} else {

		log.Println("Done")

	}

}

```

## License