Veiviseren for web-tjenester hjelper deg med å opprette en ny web-tjeneste, konfigurere den for distribusjon og distribuere web-tjenesten til en server.
Så snart web-tjenesten er distribuert, hjelper veiviseren deg med å generere klient-proxyen og eksempelapplikasjonen for å teste web-tjenesten. Når du er ferdig med å
teste, kan du publisere web-tjenesten til et UDDI-firmaregister ved hjelp av
eksportveiviseren.
Forutsetninger:
- Hvis du bruker servlettcontaineren Apache Jakarta Tomcat som
Hvis du bruker servlettcontaineren Apache Jakarta Tomcat som server, må du installere
den, konfigurere en forekomst av den og opprette et web-prosjekt med den som mål, slik
det er beskrevet i Opprette en Apache
Tomcat-server og web-prosjekt
- Opprett eller importer en bønne til Java-kildemappen for web-prosjektet. Hvis du skal importere,
velger du mappen Java-ressurser: src, går til filmenyen og velger
og blar til der pakken ligger.
Slik oppretter du en web-tjeneste fra en bønne med Apache Axis1-kjøretidsmiljøet:
- Bytt til Java EE-perspektivet (Vindu > Åpne perspektiv > Java EE).
- I Prosjektutforsker-visningen velger du bønnen som du opprettet eller
importerte til kildemappen for web-prosjektet.
- Klikk på Fil > Ny(tt) > Annet. Velg Web-tjenester
for å vise de ulike web-tjenesteveiviserne.
Velg veiviseren Web-tjeneste. Klikk på Neste.
- Siden web-tjenester: Velg Nedenfra og oppover Web-tjeneste for
Java-bønne som web-tjenestetype, og oppgi URIen til WSDL-, WSIL- eller
HTML-filen som vil bli brukt til å generere tjenesten.
- Velg de trinnene i web-tjensteutviklingen du vil fullføre ved hjelp av
glidebryteren:
- Utvikle: dette utvikler WSDL-definisjonen og -implementeringen for
web-tjenesten. Dette omfatter oppgaver som å opprette modulene som skal inneholde den
genererte koden, WSDL-filer, distribusjonsdeskriptorer og Java-filer når det er aktuelt.
- Assembler: dette sikrer at prosjektet som skal være vert for web-tjenesten eller -klienten, blir knyttet til en EAR når det kreves
av målapplikasjonstjeneren.
- Distribuer: oppretter distribusjonskoden for klienten.
- Installer: installerer og konfigurerer web-modulen og EARene på målserveren.
- Start: starter serveren når tjenesten er installert på den. Filen server-config.wsdd vil bli generert.
- Test: gir ulike alternativer for testing av tjenesten, for eksempel å bruke
utforskeren for web-tjenester eller JSP-eksempler.
- Velg server: standardserveren blir vist. Hvis du vil distribuere tjenesten til
en annen server, klikker du på linken for å angi en annen server.
- Velg kjøretid: standard kjøretid blir vist. Hvis du vil distribuere tjenesten til en
annen kjøretid, klikker du på linken for å angi kjøretiden.
- Velg tjenesteprosjekt: prosjektet som inneholder det valgte prosjektet i
arbeidsområdet, blir vist.
Hvis du vil velge et annet og prosjekt og en annen EAR, klikker du på prosjektlinken. Forsikre deg om at
prosjektet som er valgt som klientens web-prosjekt, er forskjellig fra
tjenestens web-prosjekt. Hvis ikke, blir tjenesten overskrevet av klientens genererte artefakter.
- Hvis du vil opprette en klient, velger du typen proxy som skal genereres, og
gjentar trinnene over for klienten.
- Publiser web-tjenesten: dette starter web-tjenesteutforskeren og publiserer
web-tjenesten til et UDDI-register.
- Overvåk web-tjenesten: sender web-tjenestetrafikken via TCP/IP-overvåkeren, som gjør
at du kan overvåke SOAP-trafikken som genereres av web-tjenesten, og teste at trafikken
samsvarer med WS-I.
Du kan også konfigurere en TCP/IP-overvåker slik det blir beskrevet i
Bruke
TCP/IP-overvåkeren til å teste web-tjenester.
- Siden Java-bønneidentitet for web-tjeneste: Web-tjenestens WSDL-navn blir oppført. Du har disse alternativene:
- Velg metodene skal skal eksponeres.
- Velg kodestil. RPC/Encoded er den anbefalte kodestilen for Axis-kjøretidsmiljøet. Denne kodemetoden samsvarer ikke med WS-I.
- Velg om du vil tilpasse pakken til navneområdetilordninger.
Klikk på
Neste
- Siden Tilordning fra web-tjenestepakke til navneområde: Hvis du valgte
Definer tilpasset tilordning for pakke til navneområde
i forrige skjermbilde, kan du oppgi dine tilpassede tilordningspar i dette skjermbildet ved å
klikke på Legg til.
Alternativt kan du klikke på Importer for å importere tilpassede tilordningspar fra en .properties-fil.
Innholdet i egenskapsfilen må ha formatet pakke=navneområde.
Enkelte spesialtegn må merkes med kodevekslingstegn i egenskapsfilene.
Eksempel: somePackage=http://someNamespace should be somePackage=http\://someNamespace.
Ellers behandles kolonet (:) som et skilletegn, og det vil resultere i et forsøk på å
tilordne somePackage til http.
- Siden Web-tjenestetest: Hvis du har valgt å teste web-tjenesten, velger du testfunksjonen for den genererte web-tjenesten.
Det
åpner web-tjenesten i
web-tjenesteutforskeren. Velg operasjonen du vil teste, og klikk på Utfør.
Resultatet blir vist i Status-ruten. Klikk på Neste.
- Proxy-side for web-tjeneste: Hvis du har valgt å generere en proxy, velger du om du
vil tilpasse pakken til navneområdetilpasning.
- Siden Klienttest for web-tjeneste: Bruk denne siden for å velge følgende
alternativer:
- Velg testfunksjonen. Du kan teste den genererte proxyen i web-tjenesteutforskeren,
eller du kan generere et eksempel på en web-tjeneste-JSP.
- Hvis du har valgt å teste proxyen via en JSP, kan du velge mappen der JSPen skal
ligge, og du kan velge metoder som blir inkludert i JSPen.
- Velg Kjør test på serveren for å starte serveren automatisk.
- Web-tjenestepublisering: Velg om du vil publisere denne web-tjenesten til et
UDDI-register eller ikke.
Klikk på Finish. Merk: Du får kanskje advarselen Feil ved generering av WSDL fra Java.
ClassNotFound:
<bønnenavn>. Denne feilen kan trygt ignoreres.
Når web-tjenesten er opprettet, kan følgende skje,
avhengig av alternativene du valgte:
- Hvis du har valgt å teste den genererte proxyen ved hjelp av web-tjenestens JSPer,
blir proxyen startet i en nettleser på denne URLen: http://localhost:
port/ WebProjectClient/sampleBeanName/
WebServiceName/TestClient.jsp Du kan bruke denne eksempelapplikasjonen
til å teste web-tjenesten ved å velge en metode, oppgi en verdi for metoden og klikke på
Aktiver. Resultatet av metoden blir vist
i resultatruten.
- Hvis du har valgt å teste web-tjenesten ved hjelp av web-tjenesteutforskeren, blir
utforskeren åpnet. Velg operasjonen du vil teste, og klikk på Utfør. Resultatet blir vist i Status-ruten.
- Hvis du har valgt å publisere web-tjenesten, startes web-tjenesteutforskeren og viser
siden som kreves for å publisere web-tjenesten. Følg instruksjonen i
Publisere web-tjenesten for å fullføre denne oppgaven.
Viktig: Hvis metodene inneholder typer som ikke
støttes av eksempelet, for eksempel matriser, indekserte egenskaper og samlinger, blir
metodene utelatt fra eksempelet, og du får en advarsel.