Ruby-SDK之如何实现管理文件？

一个Bucket下可能有非常多的文件，SDK提供一系列的接口方便用户管理文件。

查看所有文件


通过Bucket#list_objects来列出当前Bucket下的所有文件。主要的参数如下：

• :prefix 指定只列出符合特定前缀的文件
• :marker 指定只列出文件名大于marker之后的文件
• :delimiter 用于获取文件的公共前缀require 'aliyun/oss'
• client = Aliyun::OSS::Client.new(
• endpoint: 'endpoint',
• access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')
• bucket = client.get_bucket('my-bucket')
• # 列出所有文件
• objects = bucket.list_objects
• objects.each { |o| puts o.key }
• # 列出前缀为'my-'的所有文件
• objects = bucket.list_objects(:prefix => 'my-')
• objects.each { |o| puts o.key }
• # 列出前缀为'my-'且在'my-object'之后的所有文件
• objects = bucket.list_objects(:prefix => 'my-', :marker => 'my-object')
• objects.each { |o| puts o.key }
• 
  

模拟目录结构


OSS是基于对象的存储服务，没有目录的概念。存储在一个Bucket中所有文件都 是通过文件的key唯一标识，并没有层级的结构。这种结构可以让OSS的存储非常 高效，但是用户管理文件时希望能够像传统的文件系统一样把文件分门别类放到 不同的“目录”下面。通过OSS提供的“公共前缀”的功能，也可以很方便地模拟目录 结构。公共前缀的概念请参考 查看对象列表
假设Bucket中已有如下文件： foo/x
foo/y
foo/bar/a
foo/bar/b
foo/hello/C/1
foo/hello/C/2
...
foo/hello/C/9999


接下来我们实现一个函数叫list_dir，列出指定目录下的文件和子目录： require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
endpoint: 'endpoint',
access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')

bucket = client.get_bucket('my-bucket')

def list_dir(dir)
objects = bucket.list_objects(:prefix => dir, :delimiter => '/')
objects.each do |obj|
if obj.is_a?(OSS::Object) # object
puts "Object: #{obj.key}"
else # common prefix
puts "SubDir: #{obj}"
end
end
end


运行结果如下： > list_dir('foo/')
=> SubDir: foo/bar/
SubDir: foo/hello/
Object: foo/x
Object: foo/y

> list_dir('foo/bar/')
=> Object: foo/bar/a
Object: foo/bar/b

> list_dir('foo/hello/C/')
=> Object: foo/hello/C/1
Object: foo/hello/C/2
...
Object: foo/hello/C/9999



文件元信息


向OSS上传文件时，除了文件内容，还可以指定文件的一些属性信息，称为“元信息”。 这些信息在上传时与文件一起存储，在下载时与文件一起返回。
在SDK中文件元信息用一个Hash表示，其他key和value都是String类型，并 且都[backcolor=transparent]只能是简单的ASCII可见字符，不能包含换行。 所有元信息的总大小不 能超过8KB。

注意：

• 因为文件元信息在上传/下载时是附在HTTP Headers中， HTTP协议规定不能 包含复杂字符。

使用Bucket#put_object，Bucket#append_object和 Bucket#resumable_upload时都可以通过指定:metas参数来指定文件的元信 息： require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
endpoint: 'endpoint',
access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')

bucket = client.get_bucket('my-bucket')

bucket.put_object(
'my-object-1',
:file => 'local-file',
:metas => {'year' => '2016', 'people' => 'mary'})

bucket.append_object(
'my-object-2', 0,
:file => 'local-file',
:metas => {'year' => '2016', 'people' => 'mary'})

bucket.resumable_upload(
'my-object',
'local-file',
:metas => {'year' => '2016', 'people' => 'mary'})


通过Bucket#update_object_metas命令来更新文件元信息： require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
endpoint: 'endpoint',
access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')

bucket = client.get_bucket('my-bucket')

bucket.update_object_metas('my-object', {'year' => '2017'})



拷贝文件


使用Bucket#copy_object拷贝一个文件。拷贝时对文件元信息的处理有两种选 择，通过:meta_directive参数指定：

• 与源文件相同，即拷贝源文件的元信息
• 使用新的元信息覆盖源文件的信息require 'aliyun/oss'
• client = Aliyun::OSS::Client.new(
• endpoint: 'endpoint',
• access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')
• bucket = client.get_bucket('my-bucket')
• # 拷贝文件元信息
• bucket.copy_object(
• 'my-object', 'copy-object',
• :meta_directive => Aliyun::OSS::MetaDirective::COPY)
• # 覆盖文件元信息
• bucket.copy_object(
• 'my-object', 'copy-object',
• :metas => {'year' => '2017'},
• :meta_directive => Aliyun::OSS::MetaDirective::REPLACE)
• 
  

删除文件


通过Bucket#delete_object来删除某个文件： require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
endpoint: 'endpoint',
access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')

bucket = client.get_bucket('my-bucket')

bucket.delete_object('my-object')



批量删除文件


通过Bucket#batch_delete_object来删除一批文件，用户可以通过:quiet参 数来指定是否返回删除的结果：

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
endpoint: 'endpoint',
access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')

bucket = client.get_bucket('my-bucket')

objs = ['my-object-1', 'my-object-2']
result = bucket.batch_delete_object(objs)
puts result #['my-object-1', 'my-object-2']，默认返回删除成功的文件

objs = ['my-object-3', 'my-object-4']
result = bucket.batch_delete_object(objs, :quiet => true)
puts result #[]，不返回删除的结果