Releases: watson-developer-cloud/java-sdk
v8.2.0
8.2.0 (2020-01-16)
Bug Fixes
- Discovery v1: Ensure collectionIds are supplied to avoid service error (955742b)
- Discovery v2: Ensure all required props are sent to prevent service errors (aab26b7)
Features
- Assistant v2: Add system prop to MessageContentSkill (b95388a)
- Speech to Text: Add endOfPhraseSilenceTime and splitTranscriptAtPhraseEnd props to CreateJobOp (be54f7f)
- Speech to Text: Add endOfUtterance prop to SpeechRecognitionResult (42f6ec6)
- Speech to Text: Add support for Italian and Dutch models (6f707da)
- Text to Speech: Add Argentinean, Dutch, and Chinese voices (62259ca)
java-sdk-8.1.0
8.1.0 (2019-11-27)
Bug Fixes
- Discovery: Add GenericQueryAggregation classes (11f04fb)
- Discovery v1: Remove incorrectly-defined title prop from QuertResult and QueryNoticesResult (28d4f5c)
- Visual Recognition: Fix incorrectly-defined errors property in Image and ImageDetails (5ce250b)
Features
- Assistant v1: Add disambiguationOptOut prop to dialog nodes (38c610c)
- Assistant v1: Add offTopic prop to WorkspaceSystemSettings (34809d3)
- Assistant v1: Add randomize and maxSuggestions props to WorkspaceSystemSettingsDisambiguation (8db7136)
- Assistant v1: Add suggestionTextPolicy prop to WorkspaceSystemSettingsDisambiguation (2741942)
- Assistant v1: Add webhook functionality (252f385)
- Discovery v2: Add custom deserializer for aggregations (a6dec27)
- Discovery v2: Add initial generation of service (ac17067)
- Visual Recognition v4: Add getTrainingUsage method (14fefbd)
- Visual Recognition v4: Add THUMBNAIL size constant to GetJpegImageOptions (ee3298d)
java-sdk-8.0.1
java-sdk-8.0.0
java-sdk-7.4.1
java-sdk-8.0.0-rc1
Breaking changes
There are some small breaking changes present, like some methods dropping a parameter or two or some parameters being renamed, but below are the big changes throughout the SDK.
Authentication methods
Authentication methods have changed to make things more extensible for the future. There are 5 authentication variants supplied in the SDK (shown below), and it's possible now to create your own authentication implementation if you need something specific by implementing the Authenticator implementation.
Basic
You can authenticate with basic auth using the BasicAuthenticator. This allows you to pass in a username and password.
Authenticator authenticator = new BasicAuthenticator("<username>", "<password>");Bearer token
Use the BearerTokenAuthenticator. This one accepts just the bearer token.
Authenticator authenticator = new BearerTokenAuthenticator("<bearer_token>");Cloud Pak for Data
This class helps you authenticate with your services on (Cloud Pak for Data)[https://www.ibm.com/analytics/cloud-pak-for-data).
// constructor with required parameters
Authenticator authenticator = new CloudPakForDataAuthenticator(
"<url>",
"<test_username>",
"<test_password>"
);There's also another constructor to disable SSL verification or send request headers on the token exchange.
IAM
Like the CloudPakForDataAuthenticator, there's a basic constructor
Authenticator authenticator = new IamAuthenticator("<token>");and another one to supply additional arguments like a particular token exchange URL, a client ID and secret, and the same options to disable SSL verification and send headers.
None
Finally, there's the NoAuthAuthenticator, which is pretty self-explanatory. Pass this when you don't need any authentication to happen.
Assistant service = new Assistant("2019-02-28", new NoAuthAuthenticator());More model builders
If you've used the SDK before, you're probably familiar with the use of the builder pattern across the board. With this release, we've tweaked the generation process to capture better which are models that are being constructed to be sent to the service. These are models we'd prefer to have builders, making it easier to put them together.
There are unfortunately a decent number of models which move to this pattern, but it's one we expect to use well into the future.
Features
Better control over HTTP logging
Logging used to be controlled with a .properties file somewhere in the namespace, but it was confusing to many people. We also didn't leave an option to shut them off!
We've added control over this to the existing HttpConfigOptions class. Information on usage can be found here.
Ability to cancel an API call
It's possible that in your code, you may want to cancel an API call you made. Some reasons for this might be requests exceeding some response time threshold or sending multiple async requests and just wanting to keep the fastest one, canceling the rest.
Regardless, this feature has been added for this release. You can see more information here.
java-sdk-7.4.0
java-sdk-7.3.1
java-sdk-7.3.0
7.3.0 (2019-07-25)
Bug Fixes
- Compare and Comply: Add correct getter for contract types and additional props (f16dfd9)
Features
- Assistant v2: Add search skill support (3a4ceb8)
- Compare and Comply: Add Contexts and TableTitle models (b2da66d)
- Compare and Comply: Add ContractTerms, ContractTypes, Interpretation, and PaymentTerms models (b72aa8f)
- Compare and Comply: Add Mention model (b3675fd)
- Compare and Comply: Add new constant values (d534fc2)
- Compare and Comply: Add Paragraphs model (be85232)
- Compare and Comply: Add text and provenance ID info to various models (133db0e)
- Natural Language Understanding: Add confidence prop to EntitiesResult and EntityMention (4bf11b8)
- Speech to Text: Add updated prop to AcousticModel and LanguageModel (b6dc3ac)