remotefile.java

基于Java的FTP源码

/*
 * @(#) RemoteFile.java
 * <p>Copyright: Copyright (c) 2003,2004 Rad Inks (Pvt) Ltd  </p>
 * <p>Company: Rad Inks (Pvt) Ltd</p>
 */


/*
 * License
 *
 * The contents of this file are subject to the Jabber Open Source License
 * Version 1.0 (the "JOSL").  You may not copy or use this file, in either
 * source code or executable form, except in compliance with the JOSL. You
 * may obtain a copy of the JOSL at http://www.jabber.org/ or at
 * http://www.opensource.org/.
 *
 * Software distributed under the JOSL is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied.  See the JOSL
 * for the specific language governing rights and limitations under the
 * JOSL.
 */

package com.radinks.net;


/**
 * <p>Represents a file on the remote server, two subclasses provide functionality
 * specific to files on windows and unix like operating systems. Other platforms
 * are not supported at the moment.</p>
 * <p>The correct way to make use of this class is to create a new instance
 * by calling the {@link #parse parse()} method, which is a factory.
 * </p>
 *
 *
 * @author Raditha Dissanayake
 * @version 1.01
 */

public class RemoteFile {
	static private boolean redMond=false;

	/**
	 * Contains additonal information about the file such as modification times,
	 * size etc.
	 */
	FileAttrs attrs;

	/**
	 * the name of the file
	 */
	String fileName;

    protected RemoteFile() {
    }


	protected RemoteFile(String s)
	{
	}

	/**
	 * A factory method that creates a remote file instanace for the current
	 * server type.
	 *
	 * @param s a line read in from the LIST command.
	 * @return an instance of a RemoteFile subclass.
	 */
	public static RemoteFile parse(String s)
	{
		RemoteFile f=null;
		if(redMond)
		{
			f = new MSRemoteFile(s);
		}
		else
		{
			f = new UnixRemoteFile(s);
		}
		return (f.getFilename() == null) ? null : f;
	}

	/**
	 * Create an entry for the parent folder.
	 *
	 * The ftp server maynot return a '..' entry, in that case we have to
	 * create one, however doing a ls ../.. is not always a good idea so
	 * we hack together a filename.
	 *
	 * @return an object that corresponds to the parent folder of the current
	 *  working directory.
	 */

	public static RemoteFile doubleDot()
	{
		RemoteFile f=null;
		if(redMond)
		{
			f = new MSRemoteFile();
		}
		else
		{
			f = new UnixRemoteFile();
		}
		f.setFileName("..");
		FileAttrs at = new FileAttrs();
		at.setDir(true);
		f.setAttrs(at);
		return f;
	}


	/**
	 *
	 * @return this file's name
	 */
	public String getFilename()
	{
		return fileName;
	}

	/**
	 *
	 * @return attributes for this file.
	 */
	public FileAttrs getAttrs()
	{
		return attrs;
	}

	/**
	 * Are we running on windows or linux?
	 * @todo this needs to be improved to support other platforms and use
	 * better methods of os detection.
	 * @param st
	 */
    public static void setServerType(String st) {
        redMond = (st.indexOf("MS") != -1 || st.indexOf("Winodws") != -1);
    }

	/**
	 *
	 * @return true if the server is running on that lousy operating system.
	 */
    public static boolean isRedmond()
    {
        return redMond;
    }

	/**
	 *
	 * @param attrs attributes for this file.
	 */
    public void setAttrs(FileAttrs attrs) {
        this.attrs = attrs;
    }

	/**
	 *
	 * @param fileName name of this file.
	 */
    public void setFileName(String fileName) {
        this.fileName = fileName;
    }
}