Indstillinger for webserviceprogrammer

Inden du starter på at udvikle webserviceprogrammer eller -klienter, kan du optimere arbejdsbænken til brug for udvikling af webserviceprogrammer ved at angive en række indstillinger.

Udfør følgende trin, hvis du vil angive nogle af indstillingerne for webserviceprogrammer:
  1. Klik på Vindue > Indstillinger for at åbne notesbogen Indstillinger.
  2. Udvid Webserviceprogrammer eller Web og XML, og klik på den indstillingskategori, du vil angive.
  3. Vælg de afkrydsningsfelter, du vil angive som standard, når du opretter dit webserviceprogram.
  4. Klik på OK for at anvende ændringerne og lukke notesbogen Indstillinger.
Hvis du har brug for flere oplysninger til nogle af indstillingerne, skal du klikke på F1.

Ved hjælp af webserviceprogramværktøjerne kan du definere følgende indstillinger:

Axis Emitter
På denne side kan du angive følgende indstillinger, der bruges ved oprettelse eller under anvendelse af Axis-webserviceprogrammer.
WSDL2Java
  • Generér kode for alle elementer: Som standard genererer WSDL2Java kun kode for de elementer i WSDL-filen, der refereres til. Du finder flere oplysninger om, hvordan referencer fungerer i Axis-referenceguiden: http://ws.apache.org/axis/java/reference.html
  • Aktivér separate hjælperklasser for metadata: Hvis du vælger denne indstilling, opretter WSDL2Java en separat hjælperklasse, der indeholder metadataene i stedet for at medtage dem i skelettet.
  • Bean-bygning foretrækkes fremfor almindelige arrays til indpakkede XML-arraytyper: Som standard tilknyttes denne XML-konstruktion vha. mapping:
    <elementnavn>
     <complexType>
      <sequence>
       <element name="item" type="xs:string"/>
      </sequence>
     </complexType>
    </element>
    til en Java String-array (String[]). Hvis du foretrækker, at en bestemt JavaBean-klasse (ArrayOfString) genereres for disse typer skemaer, skal du vælge denne indstilling.
  • Tilføj omfang til deploy.wsdd: angiver, hvordan serverimplementeringen skal distribueres. Programmet bruger en forekomst af implementeringsklassen til alle anmodninger. Anmodning opretter en ny forekomst af implementeringsklassen for hver anmodning. Session opretter en ny forekomst af implementeringsklassen for hver session.
  • Tidsfrist i sekunder: Standardværdien er 45. Brug -1 til at deaktivere tidsfristen.
Java2WSDL
  • Søg efter tilladte metoder i overtaget klasse: Hvis denne indstilling er angivet, søger Java2WSDL-parseren i de udvidede klasser for at bestemme listen over metoder, der skal eksporteres til WSDL-filen.
  • Undersøg, om serviceprogrampakken overholder JAX-RPC, før koden genereres: Hvis denne indstilling er valgt, vil værktøjerne undersøge Java-serviceprogramklassen og dens værdityper for at kontrollere, at den opfylder vigtige betingelser i JAX-RPC-specifikationen.
Valg af pop op-dialogboks
Dialogboksindstillingerne giver dig mulighed for at bestemme, hvilke dialogbokse du vil have vist, når du udfører pop op-funktioner. Hvis du har deaktiveret nogen af dialogboksene ved at vælge "Vis ikke denne dialogboks igen" på den første side af guiden Webserviceprogrammer, kan du fortryde ændringen ved at fjerne markeringen af afkrydsningsfeltet ud for dialogboksen, du har valgte ikke at få vist.
Profiloverholdelse og validering
Ved hjælp af indstillingerne til WS-I-overholdelse kan du vælge overholdelsesniveauet for WS-I SSBP (Simple SOAP Binding Profile) og WS-I AP (Attachement Profile). Bemærk: Hvis du ændrer niveauet af WS-I-overholdelse, samtidig med at der vises manglende WS-I-overholdelse i opgaveoversigten, opdateres opgaveoversigten ikke automatisk. Arbejdsområdet skal valideres igen, inden advarslerne kan fjernes fra opgaveoversigten. Du finder flere oplysninger om WS-I på: http://www.ws-i.org/
Blandt valideringsindstillingerne kan du vælge, om de WSDL-filer, der benyttes af guiderne til webserviceprogrammerne, skal valideres, og om WSDL-valideringen skal udføres, inden guiden går videre til det næste trin.
Projekttopologi
Med indstillingerne til Projekttopologi kan du:
  • Vælge den standard for klientprojekttype, som guiderne til webserviceprogrammer opretter ved generering af en webserviceprogramklient. Du kan også angive den rækkefølge, som klientprojekttyperne skal opstilles i i guiden. Bemærk, at dette valg er blot en standardværdi, og at du kan vælge en anden projekttype i guiden.
  • Vælge, om webserviceprogrammet og webserviceprogramklienten skal genereres i det samme EAR-projekt eller i forskellige EAR-projekter. At generere serviceprogrammet og klienten i hver sit EAR-projekt kan reducere antallet af eventuelle konflikter, der kan opstå, når begge findes i et enkelt EAR-projekt, men det kræver til gengæld flere systemressourcer.
Ressourcestyring
Med indstillingerne for Ressourcestyring kan du fastlægge de standardværdier for oprettelse og overskrivning af filer og foldere , du vil bruge, når du opretter webserviceprogrammet.
  • Overskriv filer uden advarsel: giver guiderne tilladelse til at overskrive eksisterende filer i arbejdsområdet uden at vise besked først. Hvis denne indstilling ikke vælges, vises en besked, hver gang en fil skal overskrives.
  • Opret foldere, hvis det er nødvendigt: giver guiderne tilladelse til at oprette påkrævede foldere.
  • Tjek filer ud uden advarsel: tjekker filer ud uden at vises en advarsel, der skal bekræftes først.
  • Flet genereret skeletfil: som standard er dette afkrydsningsfelt deaktiveret. Hvis afkrydsningsfeltet er aktiveret, når der allerede findes en skeletfil med det samme navn i arbejdsområdet, flettes den netop genererede skeletfil med den eksisterende skeletfil. Aktivér feltet for at bevare kode, du allerede har ændret i de eksisterende skeletfiler.

    Bemærk, at når du aktiverer denne indstilling, og returtypen for en grænseflade ændres, vil den endelige skeletfil omfatte en metode, som returnerer den type, der er defineret i den nye grænseflade, men samtidig have et metodeindhold fra den oprindelige skeletfil (som ville returnere en anden type). Det medfører en kompileringsfejl, som du skal rette manuelt.

Standardværdier for scenario
Med Standardværdier for scenario kan du fastlægge følgende standardværdier for scenario, du vil bruge, når du opretter webserviceprogrammet:
  • den type webserviceprogram og klient, der skal vælges som standard.
  • de faser af webserviceprogrammets livscyklus, du vil udføre i guiden.
  • om Web Services Explorer skal starte som standard, så du kan publicere dit webserviceprogram i en UDDI-registreringsdatabase.
  • om du ønsker at dirigere webserviceprogrammets SOAP-trafik via TCP/IP-overvågning, så du kan overvåge SOAP-pakkerne og teste dem for WS-I-overholdelse.
Bemærk, at disse standardværdier kan tilsidesættes i guiden.
Server og runtime
Vælg den server, det runtime-miljø for webserviceprogram og den J2EE-version, der skal vælges som standard i webserviceprogramguiden. Bemærk, at disse standardværdier kan tilsidesættes i guiden.
Standardværdier for testfunktion
Du kan vælge, om guiden skal starte en testfunktion automatisk, og du kan vælge din foretrukne testfunktion
WSDL-filer
Når du opretter en WSDL-fil i en WSDL-editor, kan du indstille standardmålnavneområdet. Hvis du vælger at beholde standardværdien, får WSDL-filen http://tempuri.org som målnavneområde.