Generér Java-klient-proxy og programeksempel på basis af et WSDL-dokument vha. Axis-runtime-miljø

Guiden Webserviceprogramklient hjælper dig med at generere en Java™-bean-proxy og et programeksempel. 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 et WSDL-dokument i webprojektet. Du kan kun bruge en WSDL-fil, der indeholder et serviceelement.
Sådan genererer du en Java-klient-proxy og et programeksempel fra et opsporet WSDL-dokument:
  1. Skift til J2EE-perspektivet (Window > Åbn perspektiv > J2EE).
  2. Vælg det webprojekt, som du vil generere et programeksempel i, i oversigten Navigator.
  3. Klik på Fil > Ny > Andet. Vælg Webserviceprogrammer for at få vist de forskellige webserviceprogramguider. 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: opretter klientkoden
      • Samling:
      • Distribution: opretter distributionskoden for klienten
      • Installation: installerer klienten på den valgte server
      • Start: starter serveren, når klienten er installeret på den
      • Test: stiller forskellige valgmuligheder til rådighed for test af klienten
    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 i Brug 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 Klientnavneområde for webserviceprogram til pakke-mapping: Hvis du har valgt Definér tilpasset mapping for navneområde til pakke på forrige skærmbillede, kan du angive tilpassede mapping-par på dette skærmbillede ved at klikke på Tilføj.
  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 Javaklient-proxy, kan du teste webserviceprogrammets metoder via proxy'en vha. webserviceprogrameksempel-JSP'er eller UTC (Universal Test Client).

Du finder flere oplysninger om oprettelse af webprojekter i dokumentationen til udvikling af webprogrammer.