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

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.
Slik oppretter du en web-tjeneste fra en bønne med et Apache Axis-kjøretidsmiljø:
  1. Bytt til J2EE-perspektivet (Vindu > Åpne perspektiv > J2EE).
  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 hvilke trinn av utviklingen av web-tjenestene du vil fullføre ved hjelp av glidebryteren:
      • Utvikle: oppretter tjenestekoden
      • Assembler:
      • Distribuer: oppretter distribusjonskoden for klienten
      • Installer: installerer tjenesten på den valgte serveren
      • Start: starter serveren når tjenesten er installert på den
      • Test: gir ulike alternativer for testing av tjenesten
    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.
  7. Siden Web-tjenestetest: Hvis du valgte å teste 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 til å 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å Fullfør Merk: 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, blir web-tjenesteutforskeren åpnet. Den viser siden som er nødvendig 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.