Udostępnij za pośrednictwem

  • Artykuł

Przy użyciu języka WSDL

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

Języka Web usługa Description Language (WSDL) definiuje definicji interfejs sieci Web dla każdej funkcji RPC narażone na punkt końcowy HTTP, a także opis funkcji partia SQL dla punktu końcowego.Klient może żądać odpowiedzi WSDL instancji SQL Server a następnie używać go do wygenerowania żądania RPC i SQL partia na serwerze przy użyciu punktów końcowych protokołu HTTP, które zostały skonfigurowane do obsługi typu WSDL. WSDL odpowiedzi jest faktycznie generowanych dynamicznie dokumentem XML oparta na funkcjach RPC skojarzonych z punktem końcowym w czasie żądania.

Uwaga

Aby uzyskać ogólne informacje na temat języka WSDL zobacz temat dostępne witryna sieci Web konsorcjum World Wide Web Consortium (W3C) w specyfikacji języka WSDL 1.1 http://www.W3C.org.

Punkty końcowe HTTP, które są skonfigurowane do obsługi oferowania WSDL, można podać jeden z następujących konfiguracji WSDL do użytku w odpowiadający klientom, których przesyłanie żądań WSDL:

  • Domyślne WSDL

  • Dostosowane WSDL

Jeśli skonfigurowana do dostarczania domyślna opcja WSDL SQL Server oferuje obsługę dwóch typów WSDL: Domyślnie lub rozszerzonego WSDL i uproszczone format WSDL.

Chociaż jeden z tych dokumentów WSDL opis metod, które są obsługiwane dla punktu końcowego, domyślne WSDL używa dodatkowych funkcji z schematu XML (XSD) zawierają bogatszy opis metod, typy danych, parametry i zwracają wartości, które są dostępne lub narażonych przez punkt końcowy.

Uproszczone format języka WSDL, który może być wymagane dla niskiego poziom zgodności ze starszymi klientami, korzysta z bardzo podstawowego schematu XSD, który wymaga tylko typy danych pierwotnych.Jeśli domyślne ani WSDL uproszczony udostępnia dokładne zawartość WSDL odpowiednie dla konkretnego klient, można zaktualizować serwer zapewni dostosowaną wersja języka WSDL, zgodnie z wymaganiami.

WSDL odpowiedzi są generowane i zwracane przez wystąpienie SQL Server Po nawiązaniu początkowego połączenia punkt końcowy HTTP przez klient usługi sieci Web, która przesyła żądanie WSDL.

W jaki sposób WSDL jest obsługiwane przez program SQL Server

When an endpoint is defined, the WSDL argument in the CREATE ENDPOINTTransact-SQL statement is used to specify for the server whether a WSDL response is generated and returned for the endpoint to describe its Web programmable features.Jeśli punkt końcowy zostało ustanowione przy użyciu WSDL = wartość Brak, serwer nie zwróci odpowiedź WSDL.

Jeśli domyślny WSDL generowania została określona, takiego jak WSDL = DEFAULT została określona podczas tworzenia punktu końcowego, format języka WSDL, zwracane przez serwer będzie zależeć od tego ciąg adres URL używany przez klient do łączenia się z punktem końcowym protokołu HTTP.Klienci mogą używać jednej z następujących formatów adresu URL żądania WSDL:

  • Domyślne WSDL

    Jest to pełna wersja rozszerzone odpowiedź WSDL, która jest zwracana, gdy używasz http://serwer / endpoint_path? wsdl URL do łączenia się z punktem końcowym.Ten format używa typów pochodnych XSD do zapewnienia obsługi mapowania bardziej złożone typy SQL.Aby uzyskać więcej informacji zobaczDomyślne WSDL.

  • Proste WSDL

    Jest to krótkie uproszczoną wersja języka WSDL, która mapuje wszystkie domyślne SQL Server System typów danych do trybu macierzystego typów XSD. Ten format jest zwracana, gdy używasz http://serwer / endpoint_path? wsdlsimple jako adres URL do łączenia się z punktem końcowym.Aby uzyskać więcej informacji zobaczProste WSDL.

  • Pole niestandardowe WSDL

    Podczas każdej wersja WSDL, wystąpienie SQL Server Zwraca wartość domyślną lub uproszczone jeden nie jest możliwy do zaakceptowania dla klientów, można określić niestandardowe oferty WSDL. Ta opcja wymaga projektowania i implementacji dodatkowy kod.W ten sposób procedura przechowywana może służyć do generowania i zwracają dostosowaną zawartość WSDL w związku z klientami, które określają typ niestandardowy WSDL kwerendę oparte na protokole HTTP.Aby uzyskać więcej informacji zobaczObsługa języka WSDL niestandardowe wykonawczych.

Zawartość WSDL

Wystąpienie języka Web Services Description Language (WSDL) jest dokumentem XML zawierający katalog główny <definicje> element, który określa (obszaru nazw WSDLhttps://schemas.xmlsoap.org/wsdl) i definiuje zestaw usług sieci Web jako zbiór punktów końcowych sieci lub portów. Typowe dokument WSDL będą mieć następującą strukturę najwyższego poziom:

<wsdl:definitions>
  <wsdl:types>...</wsdl:types>
  <wsdl:message>...<wsdl:message/>
  <wsdl:portType>...</wsdl:portType>
  <wsdl:binding>...</wsdl:binding>
  <wsdl:service>...<wsdl:service>
<wsdl:definitions>

Jak pokazano na ten widok uproszczony formatu języka WSDL, kilka elementów są używane do wskazywania głównych sekcji w dokumencie WSDL.Roli każdego z nich jest opisany przez chwilę w poniższej tabela.

Element

Description

wsdl:types

Element kontener dla definicji typu danych, które są wykonywane przy użyciu schematu XML (XSD) lub inny system podobnych typach danych.

wsdl:message

Definicja danych wiadomości są przekazywane.Komunikat może składać się z wielu części i każda część może być innego typu

wsdl:portType

Klasa abstrakcyjna zestaw operacji obsługiwanych przez jeden lub więcej punktów końcowych.

wsdl:binding

Konkretnych danych i protokół specyfikacja formatu dla typu określonego portu.

wsdl:service

Kolekcja powiązanych punktów końcowych.

Służy do obsługi procedury składowane w systemie WSDL

Poniższe procedury składowane w systemie, które są dołączone do macierzysty usług XML sieci Web w SQL Server do obsługi domyślne i proste WSDL implementacji i są wywoływane w odpowiedzi na żądanie dla języka WSDL:

  • sp_http_generate_wsdl_defaultcomplexorsimple

  • sp_http_generate_wsdl_defaultsimpleorcomplex

  • sp_http_generate_wsdl_complex

  • sp_http_generate_wsdl_simple

Do wykonać tych procedur przechowywanych, wymaga członkostwo w grupie publiczne roli.Kwerendę każdego z tych procedur przechowywanych, katalogi w celu uzyskania informacji na temat dodatkowych procedur przechowywanych, udostępniane za pośrednictwem punktów końcowych jako metody sieci Web.Użytkownicy potrzebują jedynie uprawnień do tych procedur przechowywanych metoda sieci Web.Aby uzyskać więcej informacji zobaczNarażania programowania SQL w sieci Web.