googleapis / googleapis/google-http-java-client
JsonParser does not document exception handling
Offen
priority: p3
type: feature request
- Vorherrschende Sprache
- Java
- Sterne
- 1.4k
- Forks
- 473
- PR-Merge-Kennzahlen
- Keine gemergten PRs in 30 T.
Beschreibung
JsonParser.parseAndClose and similar methods do not document which exceptions are thrown under what circumstances. The Jackson and GSON subclasses are in fact throwing different exceptions, IO and IllegalArgument to name two, for the same input. This needs to be documented and made consistent.
Beitragsleitfaden
Rechercherichtung
Start by locating JsonParser.parseAndClose and similar methods, then compare the Jackson and GSON subclass implementations mentioned in the issue. Document the exceptions each method can throw and make their behavior consistent for the same input; done means the public contracts explain the differing cases clearly.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- java
- Bereich
- backend-api-design
- Issue-Typ
- Dokumentation
- Schwierigkeit
- 4/5
- Geschätzter Aufwand
- 3-5 Tage
- Aktivitätsstatus
- Veraltet
- Klarheit
- Größtenteils klar
- Anfängerfreundlichkeit
- 35/100