Veiviseren for web-tjenester støtter genereringen av en Java-bønne-proxy og en eksempelapplikasjon. Eksempelet på en web-applikasjon demonstrerer hvordan en proxy-fil skal kodes.
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
- Finn og importer
et WSDL-dokument til web-prosjektet. Du kan bare bruke en
WSDL-fil som inneholder et tjenesteelement.
slik genererer du en Java-klient-proxy og en eksempelapplikasjon fra et oppdaget WSDL-dokument:
- Bytt til Java EE-perspektivet (Vindu > Åpne perspektiv > Java EE).
- I Navigator-visningen velger du
web-prosjektet der du vil generere en eksempelapplikasjon.
- Klikk på Fil > Ny(tt) > Annet. Velg web-tjenester
for å vise de ulike web-tjenesteveiviserne.
Velg veiviseren Web-tjenesteklient. Klikk på Neste.
- Web-tjenestesiden:
- Oppgi URIen til WSDL-, WSIL- eller HTML-filen som skal brukes til å generere klienten.
- Velg hvilken proxytype som skal genereres
- 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 og Java-filer, i tillegg til å kopiere Axis-JAR-filene.
- 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 klienten til en annen server, klikker du på linken for å angi serveren.
- Velg kjøretid: standard kjøretid blir vist. Hvis du vil distribuere klienten til en annen kjøretid, klikker du på linken for å angi kjøretiden.
- Velg klientprosjekt: 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.
- 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.
- Proxy-side for web-tjeneste: Denne ruten viser alternativene for proxyen.
Den viser mappen der proxyen blir generert, og du kan også opprette tilpassede tilordninger mellom navneområder og pakker.
- Siden Tilordning fra web-tjenesteklientens navneområde til pakke: Hvis du har valgt Definer tilpasset tilordning for navneområde til pakke på forrige side, kan du oppgi de tilpassede tilordningsparene på denne siden 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 navneområde=pakke.
Enkelte spesialtegn må merkes med kodevekslingstegn i egenskapsfilene.
For eksempel må http://someNamespace=somePackage oppgis som http\://someNamespace=somePackage.
Ellers behandles kolonet (:) som et skilletegn, og det vil resultere i et forsøk på å
tilordne http til //someNamespace=somePackage.
- Siden Klienttest for web-tjeneste: Denne siden viser om du har valgt å teste klienten.
Velg den testfunksjonen du vil bruke til å teste proxyen, og de metodene du vil inkludere
i proxyen. Vær oppmerksom på at UTC (Universal Test Client)
bare er kompatibel med web-tjenesteklientene som er distribuert på
WebSphere®-serverne.
- Klikk på Fullfør. Hvis du har valgt å teste proxyen, blir testklienten åpnet i et nettleservindu.
Den genererte Java-bønne-proxyen har et eksternt prosedyrekallgrensesnitt til web-tjenesten. Eksempelet på
en web-applikasjon demonstrerer hvordan proxy-filen skal kodes.
Når du har generert Java-klient-proxyen,
kan du teste metodene for web-tjenesten gjennom proxyen ved hjelp av web-tjenestens
JSPer eller UTCen (Universal Test Client).
- 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 vil ha mer informasjon om
hvordan du oppretter et web-prosjekt, kan du lese dokumentasjonen om utvikling av web-applikasjoner.