Java 使用账号密码权限访问网络共享路径 `\\172.17.24.10\研发中心\文档` 的全面指南

$networking - Windows cannot access \\Shared Folder - How to remove the ...$

在企业应用中，常常需要通过Java程序访问网络共享路径，以读取、写入或管理文件。例如，访问路径 \\172.17.24.10\研发中心\文档 需要使用特定的账号和密码进行身份验证。本文将详细介绍多种在Java中实现这一功能的方法，包括使用内建的安全特性、第三方库如JCIFS和SMBJ，以及其他可行的解决方案。

一、使用第三方库访问SMB共享文件夹

访问SMB（Server Message Block）共享文件夹是实现网络文件访问的常见方式。Java并不直接支持SMB协议，因此需要借助第三方库。以下是两种流行的Java库：JCIFS和SMBJ，它们分别支持不同版本的SMB协议。

1. 使用JCIFS库访问共享文件夹

JCIFS是一个开源的Java库，主要支持SMB1协议，适用于访问Windows网络共享文件夹。尽管SMB1在现代系统中逐渐被弃用，但在一些遗留系统中仍然有其应用价值。

1.1 添加JCIFS依赖

如果使用Maven进行项目管理，可以在pom.xml中添加以下依赖：

<dependency>
    <groupId>org.samba.jcifs</groupId>
    <artifactId>jcifs</artifactId>
    <version>1.3.17</version>
</dependency>

如果不使用Maven，可以从JCIFS官方网站下载JAR文件，并将其添加到项目的类路径中。

1.2 编写Java代码

import jcifs.smb.NtlmPasswordAuthentication;
import jcifs.smb.SmbFile;
import jcifs.smb.SmbFileOutputStream;
import java.io.BufferedReader;
import java.io.InputStreamReader;

public class JCIFSExample {
    public static void main(String[] args) {
        try {
            // 认证信息
            String username = "yourUsername";
            String password = "yourPassword";
            String domain = ""; // 如果不需要域认证，可以留空

            // 共享文件夹路径
            String sharedFolder = "smb://172.17.24.10/研发中心/文档/";

            // 创建认证对象
            NtlmPasswordAuthentication auth = new NtlmPasswordAuthentication(domain, username, password);

            // 创建SmbFile对象
            SmbFile smbFile = new SmbFile(sharedFolder, auth);

            // 检查共享文件夹是否存在
            if (smbFile.exists()) {
                System.out.println("共享文件夹存在！");
                
                // 列出共享文件夹中的文件
                SmbFile[] files = smbFile.listFiles();
                for (SmbFile file : files) {
                    System.out.println("文件名: " + file.getName());
                }
                
                // 示例：下载一个文件
                String remoteFilePath = "smb://172.17.24.10/研发中心/文档/example.txt";
                SmbFile remoteFile = new SmbFile(remoteFilePath, auth);
                if (remoteFile.exists()) {
                    BufferedReader reader = new BufferedReader(new InputStreamReader(remoteFile.getInputStream()));
                    String line;
                    while ((line = reader.readLine()) != null) {
                        System.out.println(line);
                    }
                    reader.close();
                    System.out.println("文件读取完成！");
                }
            } else {
                System.out.println("共享文件夹不存在！");
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

在上述代码中：

NtlmPasswordAuthentication 用于创建身份验证对象，包含用户名、密码和域信息。
SmbFile 表示共享文件夹或文件，可以用于检查路径是否存在、列出文件、读取文件内容等操作。

1.3 注意事项

SMB版本兼容性：JCIFS仅支持SMB1协议，现代Windows系统默认禁用SMB1，可能需要手动启用或使用更现代的库。
安全性：SMB1协议存在已知的安全漏洞，建议仅在受信任的内部网络中使用。

2. 使用SMBJ库访问共享文件夹

SMBJ是一个更现代的Java库，支持SMB2和SMB3协议，适用于现代网络环境下的文件访问需求。相比JCIFS，SMBJ在性能和安全性方面有更好的表现。

2.1 添加SMBJ依赖

在Maven项目中添加以下依赖：

<dependency>
    <groupId>com.hierynomus</groupId>
    <artifactId>smbj</artifactId>
    <version>0.11.3</version>
</dependency>

或者从SMBJ GitHub仓库下载JAR文件并添加到项目中。

2.2 编写Java代码

import com.hierynomus.smbj.SMBClient;
import com.hierynomus.smbj.connection.Connection;
import com.hierynomus.smbj.session.Session;
import com.hierynomus.smbj.share.DiskShare;
import com.hierynomus.smbj.share.File;
import java.io.FileOutputStream;
import java.io.InputStream;

public class SMBJExample {
    public static void main(String[] args) {
        String hostname = "172.17.24.10";
        String shareName = "研发中心";
        String domain = ""; // 如果不需要域认证，可以留空
        String username = "yourUsername";
        String password = "yourPassword";
        
        SMBClient client = new SMBClient();
        
        try (Connection connection = client.connect(hostname)) {
            // 认证
            Session session = connection.authenticate(new com.hierynomus.smbj.auth.AuthenticationContext(username, password.toCharArray(), domain));
            
            // 连接到共享文件夹
            DiskShare share = (DiskShare) session.connectShare(shareName);
            
            // 列出共享文件夹中的文件
            for (com.hierynomus.smbj.share.FileIdBothDirectoryInformation file : share.list("")) {
                System.out.println("文件名: " + file.getFileName());
            }
            
            // 示例：下载一个文件
            String filePath = "文档/example.txt";
            if (share.fileExists(filePath)) {
                File remoteFile = share.openFile(
                    filePath,
                    com.hierynomus.msdtyp.AccessMask.GENERIC_READ,
                    com.hierynomus.smbj.share.FileAttributes.FILE_ATTRIBUTE_NORMAL,
                    com.hierynomus.smbj.share.ShareAccess.ALL,
                    com.hierynomus.smbj.share.FileDisposition.FILE_OPEN,
                    null
                );
                
                try (InputStream in = remoteFile.getInputStream();
                     FileOutputStream out = new FileOutputStream("C:/local_example.txt")) {
                     
                    byte[] buffer = new byte[1024];
                    int bytesRead;
                    while ((bytesRead = in.read(buffer)) > 0) {
                        out.write(buffer, 0, bytesRead);
                    }
                    System.out.println("文件下载完成！");
                }
            }
            
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            client.close();
        }
    }
}

上述代码功能包括：

使用SMBClient创建客户端连接到指定主机。
通过AuthenticationContext进行身份验证。
连接到指定的共享文件夹（研发中心）。
列出共享文件夹中的文件，并下载指定文件。

2.3 注意事项

SMB版本兼容性：SMBJ支持SMB2和SMB3协议，适用于现代Windows系统。
性能和安全性：相比JCIFS，SMBJ在处理大文件和高延迟网络环境下表现更佳，并且支持更强的加密和安全特性。

二、使用Java内建的安全特性管理文件访问权限

Java提供了一套内建的安全管理机制，通过SecurityManager和FilePermission类，可以动态控制文件和目录的访问权限。这在需要细粒度权限控制的应用中尤为有用。

1. 使用SecurityManager和FilePermission

1.1 创建SecurityManager对象

System.setSecurityManager(new SecurityManager());

1.2 配置FilePermission

通过FilePermission类，可以为特定路径设置读、写、执行等权限。例如：

FilePermission permission = new FilePermission("\\\\172.17.24.10\\研发中心\\文档", "read,write");
    System.getSecurityManager().checkPermission(permission);

上述代码检查当前运行环境是否具有对指定路径的读取和写入权限。

2. 动态控制权限

通过在代码中动态修改权限，可以根据不同的需求调整访问控制策略。这种方法适用于需要在运行时根据用户角色或其他条件调整权限的场景。

SecurityManager securityManager = System.getSecurityManager();
    if (securityManager == null) {
        securityManager = new SecurityManager();
        System.setSecurityManager(securityManager);
    }

    FilePermission readPermission = new FilePermission("\\\\172.17.24.10\\研发中心\\文档", "read");
    securityManager.checkPermission(readPermission);

3. 注意事项

权限配置：通常通过策略文件（policy文件）来配置权限，而不是在代码中直接设置。
安全性：确保SecurityManager正确配置，以防止未经授权的访问。

三、使用Spring Security进行权限管理

Spring Security是一个功能强大的安全框架，提供了全面的身份验证和授权机制。通过整合Spring Security，可以实现对文件访问的细粒度控制。

1. 配置Spring Security

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
                .antMatchers("/file/**").hasRole("USER")
                .and()
            .formLogin();
    }

    @Override
    protected void configure(AuthenticationManagerBuilder auth) throws Exception {
        auth.inMemoryAuthentication()
            .withUser("user").password(passwordEncoder().encode("password")).roles("USER");
    }

    @Bean
    public PasswordEncoder passwordEncoder() {
        return new BCryptPasswordEncoder();
    }
}

上述配置实现了基于角色的访问控制，只有具有“USER”角色的用户才能访问以/file/开头的路径。

2. 使用注解进行权限控制

@Service
public class FileService {

    @PreAuthorize("hasRole('USER')")
    public void readFile(String filePath) {
        // 文件读取逻辑
    }
}

通过@PreAuthorize注解，可以在方法级别进行权限检查，确保只有授权用户才能执行相应操作。

3. 注意事项

集成复杂性：Spring Security功能强大，但配置相对复杂，需根据项目需求进行精准配置。
灵活性：支持多种认证方式（如内存、数据库、LDAP等），适用于不同的应用场景。

四、基于数据库或文件系统的权限控制

另一种权限管理方式是将用户权限存储在数据库或文件系统中，并在访问文件前进行权限验证。这种方法需要自定义实现，但具有高度的灵活性和扩展性。

1. 数据库权限控制

1.1 设计数据库表

CREATE TABLE users (
    id INT PRIMARY KEY,
    username VARCHAR(255) UNIQUE NOT NULL,
    password VARCHAR(255) NOT NULL
);

CREATE TABLE permissions (
    id INT PRIMARY KEY,
    user_id INT,
    permission VARCHAR(255),
    FOREIGN KEY (user_id) REFERENCES users(id)
);

1.2 编写权限检查逻辑

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.ResultSet;

public class DatabasePermissionCheck {
    public boolean hasReadPermission(int userId, String filePath) {
        String query = "SELECT permission FROM permissions WHERE user_id = ? AND permission = ?";
        try (Connection conn = DriverManager.getConnection("jdbc:yourdb:url", "username", "password");
             PreparedStatement stmt = conn.prepareStatement(query)) {
             
            stmt.setInt(1, userId);
            stmt.setString(2, "read");
            ResultSet rs = stmt.executeQuery();
            
            return rs.next();
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
    }
}

2. 文件系统权限控制

2.1 设置文件系统权限

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.attribute.PosixFilePermission;
import java.nio.file.attribute.PosixFilePermissions;
import java.util.Set;

public class FileSystemPermissionControl {
    public void setFilePermissions(String filePath) {
        Path path = Paths.get(filePath);
        Set<PosixFilePermission> perms = PosixFilePermissions.fromString("rwxr--r--");
        try {
            Files.setPosixFilePermissions(path, perms);
            System.out.println("权限设置成功！");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

上述代码通过Java NIO.2 API设置POSIX文件权限，适用于Unix-like系统。

3. 注意事项

数据库设计：确保权限表能够灵活表示不同级别和类型的权限。
性能考虑：频繁的数据库查询可能影响性能，需适当优化。
文件系统兼容性：POSIX权限仅适用于支持该特性的文件系统，需根据部署环境选择合适的方法。

五、使用Java内建的URL和URLConnection类

Java的内建库也提供了一种简单的方式，通过URL和URLConnection类访问网络资源。然而，这种方法功能较为有限，通常只适用于简单的文件读取操作。

1. 编写Java代码

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.URL;
import java.net.URLConnection;
import java.util.Base64;

public class URLConnectionExample {
    public static void main(String[] args) {
        try {
            String username = "yourUsername";
            String password = "yourPassword";
            String sharedFile = "file://172.17.24.10/研发中心/文档/example.txt";
            
            // 编码认证信息
            String auth = username + ":" + password;
            String encodedAuth = Base64.getEncoder().encodeToString(auth.getBytes());
            
            // 创建URL对象
            URL url = new URL(sharedFile);
            
            // 打开连接
            URLConnection connection = url.openConnection();
            connection.setRequestProperty("Authorization", "Basic " + encodedAuth);
            
            // 读取文件内容
            try (BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()))) {
                String line;
                while ((line = reader.readLine()) != null) {
                    System.out.println(line);
                }
            }
            
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

2. 注意事项

权限限制：此方法依赖于操作系统和网络权限，可能无法执行复杂的文件操作如写入。
功能限制：仅适用于读取文件内容，无法进行文件上传或删除等操作。

六、使用Apache Commons VFS进行虚拟文件系统访问

Apache Commons VFS（Virtual File System）是一个功能强大的文件系统访问库，支持多种协议，包括SMB/CIFS。它提供了统一的API接口，简化了不同协议的文件操作。

1. 添加依赖

<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-vfs2</artifactId>
    <version>2.9.0</version>
</dependency>

2. 编写Java代码

import org.apache.commons.vfs2.FileObject;
import org.apache.commons.vfs2.FileSystemManager;
import org.apache.commons.vfs2.VFS;
import org.apache.commons.vfs2.auth.StaticUserAuthenticator;
import org.apache.commons.vfs2.impl.DefaultFileSystemConfigBuilder;

public class CommonsVFSExample {
    public static void main(String[] args) {
        try {
            String username = "yourUsername";
            String password = "yourPassword";
            String sharedFolder = "smb://172.17.24.10/研发中心/文档/";
            
            // 设置认证信息
            StaticUserAuthenticator auth = new StaticUserAuthenticator(null, username, password);
            FileSystemManager fsManager = VFS.getManager();
            DefaultFileSystemConfigBuilder.getInstance().setUserAuthenticator(fsManager.getFileSystemOptions(), auth);
            
            // 访问共享文件夹
            FileObject fileObject = fsManager.resolveFile(sharedFolder);
            if (fileObject.exists()) {
                FileObject[] files = fileObject.getChildren();
                for (FileObject file : files) {
                    System.out.println("文件名: " + file.getName().getBaseName());
                }
            } else {
                System.out.println("共享文件夹不存在！");
            }
            
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

3. 注意事项

依赖库：确保所有Apache Commons VFS的相关依赖库都已正确添加。
性能：相比JCIFS，Commons VFS在处理大批量文件时性能可能稍逊，但功能更全面。

七、基于云存储服务的解决方案

如果网络共享文件夹存储在云端，如阿里云OSS或AWS S3，可以使用相应的云存储SDK进行文件访问和权限管理。这种方法适用于分布式或云原生应用。

1. 使用阿里云OSS SDK

import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;

public class AliyunOSSExample {
    public static void main(String[] args) {
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        String accessKeyId = "yourAccessKeyId";
        String accessKeySecret = "yourAccessKeySecret";
        String bucketName = "examplebucket";
        String objectName = "研发中心/文档/example.txt";
        
        // 创建OSSClient实例
        OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
        
        try {
            // 下载文件
            ossClient.getObject(new com.aliyun.oss.model.GetObjectRequest(bucketName, objectName), new java.io.File("C:/local_example.txt"));
            System.out.println("文件下载完成！");
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            // 关闭OSSClient
            ossClient.shutdown();
        }
    }
}