Skip to content

Latest commit

 

History

History
569 lines (333 loc) · 13.3 KB

CHANGELOG.md

File metadata and controls

569 lines (333 loc) · 13.3 KB
Raw

Change Log

All notable changes to QingStor SDK for JAVA will be documented in this file.

[v2.6.6] - 2024-12-24

Fixed

  • Fix the bug that the header x-qs-date is not considered in the signature calculation.
  • Fix the bug that decoding versioned delete-object output fails on boolean field.
  • Use -1 as unknown body size hint before parsing the content length.

[v2.6.5] - 2024-04-30

Added

  • Implement Closeable for responses have non-empty body.

[v2.6.4] - 2024-04-17

Fixed

  • Update jackson to address vulnerability issue.

[v2.6.3] - 2024-01-15

Fixed

  • Update okhttp & jackson to address several vulnerability issues.

[v2.6.2] - 2023-07-28

Fixed

  • Fix race condition when build request signature.

[v2.6.1] - 2023-07-28

Added

  • versioning-related api to support qingstor version-control feature.

Fixed

  • Prefix field in Lifecycle rule filter is not required.
  • Return Cache-Control, Expires etc header when HEAD object.

Deps

  • Update org.json to address CVE-2022-45688.

[v2.6.0] - 2022-09-10

Fixed

  • Make Async-request + callback works as expected;

[v2.5.2] - 2021-07-25

Fixed

  • Ensure bucket is append before optional zone when enable_virtual_host_style(bug introduced in v2.5.1);

[v2.5.1] - 2021-02-04

Added

  • Config through env variables and default location;

Changed

  • Use endpoint instead of protocol/host/port when config;
  • Skip sign if no credentials provided;
  • Auto add/strip-out x-qs-meta- prefix when deal with custom metadata in related api(PUT/GET/HEAD etc);

Fixed

  • Check zone before prepend it to host;

[v2.5.0] - 2021-01-04

Added

  • Support bucket Replication api(#103);

Changed

  • Migrate to github actions(#105);
  • Replace virtual_host_enabled to enable_virtual_host_style(#119);

Fixed

  • fix code template error when multiple fields in(#104);
  • Error thrown during request when safeOkHttp configured as true(#117);

[v2.4.0] - 2020-09-28

Added

  • update docs/api comments;
  • support send cname host req to qingstor;
  • ParamType: add enum to replace constants;

Changed

  • Multiple refactors and improvements(robust req build procedure);
  • Remove several deprecated api that exist from long time ago;
  • virtual_host_enabled instead of specify url mode;
  • Multiple simplification(local-scope use of stringBuffer, over-encapsulation);

Fixed

  • Correct paramType annotation;

[v2.3.4] - 2020-07-03

Fixed

  • Fix construct pre-signed url failure when handle image process.

[v2.3.3] - 2020-05-07

Added

  • Support bucket CNAME api

[v2.3.2] - 2020-04-16

Added

  • Support bucket logging api

[v2.3.1] - 2020-04-13

Fixed

  • Adjust the log level to suit the actual situation

[v2.3.0] - 2020-04-07

Fixed

  • error message and code etc unpacking failure when potential binary body included
  • headers' unexpect non-ascii escape encoding

Added

  • replace log implementation to an abstract layer, more non-invasive
  • support http client timeout-related config.

Changed

  • finally remove deprecated EvnContext, please use EnvContext.

[v2.2.19] - 2020-03-27

Fixed

  • signature failure when multiple sub-source with query value combined
  • header's unexpected non-ascii escape encoding

Added

  • append object support
  • user-defined metadata support

[v2.2.18] - 2019-09-18

Fixed

  • Support calling getRequestId() in a normal request.

[v2.2.17] - 2019-04-11

Fixed

  • Fix auto set content-disposition in upload manager

[v2.2.16] - 2019-03-01

Fixed

  • Fix Boolean values in Model are always null
  • Update listObjects method

[v2.2.15] - 2018-12-25

Changed

To add the objectKey in the callbacks of UploadManager, there are some changes below:

  • UploadManagerCallback.onAPIResponse(OutputModel outputModel) => UploadManagerCallback.onAPIResponse(String objectKey, OutputModel outputModel)
  • BodyProgressListener in UploadManager => UploadProgressListener

Added

Add a construction method of QingStor.java

[v2.2.14] - 2018-12-07

Fixed

  • Fix signature not match error

[v2.2.13] - 2018-11-27

Changed

  • Modify the http response header key to lower case

Now some http response headers have become lowercase, were uppercase before("X-QS-Encryption-Customer-Algorithm" --> "x-qs-encryption-customer-algorithm"). To fix this issue, http headers in SDK are case insensitive.

[v2.2.12] - 2018-09-05

Added

  • Add has_more in response element

If you are a private cloud user, please ensure that the version number of your server is greater than 20180801 (inclusive).

[v2.2.11] - 2018-08-09

Changed

  • Modify the class EvnContext to EnvContext
  • Modify lazy load a single instance of okhttp client
  • Modify examples and java docs

Fixed

  • Fix ClassCastException when multiUpload

[v2.2.10] - 2018-07-30

Fixed

  • Fix an issue that may not get the response header "Content-Length" when download.

[v2.2.9] - 2018-07-13

Added

  • Add supports for lifecycle and notification

Fixed

  • Fix the char ':' in http headers has been encoded
  • Fix a json object's types error in json string

Changed

  • Modify examples and github pages doc.

[v2.2.8] - 2018-05-28

Fixed

  • Fix nullable check of type enum in request header

[v2.2.7] - 2018-04-18

Changed

  • Modify UploadManager and UploadManagerCallback

  • We make interface UploadManagerCallback become a abstract class

    Not all of users need sign with server. We make methods "String onSignature(String strToSign)" and "String onAccessKey()" do not auto override. To support java 1.6 as well, default method in interface does not work.

    In summary, interface UploadManagerCallback is a abstract class now.

  • A correct time method added in UploadManagerCallback.

  • A method to correct time added in UploadManager when sign.

  • Modify examples

Modify examples about how to correct the time of your device.

If the local time of users' clients are not synchronized with the network time, may occur a signture error.

Now you can correct the time of your device by below codes.

requestHandler.getBuilder().setHeader(QSConstant.HEADER_PARAM_KEY_DATE, gmtTime);
requestHandler.send();

See examples for more info.

Sign With Server - English Version Sign With Server - Chinese Version

UploadManager - English Version UploadManager - Chinese Version

[v2.2.6] - 2018-04-17

Fixed

  • Fix generate signed url may miss request uri
  • Add requestHandlers in ImageProgressClient
  • Modify examples

We fixed a lot of mistakes in examples. And add an example about how to do a image progress. Visit below links to get examples.

English Version Chinese Version

[v2.2.5] - 2018-01-25

Fixed

  • Fix the problem that call incorrect progress of multipart upload.

Add

  • Add a class 'CancellationHandler' to handle cancellation when upload.

Visit below links to get examples.

English Version Chinese Version

  • Add upload manager to auto upload which will keep the position last uploaded.

Visit below links to get examples.

English Version Chinese Version

[v2.2.4] - 2018-01-13

Fixed

  • Fix improper design of multipart upload interface. Now we allow to upload either using offsets to a file or using slices of large content that stored separately.

Visit below links to know more.

English Version Chinese Version

Add

  • Add some examples.

You can see the new examples here:

English Version Chinese Version

[v2.2.3] - 2018-01-05

Fixed

  • Fixed the encoding problem when set the http header with key "content-disposition".

(The java method corresponding to: Bucket#GetObjectInput#setResponseContentDisposition(String); ).

Add

  • Add some examples.

You can see the examples here:

English Version Chinese Version

[v2.2.2] - 2017-12-21

Fixed

  • Fixed java docs errors in the template.

  • Fixed twice encode when set responseContentDisposition.

Now you can set responseContentDisposition like this:

	Bucket.GetObjectInput inputs = new Bucket.GetObjectInput();
	String fileName = "测试图片(测试).jpg";
	String urlName = URLEncoder.encode(fileName, "utf-8");
	//do not add blanks int the key "attachment;filename="
	inputs.setResponseContentDisposition("attachment;filename=" + urlName);
	RequestHandler handle = bucket.GetObjectBySignatureUrlRequest("测试图片(测试).jpg", inputs, System.currentTimeMillis() + 10000);
	String tempUrl = handle.getExpiresRequestUrl();

Added

  • Add config to change url style.

Available url style: One is the default, when requestUrlStyle != QSConstant#PATH_STYLE} You may see the url like this(QSConstant#VIRTUAL_HOST_STYLE): https://bucket-name.zone-id.qingstor.com/object-name Otherwise you may see the url like this(QSConstant#PATH_STYLE): https://zone-id.qingstor.com/bucket-name/object-name

  • Now you can add configs in EvnContext to change url style. In java:
	EvnContext evn = EvnContext.loadFromFile("config_stor.yaml");
	Bucket bucket = new Bucket(evn, zoneId, bucketName);

About file config_stor.yaml you can add configs below:

# QingStor services configuration

access_key_id: "ACCESS_KEY_ID"
secret_access_key: "SECRET_ACCESS_KEY"

host: "qingstor.com"
port: "443"
protocol: "https"
connection_retries: 3
# uri: '/iaas'

# Valid log levels are "debug", "info", "warn", "error", and "fatal".
log_level: "warn"

# Valid request url styles are "virtual_host_style"(default) and "path_style"
request_url_style: "path_style"

Attention: if some of the configs you do not use, please add a "#" at the first of the line. Like this: # port: '443'

  • Or set request url style with EvnContext.
	EvnContext evn = new EvnContext("ACCESS_KEY_ID_EXAMPLE", "SECRET_ACCESS_KEY_EXAMPLE");
	//Valid request url styles' params are QSConstant.PATH_STYLE and QSConstant.VIRTUAL_HOST_STYLE
	evn.setRequestUrlStyle(QSConstant.PATH_STYLE);
	String zoneName = "pek3a";
	String bucketName = "testBucketName";
	Bucket bucket = new Bucket(evn, zoneKey, bucketName);

[v2.2.1] - 2017-11-07

Changed

  • Remove required content-length parameter for upload inputstream.

[v2.2.0] - 2017-09-28

Added

  • Add image process API.

Changed

  • Add Last-Modified to getObject response head.
  • Optimize type definition.

[v2.1.10] - 2017-07-08

Changed

  • Remove default zone.
  • Remove deprecated method.
  • Update dependency okhttp lib to 3.5.0.

[v2.1.9] - 2017-06-23

Changed

  • Assign query signature to request params .

[v2.1.8] - 2017-06-21

Changed

  • Modify List Multipart Uploads API.
  • Add new headers to UploadMultipart.
  • Add Content-Length to GetObject response headers.

[v2.1.7] - 2017-06-04

Fixed

  • Object to jsonstring optimization.
  • Adjust response message model.

[v2.1.6] - 2017-04-24

Fixed

  • Fixed encoders are not thread-safe.

[v2.1.5] - 2017-02-28

Changed

  • Improve the implementation of list multipart uploads.

Fixed

  • Out of int type range.

[v2.1.4] - 2017-02-11

Fixed

  • Url inputstream buffer read.

[v2.1.3] - 2017-01-23

Fixed

  • Assii character encode.

[v2.1.2] - 2017-01-13

Fixed

  • Object name is contain the same as the bucket name will get error suffix path.

[v2.1.1] - 2016-12-28

Changed

  • Android adapter.

[v2.1.0] - 2016-12-25

Added

  • Add request parameters for GET Object.
  • Add IP address conditions for bucket policy.
  • Add more parameters to sign.

Fixed

  • Fix signer bug.

[v2.0.1] - 2016-12-15

Changed

  • Improve the implementation of deleting multiple objects.

[v2.0.0] - 2016-12-14

Added