Improve redirect detection for javadocs

Aperta
#1,041 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@efegokdemir ci sta già lavorando.

Dal 23/9/2026.

  • #1213 di @efegokdemir — aperta

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
45/100
Tipo di issue
Funzionalità
Chiarezza
Specificata chiaramente
Stato di attività
Ferma
Stack tecnologico
java
Ambito
build-system

Direzione di ricerca

Inizia in maven-plugin-tools-api/src/main/java/org/apache/maven/tools/plugin/javadoc/JavadocSite.java intorno alla riga 539 e traccia come viene risolto externalJavadocBaseUrl e come viene utilizzato per costruire la richiesta element-list. Verifica il comportamento con gli URL della documentazione Oracle Java 11; il lavoro è completo quando i reindirizzamenti a una pagina indice consentono comunque alla richiesta element-list di puntare alla posizione risolta della documentazione.

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

Descrizione

enhancement
New feature, improvement proposal

Currently the given externalJavadocBaseUrl is being used first to construct a target url (e.g. to element-list) and then it is requested. This fails when there is no deep redirect support. For example the Oracle URL https://docs.oracle.com/javase/11/docs/api/ redirects to https://docs.oracle.com/en/java/javase/11/docs/api/index.html but https://docs.oracle.com/javase/11/docs/api/element-list is also redirected to https://docs.oracle.com/en/java/javase/11/docs/api/index.html instead of https://docs.oracle.com/en/java/javase/11/docs/api/element-list.

In order to support redirects which always redirect to the index page, the request url should be constructed after the redirect target has been been resolved.

This requires some change in https://github.com/apache/maven-plugin-tools/blob/4ee91b1f88c6ab02323be397f45e978ebc1064c0/maven-plugin-tools-api/src/main/java/org/apache/maven/tools/plugin/javadoc/JavadocSite.java#L539.

Lingua principale
Java
Stelle
63
Fork
78
Merge medio
1g 58m
PR unite (30g)
21

Preparare l'ambiente

  • Nessun Dockerfile né file Docker Compose
  • Ha un modello di pull request
  • Nessuna guida per i contributori

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 apache/maven-plugin-tools

Tutte le issue di apache/maven-plugin-tools

Issue simili

Altre issue su Java

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.