Improve redirect detection for javadocs

オープン
#1,041 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

@efegokdemir がすでに取り組んでいます。

2026年9月23日 から。

  • #1213 @efegokdemir による — オープン

評価

難易度
3/5
見積もり時間
1〜2日
初心者へのやさしさ
45/100
issue の種類
機能追加
明瞭さ
明確に書かれている
活発さ
停滞
技術スタック
java
領域
build-system

調査の方向性

maven-plugin-tools-api/src/main/java/org/apache/maven/tools/plugin/javadoc/JavadocSite.java の539行目付近から始め、externalJavadocBaseUrl がどのように解決され、element-list リクエストの構築にどのように使用されるかを追跡します。Oracle Java 11 のドキュメント URL で動作を検証します。インデックスページへのリダイレクトが発生しても、element-list リクエストが解決されたドキュメントの場所を対象にできれば完了です。

索引モデルが issue の本文から書いたものです。

説明

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.

主要言語
Java
スター
63
フォーク
78
平均マージ
1日 58分
マージ済み PR(30日)
21

環境構築

  • Dockerfile・Docker Compose ファイルなし
  • プルリクエストのテンプレートあり
  • コントリビューションガイドなし

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

apache/maven-plugin-tools のほかの issue

apache/maven-plugin-tools の issue をすべて見る

似ている issue

Java の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。