Ohjattu Web-palvelun luontitoiminto auttaa uuden Web-palvelun luonnissa, sen kokoonpanon
määrityksessä käyttöönottoa varten ja sen käyttöönotossa palvelimessa.
Kun Web-palvelu on otettu käyttöön, ohjattu toiminto auttaa luomaan työaseman välityspalvelimen ja mallisovelluksen, joiden avulla Web-palvelua voi testata. Kun testaus on valmis, voit julkaista
Web-palvelun UDDI-rekisterissä ohjatun vientitoiminnon avulla.
Edellytykset:
- Jos käytät Apache Jakarta Tomcat -palvelinsovelmasäilöä palvelimenasi, se on asennettava, sen ilmentymän kokoonpano on määritettävä ja on luotava siihen kohdistettu Web-projekti ohjeaiheen Apache Tomcat -palvelimen ja Web-projektin
luonti kuvauksen mukaisesti.
- Luo tai tuo bean-komponentti Web-projektin Java-lähdekansioon.
Voit luoda Web-palvelun bean-komponentista ajonaikaisessa Apache Axis -ympäristössä seuraavasti:
- Vaihda J2EE-perspektiiviin (Ikkuna > Avaa perspektiivi > J2EE).
- Valitse projektien selausnäkymästä se bean-komponentti, joka on luotu tai tuotu Web-projektin
lähdekansioon.
- Valitse vaihtoehdot Tiedosto > Uusi > Muu. Näytä eri ohjatut Web-palvelutoiminnot valitsemalla Web Services -palvelut -vaihtoehto.
Valitse ohjattu Web-palvelutoiminto. Napsauta Seuraava-painiketta.
- Web-palvelut-sivu: valitse Web-palvelun lajiksi Kokoava Java-bean-komponentin Web-palvelu ja anna sen WSDL-, WSIL- tai HTML-tiedoston URI-osoite,
jonka avulla palvelu luodaan.
- Valitse liukusäätimen avulla toteutettavat Web-palvelun kehitysvaiheet:
- Kehitys: tämä vaihtoehto luo palvelun koodin
- Kääntäminen:
- Käyttöönotto: tämä vaihtoehto luo palvelun käyttöönoton koodin
- Asennus: tämä vaihtoehto asentaa palvelun valittuun palvelimeen
- Aloitus: tämä vaihtoehto aloittaa palvelimen, kun palvelu on asennettu siihen
- Testaus: tämä vaihtoehto antaa käyttöön erilaisia valintoja palvelun testaamiseksi
- Valitse palvelin: oletuspalvelin tulee näkyviin. Jos haluat ottaa palvelun käyttöön jossakin toisessa palvelimessa, määritä palvelin napsauttamalla linkkiä.
- Valitse ajonaikainen ympäristö: oletusarvon mukainen ajonaikainen ympäristö tulee näkyviin. Jos haluat ottaa palvelun käyttöön jossakin toisessa ajonaikaisessa ympäristössä, määritä ajonaikainen
ympäristö napsauttamalla linkkiä.
- Valitse palvelun projekti: työtilassa valitun projektin sisältävä projekti tulee näkyviin. Voit valita jonkin toisen projektin ja EAR-tiedoston napsauttamalla projektin linkkiä. Varmista, että Web-työasemaohjelmaprojektiksi valittu projekti ei ole sama kuin Web-palveluprojekti, tai työasemaohjelmaan luodut artefaktit korvaavat palveluprojektin.
- Jos haluat luoda työaseman, valitse luotavan välityspalvelimen laji ja toista edellä kuvatut
vaiheet työaseman osalta.
- Julkaise Web-palvelu: tämä vaihtoehto aloittaa Web Services -selausnäkymän, jossa voit julkaista Web-palvelun UDDI-rekisterissä.
- Valvo Web-palvelua: Web-palvelun liikenne lähetetään TCP/IP-valvontaohjelman kautta, jolloin voit
valvoa Web-palvelun luomaa SOAP-liikennettä ja testata liikenteen WS-I-yhteensopivuuden. Vaihtoehtoisesti voit asentaa TCP/IP-valvontaohjelman manuaalisesti, kuten kohdassa TCP/IP-valvontaohjelman käyttö Web-palveluiden testaukseen kuvataan.
- Web-palvelun Java-bean-komponentin tunnus -sivu: tässä näkyy Web-palvelun WSDL-nimi. Voit valita seuraavista vaihtoehdoista:
- Valitse altistettavat metodit.
- Valitse koodaustyyli. Ajonaikaisessa Axis-ympäristössä suositeltu
koodaustyyli on RPC/Encoded. Tämä koodausmenetelmä ei ole WS-I-yhteensopiva.
- Valitse, haluatko mukauttaa paketista nimitilaan -vastaavuusmääritykset.
NapsautaSeuraava-vaihtoehtoa.
- Web-palvelun Paketista nimitilaan -vastaavuusmäärityssivu: jos valitsit edellisessä
näytössä Määritä mukautettu Paketista nimitilaan -vastaavuuden määritys -vaihtoehdon, voit antaa mukautetut vastaavuusparit tässä näytössä napsauttamalla Lisää-vaihtoehtoa.
- Web-palvelun testaussivu: Jos olet valinnut Web-palvelun testauksen,
valitse Web-palvelun testitoiminto. Tämä avaa Web-palvelun Web Services -selausnäkymässä. Valitse testattava toiminto, anna tarvittavat tiedot ja napsauta Siirry-vaihtoehtoa.
Tulos tulee näkyviin tilaruudussa. Napsauta Seuraava-painiketta.
- Web-palvelun välityspalvelinsivu: jos olet valinnut välityspalvelimen luonnin, valitse, haluatko mukauttaa paketista nimitilaan -vastaavuusmäärityksiä.
- Web-palvelun työaseman testaussivu: Tällä sivulla voit valita seuraavat vaihtoehdot:
- Valitse testitoiminto. Voit testata luotua välityspalvelinta Web Service -selausnäkymässä tai voit luoda Web-palvelun JSP-mallin.
- Jos valitset välityspalvelimen testauksen JSP:n kautta, voit valita kansion, jossa JSP sijaitsee, ja valita metodit, jotka sisällytetään JSP:hen.
- Voit aloittaa palvelimen automaattisesti valitsemalla Testaa palvelin -vaihtoehdon.
- Web-palvelun julkaisusivu: Valitse, haluatko julkaista tämän Web-palvelun
UDDI-rekisterissä. Napsauta Valmis-vaihtoehtoa. Huomautus: näkyviin voi tulla varoitus Virhe muodostettaessa WSDL-tiedostoa
Java-koodista. ClassNotFound: <bean-nimi>. Tämän virheen voi ohittaa turvallisesti.
Kun Web-palvelu on luotu, valitsemiesi vaihtoehtojen mukaan voi tapahtua seuraavaa:
- Jos testaat luotua välityspalvelinta Web-palvelujen JSP-tiedostoilla, välityspalvelin aloitetaan Web-selaimessa seuraavassa URL-osoitteessa: http://localhost: port/WebProjectClient/sampleBeanName/WebServiceName/TestClient.jsp. Mallisovellusta voi käyttää Web-palvelun testaukseen valitsemalla metodin, syöttämällä metodille arvon ja napsauttamalla Kutsu-painiketta. Metodin tulos näytetään tulosruudussa.
- Jos testaat Web-palvelua Web Services -selausnäkymän avulla, selausnäkymä
avautuu. Valitse testattava toiminto, anna tarvittavat tiedot ja napsauta Siirry-vaihtoehtoa. Tulos tulee näkyviin tilaruudussa.
- Jos valitsit Web-palvelun julkaisun, Web Services -selausnäkymässä tulee näkyviin sivu,
jonka avulla voit julkaista Web-palvelun. Noudata kohdan Web-palvelun julkaisu ohjeita ja tee tehtävä valmiiksi.
Tärkeää: Jos metodit sisältävät lajeja,
joita malli ei tue, esimerkiksi matriiseja, indeksoituja ominaisuuksia tai kokoelmia,
metodit jätetään pois mallista ja saat varoitussanoman.