De wizard Webservice helpt u bij het maken van een nieuwe
webservice, configureren voor ingebruikname en ingebruikname van de webservice
op een server.
Nadat u de webservice in gebruik hebt genomen, helpt de wizard u bij het
genereren van de clientproxy en een voorbeeldtoepassing voor het testen van de
webservice. Nadat het testen is voltooid, kunt u de webservice publiceren naar
een UDDI-bedrijfsregister met behulp van de wizard Exporteren.
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
- Maak of importeer een bean in de
Java-bronmap
van het webproject.
Een webservice maken op basis van een bean met behulp van de Apache Axis-runtimeomgeving:
- Ga naar het perspectief J2EE ( Venster > Perspectief openen > J2EE).
- Selecteer in de view Projectverkenner de bean die u hebt gemaakt
of in de bron map van uw webproject hebt geïmporteerd.
- 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 beneden naar boven Webservice
Java-bean als type webservice en geef de URI op van het WSDL-,
WSIL- of HTML-bestand dat wordt gebruikt om de service te genereren.
- Selecteer met de schuifregelaar de ontwikkelstadia van de webservices die u wilt voltooien:
- Ontwikkelen: De servicecode wordt gemaakt
- Assembleren:
- In gebruik nemen: De code voor ingebruikname voor de service wordt gemaakt
- Installeren: De service wordt op de gekozen server geïnstalleerd
- Starten: De server wordt gestart nadat de service op de server is geïnstalleerd
- Testen: Er zijn opties beschikbaar voor het testen van de service
- 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 standaardruntime 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.
- Serviceproject: Het project dat wordt afgebeeld, is het project dat het
geselecteerde project in het werkgebied bevat. Op 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 wordt de Webservicesverkenner gestart
om de webservice te publiceren naar een UDDI-register.
- Webservice bewaken: Hiermee wordt ervoor gezorgd dat het verkeer van de
webservice via de TCP/IP-monitor wordt geleid, zodat u het SOAP-verkeer kunt
bewaken dat door de webservice wordt gegenereerd. OOk wordt het verkeer getest
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
- Pagina Webservice-ID voor
Java-bean:
De naam van de WSDL van de webservice wordt afgebeeld. U kunt kiezen uit de volgende opties:
- Selecteer de methoden voor exposeren.
- Selecteer de codeerstijl. De aanbevolen codeerstijl voor de
AXIS-runtimeomgeving is RPC/Encoded. Deze methode voldoet niet aan WS-I.
- Selecteer of u de naamruimtetoewijzingen van het pakket wilt aanpassen.
Klik op Volgende
- Pagina Toewijzing van webservicepakket aan naamruimte: 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.
- 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 afgebeeld in het deelvenster Status. Klik op Volgende.
- Pagina Webserviceproxy: Als u een proxy wilt genereren, selecteert u of u
het pakket wilt aanpassen aan naamruimtetoewijzingen .
- Pagina Webserviceclient testen: Op deze pagina kunt u de volgende opties
selecteren:
- Selecteer de testvoorziening. 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.
- Pagina Webwervice publiceren: Selecteer of u deze webservice naar een
UDDI-register wilt publiceren. Klik op Voltooien. Opmerking: Mogelijk verschijnt de waarschuwing Fout tijdens genereren van WSDL vanuit Java. Klasse niet gevonden: <beannaam>.
Deze fout kunt u negeren.
Nadat u de
webservice hebt gemaakt kan, afhankelijk van de opties die u hebt geselecteerd,
het volgende gebeuren:
- 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.
- Wanneer u ervoor hebt gekozen de webservice te testen met 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 afgebeeld in het deelvenster Status.
- Wanneer u ervoor hebt gekozen de webservice te publiceren, wordt de
Webservicesverkenner geopend met de pagina die vereist is om de webservice te
publiceren. Volg de instructies in De webservice publiceren
om deze taak te voltooien.
Belangrijk: Wanneer uw methoden typen
bevatten die niet worden ondersteund door het voorbeeld, zoals arrays,
geïndexeerde eigenschappen en collecties, dan worden deze methoden niet in het
voorbeeld opgenomen en ontvangt u een waarschuwingsbericht.