Opret et webserviceprogram fra en Java-bean vha. Apache Axis-runtime-miljøet

Guiden Webserviceprogram kan hjælpe dig med at oprette et nyt webserviceprogram, konfigurere det til distribution og distribuere webserviceprogrammet til en server. Når først webserviceprogrammet er distribueret, kan guiden hjælpe dig med at generere klient-proxy'en og programeksemplet til brug for test af webserviceprogrammet. Når du er færdig med at teste, kan du publicere webserviceprogrammet til en UDDI-virksomhedsregistreringsdatabase vha. eksportguiden.

Forudsætninger:
  1. Opret eller importér en bean til webprojektets Java™-kildefolder.
Sådan operetter du et webserviceprogram fra en bean vha. Apache Axis-runtime-miljøet:
  1. Skift til J2EE-perspektivet (Window > Åbn perspektiv > J2EE).
  2. Vælg den bean, som du har oprettet eller importeret til webprojektets kildefolder, i oversigten Project Explorer.
  3. Klik på Fil > Ny > Andet. Vælg Webserviceprogrammer for at få vist de forskellige webserviceprogramguider. Vælg guiden Webserviceprogram. Klik på Næste.
  4. Siden Webserviceprogrammer: Vælg Bund op Java-bean til webserviceprogram som webserviceprogramtype, og angiv URI'en til den WSDL-, WSIL- eller HTML-fil, som skal bruges til at generere serviceprogrammet.
    1. 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
    2. 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.
    3. Vælg kørselstidspunkt: standardkørselstidspunktet vises. Hvis du vil distribuere serviceprogrammet på et andet tidspunkt, skal du klikke på linket og angive et andet kørselstidspunkt.
    4. 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.
    5. Hvis du vil oprette en klient, skal du vælge den type proxy, der skal genereres, og gentage ovenstående trin for klienten.
    6. Publicér webserviceprogrammet: starter Web Services Explorer for at publicere webserviceprogrammet til en UDDI-registreringsdatabase.
    7. 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
  5. Siden Java-bean-id til webserviceprogram: WSDL-navnet på webserviceprogrammet vises. Du har følgende muligheder:
    • Vælg de metoder, der skal åbnes.
    • Vælg kodningstype. RPC/kodet er den kodningstype, der anbefales til Axis-runtime-miljøet. Denne kodningsmetode overholder ikke WS-I.
    • Vælg, om du vil tilpasse pakken til navneområdetilknytninger vha. mapping.
    Klik på Næste
  6. Siden Webserviceprogrampakke til navneområde-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.
  7. Siden Webserviceprogramtest: Hvis du valgte 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.
  8. Siden Proxy for webserviceprogram: Hvis du har valgt at generere en proxy, skal du vælge, om du vil tilpasse pakken til navnområdetilknytninger vha. mapping.
  9. Siden Test af webserviceprogramklient: Brug denne side til at vælge følgende indstillinger:
    1. Vælg testfunktion. Du kan teste den genererede proxy i Web Service Explorer, eller du kan generere et eksempel på en webserviceprogram-JSP.
    2. 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.
    3. Vælg Udfør test på server for at starte serveren automatisk.
  10. Siden Publicering af webserviceprogram: Vælg, om webserviceprogrammet skal publiceres til en UDDI-registreringsdatabase. Klik på Afslut. Bemærk: Der vises muligvis en meddelelse om Fejl i generering af WSDL fra Java. ClassNotFound: <bean-navn>. Denne fejl kan ignoreres.
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 webprogrammet 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.

Vigtigt: Hvis metoderne indeholder typer, der ikke understøttes af programeksemplet, f.eks. arrays, indekserede egenskaber og samlinger, udelades metoderne fra programeksemplet, og der vises en advarsel.