Java-bean-komponentin perusrakenteen luonti WSDL-asiakirjasta ajonaikaisessa Apache Axis1 -ympäristössä

Ohjattu Web-palvelun luontitoiminto auttaa bean-komponentin perusrakenteen luonnissa WSDL-tiedostosta. Bean-komponentin perusrakenteessa on joukko metodeja, jotka vastaavat WSDL-asiakirjassa kuvattuja toimintoja. Kun bean-komponentti luodaan, kullakin metodilla on tavanomainen toteutus, jonka voit korvata muokkaamalla bean-komponenttia.

Edellytykset:

  1. 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.
  2. Luo tai tuo WSDL-tiedosto Web-projektin Web-sisältö-kansioon. Voit käyttää vain palveluelementin sisältäviä WSDL-tiedostoja.
Voit luoda Web-palvelun WSDL-tiedostosta ajonaikaisessa Apache Axis1 -ympäristössä seuraavasti:
  1. Vaihda Java EE -perspektiiviin (Ikkuna > Avaa perspektiivi > Java EE).
  2. Valitse projektien selausnäkymästä se WSDL-tiedosto, joka on luotu tai tuotu Web-projektin Web-sisältö-kansioon.
  3. Valitse vaihtoehdot Tiedosto > Uusi > Muu. Näytä eri ohjatut Web-palvelutoiminnot valitsemalla Web Services -palvelut -vaihtoehto. Valitse ohjattu Web-palvelutoiminto. Napsauta Seuraava-painiketta.
  4. Web-palvelut-sivu: valitse Web-palvelun tyypiksi Jäsentävän Java-bean-komponentin Web-palvelu ja valitse artefakti, josta palvelu luodaan.
    1. Valitse liukusäädintä siirtämällä Web-palveluiden kehitysvaiheet, jotka haluat suorittaa:
      • Kehitä: tämä kehittää Web-palvelun WSDL-määrityksen ja -toteutuksen. Tähän sisältyy esimerkiksi luodun koodin, WSDL-tiedostot, käyttöönoton kuvaajat ja Java-tiedostot sisältävien moduulien luonti tarvittaessa.
      • Kokoa: tämä varmistaa, että Web-palvelua tai -työasemaa ylläpitävä projekti liitetään EAR-tiedostoon, kun kohdesovelluspalvelin edellyttää sitä.
      • Ota käyttöön: tämä luo palvelun käyttöönottokoodin.
      • Asenna: tämä asentaa ja määrittää Web-moduulin ja EAR-tiedostot kohdepalvelimeen.
      • Aloita: tämä käynnistää palvelimen, kun palvelu on asennettu siihen. Järjestelmä luo server-config.wsdd-tiedoston.
      • Testaa: tämä antaa käyttöön erilaisia palvelun testausvaihtoehtoja, joita ovat Web Service -selausnäkymän tai JSP-näytetiedostojen käyttö.
    2. Valitse palvelin: näkyviin tulee oletuspalvelin. Jos haluat ottaa palvelun käyttöön toisella palvelimella, määritä käytettävä palvelin napsauttamalla linkkiä.
    3. Valitse ajonaikainen ympäristö: näkyviin tulee oletusarvoinen ajonaikainen ympäristö. Jos haluat ottaa palvelun käyttöön toisessa ajonaikaisessa ympäristössä, määritä käytettävä ajonaikainen ympäristö napsauttamalla linkkiä.
    4. Valitse palveluprojekti: näkyviin tulee työtilassa valittu projekti. Jos haluat valita jonkin toisen projektin ja EAR-tiedoston, napsauta projektilinkkiä. Varmista, että Web-työasemaohjelmaprojektiksi valittu projekti ei ole sama kuin Web-palveluprojekti, tai työasemaohjelmaan luodut artefaktit korvaavat palveluprojektin.
    5. Jos haluat luoda työaseman, valitse luotavan välityspalvelimen laji ja toista edellä kuvatut vaiheet työaseman osalta.
    6. Julkaise Web-palvelu: tämä vaihtoehto aloittaa Web Services -selausnäkymän, jossa voit julkaista Web-palvelun UDDI-rekisterissä.
    7. Valvo Web-palvelua: tämä valinta ohjaa Web-palvelun liikenteen TCP/IP-valvontaohjelmalle, jonka avulla voit seurata Web-palvelun tuottamaan SOAP-liikennettä ja testata tämän palveluliikenteen WS-I-yhteensopivuuden. Vaihtoehtoisesti voit asentaa TCP/IP-valvontaohjelman manuaalisesti, kuten kohdassa TCP/IP-valvontaohjelman käyttö Web-palveluiden testaukseen kuvataan.
  5. Web-palveluiden perusrakenteen Java-bean-komponentin kokoonpanosivu: Valitse kansio, johon luotu Java-komponentti tallennetaan. Jos haluat tarkistaa tai muokata pakettien ja nimitilojen välisiä vastaavuuksia, valitse Määritä mukautettu Nimitilasta pakettiin -vastaavuuden määritys -valintaruutu. Napsauta Seuraava-painiketta.
  6. Web-palvelun paketista nimitilaan -vastaavuusparien määrityssivu: Jos valitsit edellisessä ruudussa Määritä mukautettu Paketista nimitilaan -vastaavuuden määritys -vaihtoehdon, voit kirjoittaa mukautetut vastaavuusparit tässä ruudussa napsauttamalla Lisää-painiketta. Vaihtoehtoisesti voit tuoda mukautetut vastaavuusparit .properties-tiedostosta napsauttamalla Tuo-painiketta. Ominaisuustiedoston sisällön on oltava muodossa nimitila = paketti. Joissakin erikoismerkeissä on käytettävä koodinvaihtomerkkejä ominaisuustiedostossa. Esimerkiksi merkkijono http://nimitila=paketti on kirjoitettava muodossa http\://nimitila=paketti. Muussa tapauksessa järjestelmä tulkitsee kaksoispisteen (:) erotinmerkiksi ja yrittää määrittää merkkijonot http ja //nimitila=paketti toisiaan vastaaviksi.
  7. Web-palvelun testisivu: Jos valitsit Web-palvelun testauksen, määritä luodun 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.
  8. Web-palvelun välityspalvelinsivu: jos olet valinnut välityspalvelimen luonnin, tällä sivulla näkyvät välityspalvelimen valinnat. Ruudussa näkyy kansio, johon välityspalvelin luodaan, ja lisäksi voit luoda mukautettuja vastaavuusmäärityksiä nimitilojen ja pakettien välille. Napsauta Seuraava-painiketta.
  9. Web-palvelun työasemaohjelman testisivu: määritä tällä sivulla seuraavat valinnat:
    1. Valitse testitoiminto. Voit testata luodun välityspalvelimen Web Service -selausnäkymässä tai luoda Web-palvelun JSP-mallikokoonpanon.
    2. Jos valitset välityspalvelimen testauksen JSP:n kautta, voit valita kansion, jossa JSP sijaitsee, ja valita metodit, jotka sisällytetään JSP:hen.
    3. Käynnistä palvelin automaattisesti valitsemalla Suorita testi palvelimessa.
  10. Web-palvelun julkaisusivu: Jos olet valinnut Web-palvelun julkaisun UDDI-rekisteriin, käytä tätä sivua Web Services -selausnäkymän käynnistykseen ja valitse sitten UDDI-rekisteri, johon Web-palvelu julkaistaan. Napsauta Valmis-painiketta.
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.
Aiheeseen liittyviä käsitteitä
Web-palvelujen luonti ajonaikaisessa Apache Axis1 -ympäristössä