Een raamwerk-Java-bean maken op basis van een WSDL-document met behulp van de Apache Axis-runtimeomgeving

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:

  1. 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
  2. Maak of importeer een WSDL-bestand in de map Webcontent 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 Axis 1.0 runtimeomgeving:
  1. Ga naar het perspectief J2EE ( Venster > Perspectief openen > J2EE).
  2. Selecteer in de view Projectverkenner het WSDL-bestand dat u hebt gemaakt of in de map Webcontent van uw webproject hebt geïmporteerd.
  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 boven naar beneden Webservice Java-bean als webservicetype en selecteer het artefact waarmee de service wordt gemaakt.
    1. 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
    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 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.
    4. 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.
    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 wordt de Webservicesverkenner gestart om de webservice te publiceren naar een UDDI-register.
    7. 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
  5. 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.
  6. 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. Klik op Volgende.
  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 afgebeeld in het deelvenster Status. Klik op Volgende.
  8. Pagina Webserviceproxy: Als u een proxy wilt genereren, vindt u op deze pagina de opties voor de proxy. Op de pagina vindt u de map waarin de proxy wordt gemaakt. Eventueel kunt u aangepaste toewijzingen maken tussen naamruimten en pakketten. Klik op Volgende.
  9. Pagina Webserviceclient testen: Op deze pagina kunt u de volgende opties selecteren:
    1. Selecteer de testvoorziening. 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: Wanneer u ervoor hebt gekozen om uw webservice te publiceren naar een UDDI-register, gebruikt u deze pagina om de Webservicesverkenner te starten en het UDDI-register te selecteren waarin de webservice wordt gepubliceerd. Klik op Voltooien.
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.