Class Constants
- Author:
- ianjones
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final DateTimeFormatterstatic final DateTimeFormatterstatic final DateTimeFormatterstatic final DateTimeFormatterISO-8601-style wire timestamps:Tor space separator, 0-9 fractional-second digits, and an optional offset writtenZ,+HH,+HHMMor+HH:MM.static final Stringstatic final Stringstatic final Stringstatic final com.fasterxml.jackson.databind.ser.impl.SimpleBeanPropertyFilterstatic final Integerstatic final Integerstatic final DateTimeFormatterFormats a date-time query/body parameter in the API'syyyy-MM-dd'T'HH:mm:ss'Z'shape.static final Pattern -
Method Summary
Modifier and TypeMethodDescriptionstatic com.fasterxml.jackson.databind.ObjectMapperThe shared object-to-object conversionObjectMapper(used to seed updater JSON models from fetched resources viaconvertValue; never used for wire traffic).static com.fasterxml.jackson.databind.ObjectMappermapper()The shared wireObjectMapperused for all SDK request/response (de)serialization.
-
Field Details
-
DEFAULT_ENCODING
- See Also:
-
PAGE_LIMIT
-
PAGE_OFFSET
-
LIFECYCLE_DETAIL_FILTER
public static final com.fasterxml.jackson.databind.ser.impl.SimpleBeanPropertyFilter LIFECYCLE_DETAIL_FILTER -
queryParamFormatter
Formats a date-time query/body parameter in the API'syyyy-MM-dd'T'HH:mm:ss'Z'shape.The input must be UTC wall clock - which is the SDK-wide convention: the core
LocalDateTimeDeserializerparses"...T12:00:00Z"into a bareLocalDateTimeof 12:00, so every timestamp the SDK returns is already UTC wall clock and can be formatted here verbatim. The trailing'Z'is a literal, not an offset: this formatter performs no zone conversion, so formatting a zone-localLocalDateTime(e.g.LocalDateTime.now()) would stamp local wall-clock digits with a UTC designator. For the current time useLocalDateTime.now(ZoneOffset.UTC), or format anInstantviaLocalDateTime.ofInstant(instant, ZoneOffset.UTC). -
DATE_TIME_FORMAT
ISO-8601-style wire timestamps:Tor space separator, 0-9 fractional-second digits, and an optional offset writtenZ,+HH,+HHMMor+HH:MM. (The previous fixed-width fraction pattern rejected 4, 5, 7, 8 and 9 digits, so the spec's own example2025-02-04T00:20:54.511118575Zfailed the whole response; it also rejected+00:00.) An offset, when present, is applied byLocalDateTimeDeserializer, which normalises every value to UTC. -
COMMENCE_BILLING
-
COMMENCE_BILLING_SHORT
-
ALL_DATE_FORMATS
-
UUID_PATTERN
-
JSON_DESERIALIZE_EXCEPTION
- See Also:
-
JSON_SERIALIZE_EXCEPTION
- See Also:
-
-
Method Details
-
mapper
public static com.fasterxml.jackson.databind.ObjectMapper mapper()The shared wireObjectMapperused for all SDK request/response (de)serialization.Do not reconfigure the returned instance. Its configuration is frozen at class-initialization time and it is used concurrently by every SDK thread; calling
configure/registerModule/setSerializationInclusion(or similar) on it is a thread-safety violation and silently changes SDK-wide behaviour. Treat it as read-only: use it forreadValue/writeValueAsString/convertValueor derive an immutable handle viareader()/writer().- Returns:
- the shared, fully configured wire mapper
-
converter
public static com.fasterxml.jackson.databind.ObjectMapper converter()The shared object-to-object conversionObjectMapper(used to seed updater JSON models from fetched resources viaconvertValue; never used for wire traffic).Do not reconfigure the returned instance - same contract as
mapper().- Returns:
- the shared, fully configured conversion mapper
-