Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Add java.time.Duration-based APIs

Aperta
#776 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
25/100
Tipo di issue
Funzionalità
Chiarezza
Da chiarire
Stato di attività
Ferma
Stack tecnologico
java
Ambito
api

Direzione di ricerca

Inizia facendo un inventario delle API della libreria che accettano primitive numeriche che rappresentano concetti di data/ora, usando come riferimento l'esempio readTimeout dell'issue. Determina quali possono ricevere overload di java.time.Duration e come dovrebbero essere denominati alternativamente i valori numerici restituiti. Il lavoro è completo quando le API interessate adottano un approccio coerente e documentato, senza lasciare ambiguo l'ambito.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

semver: minor status: blocked type: cleanup

Representing date/time concepts as numeric primitives is a bad idea. It leads to unit mismatch, overflows, and many other dangerous date/time-related bugs.

For instance, it's impossible to tell what time unit readTimeout is without reading it's javadocs:

public final class HttpRequest {
  public HttpRequest setReadTimeout(int readTimeout) { ... }
}

Please consider adding java.time.Duration overloads to all APIs that accept a date/time concept as a numeric primitive. Methods that return a numeric primitive representing a date/time concept are much more difficult as new, alternative method names must be chosen (e.g., public int getReadTimeout()).

Lingua principale
Java
Stelle
1.4k
Fork
473
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di googleapis/google-http-java-client

Tutte le issue di googleapis/google-http-java-client

Issue simili

Altre issue su Java

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.