Java中SMB的應用

目錄

• SMB 服務操做
  • Ⅰ SMB簡介
  • Ⅱ SMB配置
    • 2.1 Windows SMB
  • Ⅲ 添加SMB依賴
  • Ⅳ 路徑格式
  • Ⅴ 操做共享
  • Ⅵ 登陸驗證

SMB 服務操做

Ⅰ SMB簡介

​ SMB(全稱是Server Message Block)是一個協議名，它能被用於Web鏈接和客戶端與服務器之間的信息溝通。SMB協議做爲一種局域網文件共享傳輸協議，常被用來做爲共享文件安全傳輸研究的平臺。
​ Windows操做系統都包括了客戶機和服務器 SMB協議支持。Microsoft 爲 Internet 提供了SMB的開源版本，即通用Internet文件系統CIFS。與現有 Internet 應用程序如文件傳輸協議FTP相比， CIFS 靈活性更大。對於UNIX系統，可以使用一種稱爲Samba的共享軟件。

Ⅱ SMB配置

2.1 Windows SMB

2.1.1 配置服務

​ 在本地機上以Windows10舉例 ：在控制面板 -->程序-->程序和功能-->啓用或關閉Windows功能-->SMB 1.0/cifs file sharing support勾選SMB 1.0/CIFS Client和SMB 1.0/CIFS Server

2.1.2 驗證服務

​ 開啓以後來驗證一下SMB是否正確開啓：在DOS命令窗口用PowerShell命令進入程序輸入Get-SmbServerConfiguration | Select EnableSMB1Protocol, EnableSMB2Protocol查看服務狀態，如圖所示：

2.1.3 共享文件

​ 在D盤新建一個測試文件D:\Test\SmbTest\GoalTest，右鍵菜單-->授予訪問權限-->特定用戶選擇一個用戶進行受權，如圖所示：

​ 受權給用戶以後會提示你的文件夾已共享，在DOS窗口輸入彈窗提示的共享鏈接\\DESKTOP-D5DVINV\Test便可進入共享文件夾，右擊共享文件夾還能夠設置訪問密碼，更改訪問用戶等等。

Ⅲ 添加SMB依賴

​ 在pom.xml中添加SMB服務相關的依賴：

<!-- 引用SmbFile類的jar包  -->
<dependency>
       <groupId>jcifs</groupId>
       <artifactId>jcifs</artifactId>
       <version>1.3.17</version>
</dependency>

Ⅳ 路徑格式

​ 在Java中SMB路徑請求格式有以下三種狀況：

• 若是是無需密碼的共享，格式相似：smb://ip/sharefolder(例如:smb://192.168.0.77/test)
• 若是須要用戶名和密碼，格式相似：smb://username:password@ip/sharefolder(例:smb://chb:123456@192.168.0.1/test)
• 若是用戶名密碼和域名，格式相似：smb:域名;用戶名:密碼@目的IP/文件夾/文件名.xxx(例:smb://orcl;wangjp:Password123@192.168.193.13/Test)

Ⅴ 操做共享

​ 以上步驟以後，就完成了在Windows上創建了一個SMB文件服務器和必要準備工做，接下來就是簡單的代碼環節，上傳和下載的邏輯也比較簡單，對SMB共享文件的操做其實就是處理SmbFile對象。

import jcifs.smb.SmbFile;
import jcifs.smb.SmbFileInputStream;
import jcifs.smb.SmbFileOutputStream;
import org.springframework.util.FileCopyUtils;
import java.io.*;
/**
 * @author: Create By WangJP
 * @description: SMB服務操做相關
 * @date: 2020/1/1
 */
public class Demo {

    private static final String SMB_SHARE_FOLDER = "smb://username:password@192.168.1.103/Test/";
    private static final String SHARE_FOLDER_PATH = "SmbTest\\GoalTest";
    private static final String FILE_NAME = "test.txt";
    private static final String LOCAL_DIR = "D:\\LocalTest";

    public static void main(String[] args) {
        downloadSmbFile(SMB_SHARE_FOLDER, SHARE_FOLDER_PATH, FILE_NAME, LOCAL_DIR);
        uploadFile(SMB_SHARE_FOLDER, SHARE_FOLDER_PATH, FILE_NAME, LOCAL_DIR);
    }

    /**
     * 從SMB共享文件夾下載文件到本地
     * @param remoteUrl       SMB請求路徑Url
     * @param shareFolderPath 共享文件夾中SMB目標文件存放的完整路徑
     * @param fileName        文件名
     * @param localDir        本地文件夾
     */
    public static void downloadSmbFile(String remoteUrl, String shareFolderPath, String fileName, String localDir) {
        InputStream in = null;
        OutputStream out = null;
        try {
            SmbFile smbfile = new SmbFile(remoteUrl + shareFolderPath + File.separator + fileName);
            File localFile = new File(localDir + File.separator + fileName);
            in = new BufferedInputStream(new SmbFileInputStream(smbfile));
            out = new BufferedOutputStream(new FileOutputStream(localFile));
            FileCopyUtils.copy(in, out);
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            closeStreanm(in, out);
        }
    }

    /**
     * 將本地文件夾中的文件上傳到SMB共享文件夾（與下載相似）
     * @param remoteUrl       SMB請求路徑Url
     * @param shareFolderPath 共享文件夾中SMB目標文件存放的完整路徑
     * @param fileName        文件名
     * @param localDir        本地文件夾
     */
    private static void uploadFile(String remoteUrl, String shareFolderPath, String fileName, String localDir) {
        InputStream in = null;
        OutputStream out = null;
        try {
            SmbFile smbfile = new SmbFile(remoteUrl + shareFolderPath + File.separator + fileName);
            File localFile = new File(localDir + File.separator + fileName);
            in = new BufferedInputStream(new FileInputStream(localFile));
            out = new BufferedOutputStream(new SmbFileOutputStream(smbfile));
            FileCopyUtils.copy(in, out);
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            closeStreanm(in, out);
        }
    }

    private static void closeStreanm(InputStream in, OutputStream out) {
        try {
            if (in != null) {
                in.close();
            }
            if (out != null) {
                out.close();
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

​ 本身工做中有一個業務需求是要檢測SMB共享目錄中的某個文件是否存在，經過下載上傳的例子，學習到獲取 SmbFile 對象須要特定的的屬性（url canon等等）構建，處理方法上有不少和File對象相似，代碼示例以下：

/**
     * 檢驗SMB共享文件是否存在
     * @param remoteUrl       SMB請求路徑Url
     * @param shareFolderPath 共享文件夾中SMB目標文件存放的完整路徑
     * @param fileName        文件名
     * @return true:存在 false:不存在
     */
    public static boolean checkSmbFile(String remoteUrl, String shareFolderPath, String fileName) {
        boolean result = false;
        try {
            SmbFile smbfile = new SmbFile(remoteUrl + shareFolderPath + File.separator + fileName);
            result = smbfile.exists();
        } catch (Exception e) {
            e.printStackTrace();
        }
        return result;
    }

Ⅵ 登陸驗證

​ SMB的登陸驗證主要是爲解決帳號密碼中存在特殊字符的問題（好比轉義字符，連接裏的特定字符），存在特殊字符的帳號密碼每每會報出下列異常：

Connected to the target VM, address: '127.0.0.1:54593', transport: 'socket'
jcifs.smb.SmbAuthException: Logon failure: unknown user name or bad password.

​ 這時爲了構建合法的SmbFile對象，咱們就須要先進行登陸驗證，再去嘗試構建該對象：

private static String domainip = "192.168.170.13";
private static String username = "username";
private static String password = "password";
private static String remoteurl = "smb://192.168.170.13/share";
//進行帳號IP地址登陸驗證
NtlmPasswordAuthentication auth = new NtlmPasswordAuthentication(domainip, username, password);  
SmbFile smbfile = new SmbFile(remoteurl+"//"+folderpath,auth);