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