Opprette en web-tjeneste fra en Java-bønne med Apache Axis1-kjøretidsmiljøet

Veiviseren for web-tjenester hjelper deg med å opprette en ny web-tjeneste, konfigurere den for distribusjon og distribuere web-tjenesten til en server. Så snart web-tjenesten er distribuert, hjelper veiviseren deg med å generere klient-proxyen og eksempelapplikasjonen for å teste web-tjenesten. Når du er ferdig med å teste, kan du publisere web-tjenesten til et UDDI-firmaregister ved hjelp av eksportveiviseren.

Forutsetninger:
  1. Opprett eller importer en bønne til Java-kildemappen for web-prosjektet. Hvis du skal importere, velger du mappen Java-ressurser: src, går til filmenyen og velger Importer > Generelt > Filsystem og blar til der pakken ligger.
Slik oppretter du en web-tjeneste fra en bønne med Apache Axis1-kjøretidsmiljøet:
  1. Bytt til Java EE-perspektivet (Vindu > Åpne perspektiv > Java EE).
  2. I Prosjektutforsker-visningen velger du bønnen som du opprettet eller importerte til kildemappen for web-prosjektet.
  3. Klikk på Fil > Ny(tt) > Annet. Velg Web-tjenester for å vise de ulike web-tjenesteveiviserne. Velg veiviseren Web-tjeneste. Klikk på Neste.
  4. Siden web-tjenester: Velg Nedenfra og oppover Web-tjeneste for Java-bønne som web-tjenestetype, og oppgi URIen til WSDL-, WSIL- eller HTML-filen som vil bli brukt til å generere tjenesten.
    1. Velg de trinnene i web-tjensteutviklingen du vil fullføre ved hjelp av glidebryteren:
      • Utvikle: dette utvikler WSDL-definisjonen og -implementeringen for web-tjenesten. Dette omfatter oppgaver som å opprette modulene som skal inneholde den genererte koden, WSDL-filer, distribusjonsdeskriptorer og Java-filer når det er aktuelt.
      • Assembler: dette sikrer at prosjektet som skal være vert for web-tjenesten eller -klienten, blir knyttet til en EAR når det kreves av målapplikasjonstjeneren.
      • Distribuer: oppretter distribusjonskoden for klienten.
      • Installer: installerer og konfigurerer web-modulen og EARene på målserveren.
      • Start: starter serveren når tjenesten er installert på den. Filen server-config.wsdd vil bli generert.
      • Test: gir ulike alternativer for testing av tjenesten, for eksempel å bruke utforskeren for web-tjenester eller JSP-eksempler.
    2. Velg server: standardserveren blir vist. Hvis du vil distribuere tjenesten til en annen server, klikker du på linken for å angi en annen server.
    3. Velg kjøretid: standard kjøretid blir vist. Hvis du vil distribuere tjenesten til en annen kjøretid, klikker du på linken for å angi kjøretiden.
    4. Velg tjenesteprosjekt: prosjektet som inneholder det valgte prosjektet i arbeidsområdet, blir vist. Hvis du vil velge et annet og prosjekt og en annen EAR, klikker du på prosjektlinken. Forsikre deg om at prosjektet som er valgt som klientens web-prosjekt, er forskjellig fra tjenestens web-prosjekt. Hvis ikke, blir tjenesten overskrevet av klientens genererte artefakter.
    5. Hvis du vil opprette en klient, velger du typen proxy som skal genereres, og gjentar trinnene over for klienten.
    6. Publiser web-tjenesten: dette starter web-tjenesteutforskeren og publiserer web-tjenesten til et UDDI-register.
    7. Overvåk web-tjenesten: sender web-tjenestetrafikken via TCP/IP-overvåkeren, som gjør at du kan overvåke SOAP-trafikken som genereres av web-tjenesten, og teste at trafikken samsvarer med WS-I. Du kan også konfigurere en TCP/IP-overvåker slik det blir beskrevet i Bruke TCP/IP-overvåkeren til å teste web-tjenester.
  5. Siden Java-bønneidentitet for web-tjeneste: Web-tjenestens WSDL-navn blir oppført. Du har disse alternativene:
    • Velg metodene skal skal eksponeres.
    • Velg kodestil. RPC/Encoded er den anbefalte kodestilen for Axis-kjøretidsmiljøet. Denne kodemetoden samsvarer ikke med WS-I.
    • Velg om du vil tilpasse pakken til navneområdetilordninger.
    Klikk på Neste
  6. Siden Tilordning fra web-tjenestepakke til navneområde: Hvis du valgte Definer tilpasset tilordning for pakke til navneområde i forrige skjermbilde, kan du oppgi dine tilpassede tilordningspar i dette skjermbildet ved å klikke på Legg til. Alternativt kan du klikke på Importer for å importere tilpassede tilordningspar fra en .properties-fil. Innholdet i egenskapsfilen må ha formatet pakke=navneområde. Enkelte spesialtegn må merkes med kodevekslingstegn i egenskapsfilene. Eksempel: somePackage=http://someNamespace should be somePackage=http\://someNamespace. Ellers behandles kolonet (:) som et skilletegn, og det vil resultere i et forsøk på å tilordne somePackage til http.
  7. Siden Web-tjenestetest: Hvis du har valgt å teste web-tjenesten, velger du testfunksjonen for den genererte web-tjenesten. Det åpner web-tjenesten i web-tjenesteutforskeren. Velg operasjonen du vil teste, og klikk på Utfør. Resultatet blir vist i Status-ruten. Klikk på Neste.
  8. Proxy-side for web-tjeneste: Hvis du har valgt å generere en proxy, velger du om du vil tilpasse pakken til navneområdetilpasning.
  9. Siden Klienttest for web-tjeneste: Bruk denne siden for å velge følgende alternativer:
    1. Velg testfunksjonen. Du kan teste den genererte proxyen i web-tjenesteutforskeren, eller du kan generere et eksempel på en web-tjeneste-JSP.
    2. Hvis du har valgt å teste proxyen via en JSP, kan du velge mappen der JSPen skal ligge, og du kan velge metoder som blir inkludert i JSPen.
    3. Velg Kjør test på serveren for å starte serveren automatisk.
  10. Web-tjenestepublisering: Velg om du vil publisere denne web-tjenesten til et UDDI-register eller ikke. Klikk på FinishMerk: Du får kanskje advarselen Feil ved generering av WSDL fra Java. ClassNotFound: <bønnenavn>. Denne feilen kan trygt ignoreres.
Når web-tjenesten er opprettet, kan følgende skje, avhengig av alternativene du valgte:
  • Hvis du har valgt å teste den genererte proxyen ved hjelp av web-tjenestens JSPer, blir proxyen startet i en nettleser på denne URLen: http://localhost: port/ WebProjectClient/sampleBeanName/ WebServiceName/TestClient.jsp Du kan bruke denne eksempelapplikasjonen til å teste web-tjenesten ved å velge en metode, oppgi en verdi for metoden og klikke på Aktiver. Resultatet av metoden blir vist i resultatruten.
  • Hvis du har valgt å teste web-tjenesten ved hjelp av web-tjenesteutforskeren, blir utforskeren åpnet. Velg operasjonen du vil teste, og klikk på Utfør. Resultatet blir vist i Status-ruten.
  • Hvis du har valgt å publisere web-tjenesten, startes web-tjenesteutforskeren og viser siden som kreves for å publisere web-tjenesten. Følg instruksjonen i Publisere web-tjenesten for å fullføre denne oppgaven.

Viktig: Hvis metodene inneholder typer som ikke støttes av eksempelet, for eksempel matriser, indekserte egenskaper og samlinger, blir metodene utelatt fra eksempelet, og du får en advarsel.

Beslektede begreper
Opprette web-tjenester med kjøretidsmiljøet Apache Axis1