hhaohuang / ks3-sdk-java

金山云存储服务客户端SDK，Java版本。

北京金山云网络技术有限公司标准存储服务开发工具包Java版 KS3 SDK for Java

版权所有 （C）金山云科技有限公司

Copyright (C) Kingsoft Cloud All rights reserved.

http://ks3.ksyun.com/

环境要求：

• J2SE Development Kit (JDK) 6.0或以上版。
• Apache Commons 相关jar。
• JSon-lib等相关jar，用于POJO的序列化输出。
• 必须注册有KSC用户账户，并开通KS3服务。

更新日志：

------2013年11月19日------
1.修正了部分情况下通过SDK计算出的缩略图打开会出现415 Unsupported Media Type的问题。

------2013年9月13日------
1.修正了文件大小大于2147483647Byte时引起的SDK出错到问题。

------2013年9月5日------
1.分块上传功能可以设置MimeType信息。

------2013年9月4日------
1.增加了获得Object的Metadata的接口和相关DTO。
2.增加了分块下载和断点续传的Demo。

------2013年9月2日------
1.重载了三个上传Object的接口，这三个接口可以多传入ACL作为参数，直接上传具有指定ACL属性的Object。
2.增加了查看和设定指定Object的ACL属性的接口。
3.增加了缩略图URL生成功能，可以对指定Object生成缩略图的URL。

------2013年8月22日------
1.重写了构造请求的算法，更优化。
2.保留原接口的同时，增加了以InputStream，即以流的形式上传文件的接口（putObjectByInputStream），服务器可以边读边上传。
3.增加了分块上传功能，并提供了多种上传策略供用户选择，详见（KS3MultipartSampleSolution1、KS3MultipartSampleSolution2和KS3MultipartSampleSolution3中的Demo）。
4.所有DTO均实现了Serializable接口，同时均实现了toString方法和toJson方法，方便用户灵活使用。
5.增加了自动重试机制，当用户由于网络问题引起的请求失败，SDK可以自动进行重试。
6.提供了一个压力测试的Demo，用户可以使用它作为测试网络和SDK的一个样本。

------2013年8月19日------
1.解决了并发操作时Request可能会引发空引用异常的bug。
2.解决了某些操作不能自动回收连接池内连接致使无法再发送请求的bug。

------2013年8月5日------ 1.修正了prefix中含有特殊符号搜索结果为空的问题。
2.对于SDK中的DTO，均增加并实现了toJson方法，用户可以更容易的得到格式化的结果来进行传输。
3.优化了生成预签名的下载链接的实现逻辑，前端打开新生成的链接可以直接弹出保存窗口。
4.修正了objectKey中含有空格、型号等特殊符号的情况下会导致部分功能出现异常的问题。
5.封装了ResponseException，当用户通过SDK调用S3成功但返回值不为200时，抛出此异常。（即请求成功，调用失败。例如：创建的bucket已经存在。）

------2013年7月18日------
1.修正了objectkey中不能含有"/"的bug。
2.对于ObjectListOptions中的setMarker等方法，现在已经可以设置空字符串("")。

------2013年7月10日------
1.减少了对第三方的包的依赖。
2.优化了网络访问部分，性能更高，稳定性更强。
3.增加了对安卓的优化，安卓可以直接使用当前的SDK。
4.ObjectInfo对象已经可以进行序列化，因而用户可以对Object的List使用MC等容器直接进行缓存。
5.修正了特殊参数下签名计算错误引起的请求失败的bug。
6.更正了包的命名规则。
7.改进了其他若干细节。

------2013年4月22日------
1.增加了getObjectListByOptions方法，可以根据prefix、marker等信息获取ObjectList。
2.增加了getObejctByOptions方法，实现了可用于分块下载的range功能和用户与判断的If-Match、If-Modified-Since等功能。
3.增加了getPresignedUrl方法，用户可以自己根据指定参数生成预签名的url。

----------------------------------------------------------
如果您发现任何Bug或者有更好的改进意见，请联系：[e-mail]
我们的进步离不开您的支持！