From ae64a7d3a056f4463d3266b360f6e5aea819d883 Mon Sep 17 00:00:00 2001
From: juanf <juanf@ethz.ch>
Date: Fri, 9 Jun 2023 21:11:55 +0200
Subject: [PATCH] SSDM-13521: Providing same test coverage for new Posix class
as for Unix class
---
.../ch/systemsx/cisd/common/io/Posix.java | 45 ++++++++++++++++---
1 file changed, 39 insertions(+), 6 deletions(-)
diff --git a/lib-commonbase/source/java/ch/systemsx/cisd/common/io/Posix.java b/lib-commonbase/source/java/ch/systemsx/cisd/common/io/Posix.java
index 538aa63c3e4..b111a65243f 100644
--- a/lib-commonbase/source/java/ch/systemsx/cisd/common/io/Posix.java
+++ b/lib-commonbase/source/java/ch/systemsx/cisd/common/io/Posix.java
@@ -187,6 +187,10 @@ public final class Posix
return getGid();
}
+ /**
+ * Sets the owner of <var>fileName</var> to the specified <var>uid</var> and <var>gid</var> values.
+ * Dereferences a symbolic link.
+ */
public static void setOwner(String path, int userId, int groupId)
{
try
@@ -567,6 +571,11 @@ public final class Posix
return symbolicLinkOrNull != null;
}
+ /**
+ * Returns the number of hard links for the <var>linkName</var>. Does not dereference a symbolic link.
+ *
+ * @throws IOExceptionUnchecked If the information could not be obtained, e.g. because the link does not exist.
+ */
public int getNumberOfHardLinks() throws IOException
{
Number count = (Number) Files.getAttribute(path, "unix:nlink", LinkOption.NOFOLLOW_LINKS);
@@ -656,6 +665,12 @@ public final class Posix
return getLinkInfo(absolutePath, true);
}
+ /**
+ * Returns the information about <var>linkName</var>. If <code>readSymbolicLinkTarget == true</code>, then the symbolic link target is read when
+ * <var>linkName</var> is a symbolic link.
+ *
+ * @throws IOExceptionUnchecked If the information could not be obtained, e.g. because the link does not exist.
+ */
public static Stat getLinkInfo(String pathAsString, boolean readSymbolicLinkTarget)
{
try {
@@ -722,20 +737,38 @@ public final class Posix
}
}
+ /**
+ * Returns the information about <var>linkName</var>, or {@link NullPointerException}, if the information could not be obtained, e.g. because the
+ * link does not exist.
+ */
public static Stat tryGetLinkInfo(String pathAsString){
return getLinkInfo(pathAsString, true);
}
+ /**
+ * Returns the information about <var>fileName</var>, or {@link NullPointerException}, if the information could not be obtained, e.g. because the
+ * file does not exist.
+ */
public static Stat tryGetFileInfo(String absolutePath)
{
return getFileInfo(absolutePath, true);
}
+ /**
+ * Returns the information about <var>fileName</var>.
+ *
+ * @throws IOExceptionUnchecked If the information could not be obtained, e.g. because the file does not exist.
+ */
public static Stat getFileInfo(String pathAsString)
{
return getFileInfo(pathAsString, true);
}
+ /**
+ * Returns the information about <var>fileName</var>.
+ *
+ * @throws IOExceptionUnchecked If the information could not be obtained, e.g. because the file does not exist.
+ */
public static Stat getFileInfo(String pathAsString, boolean readSymbolicLinkTarget)
throws IOExceptionUnchecked
{
@@ -799,13 +832,13 @@ public final class Posix
}
}
+ /**
+ * Sets the access mode of <var>filename</var> to the specified <var>mode</var> value.
+ * Dereferences a symbolic link.
+ */
public static void setAccessMode(String path, short mode) throws IOExceptionUnchecked {
- try {
- Set<PosixFilePermission> permissions = getFilePermissionsMode(mode);
- Files.setPosixFilePermissions(Path.of(path), permissions);
- } catch (IOException e) {
- throw new IOExceptionUnchecked(e);
- }
+ Set<PosixFilePermission> permissions = getFilePermissionsMode(mode);
+ setAccessMode(path, permissions);
}
--
GitLab