Android app通过jcifs-ng实现Samba连接共享文件夹

Android端使用Samba连接共享文件夹,下载或上传文件的功能实现。如果你是用jcifs工具包,那么你要注意jcifs-ng 和 jcifs 支持的SMB版本区别。

JCIFS-NG的github地址
JCIFS官网地址 这里有关于jciffsjcifs-codelibsjcifs-ngsmbj的详细介绍

对比

  • 支持的smb版本
    jcifs:

    仅支持SMB 1.0(CIFS), jcifs 最初是针对 SMB 1.0(CIFS)协议开发的,因此它是对 SMB 1.0 版本的最好支持。
    jcifs-ng 2.1:

    此版本默认启用SMB2支持,并包含一些实验性的SMB3.0支持。

    协商的协议级别现在可以使用jcifs.smb.client.minVersion和jcifs.smb.client.maxVersion进行控制(这会弃用jcifs.smb.client.enableSMB2/jcifs.sm b.client.disableSMB1属性)。默认的最小/最大版本是SMB1到SMB210。

    此版本禁止服务器浏览(即服务器/工作组枚举),并包含有关身份验证的一些突破性API更改。
    jcifs-ng 2.0:

    此版本支持SMB2(2.02协议级别),目前仅在配置了jcifs.smb.client.enableSMB2的情况下宣布支持SMB2,但如果服务器不支持SMB1方言,也可以选择支持SMB2。

  • 开发状态:
    jcifs: jcifs 是最初由 Mike Allen 开发的 Java CIFS 实现,最后一个官方发布版本是 1.3.19,发布于 2007 年。此后,jcifs 进入了维护模式,不再进行主要更新。
    jcifs-ng: jcifs-ng(jcifs-next generation)是基于 jcifs 的一个分支,由 Alexander Böhm 等人开发。它是对 jcifs 的改进和扩展,具有更现代化的代码结构和更多功能。jcifs-ng 目前仍在活跃地开发和维护。

  • 功能和性能:

    jcifs-ng 在功能和性能上进行了改进和优化,相比于原始的 jcifs,它提供了更多的功能和更好的性能。例如,jcifs-ng 支持更多的 SMB 协议特性,并且在速度和稳定性方面进行了改进。

  • API 和使用方式:

    jcifs-ng 在 API 和使用方式上与 jcifs 类似,但可能会有一些差异和改进。因此,如果你已经熟悉 jcifs,那么迁移到 jcifs-ng 应该相对容易。

这里使用的是jcifs-ng 2.1.9

添加依赖

bash 复制代码
implementation 'eu.agno3.jcifs:jcifs-ng:2.1.9'

代码实现(Kotlin)

kotlin 复制代码
package com.xxx.customer

import android.util.Log
import androidx.lifecycle.LifecycleOwner
import androidx.lifecycle.lifecycleScope
import jcifs.CIFSContext
import jcifs.context.SingletonContext
import jcifs.smb.SmbException
import jcifs.smb.SmbFile
import jcifs.smb.SmbFileInputStream
import jcifs.smb.SmbFileOutputStream
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.GlobalScope
import kotlinx.coroutines.launch
import java.io.BufferedInputStream
import java.io.BufferedOutputStream
import java.io.File
import java.io.FileInputStream
import java.io.FileOutputStream
import java.io.IOException
import java.util.Properties


class SambaManager {

	private val SAMBA_SERVER_IP = "your server ip"
	private val SAMBA_USERNAME = "username"
	private val SAMBA_PASSWORD = "password"
	
    companion object {
        private const val TAG = "SambaManager"
        private var mCIFSContext: CIFSContext? = null

    }

    /**
     * 上传文件到共享文件夹指定目录
     * @param viewLifecycleOwner
     * @param localFilePathList 待上传的本地文件路径列表
     * @param remoteFolderPath 要上传到的远端路径,
     *        如果共享文件夹为shared_folder,则该路径应该包含shared_folder,
     *        如:shared_folder/ 或 shared_folder/xxx
     * @param onComplete 任务完成厚的回调
     */
    fun uploadFiles(
        viewLifecycleOwner: LifecycleOwner,
        localFilePathList: MutableList<String>,
        remoteFolderPath: String,
        onComplete: (Int) -> Unit
    ) {
        viewLifecycleOwner.lifecycleScope.launch(Dispatchers.IO) {
            var count = 0
            val smbContext = getCIFSContext()
            for (filePath in localFilePathList) {
                val localFile = File(filePath)
                if (!localFile.exists()) {
                    continue
                }
                val folderUrl = "smb://${SAMBA_SERVER_IP}/${remoteFolderPath.trim('/')}"
                val smbFolder = try {
                    SmbFile(folderUrl, smbContext)
                } catch (e: IOException) {
                    Log.e(TAG, "Failed to create SmbFile", e)
                    continue
                }
                //创建目录
                smbFolder.mkdirs()

                val url = "$folderUrl/${localFile.name}"
                val smbFile = try {
                    SmbFile(url, smbContext)
                } catch (e: IOException) {
                    Log.e(TAG, "Failed to create SmbFile", e)
                    continue
                }

                try {
                    if (smbFile.exists()) {
                        smbFile.delete()
                    }
                    smbFile.createNewFile()
                } catch (e: SmbException) {
                    Log.e(TAG, "Failed to create new SmbFile", e)
                    continue
                }

                try {
                    val outputStream = BufferedOutputStream(SmbFileOutputStream(smbFile))
                    val inputStream = BufferedInputStream(FileInputStream(localFile))
                    inputStream.use { input ->
                        outputStream.use { output ->
                            val buffer = ByteArray(1024)
                            var bytesRead: Int
                            while (input.read(buffer).also { bytesRead = it } != -1) {
                                output.write(buffer, 0, bytesRead)
                            }
                        }
                    }
                    count++
                } catch (e: IOException) {
                    Log.e(TAG, "Failed to download file", e)
                    continue
                }
            }
            onComplete(count)
        }
    }


    /**
     * 批量下载文件
     * @param viewLifecycleOwner
     * @param remoteFilePathList 需要下载的远端文件路径列表
     * @param localFolderPath 本地文件夹路径,用于保存下载的文件
     * @param onComplete 任务完成后的回调
     */
    fun downloadFiles(
        viewLifecycleOwner: LifecycleOwner,
        remoteFilePathList: MutableList<String>,
        localFolderPath: String,
        onComplete: (Int) -> Unit
    ) {
        viewLifecycleOwner.lifecycleScope.launch(Dispatchers.IO) {
            var count = 0

            val smbContext = getCIFSContext()

            for (path in remoteFilePathList) {
                val strList = path.split("/")
                var fileName = strList[strList.lastIndex]

                val url = "smb://${SAMBA_SERVER_IP}/${path.trimStart('/')}"
                val smbFile = try {
                    SmbFile(url, smbContext)
                } catch (e: IOException) {
                    Log.e(TAG, "Failed to create SmbFile", e)
                    continue
                }

                if (!smbFile.exists()) {
                    Log.e(TAG, "File does not exist: ${path}")
                    continue
                }

                try {
                    val localFile = File("$localFolderPath/$fileName")
                    if (!localFile.exists()) {
                        localFile.createNewFile()
                    }
                    val inputStream = BufferedInputStream(SmbFileInputStream(smbFile))
                    val outputStream = BufferedOutputStream(FileOutputStream(localFile))
                    inputStream.use { input ->
                        outputStream.use { output ->
                            val buffer = ByteArray(1024)
                            var bytesRead: Int
                            while (input.read(buffer).also { bytesRead = it } != -1) {
                                output.write(buffer, 0, bytesRead)
                            }
                        }
                    }
                    count++
                } catch (e: IOException) {
                    Log.e(TAG, "Failed to download file", e)
                    continue
                }
            }
            onComplete(count)
        }
    }

    /**
     * 获取包含配置参数的CIFSContext
     */
    private fun getCIFSContext(): CIFSContext {
        if (mCIFSContext == null) {
            val properties = Properties()
            properties.setProperty("jcifs.smb.client.domain", SAMBA_SERVER_IP);
            properties.setProperty("jcifs.smb.client.username", SAMBA_USERNAME);
            properties.setProperty("jcifs.smb.client.password", SAMBA_PASSWORD);
            SingletonContext.init(properties) //init只能初始化一次
            mCIFSContext = SingletonContext.getInstance()
        }
        return mCIFSContext!!
    }
}
相关推荐
apihz21 分钟前
域名WHOIS信息查询免费API使用指南
android·开发语言·数据库·网络协议·tcp/ip
问道飞鱼38 分钟前
【移动端知识】移动端多 WebView 互访方案:Android、iOS 与鸿蒙实现
android·ios·harmonyos·多webview互访
aningxiaoxixi1 小时前
Android 之 audiotrack
android
枷锁—sha1 小时前
【DVWA系列】——CSRF——Medium详细教程
android·服务器·前端·web安全·网络安全·csrf
Cao_Shixin攻城狮5 小时前
Flutter运行Android项目时显示java版本不兼容(Unsupported class file major version 65)的处理
android·java·flutter
呼啦啦呼啦啦啦啦啦啦8 小时前
利用pdfjs实现的pdf预览简单demo(包含翻页功能)
android·javascript·pdf
idjl10 小时前
Mysql测试题
android·adb
游戏开发爱好者812 小时前
iOS App 电池消耗管理与优化 提升用户体验的完整指南
android·ios·小程序·https·uni-app·iphone·webview
人生游戏牛马NPC1号12 小时前
学习 Flutter (四):玩安卓项目实战 - 中
android·学习·flutter
星辰也为你祝福h14 小时前
Android原生Dialog
android