XML Web-службы в Microsoft SQL Server 2005
Страница 17. Синтаксис для создания Web-службы



Синтаксис для создания Web-службы

FOR SOAP(
[ { WEBMETHOD [ ‘namespace’ .] ‘method_alias’
( NAME = ‘three.part.name’
[, SCHEMA = {NONE | STANDARD | DEFAULT}]
[, FORMAT = { ALL_RESULTS | ROWSETS_ONLY | NONE }]
[, LOGIN_TYPE = { MIXED | WINDOWS } ]
)
} [,...n] ]
[ BATCHES = { ENABLED | DISABLED } ]
[ , WSDL = { NONE | DEFAULT | ‘sp_name’ } ]
[ , SESSIONS = { ENABLED | DISABLED } ]
[ , SESSION_TIMEOUT = int ]


[ , DATABASE = { ‘database_name’ | DEFAULT }
[ , NAMESPACE = { ‘namespace’ | DEFAULT } ]
[ , SCHEMA = { NONE | STANDARD } ]
[ , CHARACTER_SET = { SQL | XML }]
)
  • WEBMETHOD — указывает пространство имен и название Web-методa. Данное значение используется для однозначной идентификации Web-метода и передается в заголовке SOAPAction. Если пространство имен не задано, будет использовано пространство имен Web-службы, которое задается параметром NAMESPACE (описан далее). У Web-метода есть свой набор параметров:
    • NAME — название хранимой процедуры или пользовательской функции. Имя должно состоять из трех частей: названия базы, названия схемы и названия объекта. Если на момент создания Web-метода данного объекта не существует, будет выдано предупреждение, однако Web-метод будет успешно создан.
    • SCHEMA — определяет, будет ли отправляться схема XML в каждом ответном сообщении. Может принимать значения: default — значение берется из глобального параметра schema для всей Web-службы; standard — схема будет отдаваться в каждом ответном сообщении; и none — схема не будет отдаваться клиенту в ответном сообщении. По умолчанию используется default.
    • FORMAT — тип формата вывода результатов Web-метода. Это могут быть следующие значения: all_results — выводятся все результаты выполнения Web-метода, а именно: результирующий набор строк, количество выбранных строк и сообщения об ошибках и предупреждениях; rowsets_only — выводится только результирующий набор строк; none — результат выводится в том виде, какой отдается сервером, т.е. не выполняется никаких преобразований к xml-виду. По умолчанию используется all_results.
    • LOGIN_TYPE — тип учетной записи, которая используется для вызова Web-метода. Может принимать значения: windows — интегрированная аутентификация Windows; mixed — смешанная аутентификация SQL Server и Windows. Если при установке сервера смешанная аутентификация была запрещена или при настройке транспорта не был указан ssl, режим mixed применять запрещается. По умолчанию используется Windows.
  • BATCHES — определяет, может ли Web-служба принимать запросы на исполнение пакетов команд. При указании значения enabled становится возможным посылать любые команды TSQL без создания каких-либо дополнительных Web-методов. При указании значения default, которое является значением по умолчанию, данная возможность отпадает.
  • WSDL — указывает, будет ли генерироваться описание Web-службы в формате wsdl или нет. Если стандартная схема по каким-либо причинам не подходит, можно указать хранимую процедуру, которая будет использоваться для генерации wsdl.
  • SESSIONS — позволяет объединять различные запросы soap, как часть одной сессии, если указывается значение enabled. Значение disabled, которое является значением по умолчанию, отключает сессии.
  • SESSION_TIMEOUT — задает время в секундах, по истечении которого после последнего запроса клиента сессия soap будет уничтожена.
  • DATABASE — база данных по умолчанию. Если указано значение default, будет использоваться база данных по умолчанию для данной учетной записи.
  • NAMESPACE — пространство имен для Web-службы. Если указано значение default, используется стандартное предопределенное пространство https://tempuri.org.
  • SCHEMA — указывает, будет ли генерироваться XML Schema для Web-службы.
  • CHARACTER_SET — указывает, будут ли включаться в результирующее сообщение символы с некорректными для XML кодами.

 
« Предыдущая статья   Следующая статья »