Een webservice maken aan de hand van een Java-bean met behulp van de Apache Axis1-runtimeomgeving

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:
  1. Maak of importeer een bean in de Java-bronmap van het webproject. Om te importeren selecteert u de map Java-resources: src, kiest u Importeren >Algemeen >Bestandssysteem in het menu Bestand en geeft u aan waar het pakket zich bevindt.
Een webservice maken op basis van een bean met behulp van de Apache Axis1-runtimeomgeving:
  1. Schakel naar het Java EE-perspectief (Venster > Perspectief openen > Java EE).
  2. In de view Projectverkenner selecteert u de bean die u hebt gemaakt of geïmporteerd in de bronmap van uw webproject.
  3. Ga naar Bestand > Nieuw > Overige. Selecteer Webservices om de diverse wizards voor webservices af te beelden. Selecteer de wizard Webservice. Klik op Volgende.
  4. Pagina Webservices: Selecteer Van onderaf Webservice Java-bean als type webservice en geef het URI op van het WSDL-, WSIL- of HTML-bestand dat wordt gebruikt om de service te genereren.
    1. 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.
    2. 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.
    3. 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.
    4. 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.
    5. Als u een client wilt maken, selecteert u het type proxy dat moet worden gegenereerd en herhaalt u de bovenstaande stappen voor de client.
    6. Webservice publiceren: hiermee start u de Webservicesverkenner zodat u de webservice naar een UDDI-register kunt publiceren.
    7. 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
  5. 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 die u wilt exposeren.
    • Selecteer de codeerstijl. RPC/Encoded is de aanbevolen coderingsstijl voor de Axis-uitvoeringsomgeving. Deze coderingsmethode is niet compatibel met WS-I.
    • Geef op of u een aangepaste toewijzing van pakket aan naamruimte wilt definiëren.
    Klik op Volgende
  6. 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. U kunt ook op Importeren klikken om aangepaste toewijzingsparen te importeren uit een .properties-bestand. De content van het PROPERTIES-bestand moet de indeling pakket=naamruimte hebben. U moet escape-tekens plaatsen voor enkele speciale tekens in de eigenschappenbestanden. somePackage=http://someNamespace moet bijvoorbeeld somePackage=http\://someNamespace zijn. Anders zou de dubbele punt (:) worden beschouwd als scheidingsteken, waardoor somePackage zou worden toegewezen aan http.
  7. 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.
  8. Pagina Webserviceproxy: Als u een proxy wilt genereren, selecteert u hier of u het pakket wilt aanpassen aan toewijzingen voor naamruimten.
  9. Pagina Webserviceclient testen: Op deze pagina kunt u de volgende opties selecteren:
    1. Selecteer een testfunctie. U kunt de gemaakte proxy testen in de Webservicesverkenner of u kunt een voorbeeld-webservice-JSP maken.
    2. 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.
    3. Selecteer Servertest uitvoeren om de server automatisch te starten.
  10. Pagina Webwervice publiceren: Geef aan 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. ClassNotFound: <bean_naam>. Deze waarschuwing kunt u zonder problemen negeren.
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.

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.

Verwante concepten
Webservices maken met behulp van de Apache Axis1 runtimeomgeving