samepath: java >= 11

Author: scivision

+stdlib/device.m

@@ -7,17 +7,18 @@
   path {mustBeTextScalar}
 end
 
+i = [];
+
 if stdlib.exists(path)
   if stdlib.isoctave()
     [s, err] = stat(path);
     if err == 0
       i = s.dev;
     end
-  else
+  elseif stdlib.has_java() && stdlib.java_api() >= 11
+    % Java 1.8 is buggy in some corner cases, so we require at least 11.
     i = java.nio.file.Files.getAttribute(javaPathObject(path), "unix:dev", javaLinkOption());
   end
-else
-  i = [];
 end
 
 end

+stdlib/inode.m

@@ -15,11 +15,10 @@
     if err == 0
       i = s.ino;
     end
-  else
+  elseif stdlib.has_java() && stdlib.java_api() >= 11
+    % Java 1.8 is buggy in some corner cases, so we require at least 11.
     i = java.nio.file.Files.getAttribute(javaPathObject(path), "unix:ino", javaLinkOption());
   end
-else
-  i = [];
 end
 
 end

+stdlib/java_api.m

@@ -9,7 +9,7 @@
 
 a = strsplit(v, '.');
 if(isempty(a))
-  api = 0;
+  api = [];
   return
 end
 
@@ -22,4 +22,4 @@
 end
 
 
-%!assert(java_api() > 0)
+%!assert(!isempty(java_api()))

+stdlib/samepath.m

@@ -28,9 +28,9 @@
   y = e1 == 0 && e2 == 0 && ...
       r1.ino == r2.ino && r1.dev == r2.dev;
 
-elseif stdlib.has_java()
+elseif stdlib.has_java() && stdlib.java_api() >= 11
 % https://docs.oracle.com/en/java/javase/24/docs/api/java.base/java/nio/file/Files.html#isSameFile(java.nio.file.Path,java.nio.file.Path)
-
+% Java 1.8 is buggy in some corner cases, so we require at least 11.
   y = java.nio.file.Files.isSameFile(javaPathObject(path1), javaPathObject(path2));
 
 else

.github/workflows/ci.yml

@@ -56,8 +56,10 @@ jobs:
     - name: Check CodeIssues
       uses: ./.github/workflows/composite-check
 
+# https://www.mathworks.com/support/requirements/openjdk.html
+# old matlab may segfault with too-new JDK
     - name: matlab_jenv JDK 11
-      if: ${{ matrix.release < 'R2025a' && !startsWith(matrix.release, 'latest') }}
+      if: ${{ matrix.release >= 'R2023a' && matrix.release < 'R2025a' && !startsWith(matrix.release, 'latest') }}
       run: matlab_jenv ${JAVA_HOME_11_X64}
 
     - name: Matlab tell Java Version

Readme_java.md

@@ -36,7 +36,8 @@ Get the Java version:
 stdlib.java_version()
 ```
 
-From before Matlab R2019b to at least Matlab R2025a, the Matlab factory Java version is 1.8, which is adequate for all Matlab-stdlib functionality.
+From before Matlab R2019b to at least Matlab R2025a, the Matlab factory Java version is 1.8, which is adequate for most Matlab-stdlib functionality.
+Java 11 or newer is recommended for more robustness if relying on Java functionality.
 
 If desired (not used by Matlab-stdlib), one can use non-factory Java classes in
 [Matlab](](https://www.mathworks.com/help/matlab/matlab_external/static-path-of-java-class-path.html))

test/TestJava.m

@@ -15,6 +15,7 @@ function java_required(tc)
 
 function test_inode(tc)
 tc.assumeFalse(ispc(), "not for Windows")
+tc.assumeGreaterThanOrEqual(stdlib.java_api(), 11)
 
 tc.verifyEqual(stdlib.inode("."), stdlib.inode(pwd()))
 tc.verifyEmpty(stdlib.inode(tempname))
@@ -23,6 +24,7 @@ function test_inode(tc)
 
 function test_device(tc)
 tc.assumeFalse(ispc(), "not for Windows")
+tc.assumeGreaterThanOrEqual(stdlib.java_api(), 11)
 
 tc.verifyEqual(stdlib.device("."), stdlib.device(pwd()))
 tc.verifyEmpty(stdlib.device(tempname))