EasyFile
Class Mdl_Ftp

EasyFile.Mdl_Ftp

public class Mdl_Ftp

Verantwortlich für die Bereitstellung aller Ftp-Funktionalität, die von EasyFile benötigt wird. Sie vereinfacht die Schnittstelle zur Ftp-Funktionalität der Klasse ipworks.Ftp so weit wie möglich zur Verwendung in EasyFile.


Field Summary
 Mdl_Connection connection
          Alle zum Aufbau einer Verbindung benötigten Daten.
 
Constructor Summary
Mdl_Ftp(Mdl_Hotlist theHotlist, Mdl_Log theLog, Mdl_Setting theSetting)
          Erstellt eine neue Instanz der Ftp-Modellklasse.
 
Method Summary
 void addMdl_FtpEventListener(Mdl_FtpEventListener l)
          Fügt einen Mdl_FtpEventListener zur Liste der registrierten Listener hinzu.
 void cancelTransfer()
          Bricht den Upload oder Download einer Datei ab.
 void cdLocal(java.lang.String subDir)
          Wechselt das Verzeichnis auf dem lokalen System.
 void cdServer(java.lang.String directory)
          Wechselt das Verzeichnis auf dem Server.
 void createConnection()
          Erstellt eine neue Verbindung.
 void dirList(ipworks.FtpDirListEvent e)
          Gehört zur Implementierung des Interface ipworks.FtpEventListener
 void download(java.lang.String filename)
          Kopiert die Datei filename aus dem aktuellen Verzeichnis des Ftp-Servers in das aktuelle Verzeichnis auf dem lokalen System.
 void endTransfer(ipworks.FtpEndTransferEvent e)
          Gehört zur Implementierung des Interface ipworks.FtpEventListener
 void error(ipworks.FtpErrorEvent e)
          Gehört zur Implementierung des Interface ipworks.FtpEventListener
 void interrupt()
          Bricht eine gerade stattfindende Aktion wie Verzeichniswechsel oder Verzeichnislisting ab, sofern überhaupt eine stattfindet.
 void lsLocal()
          Gibt ein Listing des aktuellen Verzeichnisses auf dem lokalen System zurück.
 void lsServer()
          Gibt ein Listing des aktuellen Verzeichnisses auf dem Ftp-Server zurück.
 void mkdirLocal(java.lang.String subDir)
          Erstellt ein Verzeichnis auf dem lokalen System.
 void mkdirServer(java.lang.String directory)
          Erstellt ein Verzeichnis auf dem Server.
 void PITrail(ipworks.FtpPITrailEvent e)
          Gehört zur Implementierung des Interface ipworks.FtpEventListener
 void removeConnection()
          Trennt eine bestehende Verbindung vollständig.
 void removeMdl_FtpEventListener(Mdl_FtpEventListener l)
          Entfernt einen Mdl_FtpEventListener aus der Liste der registrierten Listener.
 void startTransfer(ipworks.FtpStartTransferEvent e)
          Gehört zur Implementierung des Interface ipworks.FtpEventListener
 void transfer(ipworks.FtpTransferEvent e)
          Gehört zur Implementierung des Interface ipworks.FtpEventListener
 void upload(java.lang.String filename)
          Kopiert die Datei filename aus dem aktuellen Verzeichnis des lokalen Systems in das aktuelle Verzeichnis auf dem Ftp-Server.
 

Field Detail

connection

public Mdl_Connection connection
Alle zum Aufbau einer Verbindung benötigten Daten. Zusätzlich werden nur noch die Verbindungseinstellungen (Klasse Mdl_Setting) benouml;tigt.
Constructor Detail

Mdl_Ftp

public Mdl_Ftp(Mdl_Hotlist theHotlist,
               Mdl_Log theLog,
               Mdl_Setting theSetting)
Erstellt eine neue Instanz der Ftp-Modellklasse.
Parameters:
theHotlist - anwendungsweit verwendete Liste von gespeicherten Verbindungen zu Ftp-Servern.
theLog - anwendungsweit verwendete Instanz des Datenmodells der Log-Daten
theSetting - anwendungsweit verwendete Grundeinstellungen für Ftp-Verbindungen.
Method Detail

createConnection

public void createConnection()
Erstellt eine neue Verbindung. Voraussetzung sind passend gesetzte Daten im Feld connection.

removeConnection

public void removeConnection()
Trennt eine bestehende Verbindung vollständig. Wenn keine Verbindung besteht, wird nichts ausgeführt.

cdServer

public void cdServer(java.lang.String directory)
Wechselt das Verzeichnis auf dem Server.
Parameters:
directory - Der Name des Unterverzeichnisses, in das gewechselt werden soll. Er darf keine Verzeichnistrenner enthalten, sondern muss stets ein Unterverzeichnis des aktuellen Verzeichnisses auf dem Server bezeichnen. Das kann auch »..« als Link auf das übergeordnete Verzeichnis sein.

cdLocal

public void cdLocal(java.lang.String subDir)
Wechselt das Verzeichnis auf dem lokalen System.
Parameters:
directory - Der Name des Unterverzeichnisses, in das gewechselt werden soll. Er darf keine Verzeichnistrenner enthalten, sondern muss stets ein Unterverzeichnis des aktuellen Verzeichnisses auf dem lokalen System bezeichnen. Das kann auch »..« als Link auf das übergeordnete Verzeichnis sein.

mkdirServer

public void mkdirServer(java.lang.String directory)
Erstellt ein Verzeichnis auf dem Server.
Parameters:
directory - Der Name des Unterverzeichnisses, das erstellt werden soll. Es wird im aktuellen Verzeichnis auf dem Server erstellt; deshalb darf directory keine Verzeichnistrenner enthalten.

mkdirLocal

public void mkdirLocal(java.lang.String subDir)
Erstellt ein Verzeichnis auf dem lokalen System.
Parameters:
directory - Der Name des Unterverzeichnisses, das erstellt werden soll. Es wird im aktuellen Verzeichnis auf dem lokalen System erstellt; deshalb darf directory keine Verzeichnistrenner enthalten.

download

public void download(java.lang.String filename)
Kopiert die Datei filename aus dem aktuellen Verzeichnis des Ftp-Servers in das aktuelle Verzeichnis auf dem lokalen System.
Parameters:
filename - Bezeichnet den Namen einer Datei (nicht eines Verzeichnisses!) im aktuellen Verzeichnis auf dem Ftp-Server. Dieser Name darf also keine Verzeichnistrenner enthalten.

upload

public void upload(java.lang.String filename)
Kopiert die Datei filename aus dem aktuellen Verzeichnis des lokalen Systems in das aktuelle Verzeichnis auf dem Ftp-Server.
Parameters:
filename - Bezeichnet den Namen einer Datei (nicht eines Verzeichnisses!) im aktuellen Verzeichnis auf dem lokalen System. Dieser Name darf also keine Verzeichnistrenner enthalten.

lsServer

public void lsServer()
Gibt ein Listing des aktuellen Verzeichnisses auf dem Ftp-Server zurück. Dazu wird ein Strom der Ereignisse StartDirEvent (zu Beginn), DirEntryEvent (für jedes Element des Verzeichnisses) und StopDirEvent (am Ende) erzeugt.

lsLocal

public void lsLocal()
Gibt ein Listing des aktuellen Verzeichnisses auf dem lokalen System zurück. Dazu wird ein Strom der Ereignisse StartDirEvent (zu Beginn), DirEntryEvent (für jedes Element des Verzeichnisses) und StopDirEvent (am Ende) erzeugt.

cancelTransfer

public void cancelTransfer()
Bricht den Upload oder Download einer Datei ab. Das heißt, wenn eine der Methoden download(String filename) oder download(String filename) ausgeführt wird, so wird ihre Ausführung unterbrochen.

interrupt

public void interrupt()
Bricht eine gerade stattfindende Aktion wie Verzeichniswechsel oder Verzeichnislisting ab, sofern überhaupt eine stattfindet.

startTransfer

public void startTransfer(ipworks.FtpStartTransferEvent e)
Gehört zur Implementierung des Interface ipworks.FtpEventListener

dirList

public void dirList(ipworks.FtpDirListEvent e)
Gehört zur Implementierung des Interface ipworks.FtpEventListener

endTransfer

public void endTransfer(ipworks.FtpEndTransferEvent e)
Gehört zur Implementierung des Interface ipworks.FtpEventListener

error

public void error(ipworks.FtpErrorEvent e)
Gehört zur Implementierung des Interface ipworks.FtpEventListener

PITrail

public void PITrail(ipworks.FtpPITrailEvent e)
Gehört zur Implementierung des Interface ipworks.FtpEventListener

transfer

public void transfer(ipworks.FtpTransferEvent e)
Gehört zur Implementierung des Interface ipworks.FtpEventListener

addMdl_FtpEventListener

public void addMdl_FtpEventListener(Mdl_FtpEventListener l)
                             throws java.util.TooManyListenersException
Fügt einen Mdl_FtpEventListener zur Liste der registrierten Listener hinzu. Das registrierte Objekt empfängt ab jetzt alle von Mdl_FtpEventListener empfangbaren Events, d.h. progressEvent, StartDirEvent, DirEntryEvent, StopDirEvent; sofern sie in dieser Instanz von Mdl_Ftp ausgelöst wurden.

removeMdl_FtpEventListener

public void removeMdl_FtpEventListener(Mdl_FtpEventListener l)
Entfernt einen Mdl_FtpEventListener aus der Liste der registrierten Listener.