A API felület a proxykiszolgáló alapvető szolgáltatásainak a bővítésére használható. Bedolgozók írásával (az Ön által készített alkalmazáskiterjesztésekkel) egyéni feldolgozást végezhet, mint például a következők:
Az alapvető kiszolgálókérési folyamat a kiszolgáló által ebben a fázisban végzett feldolgozás alapján bontható lépésekre. Minden lépés tartalmaz egy csatolási pontot, amelyen a saját készítésű program meghatározott része lefuttatható. API direktívák a konfigurációs fájlhoz való hozzáadásával megadhatja, hogy az adott lépés során az alkalmazásfüggvények melyikét kell meghívnia a kiszolgálónak. Adott lépéshez több API direktívát is megadva több alkalmazásfüggvényt is meghívhat a kérésfeldolgozás megfelelő lépése során.
A lefordított bedolgozó program .DLL, .so vagy .o fájlba kerül, az operációs rendszertől függően. Miközben a kiszolgáló végighalad a kérésfeldolgozás lépésein, rendre meghívja a egyes lépésekhez rendelt bedolgozó alkalmazásfüggvényeket, amíg a kérések valamelyike azt nem jelzi, hogy lekezelte a kérést. Ha adott lépésben több bedolgozó függvény meghívására is sor kerül, akkor a meghívás abban a sorrendben történik, amellyel a függvények a konfigurációs fájlban szerepelnek.
Ha a kérés feldolgozása az alkalmazásfüggvény futásával nem fejeződik be (mert nincs megadva alkalmazásfüggvény, vagy az adott lépéshez megadott alkalmazásfüggvény a HTTP_NOACTION kóddal tér vissza), akkor a kiszolgáló az adott lépéshez tartozó alapértelmezett műveletet végzi el. Megjegyzés: Ez a Service lépés kivételével minden lépésre igaz; a Service lépésnek nincs alapértelmezett művelete.
A kérésfeldolgozási folyamat minden lépéséhez tartozik egy konfigurációs direktíva, amely lehetővé teszi egy az adott lépés során meghívásra és végrehajtásra kerülő egyéni alkalmazásfüggvény meghatározását.
Ha adott feldolgozási lépésből több bedolgozó függvényt is meghív, akkor egyes esetekben fontos a direktívák sorrendje. Az egyes lépéseken belül a lépésekhez tartozó függvények végrehajtása a felsorolás sorrendjében történik.
A NameTrans és a Service direktíva az Exec direktívához hasonlóan, az előfordulásától és a konfigurációs fájlban lévő többi direktívához viszonyított elhelyezésétől függően működik. A kiszolgáló tehát a konfigurációs fájlbeli sorrendjükben dolgozza fel a Service, a NameTrans, a Map, a Pass, az Exec, a Redirect és a Fail direktívát. Ha az adott URL címet sikeresen leképezte egy fájlra, akkor a kérés esetében a további direktívákat nem olvassa be és dolgozza fel.
Megjegyzés: A NameTrans és a Service direktíva, valamint a Map, a Pass, az Exec, a Redirect és a Fail direktíva a Kérésútválasztás űrlapon konfigurálható. A módosítása előtt az űrlap az alapértelmezett beállításokat jeleníti meg, amelyek a direktíváknak megfelelő sorrendben láthatók.
ServerInit | /elérési_út/fájl:függvény_neve | ||
PreExit | /elérési_út/fájl:függvény_neve | ||
Hitelesítés | típus | /elérési_út/fájl:függvény_neve | |
NameTrans | /URL | /elérési_út/fájl:függvény_neve | |
Felhatalmazás | /URL | /elérési_út/fájl:függvény_neve | |
ObjectType | /URL | /elérési_út/fájl:függvény_neve | |
PostAuth | /elérési_út/fájl:függvény_neve | ||
Szolgáltatás | /URL | /elérési_út/fájl:függvény_neve | |
Transmogrifier | /elérési_út/fájl:megnyitási_függvény_neve:írási_függvény_neve:lezárási_függvény_neve:hibafüggvény_neve | ||
Napló | /URL | /elérési_út/fájl:függvény_neve | |
Hiba | /URL | /elérési_út/fájl:függvény_neve | |
PostExit | /elérési_út/fájl:függvény_neve | ||
ServerTerm | /elérési_út/fájl:függvény_neve | ||
Midnight | /elérési_út/fájl:függvény_neve | ||
PICSDBLookup | /elérési_út/fájl:függvény_neve | ||
GC Advisor | /elérési_út/fájl:függvény_neve | ||
Proxy Advisor | /elérési_út/fájl:függvény_neve |
Megjegyzés: A Service direktívához kötelező megadni egy URL sablont, ha útvonalfordítást kíván használni.