简单应用---API介绍
The main class of the library is FTPClient (it.sauronsoftware.ftp4j.FTPClient).
1. 创建FTPClient实例
FTPClient client = new FTPClient();
连接到指定的FTP服务器(域名或IP) 不指定端口,则使用默认端口21
client.connect("ftp.host.com", /*21*/);
登录验证
client.login("user", "pswd");
下面是匿名登录
//client.login("anonymous", "密码任意设置");
client.login("anonymous", "ftp4j");
安全退出
client.disconnect(true);
//强制退出
//client.disconnect(false);
文件以及文件夹操作:
取得当前文件夹
String dir = client.currentDirectory();
改变当前文件夹
client.changeDirectory(newPath);
//绝对路径
//client.changeDirectory("/an/absolute/one");
//相对路径
//client.changeDirectory("relative");
//回退到上级目录
client.changeDirectoryUp();
//重命名文件或文件夹
client.rename("oldname", "newname");
//移动文件或文件夹
client.rename("myfile.txt", "myfolder/myfile.txt");
//删除文件
client.deleteFile(relativeOrAbsolutePath);
//client.deleteFile("useless.txt");
//创建目录
client.createDirectory("newfolder");
//删除目录(空目录)
client.deleteDirectory(absoluteOrRelativePath);
//client.deleteDirectory("oldfolder");
//浏览文件
FTPFile[] list = client.list();
//使用通配浏览文件
FTPFile[] list = client.list("*.jpg");
//显示文件或文件夹的修改时间
java.util.Date md = client.modifiedDate("filename.ext");
//上传和下载文件
//下载服务器上remoteFile.ext 下载到本地 localFile.ext
client.download("remoteFile.ext", new java.io.File("localFile.ext"));
//上传 本地 localFile.ext 到当前目录
client.upload(new java.io.File("localFile.ext"));
// 上传和下载文件时, 监听文件传输的状态
public class MyTransferListener implements FTPDataTransferListener {
//文件开始上传或下载时触发
public void started() {
}
//显示已经传输的字节数
public void transferred(int length) {
}
//文件传输完成时,触发
public void completed() {
}
//传输放弃时触发
public void aborted() {
// Transfer aborted
}
//传输失败时触发
public void failed() {
}
示例:
client.download("remoteFile.ext", new java.io.File("localFile.ext"), new MyTransferListener());
client.upload(new java.io.File("localFile.ext"), new MyTransferListener());
//ftp4j也支持断点续传功能
下面是一个简单示例:*参数 1056 跳过 1056字节点下载
client.download("remoteFile.ext", new java.io.File("localFile.ext"), 1056);
设置传输模式
//ASC码
client.setType(FTPClient.TYPE_TEXTUAL);
//二进制
client.setType(FTPClient.TYPE_BINARY);
//自动选择(根据文件内容)
client.setType(FTPClient.TYPE_AUTO);
//设置连接器
client.setConnector(connector);
SSL 套接字连接
client.setConnector( it.sauronsoftware.ftp4j.connectors.SSLConnector)
client.setConnector(anyConnectorYouWant);
ftp4j 官网: http://www.sauronsoftware.it/projects/ftp4j/
Good Luck!
Yours Matthew!