Skip to content

Tags: Guo-GuangChiou/box-java-sdk

Tags

v2.4.0

Toggle v2.4.0's commit message
This release adds support for multiput upload and single file collabo…

…rations.

It also contains a number of minor bug fixes.

New Features:

- **Support for multiput upload.** New methods in `BoxFolder` and `BoxFile`
  support multiput upload for better performance and reliability for large files.
- **Single file collaborations.** The BoxFile class now supports sharing
  individual files.
- **Automatic configuration for JWT auth.** The Box Developer console now lets
  you download a JSON file of your JWT app configuration settings. You can
  import this file into the Java SDK to easily configure your app.

v2.3.0

Toggle v2.3.0's commit message
This release adds support for a number of new API endpoints

New API Endpoints:

* [Legal Holds](https://docs.box.com/reference#legal-holds-object)
* [Retention Policies](https://docs.box.com/reference#retention-policy-object)
* [Create Metadata Template](https://docs.box.com/reference#create-metadata-schema)
* [Get All Metadata on File](https://docs.box.com/reference#get-all-metadata)
* [Get All Metadata on Folder](https://docs.box.com/reference#get-all-metadata-on-folder)
* [Get Enterprise Metadata](https://docs.box.com/reference#get-enterprise-templates)
* [Update Group](https://docs.box.com/reference#update-a-group)
* [Watermarking](https://docs.box.com/reference#watermarking)
* [Webhooks V2](https://docs.box.com/reference#webhooks-v2)
* [WebLinks](https://docs.box.com/reference#web-link-object)
* [Collections](https://docs.box.com/reference#collection-object)
* [BoxGroupMembership with <Iterator> for Paging](https://docs.box.com/reference#get-the-membership-list-for-a-group)
* [Enterprise Device Pins](https://docs.box.com/reference#device-pin-object)

New Features:

* __Transactional Authentication.__ Support for Box's new Transactional Auth APIs.
* __Upload file versions with SHA1__. A file's SHA1 can be passed in to `BoxFile.uploadVersion(...)` when uploading new versions.
* __Get `effective_access` for shared links.__ The `effective_access` field is accessible through `BoxSharedLink. getEffectiveAccess()`.
* __Added additional Event Types.__  The `TASK_ASSIGNMENT_COMPLETE`, `TASK_ASSIGNMENT_UPDATE`, `TASK_CREATE`, `COMMENT_DELETE` types are now included in the `BoxEvent` class.

Bug Fixes:

[Box Java SDK Issues](https://github.com/box/box-java-sdk/issues)

Known Issues:

JWT, which is needed for AppUsers, requires Java 1.7 or later. The rest of the SDK still supports Java 1.6 as expected.<Paste>

v2.1.1

Toggle v2.1.1's commit message

v2.1.0

Toggle v2.1.0's commit message
This release includes improvements to token caching for App Users and…

… support

for additional API endpoints.

New Features:

* __App Users token caching.__ A token cache can now be specified in
  BoxDeveloperEditionAPIConnection. This allows for improved performance when
  using App Users authentication.
* __Support for retrieving download URLs.__ The `BoxFile.getDownloadURL()`
  method allows for retrieving a direct download URL to a file.
* __File thumbnails.__ The `BoxFile.getThumbnail()` method allows for
  downloading the thumbnail for a file.

Bug Fixes:

* __Getting info for a file could crash when there's no preview__. Previously,
  an exception would be thrown if `BoxFile.getInfo(BoxFile.ALL_FIELDS)` was
  called and the file didn't have a preview available.

v2.0.0

Toggle v2.0.0's commit message
This major release contains critical bug fixes for the events API as …

…well as new

support for App User authentication.

Breaking Changes:

* __EventLog stream position is now a string.__ The events API introduced a
  breaking change which modified the type of the `streamPosition` field from a
  number to a string. Any code that uses the `EventLog` class will need to be
  updated.

New Features:

* __Support for Box Developer Edition and App Users.__ The new App Users
  authentication process is now supported by the SDK. Examples for how to use
  App Users can be found in the `src/example` directory and additional
  documentation can be found in the [API docs][1].
* __Support for transferring folders between users.__ The
  `BoxUser.moveFolderToUser(String)` method lets a user's root folder me
  transferred to another user.
* __Support for tasks.__ The tasks API is now supported, allowing for tasks to
  be created, modified, and assigned.
* __File preview links.__ The `BoxFile.getPreviewLink()` can be used to retrieve
  a temporary link which allows users to preview a file's contents.

[1]: https://box-content.readme.io/docs/app-users

Bug Fixes:

* __EventLog properly maintains event ordering__. Previously, the events in an
  `EventLog` were not guaranteed to be in the same order as returned by the API.
* __Fix exception when retrieving enterprise events__. A
  `StringIndexOutOfBoundsException` would be thrown by
  `EventLog.getEnterpriseEvents` when the `position` parameter was non-zero and
  `types` parameter was an empty array.

Thanks to @mcmilwj, @jonjo-manywho, @danielandefors, and @itsmanishagarwal for
their contributions to this release!

v1.1.0

Toggle v1.1.0's commit message
This release introduces some new features around proxy configuration and

improved event API support.

New Features:

* __Set a non-global proxy.__ New methods added to `BoxAPIConnection` allow for
  a non-global proxy to be set when making requests to the Box API. Basic HTTP
  authorization is also now support for proxies.
* __Improved events API support.__ The "created_at", "created_by", and
  "session_id" fields have been added to `BoxEvent`. Support was also added for
  some undocumented enterprise event fields.
* __Preflight checks.__ The methods `canUpload()` and `canUploadVersion()` can
  be used to perform a preflight check. This check helps ensure that a file can
  be uploaded before attempting to transfer all of its contents.

Bug Fixes:

* __gzip encoded error messages are correctly handled__. Previously, the bodies
  of error responses weren't decoded properly when gzipped.
* __Groups are properly parsed when creating and retrieving collaborations__.
  The "accessible_by" field of some collaborations was incorrectly parsed as a
  `BoxUser` instead of a `BoxGroup`.
* __Fix intermittent OAuth refresh failures.__ Sometimes OAuth refresh would
  fail when performing a large number of sequential requests. This was
  particularly noticeable when long-polling a large number of events from the
  events API.

There is a known issue where calling `stop()` on the `EventStream` class won't
immediately cancel the current long-polling request until it times out (usually
after 10 minutes). This can be problematic in situations where a refresh needs
to occur, since the current access token will remain locked (and unable to
refresh) until the request times out.

v1.0.0

Toggle v1.0.0's commit message
Bump version for v1.0.0 release

v0.7.0

Toggle v0.7.0's commit message
Bump version for v0.7.0 release

v0.6.0

Toggle v0.6.0's commit message
Bump version for v0.6.0 release

v0.5.0

Toggle v0.5.0's commit message
Release v0.5.0