Java 1.2 documentation

[devhawk]

Documentation for DBOS Transact Java 1.2, which is already published to Maven Central. The dependency snippets pin 1.2.0.

Upgrade guide

New Upgrading to v1.2 section in java/upgrading.md:

• Upgrade to 1.1 first.
  • Covers which releases can share a fleet.
  • Covers migrations 113–114. The minimum schema version is still 111.
• Changes that may require action:
  • Payload columns: workflow inputs and outputs have moved to workflow_input / workflow_output, and the workflow_status payload columns are NULL on new rows.
  • Debouncer: the debouncer now stores a DELAYED workflow, and a leftover 1.1 debouncer workflow is taken over.
  • Child workflows: a child inherits its parent's deadline, not its timeout. The section gives the precedence order and what follows from it.
  • Exports: a 1.2 export imports correctly only into 1.1.1 or later.
  • Public records: some gain new components.
  • Clock: workflow and queue timestamps now come from the database clock.
  • Class-less enqueue: a workflow enqueued without a class name now fails with DBOSWorkflowFunctionNotFoundException.
• Deprecations table: covers the old QueueOptions builders, and withDeadline on StartWorkflowOptions, EnqueueOptions and WorkflowOptions.
• 1.1 section fixes: "removed in 2.0" now reads "removed in a future release". Replacements that 1.2 itself deprecates now name the 1.2 form. The 1.1 code examples keep the 1.1 API, because new QueueOptions() doesn't exist in 1.1.

Reference and tutorials

• Queues (java#589):
  • Every example uses new QueueOptions().withX(...).
  • The QueueOptions reference lists the new builders.
  • It explains withRateLimitMax / withRateLimitPeriod for changing half of a stored limit, and the (Integer) null idiom for clearing a limit.
  • It lists the deprecated forms.
  • prompting.md tells agents not to generate the deprecated forms.
• Timeouts (java#587):
  • A child inherits its parent's deadline, even while it waits in a queue.
  • The precedence order: call options, then an enclosing WorkflowOptions block, then the parent's deadline.
  • Timeout.none() and Timeout.inherit() are described as they now behave.
  • withDeadline is marked deprecated, and the queue tutorial's deadlines section carries a deprecation note.
• Debouncer (java#594):
  • Debouncer.withTimeout, and validation when a setter is called.
  • The internal queue is used when no queue is set, and a partitioned queue can't be used.
  • withDeduplicationId is ignored.
  • How a debounce is stored, and when its key is released.
• Workflow listing (java#593, Document Python 2.28 and TS 4.24 #594): ListWorkflowsInput.withIsFork, and WorkflowStatus.isDebounced / debounceDeadline.
• Version pins: 1.1.0 → 1.2.0. The deprecation notes on the event_dispatch_kv plugin API no longer mention 2.0.

Verification

• Every API name, signature, default and behavior claim was checked against the java 1.2.0 tag, and a review pass fixed the debouncer and timeout wording (second commit).
• Every link and anchor added by this PR resolves.
• The full Docusaurus build was not run locally.

🤖 Generated with Claude Code