Obsługiwane operacje przetwarzania danych wychodzących

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.

Opcje konfiguracji połączenia wychodzącego

Produkt WebSphere Adapter for FTP obsługuje następujące opcje konfiguracji przetwarzania danych wychodzących:
  • Operacje wychodzące obsługują następujące tryby połączenia danych: active (aktywny) oraz passive (pasywny). Domyślnie jest ustawiony tryb active.
  • Pliki można przesyłać w trybie ASCII (znaki kodu ASCII) lub binary (dane binarne). Domyślnie jest ustawiony tryb binary.
  • Istnieje możliwość włączenia kontroli komend uruchamianych podczas operacji przetwarzania danych wychodzących. Takie informacje kontrolne są zapisywane w pliku śledzenia, gdy poziom śledzenia jest ustawiony na wartość FINEST (Najdokładniej).
  • Można skonfigurować ustawienia serwera proxy Socks, jeśli żądania są przekazywane za pomocą serwera proxy FTP, który znajduje się między stacją roboczą adaptera a serwerem FTP. Ustawienia proxy są konfigurowane na poziomie aplikacji i są wspólne dla wszystkich fabryk ManagedConnectionFactory oraz specyfikacji aktywowania ActivationSpec używanych podczas konfigurowania adaptera.
  • Jeśli treść pliku została wysłana z aplikacji J2EE podczas operacji przetwarzania danych wychodzących create (tworzenie), jest dostępna opcja zapisania pliku na stacji roboczej adaptera przed wykonaniem tej operacji.
  • Gdy podczas operacji przetwarzania danych wychodzących jest pobieranych wiele plików, atrybut fileName musi zawierać rozdzieloną przecinkami listę nazw plików.
  • Skrypt ExecuteFTPScript może być uruchamiany przed operacjami przetwarzania danych przychodzących i po nich. Plik skryptowy nie może zawierać komend związanych z połączeniem, takich jak open, ponieważ do wykonywania tych komend jest używane już nawiązane połączenie.
  • Numer portu używanego przez serwer FTP można skonfigurować we właściwości Adres URL serwera FTP. Na przykład: ftp://localhost:numer_portu
  • Tryb połączenia danych passive (pasywny) może być używany do połączenia adaptera z serwerem FTP przez zaporę firewall.
  • Domyślne hasła są przechowywane w postaci jawnego tekstu w plikach importu i eksportu. Jeśli jest skonfigurowany alias uwierzytelniania, bieżące hasło jest pobierane z aliasu uwierzytelniania serwera WebSphere Process Server zarówno w przypadku konfiguracji przetwarzania danych przychodzących, jak i w przypadku konfiguracji przetwarzania danych wychodzących.
  • Jeśli jest używany serwer FTP, a dane wyjściowe komendy pełnej listy (ls -l) różnią się od domyślnych wykazów obsługiwanych przez interfejs Apache Commons Net w wersji 1.4.1 dla innego systemu operacyjnego, użytkownicy mogą zaimplementować własny analizator składni do analizowania danych wyjściowych komendy ls -l.
  • Adapter obsługuje protokół Secure FTP używający protokołu SSL. Podczas zabezpieczonych operacji jest używany pasywny tryb połączenia danych.
  • W przypadku przekroczenia limitu czasu połączenia FTP adapter wykrywa utracone połączenie i nawiązuje je ponownie. Jeśli nawiązanie połączenia nie będzie możliwe, adapter wykona określoną liczbę ponownych prób. Przerwane operacje przesyłania nie są kontynuowane. Przesłane dane są tracone, a operację przesyłania pliku należy zrestartować.
  • Podczas operacji przetwarzania danych wychodzących create (tworzenie) pliki są tworzone w katalogu pomostowym (jeśli został określony). Następnie są przenoszone do wymaganego rzeczywistego katalogu. To rozwiązanie jest pomocne, gdy inna aplikacja rozpoczyna odczyt pliku przed jego pełnym zapisaniem. Ten katalog pomostowy jest używany także podczas operacji Append (dopisywanie) i Overwrite (nadpisywanie), w przypadku których określony plik jest kopiowany do katalogu pomostowego (jeśli został określony), a następnie do tego pliku jest dodawana treść lub jest on nadpisywany, a na końcu przenoszony z powrotem od wymaganego rzeczywistego katalogu. Jeśli katalog pomostowy nie zostanie określony, operacja jest uruchamiana w wymaganym rzeczywistym katalogu.

Warunki używania |


(c) Copyright IBM Corporation 2005, 2006.
To Centrum informacyjne jest oparte na technologii Eclipse (http://www.eclipse.org)