You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jira@arrow.apache.org by "David Li (Jira)" <ji...@apache.org> on 2022/04/29 11:58:00 UTC

[jira] [Commented] (ARROW-16412) [Java][Docs] Provide guidance on supported Java versions in README

    [ https://issues.apache.org/jira/browse/ARROW-16412?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17529937#comment-17529937 ] 

David Li commented on ARROW-16412:
----------------------------------

Not sure what we can do here to improve the Maven errors, but we should probably just remove the contents of that readme and point to the documentation instead, so we can focus on improving one thing.

> [Java][Docs] Provide guidance on supported Java versions in README
> ------------------------------------------------------------------
>
>                 Key: ARROW-16412
>                 URL: https://issues.apache.org/jira/browse/ARROW-16412
>             Project: Apache Arrow
>          Issue Type: Improvement
>          Components: Documentation, Java
>            Reporter: Todd Farmer
>            Priority: Major
>
> The [README|https://github.com/apache/arrow/blob/master/java/README.md] for Java lists the following requirements for a build envirnment:
>  * Java 8 or later
>  * Maven 3.3 or later
> However, compiling with Java 16 generates the following error:
> {code:java}
> [INFO] --- maven-compiler-plugin:3.6.2:compile (default-compile) @ arrow-format ---
> [INFO] Compiling 54 source files to /home/todd/Documents/arrow/java/format/target/classes
> [WARNING] Unable to autodetect 'javac' path, using 'javac' from the environment.
> [INFO] ------------------------------------------------------------------------
> [INFO] Reactor Summary for Apache Arrow Java Root POM 8.0.0-SNAPSHOT:
> [INFO] 
> [INFO] Apache Arrow Java Root POM ......................... SUCCESS [  5.170 s]
> [INFO] Arrow Format ....................................... FAILURE [  1.357 s]
> [INFO] Arrow Memory ....................................... SKIPPED
> [INFO] Arrow Memory - Core ................................ SKIPPED
> [INFO] Arrow Memory - Unsafe .............................. SKIPPED
> [INFO] Arrow Memory - Netty ............................... SKIPPED
> [INFO] Arrow Vectors ...................................... SKIPPED
> [INFO] Arrow Compression .................................. SKIPPED
> [INFO] Arrow Tools ........................................ SKIPPED
> [INFO] Arrow JDBC Adapter ................................. SKIPPED
> [INFO] Arrow Plasma Client ................................ SKIPPED
> [INFO] Arrow Flight ....................................... SKIPPED
> [INFO] Arrow Flight Core .................................. SKIPPED
> [INFO] Arrow Flight GRPC .................................. SKIPPED
> [INFO] Arrow Flight SQL ................................... SKIPPED
> [INFO] Arrow Flight Integration Tests ..................... SKIPPED
> [INFO] Arrow AVRO Adapter ................................. SKIPPED
> [INFO] Arrow Algorithms ................................... SKIPPED
> [INFO] Arrow Performance Benchmarks ....................... SKIPPED
> [INFO] ------------------------------------------------------------------------
> [INFO] BUILD FAILURE
> [INFO] ------------------------------------------------------------------------
> [INFO] Total time:  6.890 s
> [INFO] Finished at: 2022-04-28T15:39:11-06:00
> [INFO] ------------------------------------------------------------------------
> [ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.6.2:compile (default-compile) on project arrow-format: Compilation failure -> [Help 1]
> [ERROR] 
> [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
> [ERROR] Re-run Maven using the -X switch to enable full debug logging.
> [ERROR] 
> [ERROR] For more information about the errors and possible solutions, please read the following articles:
> [ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoFailureException
> [ERROR] 
> [ERROR] After correcting the problems, you can resume the build with the command
> [ERROR]   mvn <args> -rf :arrow-format
> todd@todd-ThinkPad-W541:~/Documents/arrow/java$ javac -version
> javac 16.0.1
> todd@todd-ThinkPad-W541:~/Documents/arrow/java$ /opt/
> apache-maven-3.8.5/ google/             maven/              
> todd@todd-ThinkPad-W541:~/Documents/arrow/java$ mvn -version
> Apache Maven 3.8.5 (3599d3414f046de2324203b78ddcf9b5e4388aa0)
> Maven home: /opt/maven
> Java version: 16.0.1, vendor: Private Build, runtime: /usr/lib/jvm/java-16-openjdk-amd64
> Default locale: en_US, platform encoding: UTF-8
> OS name: "linux", version: "5.13.0-40-generic", arch: "amd64", family: "unix"
> todd@todd-ThinkPad-W541:~/Documents/arrow/java$  {code}
> Reverting to Java 11 eliminated the error.
> It's worth noting that the error messages are opaque - there's no specific indication that the problem is a version incompatibility.  While there is a reference to supported Java versions in the [installation page|https://arrow.apache.org/docs/dev/java/install.html] of the documentation, it's easy enough for that to be missed in favor of the README.  It could be useful to also codify supported versions through [maven enforcement|https://maven.apache.org/enforcer/enforcer-rules/requireJavaVersion.html], supplying a less opaque error message when an incompatible Java version is used..



--
This message was sent by Atlassian Jira
(v8.20.7#820007)