I guiden Webbtjänst får du hjälp att skapa en ny webbtjänst, konfigurera den för utplacering och placera ut den på en server.
När webbtjänsten är utplacerad får du hjälp i guiden att generera klientproxyn och exempeltillämpningen så att du kan testa webbtjänsten. När du har slutfört testen kan du publicera webbtjänsten till ett UDDI-verksamhetsregister med hjälp av guiden Export.
Förutsättningar:
- 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
- Skapa eller importera en böna till webbprojektets Java-källmapp.
Så här skapar du en webbtjänst från en böna med hjälp av runtime-miljön i Apache Axis:
- Växla till J2EE-perspektivet (Fönster > Öppna perspektiv > J2EE).
- I projektutforskarvyn väljer du den böna som du har skapat eller importerat till källmappen i webbprojektet.
- Klicka på Fil > Nytt > Annat. Välj Webbtjänster så visas de olika guiderna för webbtjänster.
Välj guiden Webbservice. Klicka på Nästa.
- Sidan Webbtjänster: välj Nedifrån och uppåt Webbtjänst för Java-böna som webbtjänsttyp och ange URI-adressen till den WSDL-, WSIL- eller HTML-fil som ska användas när tjänsten skapas.
- Välj de steg av webbtjänstutveckling som du vill slutföra med hjälp av skjutreglaget:
- Utveckla: Tjänstekoden skapas.
- Bygga:
- Placera ut: Utplaceringskoden för tjänsten skapas.
- Installera: Tjänsten installeras på den valda servern.
- Starta: Servern startas när tjänsten har installerats på den.
- Testa: Olika alternativ för testning av tjänsten tillhandahålls.
- Välj server: Standardservern visas. Om du vill placera ut tjänsten på en annan server klickar du på länken och anger en annan server.
- Välj runtime-miljö: Standard-runtime-miljön visas. Om du vill placera ut tjänsten i en annan runtime-miljö klickar du på länken och anger en annan runtime-miljö.
- Välj tjänsteprojekt: 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 testobjekt.
- Om du vill skapa en klient väljer du den typ av proxy som ska genereras och gör om ovanstående steg för klienten.
- Publicera webbtjänsten: webbtjänstutforskaren startas så att du kan publicera webbtjänsten till ett UDDI-register.
- Ö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
- Sidan Java-bön-ID för webbtjänsten: webbtjänstens
WSDL-namn visas. Du har följande alternativ:
- Välj de metoder som ska exponeras.
- Välj kodningsformat. RPC/kodad rekommenderas i runtime-miljö för Axis. Det här kodningsformatet kanske inte fungerar med WS-I.
- Välj det om du vill anpassa paketet till namnområdesavbildningar.
Klicka på Nästa
- Sidan Webbtjänstpaket till Namnområdesavbildningar: om du valt
Definiera anpassad avbildning av paket till namnområde i föregående ruta kan du ange dina par med anpassade avbildningar i den rutan genom att klicka på Lägg till.
- Sidan Webbtjänsttest: Om du valde att testa webbtjänsten väljer du testfunktionen för den genererade webbtjänsten. Webbtjänsten öppnas i webbtjänstutforskaren. Välj den åtgärd som du vill testa, ange nödvändig information och klicka på OK. Resultatet visas i rutan Status.Klicka på Nästa.
- Sidan Webbtjänstproxy: Du väljer den här sidan om du har valt att generera en proxy och vill anpassa paketet till namnområdesavbildningar.
- Sidan Klienttest för webbtjänst: Har kan du välja följande alternativ.
- Välj testfunktion. Du kan testa den genererade proxyn i webbtjänstutforskaren eller du kan generera en exempel-JSP för webbtjänsten.
- Om du väljer att testa proxyn med hjälp av en JSP kan du välja den mapp där JSP kommer att placeras och därefter de metoder som ska inkluderas i JSP.
- Välj Kör test på server så startas servern automatiskt.
- Sidan Publicera webbtjänst: Du väljer det här vare sig du vill publicera den här webbtjänsten till ett UDDI-register eller inte. Klicka på Slutför. Obs! En varning kan visas med följande text Fel vid generering av WSDL från Java. ClassNotFound: <bönnamn>. Du kan ignorera felmeddelandet utan problem.
När webbtjänsten har skapats kan följande hända beroende på vilka alternativ som du har valt:
- Om du valt att testa den genererade proxyn med hjälp av JSP-filerna för webbtjänsten startas proxyn i en webbläsare på följande URL: http://localhost: port/ WebProjectClient/sampleBeanName/ WebServiceName/TestClient.jsp. Du kan testa webbtjänsten med hjälp av den här exempelapplikation genom att välja en metod och ange ett värde för metoden och klicka på Anropa.
Resultatet av metoden visas i resultatrutan.
- Om du valt att testa webbtjänsten med hjälp av Webbtjänstutforskaren öppnas utforskaren. Välj den åtgärd som du vill testa, ange nödvändig information och klicka på OK. Resultatet visas i rutan Status.
- Om du valt att publicera webbtjänsten startas webbtjänstutforskaren. Avsluta uppgiften genom att följa instruktionerna i Publicera webbtjänsten.
Obs! Om metoderna innehåller typer som inte kan användas med exemplet, till exempel matriser, indexerade egenskaper och samlingar tas metoderna bort från exemplet och ett varningsmeddelande visas.