Releases: chinoio/chino-java
3.3.2hotfix1
skip ConsentsTest class against production API
Improve console output and host normalization
Fixed host normalization: now the client automatically removes trailing slashes and adds /v1
to the Chino API host URL.
The message that used to warn about using the API over HTTP has been silenced.
Overall improvements to test classes.
Updated the URLs to Chino.io docs. The Chino.io API documentation has been moved to https://console.test.chino.io/docs/v1.
version 3.3.1: customize User-Agent
Now it is possible to customize the User-Agent header, appending a <client name>
. It will look like:
okhttp/3 chino-java/3.3.1(<client name>)
version 3.3.0: improved activation and deactivation of resources
Added support to activate resources.
When a resource is deactivated with force=false
delete(id, false)
Now it can be re-activated with an update()
:
update(true, ...)
Removed invalid delete methods
Removed parameter force
from delete()
methods for resources that can't be deactivated (Applications, BLOBs).
The old methods have been deprecated to preserve backwards compatibility and will be removed soon.
Bug fixes and improvements
Fixed delete()
method of Consents
Improved javadoc
Minor bug fixes
version 3.2.0: added support for Java 11
Support for Java 11
The project now officially supports Java 11, which is the current LTS version. Backwards compatibility with Java 8 is still granted, but developers should upgrade their Java version to keep up with the Java SE support roadmap.
Bug fixes
Improved overall quality of tests.
Fixed URL parsing in ChinoAPI, where sometimes a double slash could be found
version 3.1.0: updated BLOBs API
BLOBs API
Introduced new methods to the BLOBs API.
Now it is possible to upload and download files as BLOBs using an InputStream
instead of storing them on file system.
Existing code, documentation and tests have been improved, too.
3.0
This new major version is backwards compatible. It is a starting point for future changes to our SDK,
that will follow the semantic versioning. No JAR files are provided for this version.
Bug fixes
Fixed bugs that affected the Search.
Force HTTPS on API host URL
Every client initialized with http://api.chino.io
and http://api.test.chino.io
will be forced to use https instead.
Test and coverage
Improved tests on the SDK. Now the code coverage and code quality reports are published to
Code Climate.
Version 1.3.1: Fixed Search API
Main changes for this version:
- Added new method to
io.chino.api.search.UsersSearch
:
public boolean usernameExists(String username)
that returns true
if a user exists with the specified username.
Usage:
boolean exists = chino.search.users("user_schema_id").usernameExists("username");
- Added support for paginated results in the new Search API. Now it is possible to run search query with:
search.execute(); // return first 10 results
int offset = 5;
int limit = 50;
search.execute(offset, limit); // return the first 50 results starting from the 5th
Version 1.3 released! Major update to Chino.io Java SDK
Chino.io SDK release 1.3 
What's new
Upgraded minimum JDK version:
Since official support for Java 7 will be dropped in December 2018, the minimum SDK version for the Chino.io SDK has been raised to Java 8. We suggest using the openjdk8
build.
Removed deprecated method from version 1.2.3:
This change affects a method in class io.chino.java.Users
.
Search API:
The Search API used to produce strange requests, which now have been fixed.
We have redesigned the Search system to be more developer-friendly and as a consequence
the old Search API has been deprecated. They will be removed in a future version (1.3.X or 1.4).
A new Search interface has been implemented: see the Search section of the README.md file.
We strongly suggest migrating to the new Search API as soon as possible to preserve compatibility with new versions of our SDK.
Permissions API
We also redesigned the interface of the Permissions API, in order to make it easier to use. You can now set or revoke Permissions to your Users with fewer lines of code.
The old interface is still working but has been deprecated and will be removed in a future version (1.3.X or 1.4).
BLOBs API:
From the next release of Chino.io Java SDK, BLOB uploads will only work with the uploadBlob(...)
method.
Methods that handle the intermediate steps of the upload will no longer be accessible.
Affected methods are initUpload
, uploadChunk
and commitUpload
, which have been deprecated.
Also method delete(String, boolean)
will be removed from the public API. You should replace all usages of the deprecated method with delete(String)
.
Other changes:
- Added Javadoc for most of the classes of the SDK; existing documentation has been fixed and updated.
- Added methods for synchronous creation of Documents and Users. API calls will only return after the resources have been fully indexed, so that they will appear in the search results.
- new method
Users.checkPassword(String password)
to verify a User's password
Javadoc
The Javadoc for this version of the SDK can be obtained:
-
from the Assets section of the latest GitHub Release, as a JAR archive
-
by executing the Gradle task
javadoc
locally, that will create the HTML files inbuild/docs/javadoc
:./gradlew build javadoc
or the task
javadocJar
, that will package them inside a JAR inbuild/libs/chino-java-1.3-javadoc.jar
:./gradlew build javadocJar
-
from Jitpack.io (online copy)
v1.2.3 - New features for Users API client
v1.2.3 - New features for Users API client 
Deprecated method
Users.update(String, HashMap)
is no longer supported and will be removed in a future release. This method could be used to update only some fields of a User, but other methods with the same name require all the fields of the User to be passed - which led to confusion.
Starting from v1.2.3 the updatePartial
methods are introduced:
* updatePartial(String userId, String username, String password, HashMap attributes)
* updatePartial(String userId, String username, String password, String attributes)
- pass attributes as a JSON String
Please update your old code and use updatePartial
to perform partial updates to your Users' fields.
Improved documentation of class io.chino.java.Users
cleaned and improved javadoc - browse it on jitpack.io or download the JAR from the Asset section above.
Other fixes and improvements
- Added JUnit tests for class
io.chino.java.Users
- Minor fixes