Java-työaseman välityspalvelimen ja mallisovelluksen luonti WSDL-asiakirjasta ajonaikaisen Axis1-ympäristön avulla

Ohjattu Web-palvelun työasemaohjelman luontitoiminto auttaa Java-bean-komponentin perusrakenteen luonnissa luomalla Java-bean-välityspalvelimen ja mallisovelluksen. Web-mallisovellus näyttää, miten välityspalvelintiedosto koodataan.

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. Hae ja tuo WSDL-asiakirja Web-projektiin. Voit käyttää vain palveluelementin sisältäviä WSDL-tiedostoja.
Luo Java-työaseman välityspalvelin ja mallisovellus havaitusta WSDL-asiakirjasta seuraavasti:
  1. Vaihda Java EE -perspektiiviin (Ikkuna > Avaa perspektiivi > Java EE).
  2. Valitse navigaattorinäkymästä Web-projekti, johon haluat luoda mallisovelluksen.
  3. Valitse vaihtoehdot Tiedosto > Uusi > Muu. Näytä eri ohjatut Web-palvelutoiminnot valitsemalla Web Services -palvelut -vaihtoehto. Valitse ohjattu Web-palvelun työasemaohjelma -toiminto. Napsauta Seuraava-painiketta.
  4. Web-palvelut-sivu:
    1. Anna työaseman luontiin käytettävän WSDL-, WSIL- tai HTML-tiedoston URI-tunniste.
    2. Valitse luotavan välityspalvelimen laji.
    3. 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 ja Java-tiedostot sisältävien moduulien luonti sekä Axis-ympäristön JAR-tiedostojen kopiointi.
      • 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ö.
    4. Valitse palvelin: näkyviin tulee oletuspalvelin. Jos haluat ottaa työasemaohjelman käyttöön toisella palvelimella, määritä käytettävä palvelin napsauttamalla linkkiä.
    5. Valitse ajonaikainen ympäristö: näkyviin tulee oletusarvoinen ajonaikainen ympäristö. Jos haluat ottaa työasemaohjelman käyttöön toisessa ajonaikaisessa ympäristössä, määritä käytettävä ajonaikainen ympäristö napsauttamalla linkkiä.
    6. Valitse työasemaohjelman projekti: 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.
    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-palvelun välityspalvelinsivu: Tällä sivulla näkyvät välityspalvelimen valinnat. Sivulla näkyy kansio, johon välityspalvelin luodaan, ja lisäksi voit luoda mukautettuja vastaavuusmäärityksiä nimitilojen ja pakettien välille.
  6. Web-palvelun nimitilasta pakettiin -vastaavuusparien määrityssivu: Jos valitsit edellisellä sivulla Määritä mukautettu Nimitilasta pakettiin -vastaavuuden määritys -valintaruudun, voit määrittää mukautetut vastaavuusparit tällä sivulla 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 työasemaohjelman testisivu: Tämä sivu tulee näkyviin, jos valitsit työasemaohjelman testauksen. Valitse välityspalvelimen testaukseen käytettävä testitoiminto ja metodit, jotka haluat sisällyttää välityspalvelimeen. Huomaa, että Universal Test Client (UTC) on yhteensopiva ainoastaan WebSphere-palvelimissa käyttöönotettujen Web-palvelun työasemaohjelmien kanssa.
  8. Napsauta Valmis-painiketta. Jos valitsit välityspalvelimen testauksen, testaustyöasemaohjelma avautuu selausikkunaan.

Luotu Java-bean-välityspalvelin tuottaa etäkutsuliittymän Web-palvelua varten. Web-mallisovellus näyttää, miten välityspalvelintiedosto koodataan.

Kun Java-työasemaohjelman välityspalvelin on luotu, voit testata Web-palvelun metodit välityspalvelimen avulla käyttämällä Web Services -JSP-malleja tai Universal Test Client -työasemaohjelmaa.

Lisätietoja Web-projektin luonnista on Web-sovellusten kehitysohjeissa.

Aiheeseen liittyviä käsitteitä
Web-palvelujen luonti ajonaikaisessa Apache Axis1 -ympäristössä