Deprecate thin wrapper methods that just delegate to Java Files API

Co-authored-by: slachiewicz <[email protected]>

Author: Copilot

src/main/java/org/codehaus/plexus/components/io/attributes/AttributeUtils.java

@@ -105,6 +105,10 @@ public static Set<PosixFilePermission> getPermissions(int mode) {
         return perms;
     }
 
+    /**
+     * @deprecated Use {@link Files#readAttributes(Path, Class, java.nio.file.LinkOption...)} directly
+     */
+    @Deprecated
     @Nonnull
     public static PosixFileAttributes getPosixFileAttributes(@Nonnull Path path) throws IOException {
         return Files.readAttributes(path, PosixFileAttributes.class, LinkOption.NOFOLLOW_LINKS);
@@ -143,6 +147,10 @@ public static boolean isUnix(Path path) {
         return path.getFileSystem().supportedFileAttributeViews().contains("unix");
     }
 
+    /**
+     * @deprecated Use {@link Files#getFileAttributeView(Path, Class, java.nio.file.LinkOption...)} directly
+     */
+    @Deprecated
     @Nullable
     public static FileOwnerAttributeView getFileOwnershipInfo(@Nonnull Path path) throws IOException {
         try {

src/main/java/org/codehaus/plexus/components/io/attributes/SymlinkUtils.java

@@ -33,7 +33,9 @@ public class SymlinkUtils {
      * @param symlink A path that is a symlink
      * @return A path that is the target of the symlink
      * @throws java.io.IOException
+     * @deprecated Use {@link Files#readSymbolicLink(Path)} directly
      */
+    @Deprecated
     public static @Nonnull Path readSymbolicLink(@Nonnull Path symlink) throws IOException {
         return Files.readSymbolicLink(symlink);
     }
@@ -51,6 +53,10 @@ public class SymlinkUtils {
         return readSymbolicLink(symlink.toPath()).toFile();
     }
 
+    /**
+     * @deprecated Use {@link Files#createSymbolicLink(Path, Path, java.nio.file.attribute.FileAttribute[])} directly
+     */
+    @Deprecated
     public static @Nonnull Path createSymbolicLink(@Nonnull Path symlink, Path target) throws IOException {
         if (!Files.exists(symlink, LinkOption.NOFOLLOW_LINKS)) {
             return Files.createSymbolicLink(symlink, target);