Generera en Java-klientproxy och en exempeltillämpning från ett WSDL-dokument med hjälp av runtime-miljön för Axis1

Med guiden Webbtjänstklient får du hjälp att generera en Java-bönproxy och en exempeltillämpning. I exempelwebbtillämpningen visas hur du ska koda proxyfilen.

Förutsättningar:

  1. Om du använder servletbehållaren för Apache Jakarta Tomcat som server måste du installera den, konfigurera en förekomst av den och skapa ett webbprojekt avsett för den enligt beskrivningen i Skapa en Apache Tomcat-server och Apache Tomcat-webbprojekt
  2. Söka och importera ett WSDL-dokument till webbprojektet. Du kan endast använda en WSDL-fil som innehåller ett serviceelement.
Gör på följande sätt om du vill generera en Java-klientproxy och en exempeltillämpning från ett hittat WSDL-dokument:
  1. Byt till Java EE-perspektivet (Fönster> Öppna perspektiv > Java EE).
  2. I navigeringsvyn väljer du webbprojektet i vilket du vill generera en exempeltillämpning.
  3. Klicka på Fil > Nytt > Annat. Välj Webbtjänster så visas de olika guiderna för webbtjänster. Välj guiden Webbserviceklient. Klicka på Nästa.
  4. Sidan Webbtjänser:
    1. Ange URI till WSDL-, WSIL- eller HTML-filen med vars hjälp klienten ska genereras.
    2. Välj den typ av proxy som ska genereras
    3. Välj de steg av webbtjänstutveckling som du vill slutföra med hjälp av skjutreglaget:
      • Utveckla: Utveckla WSDL-definitionen och -implementationen för webbtjänsten. I det ingår uppgifter som att skapa de moduler som innehåller den genererade koden och Java-filer, samt att kopiera Axis-JAR-filerna.
      • Assemblera: Projektet som ska vara värd för webbtjänsten eller -klienten kopplas till en EAR när det behövs för måltillämpningens server.
      • Placera ut: Utplaceringskoden för tjänsten skapas.
      • Installera: Installera och konfigurera webbmodulerna och EAR-filerna på målservern.
      • Starta: Servern startas när tjänsten har installerats på den. Filen server-config.wsdd genereras.
      • Testa: Olika alternativ för testning av tjänsten, som att använda webbtjänstutforskaren eller JSP-exempelfiler.
    4. Välj server: standardservern visas. Om du vill utplacera din klient till en annan server klickar du på länken och anger en annan server.
    5. Välj runtime-miljö: den runtime-miljön som är standard visas. Om du vill utplacera din klient till en annan runtime-miljö klickar du på länken och anger en annan runtime-miljö.
    6. Välj klientprojekt: projektet med det projekt som valts på din arbetsyta visas. Om du vill välja ett annat projekt och EAR klickar du på projektlänken. Säkerställ att det projekt som valts som Klientwebbprojekt inte är samma som Servicewebbprojekt. I annat fall kommer tjänsten att skrivas över av klientens genererade artefakter.
    7. Övervaka webbtjänsten: det här skickar webbtjänsttrafiken genom TCP/IP-övervakaren, vilket möjliggör för dig att se den SOAP-trafik som genereras av webbtjänsten och att testa denna trafik för WS-I-kompatibilitet. Alternativt kan du manuellt ställa in en TCP/IP-övervakare enligt beskrivningen i Testa webbtjänster med TCP/IP-övervakare
  5. Sidan Webbtjänstproxy: Denna ruta visar alternativen för proxyn. Den anger den mapp i vilken proxyn kommer att genereras och du kan alternativt skapa anpassade avbildningar mellan namnrymd och paket.
  6. Sidan Webbtjänstnamnrynd till Paketavbildningar: Om du har valt Definiera anpassad avbildning för namnrymd i paketet på föregående sida kan du ange dina par med anpassade avbildningar på denna sida genom att klicka på Lägg till. Om du vill kan du i stället klicka på Importera och importera anpassade avbildningspar från en .properties-fil. Innehållet i egenskapsfilen måste ha formatet namespace=package. Vissa specialtecken måste uteslutas i egenskapsfilerna. http://someNamespace=somePackage ska t.ex. vara http\://someNamespace=somePackage. I annat fall behandlas kolontecknet (:) som ett avgränsningstecken vilket resulterar i ett försöka att avbilda http till //someNamespace=somePackage.
  7. Sidan Klienttest för webbtjänst: Denna sida visas om du valt att testa din klient. Välj den testfunktion som du kommer att använda när du testar proxyn och de metoder som du vill ska ingå i proxyn. Observera att Universal Test Client (UTC) endast är kompatibel med webbtjänstklienter som utplaceras på WebSphere-servrar.
  8. Klicka på Slutför. Om du valt att testa proxyn kommer testklienten att öppnas i ett webbläsarfönster.

Den genererade Java-bönproxyn används som anropsgränssnitt för fjärrprocedurer för webbtjänsten. I exempelwebbtillämpningen visas hur du ska koda proxyfilen.

När du genererat Java-klientproxyn kan du testa webbtjänstmetoderna genom proxyn med hjälp av exempel-JSPer från webbtjänsterna eller Universal-testklienten.

Mer information om att skapa webbprojekt finns i dokumentationen om utveckling av webbtillämpningar.

Närliggande begrepp
Skapa webbtjänster med Apache Axis1-körningsmiljö