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.
Slik oppretter du en web-tjeneste fra en bønne med et Apache
Axis-kjøretidsmiljø:
- Bytt til J2EE-perspektivet (Vindu > Åpne perspektiv >
J2EE).
- 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 hvilke trinn av utviklingen av web-tjenestene du vil fullføre ved hjelp av glidebryteren:
- Utvikle: oppretter tjenestekoden
- Assembler:
- Distribuer: oppretter distribusjonskoden for klienten
- Installer: installerer tjenesten på den valgte serveren
- Start: starter serveren når tjenesten er installert på den
- Test: gir ulike alternativer for testing av tjenesten
- 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.
- Siden Web-tjenestetest: Hvis du valgte å teste 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 til å 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å Fullfør. 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, blir web-tjenesteutforskeren åpnet. Den
viser siden som er nødvendig 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.