Webservice-extensiebestand

In deze sectie vindt u een overzicht van het bestand met de webservice-extensie.

WSX-bestand (WCF-serviceextensie) is ons extensiebestand om toepassing toe te staan om lokaal gedrag te manipuleren dat geen invloed heeft op de weergave van wire data. Het moet uitbreidbaar zijn dat we in de toekomst nieuwe functies kunnen toevoegen zonder interoperabiliteit te verbreken.

De algehele structuur van WSX zou de structuur van XSD- of WSDL-bestand nabootsen. Dit is een XML-bestand dat dezelfde structuur behoudt als het hoofdinvoerbestand. Extra kenmerken op hetzelfde benoemde token in het hoofdbestand geven de kenmerken op die de toepassing wil beheren over het standaardgedrag.

Misschien doen we hier niets in M3. In V1 kan ik zien dat we de volgende kenmerken ondersteunen:

Gebruik voor het opgeven van het argument/parameterveld aantal.

Dit is een elementkenmerk, maar alleen van toepassing op matrixtype. Het kenmerk IsCountOf geeft het matrixelement aan. Het aantalveld/parameter wordt niet weergegeven op draad.

<xs:schema xmlns:tns="http://Example.org" elementFormDefault="qualified" 
targetNamespace="http://Example.org" xmlns:xs="http://www.w3.org/2001/XMLSchema">
 <element name="FooInParam">
  <complexType> 
   <!-- MyArray field is presented in WSDL file as an element -->
    <element name="MyArrayCount" IsCountOf="MyArray"></element>
   </complexType>
  </element>
 </xs:schema>

Callback voor lezen/schrijven opgeven voor aangepast type

Deze kenmerken dwingen wsutil.exe om WS_CUSTOM_TYPE te genereren voor het opgegeven type. custom_readcallback kenmerk geeft de teruggelezen callback routine en custom_writecallback geeft de terugschrijven routine.

<xs:schema xmlns:tns="http://Example.org" elementFormDefault="qualified" 
targetNamespace="http://Example.org" xmlns:xs="http://www.w3.org/2001/XMLSchema">
 <element name="mytype" custom_readcallback="myreadcallback" custom_writecallback="mywritecallback"> 
 </element>
</xs:schema>

We kunnen een overeenkomend WSX-bestand hebben om het lokale gedrag te beschrijven:

<xs:schema xmlns:tns="http://Example.org" elementFormDefault="qualified" 
targetNamespace="http://Example.org" xmlns:xs="http://www.w3.org/2001/XMLSchema">

 <element name="FooInParam" DataValidationRoutine="MyArrayValidation">
  <complexType> 
   <element name="MyLocalArrayCount" IsCountOf="MyArray"></element> 
  </complexType>
 </element>
</xs:schema>

WsUtil.exe genereert het volgende prototype voor de structuur:

typedef struct FooInParam
{
  ULONG MyLocalArrayCount;
  int * MyArray;
};