Generér en Java-klient-proxy og et eksempelprogram ud fra et WSDL-dokument ved hjælp af Axis1-runtime-miljøet

Guiden Webserviceprogramklient hjælper dig med at generere en Java™-bean-proxy og et eksempelprogram. Webprogrameksemplet viser, hvordan man koder en proxy-fil.

Forudsætninger:

  1. Hvis du bruger Apache Jakarta Tomcat-miniserveropbevaringsstedet som server, skal du installere det, konfigurere en forekomst af det og oprette et webprojekt, der er beregnet til det som beskrevet i Opret Apache Tomcat-server og webprojekt
  2. Opspor og importér WSDL-dokument i webprojektet. Du kan kun bruge en WSDL-fil, som indeholder et serviceprogramelement.
Sådan genererer du en Java-klient-proxy og et programeksempel fra et opsporet WSDL-dokument:
  1. Skift til Java EE-perspektivet (Vindue > Åbn perspektiv > Java EE).
  2. Vælg det webprojekt, du vil generere et programeksempel i, i Navigator-oversigten.
  3. Klik på Fil > Ny > Andet. Vælg webserviceprogrammer for at kunne få fremvist de forskellige guider til webserviceprogrammer. Vælg guiden Webserviceprogramklient. Klik på Næste.
  4. Siden Webserviceprogrammer:
    1. Angiv URI'en til den WSDL-, WSIL- eller HTML-fil, der skal bruges til at generere klienten.
    2. Vælg den type proxy, der skal genereres
    3. Vælg de udviklingstrin af webserviceprogrammet, som du vil udføre, vha. skyderen.
      • Udvikling: udvikler WSDL-definitionen og -implementeringen af webserviceprogrammet. Det omfatter bl.a. opgaver som oprettelse af moduler, der indeholder den genererede kode, samt kopiering af Axis JAR-filer.
      • Assemblering: sikrer, projektet, som skal være vært for Webserviceprogrammet eller klienten, knyttes til et EAR-program, når målprogramserveren kræver det.
      • Distribuér: opretter distributionskoden for serviceprogrammet.
      • Installér: installerer og konfigurerer webmodulet og EAR-filerne på målserveren.
      • Start: starter serveren, så snart serviceprogrammet er installeret på den. Filen server-config.wsdd genereres.
      • Test: stiller forskellige indstillinger til rådighed til test af serviceprogrammet, så som brug af Web Service Explorer eller JSP-eksempler.
    4. Vælg server: standardserveren vises. Hvis du ønsker at distribuere klienten til en anden server, skal du klikke på linket for at angive en anden server.
    5. Vælg kørselstidspunkt: standardkørselstidspunktet vises. Hvis du vil ønsker at distribuere klienten til en anden runtime, skal du klikke på linket for at angive en anden runtime.
    6. Vælg klientprojekt: det projekt, der indeholder det projekt, du har valgt i arbejdsområdet, vises. Hvis du vil vælge et andet projekt og EAR, skal du klikke på projektlinket. Sørg for, at det projekt, der er valgt som klientwebprojekt, er et andet end servicewebprojektet, da serviceprogrammet ellers bliver overskrevet af klientens genererede artefakter.
    7. Overvåg webserviceprogram: sender trafikken fra webserviceprogrammet gennem TCP/IP-overvågning, som giver dig mulighed for at følge den SOAP-trafik, der er genereret af webserviceprogrammet og for at teste denne trafik for WS-I-overholdelse. Ellers kan du manuelt klargøre en TCP/IP-overvågning som beskrevet iBrug TCP/IP-overvågning til at teste webserviceprogrammer
  5. Siden Proxy for webserviceprogram: Dette skærmbillede viser indstillingerne for denne proxy. Den viser den folder, hvor proxy'en genereres, og du kan evt. oprette tilpassede tilknytninger vha. mapping mellem navneområder og pakker.
  6. Siden Navneområde for webserviceprogram til pakke-mapping: hvis du har valgt Definér tilpasset mapping for navneområde til pakke på forrige side, kan du angive de tilpassede mapping-par på denne side ved at klikke på Tilføj. Alternativt kan du klikke på Importér for at importere tilpassede mapping-par fra en .properties-fil. Indholdet i egenskabsfilen skal have formatet namespace=package. Du skal bruge Escape-tegn til visse specialtegn i egenskabsfilen. http://someNamespace=somePackage skal f.eks. skrives som http\://someNamespace=somePackage. I modsat fald behandles kolonet (:) som en separator, hvilket medfører forsøg på at tilknytte http til //someNamespace=somePackage.
  7. Webserviceprogramklient: Denne side viser, om du har valgt at teste klienten. Vælg den testfacilitet, du vil bruge til at teste proxy'en, og de metoder, du vil inkludere i proxy'en. Bemærk, at UTC (Universal Test Client) kun er kompatibel med webserviceprogramklienter, der er distribueret på WebSphere®-servere.
  8. Klik på Afslut. Hvis du har valgt at teste proxy'en, åbnes testklienten i et browservindue.

Den genererede Java-bean-proxy indeholder en grænseflade til eksternt procedurekald til webserviceprogrammet. I webprogrameksemplet illustreres, hvordan proxy-filen skal kodes.

Når du har genereret en Java-klient-proxy, kan du teste webserviceprogrammets metoder via proxy'en vha. webserviceprogrameksempel-JSP'er eller UTC (Universal Test Client).

Der er flere oplysninger om oprettelse af et webprojekt i dokumentationen til webprogramudvikling.

Relaterede begreber
Opret webserviceprogrammer med runtime-miljøet Apache Axis1