Opret et webserviceprogram ud fra en Java-bean ved hjælp af Apache Axis1-runtime-miljøet

Med guiden Webserviceprogrammer kan du oprette et nyt webserviceprogram, konfigurere det til distribution og distribuere webserviceprogrammet til en server. Når dit webserviceprogram er distribueret, kan du bruge guiden til at generere klientproxy og programeksempel til test af webserviceprogrammet. Når du har gennemført testen, kan du publicere webserviceprogrammet til en UDDI-virksomhedsregistreringsdatabase vha. Eksportguiden.

Forudsætninger:
  1. Opret eller importér en bean i Java™-kildefolderen til webprojektet. Sådan importerer du: Vælg folderen Java-ressourcer: src, og vælg Importér > Generelt > Filsystem fra filmenuen, og angiv vha. Gennemse, hvor pakken er.
Sådan oprettes et webserviceprogram ud fra en bean ved hjælp af Apache Axis1-runtime-miljøet:
  1. Skift til Java EE-perspektivet (Vindue > Åbn perspektiv > Java EE).
  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 guider til webserviceprogrammer. 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: udvikler WSDL-definitionen og -implementeringen af webserviceprogrammet. Det omfatter bl.a. opgaver som oprettelse af moduler, der indeholder den genererede kode, WSDL-filer, distribution af deskriptorer samt Java-filer, når det er relevant.
      • Assemblering: sikrer, projektet, som skal være vært for Webserviceprogrammet eller klienten, knyttes til et EAR-program, når målprogramserveren kræver det.
      • Distribuér: opretter distributionskoden for serviceprogrammet.
      • Installér: installerer og konfigurerer webmodulet og EAR-filerne på målserveren.
      • Start: starter serveren, så snart serviceprogrammet er installeret på den. Filen server-config.wsdd genereres.
      • Test: stiller forskellige indstillinger til rådighed til test af serviceprogrammet, så som brug af Web Service Explorer eller JSP-eksempler.
    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 kørselstidspunkt, 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 webserviceprogram: starter Web Services Explorer, så du kan 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 iBrug TCP/IP-overvågning til at teste webserviceprogrammer
  5. Siden Java-bean-id til webserviceprogram: WSDL-navnet på webserviceprogrammet vises. Der er følgende indstillinger:
    • Vælg de metoder, der skal vises.
    • Vælg kodningstypografi. Den anbefalede kodetype for dette Axis-runtime-miljø er RPC/kodet. Denne kodningsmetode overholder ikke WS-I.
    • Vælg, om du vil tilpasse pakken til navneområdetilknytninger vha. mapping.
    Klik på Næste
  6. Siden Navneområde for webserviceprogram til pakke-mapping: hvis du har valgt Definér tilpasset mapping for pakke til navneområde på det forrige skærmbillede, kan du angive dine tilpassede mapping-par på dette skærmbillede ved at klikke på Tilføj. Alternativt kan du klikke på Importér for at importere tilpassede mapping-par fra en .properties-fil. Indholdet af egenskabsfilen skal have formatet package=namespace. Du skal bruge Escape-tegn til visse specialtegn i egenskabsfilen. Eksempelvis skal somePackage=http://someNamespace være somePackage=http\://someNamespace. I modsat fald behandles kolonet (:) som en separator, hvilket medfører forsøg på at tilknytte somePackage til http.
  7. Siden Webserviceprogramtest: Hvis du valgte at teste webserviceprogrammet, skal du vælge testfunktionen for det genererede webserviceprogram. Herved åbnes webserviceprogrammet i Web Services Explorer. Vælg den funktion, du vil teste, angiv de nødvendige oplysninger, og klik 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 har valgt at teste proxy'en via en JSP, kan du vælge den folder, hvor JSP skal placeres, og vælge de metoder, der skal inkluderes i JSP.
    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 forekomme, afhængigt af de indstillinger, du har valgt:
  • Hvis du har valgt at teste den genererede proxy vha. webserviceprogram-JSP'erne, startes din proxy i en webbrowser ved følgende URL: http://localhost: port/ WebProjectClient/sampleBeanName/ WebServiceName/TestClient.jsp. Du kan bruge programeksemplet til at teste webserviceprogrammet ved at vælge en metode, angive en værdi for metoden og klikke på Aktivér. Resultatet af metoden vises i delvinduet med resultater.
  • Hvis du har valgt at teste webserviceprogrammet vha. Web Services Explorer, åbnes 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, startes Web Services Explorer på den side, der kræves for at publicere programmet. Følg instruktionerne i Publicér webserviceprogram for at udføre opgaven.

Vigtigt: Hvis dine metoder indeholder typer, som ikke understøttes af eksemplet, f.eks. arrays, indekserede egenskaber og samlinger, bliver metoderne udeladt af eksemplet, og du får vist en advarsel.

Relaterede begreber
Opret webserviceprogrammer med runtime-miljøet Apache Axis1