Guiden Webserviceprogram kan hjælpe dig med at oprette en skelet-bean fra et eksisterende WSDL-dokument. En skelet-bean indeholder et sæt metoder, der svarer til de funktioner, som beskrives i WSDL-dokumentet. Når den pågældende bean er oprettet, er der for hver metode en kort implementering, som du erstatter ved at redigere bean'en.
Forudsætninger:
- 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
- Opret eller importér en WSDL-fil til webprojektets folder med webindhold.
Du kan kun bruge en WSDL-fil, der indeholder et serviceelement.
Sådan opretter du et webserviceprogram fra en WSDL-fil vha. Apache Axis 1.0-runtime-miljøet:
- Skift til J2EE-perspektivet (Window > Åbn perspektiv > J2EE).
- Vælg i oversigten Project Explorer den WSDL-fil, du har oprettet eller importeret til folderen med webindhold eller webprojektet.
- Klik
på Fil > Ny > Andet. Vælg Webserviceprogrammer for at få vist de forskellige webserviceprogramguider.
Vælg guiden Webserviceprogram. Klik på Næste.
- Siden Webserviceprogrammer: Vælg Top ned Java-bean til webserviceprogram som type webserviceprogram, og vælg det artefakt, som serviceprogrammet skal oprettes fra.
- Vælg de udviklingstrin af webserviceprogrammet, som du vil udføre, vha. skyderen.
- Udvikling: opretter serviceprogramkoden
- Samling:
- Distribution: opretter distributionskoden for serviceprogrammet
- Installation: installerer serviceprogrammet på den valgte server
- Start: starter serveren, når serviceprogrammet er blevet installeret på den
- Test: stiller diverse indstillinger til rådighed til brug for test af serviceprogrammet
- Vælg server: standardserveren vises. Hvis du vil distribuere serviceprogrammet til en anden server, skal du klikke på linket for at angive en anden server.
- Vælg kørselstidspunkt: standardkørselstidspunktet vises. Hvis du vil distribuere serviceprogrammet på et andet kørselstidspunkt, skal du klikke på linket og angive et andet kørselstidspunkt.
- Vælg serviceprogramprojekt: det projekt, der indeholder det projekt, du valgte på 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.
- Hvis du vil oprette en klient, skal du vælge den type proxy, der skal genereres, og gentage ovenstående trin for klienten.
- Publicér webserviceprogrammet: starter Web Services Explorer for at publicere webserviceprogrammet til en UDDI-registreringsdatabase.
- 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
- Siden Konfiguration af skelet-Java-bean til webserviceprogram: Vælg den folder, hvor genereret Java skal gemmes. Hvis du vil gennemgå eller redigere tilknytningerne vha. mapping mellem pakker og navneområder, skal du vælge afkrydsningsfeltet Definér tilpasset for navneområde til pakke. Klik på Næste.
- Siden Klientnavneområde for webserviceprogram til pakke-mapping: Hvis du har valgt Definér tilpasset mapping for pakke til navneområde på forrige skærmbillede, kan du angive tilpassede mapping-par på dette skærmbillede ved at klikke på Tilføj. Klik på Næste.
- Siden Webserviceprogramtest: Hvis du har valgt at teste webserviceprogrammet, skal du vælge testfunktionen for det genererede webserviceprogram. Det åbner webserviceprogrammet i Web Services Explorer. Vælg den funktion, du vil teste, angiv de nødvendige oplysninger, og klik på Udfør. Resultatet vises i delvinduet Status. Klik på Næste.
- Siden Proxy for webserviceprogram: Hvis du har valgt at generere en proxy,
viser denne side proxy'ens indstillinger. Den angiver folderen, hvor proxy'en genereres, og du kan oprette tilpassede tilknytninger vha. mapping mellem navneområder og pakker. Klik på Næste.
- Siden Test af webserviceprogramklient: Brug denne side til at vælge følgende indstillinger:
- Vælg testfunktion. Du kan teste den genererede proxy
i Web Service Explorer, eller du kan generere et eksempel på en webserviceprogram-JSP.
- Hvis du vælger at teste proxy'en via en JSP, kan du vælge den folder, hvor JSP'en skal placeres, og du kan vælge de metoder, der skal inkluderes i JSP'en.
- Vælg Udfør test på server for at starte serveren automatisk.
- Siden Publicering af webserviceprogram: Hvis du har valgt at publicere webserviceprogrammet til en
UDDI-registreringsdatabase, skal du bruge denne side til at starte Web Services Explorer
og vælge den UDDI-registreringsdatabase, som webserviceprogrammet skal publiceres til. Klik på Afslut.
Når webserviceprogrammet er oprettet, kan følgende ske, afhængigt af dine indstillingsvalg:
- Hvis du har valgt at teste den genererede proxy vha. webserviceprogram-JSP'er,
starter proxy'en i en webbrowser på følgende URL: http://localhost: port/ WebProjectClient/sampleBeanName/ WebServiceName/TestClient.jsp Du kan bruge dette programeksempel til at teste webserviceprogrammet ved at vælge en metode, angive en værdi for metoden og klikke på Start. Metodens resultat vises i resultatdelvinduet.
- Hvis du har valgt at teste webserviceprogrammet vha. Web Services Explorer, åbner Web Services Explorer. Vælg den funktion, du vil teste, angiv de nødvendige oplysninger, og klik på Udfør. Resultatet vises i delvinduet Status.
- Hvis du har valgt at publicere webserviceprogrammet, starter Web Services Explorer
og viser den side, der er nødvendig for at publicere webserviceprogrammet. Følg vejledningen i Publicér webserviceprogram for at udføre denne opgave.