sftp是Secure File Transfer Protocol的缩写,安全文件传送协议。可以为传输文件提供一种安全的加密方法。sftp 与 ftp 有着几乎一样的语法和功能。SFTP 为 SSH的一部分,是一种传输档案至 Blogger 伺服器的安全方式。其实在SSH软件包中,已经包含了一个叫作SFTP(Secure File Transfer Protocol)的安全文件传输子系统,SFTP本身没有单独的守护进程,它必须使用sshd守护进程(端口号默认是22)来完成相应的连接操作,所以从某种意义上来说,SFTP并不像一个服务器程序,而更像是一个客户端程序。SFTP同样是使用加密传输认证信息和传输的数据,所以,使用SFTP是非常安全的。但是,由于这种传输方式使用了加密/解密技术,所以传输效率比普通的FTP要低得多,如果您对网络安全性要求更高时,可以使用SFTP代替FTP。
本篇示例中使用的第三方包为:jsch.jar
import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
import java.util.Properties;
import java.util.Vector;
import com.jcraft.jsch.Channel;
import com.jcraft.jsch.ChannelSftp;
import com.jcraft.jsch.ChannelSftp.LsEntry;
import com.jcraft.jsch.JSch;
import com.jcraft.jsch.Session;
/**
* SFTP客户端工具类
*
* @author jianggujin
*
*/
public class SftpClientTool
{
/** Sftp */
private ChannelSftp sftp = null;
/** 主机 */
private String host = "";
/** 端口 */
private int port = 22;
/** 用户名 */
private String username = "";
/** 密码 */
private String password = "";
/**
* 构造函数
*
* @param host
* 主机
* @param port
* 端口
* @param username
* 用户名
* @param password
* 密码
*
*/
public SftpClientTool(String host, int port, String username, String password)
{
this.host = host;
this.port = port;
this.username = username;
this.password = password;
}
/**
* 构造函数
*
* @param host
* 主机
* @param username
* 用户名
* @param password
* 密码
*
*/
public SftpClientTool(String host, String username, String password)
{
this.host = host;
this.username = username;
this.password = password;
}
/**
* 连接sftp服务器,默认超时时间20000
*
* @throws Exception
*/
public void connect() throws Exception
{
connect(20000);
}
/**
* 连接sftp服务器
*
* @param timeout
* 超时时间
*
* @throws Exception
*/
public void connect(int timeout) throws Exception
{
JSch jsch = new JSch();
Session sshSession = jsch.getSession(this.username, this.host, this.port);
sshSession.setPassword(password);
Properties sshConfig = new Properties();
sshConfig.put("StrictHostKeyChecking", "no");
sshSession.setConfig(sshConfig);
sshSession.connect(timeout);
Channel channel = sshSession.openChannel("sftp");
channel.connect();
this.sftp = (ChannelSftp) channel;
}
/**
* 断开sftp服务器连接
*
* @throws Exception
*/
public void disconnect() throws Exception
{
if (this.sftp != null)
{
if (this.sftp.isConnected())
{
this.sftp.disconnect();
}
else if (this.sftp.isClosed())
{
}
this.sftp = null;
}
}
/**
* 上传单个文件
*
* @param directory
* 上传的目录
* @param uploadFile
* 要上传的文件
*
* @throws Exception
*/
public void upload(String directory, String uploadFile) throws Exception
{
this.sftp.cd(directory);
File file = new File(uploadFile);
this.sftp.put(new FileInputStream(file), file.getName());
}
/**
* 下载单个文件
*
* @param directory
* 下载目录
* @param downloadFile
* 下载的文件
* @param saveFile
* 保存文件
*
* @throws Exception
*/
public void download(String directory, String downloadFile, String saveFile)
throws Exception
{
this.sftp.cd(directory);
File file = new File(saveFile);
this.sftp.get(downloadFile, new FileOutputStream(file));
}
/**
* 删除文件
*
* @param directory
* 要删除文件所在目录
* @param deleteFile
* 要删除的文件
*
* @throws Exception
*/
public void delete(String directory, String deleteFile) throws Exception
{
this.sftp.cd(directory);
this.sftp.rm(deleteFile);
}
/**
* 列出目录下的文件
*
* @param directory
* 要列出的目录
*
* @return list 文件名列表
*
* @throws Exception
*/
@SuppressWarnings("unchecked")
public List<String> listFiles(String directory) throws Exception
{
List<String> fileNameList = new ArrayList<String>();
Vector<LsEntry> fileList = this.sftp.ls(directory);
Iterator<LsEntry> it = fileList.iterator();
while (it.hasNext())
{
String fileName = it.next().getFilename();
// 特殊文件名,忽略
if (".".equals(fileName) || "..".equals(fileName))
{
continue;
}
fileNameList.add(fileName);
}
return fileNameList;
}
/**
* 更改文件名
*
* @param directory
* 文件所在目录
* @param oldFileNm
* 原文件名
* @param newFileNm
* 新文件名
*
* @throws Exception
*/
public void rename(String directory, String oldFileNm, String newFileNm)
throws Exception
{
this.sftp.cd(directory);
this.sftp.rename(oldFileNm, newFileNm);
}
}