Skip to content

Commit 765fd9d

Browse files
authored
chore: sync Java client with Apify OpenAPI spec v2-2026-08-27T071624Z (#16)
1 parent 6d4a0f7 commit 765fd9d

5 files changed

Lines changed: 28 additions & 20 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,14 @@ All notable changes to the Apify Java client are documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project
66
adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8+
## [0.6.2] - 2026-08-28
9+
10+
### Changed
11+
12+
- Bumped `Version.API_SPEC_VERSION` to `v2-2026-08-27T071624Z` and `Version.CLIENT_VERSION` to
13+
`0.6.2`.
14+
- Reworded a stale temporal reference ("(this PR)") in a `spotbugs-exclude.xml` comment.
15+
816
## [0.6.1] - 2026-08-15
917

1018
### Fixed

‎README.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Maven (Maven Central is a default repository, so no extra configuration is neede
2323
<dependency>
2424
<groupId>com.apify</groupId>
2525
<artifactId>apify-client</artifactId>
26-
<version>0.6.1</version>
26+
<version>0.6.2</version>
2727
</dependency>
2828
```
2929

@@ -35,7 +35,7 @@ repositories {
3535
}
3636
3737
dependencies {
38-
implementation 'com.apify:apify-client:0.6.1'
38+
implementation 'com.apify:apify-client:0.6.2'
3939
}
4040
```
4141

@@ -293,10 +293,10 @@ try {
293293
The public `com.apify.client.Version` class (`import com.apify.client.Version;`) exposes two
294294
constants:
295295

296-
- `Version.CLIENT_VERSION` — the semantic version of this client (`0.6.1`).
296+
- `Version.CLIENT_VERSION` — the semantic version of this client (`0.6.2`).
297297
- `Version.API_SPEC_VERSION` — the version of the [Apify OpenAPI specification](https://docs.apify.com/api/openapi.json)
298298
(its `info.version` field) that this client's endpoints, parameters and models were last generated
299-
and checked against (`v2-2026-08-14T072928Z`). It is a snapshot, not a live compatibility
299+
and checked against (`v2-2026-08-27T071624Z`). It is a snapshot, not a live compatibility
300300
guarantee: the client keeps working against newer, backward-compatible spec revisions, but a
301301
feature added to the API after this snapshot has no corresponding method here yet.
302302

‎pom.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66

77
<groupId>com.apify</groupId>
88
<artifactId>apify-client</artifactId>
9-
<version>0.6.1</version>
9+
<version>0.6.2</version>
1010
<packaging>jar</packaging>
1111

1212
<name>Apify Java Client</name>

‎spotbugs-exclude.xml‎

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -33,19 +33,19 @@
3333
traces a record's synthesized accessor and canonical constructor), so this pair of exclusions is
3434
specific to the record form.
3535
36-
4. EI_EXPOSE_REP on the specific getters listed below, each returning a field whose type was just
37-
changed (this PR) to extend the shared {@code ApifyResource} forward-compatibility base (an
38-
{@code extra} catch-all map + package-private {@code @JsonAnySetter}), so unmodelled API fields
39-
on nested value DTOs are preserved instead of silently dropped. That base class is not {@code
40-
final} and holds a mutable {@code LinkedHashMap} field, which flips SpotBugs' mutability
41-
heuristic for every subtype from "no public mutator -> immutable-enough, don't flag" to
42-
"mutable -> flag every getter that returns one as a field of another class" - even though
43-
nothing about this actually changed: {@code putExtra} stays package-private, {@code
44-
getExtra()} still returns an unmodifiable view, and there is still no public way to mutate a
45-
returned instance. Defensively copying on every getter call would require deep-cloning the
46-
{@code extra} map each time, which is wasted work for a map that is (by construction) never
47-
mutated after deserialization, so copying is not the fix here - the false positive is. Listed
48-
per getter (not per class) to keep the exclusion exactly as narrow as the finding it suppresses.
36+
4. EI_EXPOSE_REP on the specific getters listed below, each returning a field whose type extends
37+
the shared {@code ApifyResource} forward-compatibility base (an {@code extra} catch-all map +
38+
package-private {@code @JsonAnySetter}), so unmodelled API fields on nested value DTOs are
39+
preserved instead of silently dropped. That base class is not {@code final} and holds a mutable
40+
{@code LinkedHashMap} field, which flips SpotBugs' mutability heuristic for every subtype from
41+
"no public mutator -> immutable-enough, don't flag" to "mutable -> flag every getter that
42+
returns one as a field of another class" - a false positive: {@code putExtra} stays
43+
package-private, {@code getExtra()} still returns an unmodifiable view, and there is still no
44+
public way to mutate a returned instance. Defensively copying on every getter call would require
45+
deep-cloning the {@code extra} map each time, which is wasted work for a map that is (by
46+
construction) never mutated after deserialization, so copying is not the fix here - the false
47+
positive is. Listed per getter (not per class) to keep the exclusion exactly as narrow as the
48+
finding it suppresses.
4949
5050
5. EI_EXPOSE_REP2 on {@code ListPublisher}'s constructor, which stores the caller-supplied {@code
5151
CompletableFuture<List<T>>} straight into a field. A {@code CompletableFuture} is a handle to an

‎src/main/java/com/apify/client/Version.java‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,13 +13,13 @@ public final class Version {
1313
* The semantic version of this client library (see <a href="https://semver.org/">SemVer</a>).
1414
* Changes to the public interface other than additive ones are considered breaking changes.
1515
*/
16-
public static final String CLIENT_VERSION = "0.6.1";
16+
public static final String CLIENT_VERSION = "0.6.2";
1717

1818
/**
1919
* The version of the Apify OpenAPI specification this client was generated and verified against.
2020
* Corresponds to the {@code info.version} field of the Apify OpenAPI document.
2121
*/
22-
public static final String API_SPEC_VERSION = "v2-2026-08-14T072928Z";
22+
public static final String API_SPEC_VERSION = "v2-2026-08-27T071624Z";
2323

2424
private Version() {}
2525
}

0 commit comments

Comments
 (0)