[Docs][Java] Link to Arrow Flight SQL API documentation is broken

[linghengqian]

Describe the bug, including details regarding any error messages, version, and platform.

• Link to Arrow Flight SQL API documentation is broken.
• In https://arrow.apache.org/docs/java/flight_sql.html , the API documentation points to https://arrow.apache.org/docs/java/reference/org/apache/arrow/flight/sql/package-summary.html which is invalid.
• 
• 

Component(s)

Website

[kou]

Ah, this is caused by apache/arrow -> apache/arrow-java separation.

It should be https://arrow.apache.org/java/current/reference/org.apache.arrow.flight.sql/org/apache/arrow/flight/sql/package-summary.html when we release 18.1.0 from apache/arrow-java. See also: apache/arrow-java#574

@lidavidm BTW, it seems that old Javadoc URL is https://.../org/apache/arrow/... (separated by / not .) not https://.../org.apache.arrow.../ (separated by . not /). Should we use / separator for apache/arrow-java docs?

[lidavidm]

Hmm. AFAIK we just use whatever Javadoc gives us. If it changed, maybe we want to change it back somehow (maybe with .htaccess if it supports patterns?) Or redirect old to new, actually

[kou]

Hmm. It seems that old URL was
https://.../org.apache.arrow.XXX/org/apache/arrow/XXX/...
not
https://.../org/apache/arrow/...

It's same as the new URL pattern.

See: https://github.com/apache/arrow-site/blob/13c3daeb06e55b65b5ce281217289b5625dce9b9/docs/java/reference/org.apache.arrow.flight.sql/org/apache/arrow/flight/sql/package-summary.html

Anyway, we can add a .htaccess configuration for https://arrow.apache.org/docs/java/ -> https://arrow.apache.org/java/current/ redirect.

[kou]

Oh, 18.0.0 uses https://.../org.apache.arrow.XXX/org/apache/arrow/XXX/... and 17.0.0 uses https://.../org/apache/arrow/XXX/...

See: https://github.com/apache/arrow-site/tree/45046999f7e199ece2718aa52f9cd4000852ee5a/docs/java/reference

It seems that Javadoc changed the default format.