Skip to content

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

Closed

Description

@linghengqian

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

Component(s)

Website

Activity

  1. changed the title [-]Link to Arrow Flight SQL API documentation is broken[/-] [+][Docs][Java] Link to Arrow Flight SQL API documentation is broken[/+] on Feb 1, 2025
  2. kou commented on Feb 1, 2025

    @kou
    Member

    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?

  3. lidavidm commented on Feb 2, 2025

    @lidavidm
    Member

    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

  4. kou commented on Feb 2, 2025

    @kou
    Member

    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.

  5. kou commented on Feb 2, 2025

    @kou
    Member

    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.

  6. thisisnic commented on Nov 18, 2026

    @thisisnic
    Member

    The Java documentation is now published from apache/arrow-java at https://arrow.apache.org/java/current/, and the API documentation link on https://arrow.apache.org/java/current/flight_sql.html now resolves correctly. Closing.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions