开发FTP不要使用sun.net.ftp.ftpClient

在开发一个web应用过程中，需要开发一个服务使用ftp功能将数据传输一个网外的ftp服务器。最初使用sun.net.ftp.ftpClient类，但是遇到问题，在网内测试没有问题，向网外传时报告失败。开发环境如下：
web服务：tomcat 5.5.28
OS平台：Linux 5
java: 1.5
失败报告：port命令失败，试试用pasv代替。代码如下：

TelnetOutputStream os = null;
		FileInputStream in =null;			
		try {
			logger.debug("开始上传文件"+sourceFile);
			java.io.File file_in = new java.io.File(sourceFile);
			in = new FileInputStream(file_in);
			//ftpClient.sendServer("TYPE I \r\n");
			//ftpClient.sendServer("PASV \r\n" );
			//logger.debug("发送TYPE I 和　PASC命令");
			// 命名文件,将文件名编码转为utf-8,否则中文文件名上载后为乱码文件名			
			//os = ftpClient.put(new String(targetFile.getBytes("UTF-8")));
			os = ftpClient.put(targetFile);
			logger.debug("创建"+targetFile+" 成功");
			byte[] bytes = new byte[4096];
			int c;
			while ((c = in.read(bytes)) != -1) {
				os.write(bytes, 0, c);
			}
		} catch (IOException e) {
			logger.error(e.getMessage());
			return 0;
		} finally {
			if (in != null) {
				in.close();
			}
			if (os != null) {
				os.close();
			}
			}

代码在os = ftpClient.put(targetFile)这句出错，这样的代码在网上都很常见，但大约可以肯定的是许多的人只是拷贝复制下来构造一篇博文，并没有真正实践过。
　　试着给服务器发送PASV命令也不行。查看ftpClient的源代码，发现ftpClient在上载数据前首先尝试PASV模式，如PASV模式失败再使用PORT模式。通过TelnetOutputStream os = null此句代码，推测是否使用了telent功能，调整两边的路由器防火墙功能，折腾半死，程序失败依旧。
　　鉴于源代码使用telnetoutputStream,又没有控制传输模式的方法和命令，最后只好弃用sun.net.ftp.ftpClient，使用org.apache.commons.net.ftp.FTPClient类开发调试成功。部分代码如下：

	public boolean uploadFile(String fileName, String newName)
			throws IOException {
		boolean flag = false;
		InputStream iStream = null;
		try {
			iStream = new FileInputStream(fileName);
			ftpClient.enterLocalPassiveMode();
			logger.debug("Set pasv return code:"+ftpClient.getReplyCode());
			flag = ftpClient.storeFile(newName, iStream);
			logger.debug("upload file return code:"+ftpClient.getReplyCode());
		} catch (IOException e) {
			logger.debug("upload error:"+ftpClient.getReplyCode());
			flag = false;
			return flag;
		} finally {
			if (iStream != null) {
				iStream.close();
			}
		}
		return flag;
	}

　　最后，找到java的老巢去，发现在java 1.5的文档里，有这样一段话：

Why Developers Should Not Write Programs
That Call 'sun' Packages
The classes that Sun includes with the Java 2 SDK, Standard Edition, fall into package groups java.*, javax.*, org.* and sun.*. All but the sun.* packages are a standard part of the Java platform and will be supported into the future. In general, packages such as sun.*, that are outside of the Java platform, can be different across OS platforms (Solaris, Windows, Linux, Macintosh, etc.) and can change at any time without notice with SDK versions (1.2, 1.2.1, 1.2.3, etc). Programs that contain direct calls to the sun.* packages are not 100% Pure Java. In other words:

    The java.*, javax.* and org.* packages documented in the Java 2 Platform Standard Edition API Specification make up the official, supported, public interface.
    If a Java program directly calls only API in these packages, it will operate on all Java-compatible platforms, regardless of the underlying OS platform.

    The sun.* packages are not part of the supported, public interface.
    A Java program that directly calls into sun.* packages is not guaranteed to work on all Java-compatible platforms. In fact, such a program is not guaranteed to work even in future versions on the same platform.

For these reasons, there is no documentation available for the sun.* classes. Platform-independence is one of the great advantages of developing in the Java programming language. Furthermore, Sun and our licensees of Java technology are committed to maintaining backward compatibility of the APIs for future versions of the Java platform. (Except for code that relies on serious bugs that we later fix.) This means that once your program is written, the class files will work in future releases.
　　具体URL：http://java.sun.com/products/jdk/faq/faq-sun-packages.html
　　真是为在sun.net.ftp上浪费掉的时间懊恼不已。
　　留文于此，希望广大朋友们在开发过程中少走弯路。
　　PS到处拷贝粘帖赚文章的“专业技术作家”!

评论

5 楼 JimmyLincole 2014-04-01  

明白，以后都不用sun.*包了
好像也没用过，哈哈
谢谢提醒

4 楼 cjt 2013-05-14  

3 楼 fangjindan108 2012-09-26  

原来是这么一回事。。。~~~~(>_<)~~~~ 。。谢谢博主。。。

2 楼 zjlgdxzzw 2012-08-16  

我也碰到了这类问题，执行ftpclient.put(filename)会耗时19秒左右，尝试了在put之前ftpclient.sendServer("passive");就可以了，passive mode off

1 楼 jiangfengqin 2012-08-02  

楼主太强了，我刚好遇到这个问题，昨天晚上弄到9点都没弄好，今天早上看到这篇文章，改成org.apache.commons.net.ftp.FTPClient，真的就通了。。。。。。非常感谢