Produkt WebSphere Adapter for FTP obsługuje operacje dotyczące przetwarzania danych wychodzących opisane w poniższej tabeli.
Operacja | Wynik |
---|---|
Create | Plik o określonej nazwie jest tworzony w podanym katalogu serwera FTP. Treść tego pliku pochodzi
z żądania klienta lub może zostać pobrana z lokalnego systemu plików, w którym działa adapter. Istnieje możliwość konfigurowania
pobierania danych. Jeśli plik, który ma zostać utworzony, nie istnieje, jest on tworzony, a do aplikacji J2EE jest zwracana wartość null. Plik jest tworzony w katalogu pomostowym (jeśli taki istnieje) i z tego położenia jest przenoszony do określonego katalogu. Jeśli
katalog pomostowy nie istnieje, plik jest tworzony w określonym katalogu. Jeśli plik, który ma zostać utworzony, już istnieje, jest wysyłany wyjątek FTPFileCreateException. W takiej sytuacji plik nie zostanie utworzony, a istniejący plik nie zostanie nadpisany. |
Append | Do pliku o określonej nazwie znajdującego się w podanym katalogu serwera FTP jest dopisywana treść wysłana w żądaniu. Jeśli plik istnieje, treść jest dodawana, a do aplikacji J2EE jest zwracana wartość null. Plik, do którego ma zostać dopisana treść, jest kopiowany z podanego katalogu do katalogu pomostowego (jeśli taki istnieje), a następnie treść zostaje dodana do pliku znajdującego się w katalogu pomostowym. Potem plik jest przenoszony z powrotem do pierwotnego katalogu. Jeśli katalog pomostowy nie istnieje, treść jest dopisywana bezpośrednio do pliku znajdującego się w określonym katalogu. Jeśli plik, do którego ma zostać dopisana treść, nie istnieje, to do komponentu wywołującego jest wysyłany wyjątek FTPFileAppendException. |
Delete | Plik znajdujący się w określonym katalogu jest usuwany na serwerze FTP. Po usunięciu pliku do aplikacji J2EE jest zwracana wartość null. Jeśli plik nie istnieje, do komponentu wywołującego jest wysyłany wyjątek FTPFileDeleteException. |
Retrieve | Zwracana jest treść pliku, który został określony w żądaniu. Jeśli plik lub pliki, które są określone w żądaniu, istnieją, ich treść jest pobierana i wysyłana jako odpowiedź. Treść pliku może zostać odesłana do aplikacji J2EE jako obiekt biznesowy lub może zostać zapisana do lokalnego systemu plików, w którym jest uruchomiony adapter. Wybór jednej z tych możliwości zależy od konfiguracji użytkownika. Nazwy plików są podawane w postaci listy rozdzielonych przecinkami wartości w atrybucie fileName. Jeśli plik nie istnieje, do komponentu wywołującego jest wysyłany wyjątek FTPFileRetrieveException. |
Overwrite | Ta operacja powoduje nadpisanie pliku, który znajduje się w podanym katalogu, treścią określoną w żądaniu. Jeśli plik, który ma zostać nadpisany, istnieje, treść jest nadpisywana, a do aplikacji J2EE jest zwracana wartość null. Plik, który ma zostać nadpisany, jest kopiowany z podanego katalogu do katalogu pomostowego (jeśli taki jest używany), a następnie plik znajdujący się w katalogu pomostowym zostaje nadpisany określoną treścią. Potem plik jest przenoszony z powrotem do pierwotnego katalogu. Jeśli katalog pomostowy nie istnieje, to określoną treścią jest nadpisywany plik znajdujący się określonym katalogu. Jeśli plik, który ma zostać zaktualizowany, nie istnieje, to do komponentu wywołującego jest wysyłany wyjątek FTPFileOverwriteException. |
Exists | Jeśli w określonym katalogu istnieje plik o nazwie podanej w żądaniu, adapter zwraca obiekt biznesowy ExistsResponse z atrybutem DoesFileExists ustawionym na wartość true. Jeśli plik lub katalog nie istnieje, adapter zwraca obiekt biznesowy ExistsResponse z atrybutem DoesFileExists ustawionym na wartość false. |
List | Ta operacja zwraca nazwy wszystkich plików i podkatalogów, które znajdują się w katalogu określonym w żądaniu. Nazwy plików i podkatalogów, które znajdują się w tym katalogu, są pobierane i wysyłane jako odpowiedź w obiekcie biznesowym ListResponse. Jeśli określony katalog nie istnieje, do komponentu wywołującego jest wysyłany wyjątek FTPFileListException. |
ServerToServer FileTransfer |
Ta operacja przesyła określony plik z katalogu serwera FTP do innego katalogu serwera FTP. Jeśli żądanie
nie zawiera wszystkich informacji o obu serwerach, adapter wysyła wyjątek FTPFileServerToServer FileTransferException. |
ExecuteFTPScript | Ta operacja powoduje uruchomienie komend, które znajdują się w pliku skryptowym protokołu FTP na serwerze WebSphere Process Server. Operacja powoduje uruchomienie wyłącznie tych komend, które są obsługiwane przez serwer FTP. Pozostałe komendy są ignorowane. Jeśli operacja nie powiedzie się, jest wysyłany wyjątek FTPFileExecuteFTPScriptException. Skrypt nie powinien zawierać komend związanych z połączeniem (takich jak open lub connect), ponieważ adapter do wykonywania komend używa już nawiązanego połączenia. Jeśli komendy zawarte w pliku skryptowym muszą zostać uruchomione w określonym katalogu serwera FTP, pierwsza komenda znajdująca się w tym pliku skryptowym powinna powodować przejście do tego katalogu. |
(c) Copyright IBM Corporation 2005, 2006.
To Centrum informacyjne jest oparte na technologii Eclipse (http://www.eclipse.org)