Támogatott kimenő műveletek

A WebSphere Adapter for FTP az alábbi táblázatban szereplő kimenő feldolgozási műveleteket támogatja.

Művelet Eredmény
Create Az FTP kiszolgáló megadott könyvtárában létrejön a megadott nevű fájl. A fájl tartalma érkezhet akár az ügyféltől származó kérés részeként, vagy lekérhető arról a helyi fájlrendszerről, ahol az adapter fut. Ez a tartalomlekérés konfigurálható. Ha a létrehozni kívánt fájl még nem létezik, akkor létrejön, és null érték tér vissza a J2EE alkalmazáshoz. A fájl egy állomásoztató könyvtárban (ha van ilyen) jött létre, és onnan lett áthelyezve a megadott könyvtárba. Ha állomásoztató könyvtár nincs jelen, akkor a fájl a megadott könyvtárban jön létre.

Ha a létrehozandó fájl már létezik, akkor egy FTPFileCreateException kivétel keletkezik, a fájl nem jön létre, a létező fájl pedig nem lesz felülírva.

Append Az FTP kiszolgáló megadott könyvtárában lévő megadott nevű fájlhoz a rendszer hozzáfűzi a kérésben elküldött tartalmat. Ha a fájl létezik, akkor a tartalom hozzá lesz fűzve, és null érték tér vissza a J2EE alkalmazáshoz. A kiegészítendő fájl a megadott könyvtárból az állomásoztató könyvtárba (ha van ilyen) lesz átmásolva, és a tartalom ahhoz a fájlhoz az állomásoztató könyvtárban lesz hozzáfűzve. Ezután a fájl visszahelyeződik az eredeti megadott könyvtárba. Ha az állomásoztató könyvtár nincs jelen, akkor a tartalom a fájlhoz a megadott könyvtárban közvetlenül lesz hozzáfűzve. Ha a kiegészítendő fájl nem létezik, akkor egy FTPFileAppendException kivétel lesz elküldve a hívó komponenshez.
Delete A megadott könyvtárban lévő fájl törlésre kerül az FTP kiszolgálón. A fájl törlése után null érték tér vissza a J2EE alkalmazáshoz. Ha a fájl nem létezik, akkor egy FTPFileDeleteException kivétel lesz elküldve a hívó komponenshez.
Retrieve A kérésben megadott fájl vagy fájlok tartalma tér vissza. Ha a kérésben megadott fájl vagy fájlok létezik (léteznek), akkor a fájl tartalma lekérésre kerül és válaszként vissza lesz küldve. A fájl tartalma vagy üzleti objektumként kerül elküldésre a J2EE alkalmazáshoz, vagy pedig kimenthető arra a helyi fájlrendszerre, ahol az adapter fut. Ez konfigurálható. A fájlnevek bemenetek egy vesszővel elválasztott listaként a fileName attribútumban. Ha a fájlok nem léteznek, akkor egy FTPFileRetrieveException kivétel lesz elküldve a hívó komponenshez.
Overwrite Ez a művelet felülírja a könyvtárban lévő fájlt a kérésben megadott tartalommal. Ha a felülírandó fájl létezik, akkor a tartalma felül lesz írva, és null érték tér vissza a J2EE alkalmazáshoz. A felülírandó fájl a megadott könyvtárból át lesz másolva az állomásoztató könyvtárba (ha használt), majd itt íródik felül a tartalma. Ezután a fájl visszahelyeződik az eredeti megadott könyvtárba. Ha az állomásoztató könyvtár nincs jelen, akkor a tartalom a fájlra a megadott könyvtárban lesz felülírva. Ha a frissítendő fájl nem létezik, akkor egy FTPFileOverwriteException kivétel kerül elküldésre a hívó komponenshez.
Exists Ha a kérésben lévő fájlnév létezik a megadott könyvtárban, akkor az adapter visszaadja az ExistsResponse üzleti objektumot, amelynek a DoesFileExists attribútum értéke igaz. Ha a fájlnév, vagy a könyvtár nem létezik, akkor az adapter visszaadja az ExistsResponse üzleti objektumot, amelynek a DoesFileExists attribútum értéke hamis.
List Ez a művelet visszaadja a kérésben megadott könyvtárban lévő összes fájl és alkönyvtár nevét. A könyvtárban lévő fájlok és alkönyvtárak nevei lekérésre kerülnek, és válaszként egy ListResponse üzleti objektumban lesznek elküldve. Ha a megadott könyvtár nem létezik, akkor egy FTPFileListException kivétel lesz visszaküldve a hívó komponensnek.
ServerToServer
FileTransfer
A megadott fájlt az egyik FTP kiszolgálókönyvtárból a másik FTP kiszolgálókönyvtárba viszi át. Ha a kérés nem tartalmazza az összes információt a két kiszolgálóról, akkor az adapter egy FTPFileServerToServer
FileTransferException kivételt küld.
ExecuteFTPScript Ez a művelet a WebSphere Process Server kiszolgálón egy FTP parancsfájlban lévő parancsokat futtatja le. A művelet csak az FTP kiszolgáló által támogatott parancsokat futtatja le, a többit figyelmen kívül hagyja. Ha a művelet meghiúsul, akkor egy FTPFileExecuteFTPScriptException kivételt küld. A parancsfájlnak nem szabad tartalmaznia csatlakozással kapcsolatos parancsokat (például open vagy connect), mivel a parancsok futtatására egy már meglévő kapcsolatot használunk. Ha a parancsfájlban lévő parancsokat az FTP kiszolgáló egy bizonyos könyvtárában kell futtatni, akkor a parancsfájl első parancsának tartalmaznia kell a váltást arra a könyvtárra.

Kimenő konfigurációs lehetőségek

A WebSphere Adapter for FTP a következő konfigurációs lehetőségeket támogatja a kimenő feldolgozáshoz:
  • A kimenő műveletek mind az aktív, mint pedig a passzív adatkapcsolati módot támogatják. Az alapértelmezett mód: aktív.
  • A fájlátvitel ASCII vagy bináris módban történhet. Az alapértelmezett mód: bináris.
  • Engedélyezhető a kimenő művelet közben futó parancsok megfigyelése. Ezek az információk a nyomkövetési fájlba kerülnek, ha a nyomkövetési szint értéke FINEST.
  • Ha a kérések az adapter munkaállomás és az FTP kiszolgáló között lévő FTP proxy-n haladnak keresztül, akkor megadhat Socks proxy beállításokat. A proxy beállítások alkalmazás szinten vannak megadva, és minden ManagedConnectionFactory és ActivationSpec közösen használja őket az adapter beállítása során.
  • Ha a fájl tartalmát egy J2EE alkalmazás küldte egy kimenő létrehozás művelet során, akkor a művelet elvégzése előtt lehetőség van a fájl mentésére az adapter munkaállomásra.
  • Több fájl lekérése esetén kimenő műveletek során a fájlneveket vesszővel elválasztva a fileName attribútumnak kell tartalmaznia.
  • Az ExecuteFTPScript a kimenő művelet előtt és után is futtatható. A parancsfájlnak nem szabad tartalmaznia csatlakozással kapcsolatos parancsokat (például open), mivel a parancsok futtatására egy már meglévő kapcsolatot használunk.
  • Az FTP kiszolgáló által használt portszámot az FTP URL címben lehet beállítani. Például: ftp://localhost:portszám
  • A passzív adatkapcsolati mód segítségével az adapter tűzfalon keresztül is csatlakozni tud az FTP kiszolgálóhoz.
  • Az alapértelmezett jelszavak sima szövegként az import és export fájlokban kerülnek eltárolásra. Ha be van állítva egy hitelesítési álnév, akkor az aktuális jelszó a WebSphere Process Server hitelesítési álnevétől származik bejövő és kimenő konfigurációk esetén egyaránt.
  • Olyan FTP kiszolgáló használata esetén, amelynél egy hosszú listázó parancs (ls -l) kimenete különbözik az Apache commons net 1.4.1 alapértelmezett listázásától egy másik operációs rendszer esetén, az ls -l kimenetének értelmezéséhez a felhasználó megvalósíthat egy saját egyéni értelmezőt.
  • Az adapter támogatja a biztonságos FTP használatát SSL-en keresztül. A biztonságos művelet során passzív adatkapcsolatot használ.
  • Ha az FTP kapcsolat túllépi az időkorlátot, akkor az adapter észreveszi ezt, és újra létrehozza az elvesztett kapcsolatot. Ha a kapcsolat nem hozható létre, akkor az adapter adott számú próbálkozást hajt végre. A megszakított átvitel nem folytatódik. Ezek elvesznek, és a fájlátvitelt meg kell ismételni.
  • Kimenő létrehozás művelet során a fájlok az állomásoztató könyvtárban (ha létezik) jönnek létre. Innen kerülnek át az aktuálisan kért könyvtárba. Ez akkor hasznos, ha egy harmadik alkalmazás elkezdi olvasni a fájlt, mielőtt az teljesen ki lenne írva. Az állomásozatató könyvtár az Append és az Overwrite műveleteknél is felhasználásra kerül, ahol a megadott fájl először ebbe a könyvtárba lesz másolva (ha létezik), majd hozzá lesz fűzve, vagy felül lesz írva a tartalma, majd a fájl vissza lesz mozgatva az aktuálisan kért könyvtárba. Ha az állomásoztató könyvtár nem létezik, akkor a művelet az aktuálisan kért könyvtárban fut le.

Használat feltételei |


(c) Copyright IBM Corporation 2005, 2006.
Az információs központ Eclipse technológiára épül (http://www.eclipse.org)