De wizard Webservice helpt u bij het maken van een raamwerkbean op
basis van een bestaand WSDL-document. De raamwerkbean bevat een set methoden die corresponderen met de bewerkingen die in het WSDL-document zijn gedocumenteerd. Nadat de bean is gemaakt, bevat deze een standaardimplementatie. U kunt deze vervangen door de bean te bewerken.
Vereisten:
- Gebruikt u de Apache Jakarta Tomcat-servletcontainer
als server, dan moet u deze installeren, een instance ervan configureren en een
webproject maken met de container als doel, zoals is beschreven in Een Apache Tomcat-server en een webproject maken
- Een WSDL-bestand maken of importeren in de webcontentmap van het webproject.
U kunt alleen een WSDL-bestand gebruiken dat een service-element bevat.
Maak een webservice op basis van een WSDL-bestand met behulp van de Apache Axis1-runtimeomgeving:
- Schakel naar het Java EE-perspectief (Venster > Perspectief openen
> Java EE).
- In de view Projectverkenner selecteert u het WSDL-bestand dat u hebt gemaakt of geïmporteerd in de map voor webcontent van uw webproject.
- Ga naar Bestand > Nieuw > Overige. Selecteer Webservices om de diverse wizards voor webservices af te beelden.
Selecteer de wizard Webservice. Klik op Volgende.
- Pagina Webservices: Selecteer Van bovenaf Webservice Java-bean als
webservicetype en selecteer het artefact waarmee de service wordt gemaakt.
- Selecteer met de schuifregelaar de ontwikkelstadia van de webservices die u wilt voltooien:
- Ontwikkelen: Hiermee wordt de WSDL-definitie en implementatie van de webservice
ontwikkeld. Dit omvat taken zoals het maken van de modules die de gegenereerde code,
WSDL-bestanden, ingebruiknamedescriptors en Java-bestanden bevatten.
- Samenstellen: hiermee zorgt u ervoor dat het project dat fungeert als host voor de
webservice of -client, aan een EAR wordt gekoppeld wanneer dit door de
doeltoepassingenserver is vereist.
- In gebruik nemen: De code voor ingebruikname voor de service wordt gemaakt.
- Installeren: Hiermee worden de webmodule en de EAR's op de doelserver geïnstalleerd
en geconfigureerd.
- Starten: De server wordt gestart nadat de service op de server is geïnstalleerd. Het bestand server-config.wsdd wordt gegenereerd.
- Testen: Er zijn opties beschikbaar voor het testen van de service, zoals het gebruik
van de Webservicesverkenner of voorbeeld-JSP's.
- Server: de standaardserver wordt afgebeeld. Als u de service op een andere server in gebruik wilt nemen, klikt u op de link om een andere server op te geven.
- Runtime: de standaard runtime wordt afgebeeld. Als u de service op
een andere runtime in gebruik wilt nemen, klikt u op de link om een andere
runtime op te geven.
- Selecteer het serviceproject: het project dat het project bevat dat in uw werkgebied is
geselecteerd wordt weergegeven. Om een ander project en EAR te selecteren, klikt u op de projectlink. Zorg
ervoor dat u verschillende webprojecten kiest voor de client en de service, omdat de service anders wordt
overschreven door de gegenereerde artefacten van de client.
- Als u een client wilt maken, selecteert u het type proxy dat moet worden
gegenereerd en herhaalt u de bovenstaande stappen voor de client.
- Webservice publiceren: hiermee start u de Webservicesverkenner zodat u de webservice naar een
UDDI-register kunt publiceren.
- Webservice bewaken: hiermee verzendt u het webserviceverkeer via de TCP/IP-monitor, zodat u het SOAP-verkeer kunt bekijken dat is gegenereerd door de webservice en u dit verkeer kunt testen op naleving van WS-I. U kunt ook handmatig een TCP/IP-monitor instellen. Dit
wordt beschreven in
De
TCP/IP-monitor gebruiken om webservices te testen
- Configuratiepagina voor raamwerk webservices Java™-bean:
Selecteer de map waarin de gegenereerde Java wordt opgeslagen. Als u de toewijzingen tussen pakketten en naamruimten wilt
bewerken, selecteert u het vakje Aangepaste toewijzing van naamruimte aan pakket definiëren. Klik op Volgende.
- Pagina Toewijzing van webserviceclientnaamruimte aan pakket: Als u op het
vorige scherm Aangepaste toewijzing van naamruimte aan pakket
definiëren hebt geselecteerd, kunt u op dit scherm aangepaste
toewijzingsparen opgeven door op Toevoegen te klikken. U kunt ook
op Importeren klikken om aangepaste toewijzingsparen te importeren uit een
.properties-bestand.
De content van het eigenschappenbestand moet de indeling
naamruimte=pakket hebben.
U moet escape-tekens plaatsen voor enkele speciale tekens in de eigenschappenbestanden.
http://someNamespace=somePackage moet bijvoorbeeld http\://someNamespace=somePackage zijn.
Anders zou de dubbele punt (:) worden beschouwd als scheidingsteken, waardoor http zou worden toegewezen aan //someNamespace=somePackage.
- Pagina Webservicetest: Als u de webservice wilt testen, selecteert u de
testvoorziening voor de gegenereerde webservice. De webservice wordt dan geopend in de Webservicesverkenner. Selecteer de bewerking die u wilt testen, vul de vereiste gegevens in en klik
op Go.
Het resultaat wordt weergegeven in het venster Status. Klik op Volgende.
- Pagina Webserviceproxy: Als u een proxy wilt genereren, vindt u op deze pagina
de opties voor de proxy. Hier ziet u de map waarin de proxy wordt gegenereerd en u kunt desgewenst aangepaste toewijzingen tussen naamruimten en pakketten maken. Klik op Volgende.
- Pagina Webserviceclient testen: Op deze pagina kunt u de volgende opties
selecteren:
- Selecteer een testfunctie. U kunt de gemaakte proxy testen in de
Webservicesverkenner of u kunt een voorbeeld-webservice-JSP maken.
- Wanneer u ervoor hebt gekozen om de proxy via een JSP te testen, kunt u de
map van de JSP selecteren en kunt u de methode selecteren waarin de JSP wordt
opgenomen.
- Selecteer Servertest uitvoeren om de server
automatisch te starten.
- Webservice publiceren: Als u hebt opgegeven dat u de webservice wilt publiceren voor een UDDI-register, kunt u via deze pagina de Webservicesverkenner starten en het UDDI-register selecteren waarvoor u de webservice wilt publiceren. Klik op Voltooien.
Nadat de webservice is gemaakt, gebeurt er het volgende afhankelijk van de opties die u hebt geselecteerd:
- Als u hebt aangegeven dat de gegenereerde proxy met JSP-bestanden moet
worden getest, wordt de proxy in een webbrowser gestart op de volgende URL:
http://localhost:poort/ WebprojectClient/sampleBeannaam/Webservicenaam/Testclient.jsp
U kunt deze voorbeeldtoepassing gebruiken voor het testen van de webservice
door een methode te selecte ren, een waarde op te geven voor de methode en op
Aanroepen te klikken. Het resultaat van de methode wordt in de resultatensectie afgebeeld.
- Als u hebt opgegeven dat u de webservice wilt testen met behulp van de Webservicesverkenner, wordt de verkenner geopend. Selecteer de bewerking die u wilt testen, vul de vereiste gegevens in en klik
op Go. Het resultaat wordt weergegeven in het venster Status.
- Als u hebt opgegeven dat u de webservice wilt publiceren, wordt de Webservicesverkenner gestart en ziet u de pagina die is vereist voor het publiceren van uw webservice. Volg de instructies in De webservice publiceren
om deze taak te voltooien.