Webszolgáltatások ügyfélport-információi

Ezen az oldalon beállíthatja a kérések időkorlátját, felülbírálhat egy végpontot, és felülbírálhatja a kötési névteret a webszolgáltatás ügyfélport számára.

A webszolgáltatás több porttal rendelkezhet. Megtekintheti és beállíthatja az összes megadott webszolgáltatás port portjellemzőit. A webszolgáltatások listája a webszolgáltatás ügyfélkötések oldalon található.

Az adminisztrációs konzol ezen oldalának megjelenítéséhez tegye a következőket:
  1. Kattintson az Alkalmazások > Alkalmazástípusok > WebSphere nagyvállalati alkalmazások > erőforrás_neve elemre.
  2. Kattintson a Modulok kezelése > modul_neve > Webszolgáltatási ügyfélkötések elemre.
  3. Kattintson a Portinformációk alatt a Szerkesztés elemre.

Ez az adminisztrációs konzol oldal a Java API XML-alapú webszolgáltatásokhoz (JAX-WS) és a Java API XML-alapú RPC-hez (JAX-RPC) webszolgáltatásokra egyaránt vonatkozik. A JAX-WS ügyfeleknél csak a Felülbírált végpont URL mező támogatott. A többi mező nem alkalmazható a JAX-WS ügyfelekre.

Port

A port nevét határozza meg.

Kérés időtúllépés

Az időtartamot adja meg másodpercekben, amíg a webszolgáltatás ügyfél vár a kérés teljesítésére az adott porton. Ha nincs időkorlát megadva, akkor az alapértelmezett kérési időkorlát (amíg az ügyfél vár) 300 másodperc. Ha a megadott érték 0 (nulla), a használt időkorlát az alapul szolgáló szállítási mechanizmus alapértelmezett értéke. Ez a mező csak a JAX-RPC ügyfeleknél támogatott.

Ez a beállítás tipikusan az ügyfél viselkedésének személyre szabására használható, ha számára a webszolgáltatás elérésére a JMS szállítás van beállítva, és így tovább fog várni egy várt befejezésre. A hálózati feltételektől vagy a webszolgáltatás megvalósítás jellegétől függően szükséges lehet az időkorlát behangolása.

Felülbírált végpont URL

A végpont nevét adja meg, amely az aktuális végpont felülbírálására szolgál. Ha az ügyfél ezen a porton hív meg egy kérést, akkor ez a végpont kerül felhasználásra a WSDL fájlban megadott végpont helyett. Ez a mező a JAX-WS és a JAX-RPC ügyfeleknél is támogatott.

A JAX-RPC vagy JAX-WS ügyfelek meghívásakor a kérések a (webszolgáltatások leírónyelvén írt) WSDL fájlban a porthoz megadott SOAP címhelyattribútumban meghatározott URL címre kerülnek elküldésre. Mindkét programozási modell biztosítja továbbá az ügyfeleknek a végpontcím URL programozott beállításának képességét is. A JAX-RPC esetén az ügyfél a javax.xml.rpc.Stub.ENDPOINT_ADDRESS_PROPERTY tulajdonság segítségével állítja be a végpontcím URL értékét; a JAX-WS esetén az ügyfél a javax.xml.ws.BindingProvider.ENDPOINT_ADDRESS_PROPERTY tulajdonságot használja.

Ha az összeállított alkalmazás egy statikusan kötött webszolgáltatás ügyfelet tartalmaz, akkor az ügyfélnek a fejlesztés során használt WSDL fájlban azonosított megvalósítást (szolgáltatás végpontot) kell használnia. A végpont felülbírálása a telepített WSDL attribútum konfigurálásának egy alternatívája.

A felülbírált végpont URI attribútum portonkénti alapon van meghatározva. Nem igényel egy alternatív WSDL fájlt a modulon belül. A felülbírált végpont URI elsőbbséget élvez a telepített WSDL attribútummal szemben. Az ügyfél ezt az értéket használja a szolgáltatás végpont URI vagy a SOAP üzenet számára a statikus ügyfélkötésekben található érték helyett.

Hiba elkerülése Hiba elkerülése:
  • Ez a mező jellemzően nem érinti a felügyelet nélküli JAX-WS ügyfeleket, mivel nem szerkesztheti a mezőt, ha csak felügyelet nélküli ügyfelekkel rendelkezik. Ha azonban csak felügyelt ügyfelekkel, illetve a felügyelt és felügyelet nélküli ügyfelek keverékével rendelkezik, akkor szerkesztheti a mezőt, és így a tulajdonság beállítása hatással lehet a felügyelet nélküli ügyfelekre. Amennyiben nem szeretné, hogy egy felügyelet nélküli JAX-WS ügyfélszolgáltatástól származó kérés elküldésre kerüljön az ezen mezőben megadott végponti URL címre, úgy adja hozzá a következő egyéni tulajdonságot JVM beállításaihoz:
    com.ibm.ws.websvcs.unmanaged.client.dontUseOverriddenEndpointUri
    Ha felveszi ezt az egyéni tulajdonságot az alkalmazáskiszolgálóhoz tartozó JVM beállításai közé, valamint a true (igaz) értéket határozza meg a számára, akkor azzal megakadályozza, hogy a felügyelet nélküli JAX-WS ügyfélszolgáltatások elérhessék a WSDL fájlban szereplő végpontot felülíró végponti URL címet.
  • A végponti URL beállítások felülbírálata nem marad meg, ha a modul vagy az alkalmazás felülírásra kerül egy frissítési műveletben.
gotcha

Felülbírált kötés

Meghatározza az ezzel a porttal a WSDL fájlban található névtér helyett használandó WSDL fájl kötési névtér URI-t. Ennek a kötésnek nem kell léteznie a WSDL fájlban. Ha az ügyfél ezen a porton hív meg egy kérést, akkor ez a kötés kerül felhasználásra a WSDL fájlban megadott kötés helyett. Felülbírált kötési névteret csak akkor lehet megadni, ha egy felülbírált végpont is meg van határozva. Ez a mező csak a JAX-RPC ügyfeleknél támogatott.



Fájlnév: uwbs_portattribute.html