Generere en Java-klient-proxy og en eksempelapplikasjon fra et WSDL-dokument ved hjelp av Axis1-kjøretidsmiljøet

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:

  1. 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
  2. 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:
  1. Bytt til Java EE-perspektivet (Vindu > Åpne perspektiv > Java EE).
  2. I Navigator-visningen velger du web-prosjektet der du vil generere en eksempelapplikasjon.
  3. Klikk på Fil > Ny(tt) > Annet. Velg web-tjenester for å vise de ulike web-tjenesteveiviserne. Velg veiviseren Web-tjenesteklient. Klikk på Neste.
  4. Web-tjenestesiden:
    1. Oppgi URIen til WSDL-, WSIL- eller HTML-filen som skal brukes til å generere klienten.
    2. Velg hvilken proxytype som skal genereres
    3. 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.
    4. Velg server: standardserveren blir vist. Hvis du vil distribuere klienten til en annen server, klikker du på linken for å angi serveren.
    5. 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.
    6. 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.
    7. 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.
  5. 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.
  6. 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.
  7. 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.
  8. 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 vil ha mer informasjon om hvordan du oppretter et web-prosjekt, kan du lese dokumentasjonen om utvikling av web-applikasjoner.

Beslektede begreper
Opprette web-tjenester med kjøretidsmiljøet Apache Axis1