Caching Proxy Súgó

API kérés feldolgozás

A(z) API áttekintése

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:

Alapvető kiszolgálókérési folyamat

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.

API konfigurációs direktívák

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.

API direktíva formátumok

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

API direktíva változók

A direktívákban szereplő változók jelentése a következő:
típus
(Csak az Authentication direktívával használható.) Ez a beállítás határozza meg, hogy mikor kell meghívni az alkalmazásfüggvényt. A lehetséges értékek a következők:
Alapszintű
Az alkalmazásfüggvény meghívására csak az alapszintű hitelesítési kéréseknél kerül sor.
*
Az alkalmazásfüggvény meghívására minden kérésnél sor kerül.

/URL
Ez az érték határozza meg, hogy mely URL kéréseknél kell meghívni az alkalmazásfüggvényt. Az ezekben a direktívákban szereplő URL meghatározások virtuálisak (nem tartalmazzák a protokollt), de előttük meg kell adni egy osztásjelet (/). Például a /www.ibm.com helyes, a http://www.ibm.com viszont nem. A lehetséges értékek a következők:
Egy bizonyos URL
Az alkalmazásfüggvény meghívására csak ennél az URL címnél kerül sor.
URL sablon
Az alkalmazásfüggvény meghívására csak a sablonnak megfelelő URL címek esetében kerül sor. A sablon /URL*, /* vagy * formában adható meg.

Megjegyzés: A Service direktívához kötelező megadni egy URL sablont, ha útvonalfordítást kíván használni.


/elérési út/fájl
A lefordított program teljes képzésű fájlneve
:függvény_neve
Az alkalmazásfüggvénynek a programon belül adott név. A Transmogrifier direktívában meg kell adni a megnyitási, az írási és a lezárási függvény nevét.

Kapcsolódó információk