> ## Documentation Index
> Fetch the complete documentation index at: https://www.osohq.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Java SDK Changelog

> Changelog of updates to Oso Cloud Java SDK.

### 1.5.0

* Add `listPaginated()` method for paginated list queries. Returns a `ListPage` with `results` and `nextPageToken` for fetching subsequent pages. `pageSize` is a required parameter. Available in both synchronous `Oso` and asynchronous `Oso.Async` APIs.

### 1.4.2

* Sets `setValidateAfterInactivity` to 500ms on connection manager.
* Now retries on the following exceptions, `NoHttpResponseException` and `SocketException`.

### 1.4.1

* Expose `X-Request-ID` via `.getRequestId()` for both synchronous `Oso` and asynchronous `Oso.Async` instances. The `X-Request-ID` is a UUIDv4 generated per request.

### 1.4.0

* Add non-blocking `Oso.Async` API.

### 1.3.1

* Expand retry functionality to retry requests in more cases, including client-configured timeouts.

### 1.3.0

* Add ability to set read and write timeouts separately.

### 1.2.1

* Add OsoTimeoutException for timeout.

### 1.2.0

* Add ability to set client timeout.

### 1.1.0

* Stable release of `ParityHandle` for use with [`Oso Migrate`](/develop/local-dev/oso-migrate).

### 1.1.0-alpha.2

* Move `ParityHandle` to public API - users no longer need to import from internal package.

### 1.1.0-alpha.1

* Add `ParityHandle` for use with unreleased [`Oso Migrate`](/develop/local-dev/oso-migrate).

### 1.0.0

See the [migration guide](reference/sdks/migration-guide) for details on upgrading from v0.x.

This major release introduces a redesigned API surface for improved consistency and developer experience, including the new Query Builder API. Please consult the migration guide for a comprehensive list of breaking changes and instructions on adapting your code.

**Breaking Changes & New Features:**

* **Package Structure:** Public API is now primarily accessed via `com.osohq.oso_cloud.Oso`. Query-related methods are available through the `QueryBuilder` returned by `oso.buildQuery()`.
* **Centralized Authorization Data API:**
  * `tell(name, ...args)` is replaced by `insert(Fact)`.
  * `delete(name, ...args)` is replaced by `delete(Fact)` for specific facts and a new `delete(FactPattern)` overload for pattern matching using `ValuePattern.ANY` and `ValuePattern.ValueOfType`.
  * `get(name, ...args)` is replaced by `get(FactPattern)` which allows wildcard matching.
  * `bulkTell`, `bulkDelete`, and `bulk` are replaced by the atomic `batch(Consumer<BatchTransaction>)` method, using `tx.insert()` and `tx.delete()` within the transaction.
* **Query API:**
  * The previous `query` and `authorizeResources` methods are replaced by the new fluent **Query Builder API**, accessed via `oso.buildQuery()`.
  * The Query Builder (`com.osohq.oso_cloud.QueryBuilder`) provides methods like `and()`, `in()`, `withContextFacts()`, and `evaluate()` (using `EvaluateArgs.exists()`, `EvaluateArgs.values()`, `EvaluateArgs.map()`) for constructing and executing flexible queries.
  * Queries returning unconstrained results (e.g., an admin can access everything) now yield `"*"` in the results list, consistent with Check APIs.
* **Local Check API:**
  * Integrates with the new Query Builder API via `evaluateLocalSelect()` and `evaluateLocalFilter()` methods on the `QueryBuilder` for generating SQL.
  * Existing `listLocal`, `authorizeLocal`, and `actionsLocal` methods remain functional.

### 0.11.0

* Add support for QueryBuilder and Local Authorization evaluation.

### 0.10.0

* Added `.equals()` method for `Value` and `Fact` classes.

### 0.9.0

* Add context facts support to actionsLocal, listLocal, authorizeLocal.

### 0.8.0

* Increase the maximum number of connections used in the connection pool to 20.
  Previous default was 2 which limited the throughput a single client would
  handle.
* Added a `setMaxConnections` method to configure the maximum number.

### 0.7.1

* Specify a `User-Agent` to identify the Java and SDK client versions.
* Treat all 2xx status codes as valid.

### 0.7.0

* Use Fallback, if configured, for `.get`, `.get_policy_metadata`, and local
  check APIs if Oso Cloud returns an error (Requires [Fallback 1.0.0](#fallback-1.0.0) or later).
* Use Fallback, if configured, if Oso Cloud returns an HTTP 400 error.

### 0.6.0

* Remove extra argument from `actionsLocal` and mark old version as deprecated.

### 0.5.1

* Add `X-Request-ID` header to uniquely identify individual API requests; include this ID in error messages for better debugging.

### 0.5.0

* Added new [`oso.actionsLocal()`](/reference/sdks/local-authorization#actions-local) method.

### 0.4.2

* Add `X-Request-ID` header to uniquely identify individual API requests; include this ID in error messages for better debugging.

### 0.4.1

Removed undocumented & no longer in-use built-in `Float` type.

### 0.4.0

Added support for the local check API:

* Added new [`oso.listLocal()`](/reference/sdks/local-authorization#list-local) method.
* Added new [`oso.authorizeLocal()`](/reference/sdks/local-authorization#authorize-local) method.
* Added optional data bindings argument to
  the `Oso` constructor.