jakartaee / jakartaee/jsonb-api

May adapter input / output be null?

Open
#193 11 comments 0 reactions 0 assignees View on GitHub
Dominant language
Java
Stars
95
Forks
41
Avg merge
1d 6h
Merged PRs (30d)
35

Description

Please add information to the JSON-B Spec / JavaDocs explicitly declaring how to handle `null` in `JsonbAdapter` implementations:
* MUST a `JsonbAdapter` implementation expect to receive `null`?
* MAY a `JsonbAdapter` implementation return `null`?

Contributor guide

Open the contributing guide

Research direction

Locate the JSON-B specification and JavaDocs for JsonbAdapter, then read the existing adapter contract and its treatment of null values. Document whether implementations must accept null and may return null, with wording that makes both requirements unambiguous; the work is done when the spec and JavaDocs agree.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.