Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,8 @@ client.items().publish(42, new PublishRequest().accountIds(List.of(accountId)));
client.conversations().sendMessage(conversationId, new SendMessageRequest().text("Hello!"));
```

On `ItemUpdateRequest`, a nullable field left unset is not sent, and one set to `null` (`.sellingPlaceId(null)`) is sent as an explicit `null`, which clears it on the API. A list is replaced as a whole: send an empty list to empty it.

Retries (rate limits, 502/503/504, network errors), `Idempotency-Key` on every `POST`, cursor pagination with plain iterables and typed errors (`ControlResellError.NotFound`, `ControlResellError.RateLimit`...) are built in. The client is generated from the API's OpenAPI document (`scripts/generate.sh`, code in `src/main/java/com/controlresell/sdk/generated`).

```sh
Expand Down
5 changes: 5 additions & 0 deletions pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,11 @@
<artifactId>jackson-databind</artifactId>
<version>${jackson.version}</version>
</dependency>
<dependency>
<groupId>org.openapitools</groupId>
<artifactId>jackson-databind-nullable</artifactId>
<version>0.2.6</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.datatype</groupId>
<artifactId>jackson-datatype-jsr310</artifactId>
Expand Down
2 changes: 1 addition & 1 deletion scripts/generate.sh
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ java -jar "$JAR" generate \
--library native \
-o "$WORK/out" \
--global-property=apiTests=false,modelTests=false,apiDocs=false,modelDocs=false \
--additional-properties=invokerPackage=com.controlresell.sdk.generated,apiPackage=com.controlresell.sdk.generated.api,modelPackage=com.controlresell.sdk.generated.model,openApiNullable=false,useJakartaEe=true,hideGenerationTimestamp=true \
--additional-properties=invokerPackage=com.controlresell.sdk.generated,apiPackage=com.controlresell.sdk.generated.api,modelPackage=com.controlresell.sdk.generated.model,openApiNullable=true,useJakartaEe=true,hideGenerationTimestamp=true \
> "$WORK/generate.log"

TARGET="$ROOT/src/main/java/com/controlresell/sdk/generated"
Expand Down
2 changes: 2 additions & 0 deletions src/main/java/com/controlresell/sdk/generated/ApiClient.java
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,7 @@
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.SerializationFeature;
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
import org.openapitools.jackson.nullable.JsonNullableModule;

import java.io.InputStream;
import java.io.IOException;
Expand Down Expand Up @@ -204,6 +205,7 @@ public static ObjectMapper createDefaultObjectMapper() {
mapper.enable(DeserializationFeature.READ_ENUMS_USING_TO_STRING);
mapper.disable(DeserializationFeature.ADJUST_DATES_TO_CONTEXT_TIME_ZONE);
mapper.registerModule(new JavaTimeModule());
mapper.registerModule(new JsonNullableModule());
mapper.registerModule(new RFC3339JavaTimeModule());
return mapper;
}
Expand Down
3 changes: 3 additions & 0 deletions src/main/java/com/controlresell/sdk/generated/JSON.java
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@
import com.fasterxml.jackson.annotation.*;
import com.fasterxml.jackson.databind.*;
import com.fasterxml.jackson.databind.json.JsonMapper;
import org.openapitools.jackson.nullable.JsonNullableModule;
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
import com.controlresell.sdk.generated.model.*;

Expand All @@ -41,6 +42,8 @@ public JSON() {
.defaultDateFormat(new RFC3339DateFormat())
.addModule(new JavaTimeModule())
.build();
JsonNullableModule jnm = new JsonNullableModule();
mapper.registerModule(jnm);
}

/**
Expand Down
Loading
Loading