Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

WebServicesCore.framework, ссылочная ссылка ядра веб-сервисов платформы CoreServices

Опции
Развертывание Target:

На этой странице
Язык:

Ссылка ядра веб-сервисов

Платформа Ядра Веб-сервисов предоставляет поддержку клиентской стороны для доступа к веб-сервисам с помощью XML по HTTP или HTTPS, с определенной поддержкой XML-RPC, SOAP 1.1 и протоколов SOAP 1.2. Некоторая поддержка серверной стороны также предоставлена с обработчиками протокола для сериализации и десериализации данных в формате XML-RPC или SOAP.

Функции

Функции вызова метода

Функции вызова метода используются, чтобы создать ссылку вызова, установить параметры для вызова, добавить любые настройки, такие как заголовки действия или отладить параметры и вызвать работу (который сериализирует вывод, выполняет вызов, получает ответ и десериализовывает ответ). Дополнительные функции позволяют Вам планировать вызов на свой (рекомендуемый) цикл выполнения, устанавливать обратный вызов, чтобы иметь дело с ответом и добавить пользовательский сериализатор или deserializer.

  • WSMethodInvocationAddDeserializationOverride WSMethodInvocationAddDeserializationOverride (OS X v10.8)

    Указывает обратный вызов, который будет сделан при парсинге XML в ответе метода.

    Объявление

    Objective C

    void WSMethodInvocationAddDeserializationOverride ( WSMethodInvocationRef invocation, CFStringRef typeNamespace, CFStringRef typeName, WSMethodInvocationDeserializationProcPtr deserializationProc, WSClientContext *context );

    Параметры

    invocation

    Ссылка вызова метода.

    typeNamespace

    Полностью разрешенное пространство имен для определенного типа. Например, это поле могло быть: CFSTR("http://www.Myserver.com/myNameSpace"). Если NULL, пространство имен по умолчанию будет использоваться.

    typeName

    Неквалифицированное имя типа. Обратите внимание на то, что это - XML/name/, чтобы быть десериализованным, не имя типа. Например, если XML <Sharename xsi:type="xsd:string">Album-9</Sharename>, typeName Sharename, нет string. Этот параметр не должен быть NULL.

    deserializationProc

    A ProcPtr к обратному вызову, который вызовут для выполнения десериализации.

    context

    Указатель на a WSClientContext. Структура будет скопирована.

    Обсуждение

    Указывает обратный вызов, который будет сделан при парсинге ответа метода XML. Используемый для десериализации вводит значение по умолчанию deserializer, не обрабатывает. Обратный вызов должен возвратить a CFTypeRef содержа значение десериализованного объекта. Если возвращается обратный вызов NULL, значение по умолчанию deserializer используется.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.8.

  • WSMethodInvocationAddSerializationOverride WSMethodInvocationAddSerializationOverride (OS X v10.8)

    Указывает обратный вызов, который будет сделан при создании XML для вызова метода.

    Объявление

    Objective C

    void WSMethodInvocationAddSerializationOverride ( WSMethodInvocationRef invocation, CFTypeID objType, WSMethodInvocationSerializationProcPtr serializationProc, WSClientContext *context );

    Параметры

    invocation

    Вызов, в настоящее время сериализируемый

    objType

    CFTypeID из объекта сериализировать

    serializationProc

    ProcPtr к обратному вызову

    context

    Указатель на a WSClientContext. Структура будет скопирована.

    Обсуждение

    Указывает обратный вызов, который вызовут для создания XML, представляющего сериализацию данного типа касательно, Посмотрите WSTypes.h для списка CFTypes для которого существуют сериализаторы по умолчанию. Если возвращается Ваш обратный вызов NULL, сериализатор по умолчанию будет использоваться.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.8.

  • WSMethodInvocationCopyParameters WSMethodInvocationCopyParameters (OS X v10.8)

    Создает копию словаря параметров и устанавливает порядок в массиве.

    Объявление

    Objective C

    CFDictionaryRef WSMethodInvocationCopyParameters ( WSMethodInvocationRef invocation, CFArrayRef *parameterOrder );

    Параметры

    invocation

    вызов

    parameterOrder

    указатель на a CFArray какое желание получит имена, в их указанном порядке, входных значений параметров. Этот параметр может быть NULL.

    Возвращаемое значение

    a CFDictionaryRef

    Обсуждение

    Копирует параметры с вызова. Получающийся словарь содержит словарь параметра. parameterOrder выходной параметр, если нет NULL, будет содержать порядок, используемый для сериализации параметров.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.8.

  • WSMethodInvocationCopyProperty WSMethodInvocationCopyProperty (OS X v10.8)

    Создает копию именованного свойства ссылки вызова.

    Объявление

    Objective C

    CFTypeRef WSMethodInvocationCopyProperty ( WSMethodInvocationRef invocation, CFStringRef propertyName );

    Параметры

    invocation

    Вызов метода.

    propertyName

    Имя свойства для получения.

    Возвращаемое значение

    CFTypeRef значение свойства, или NULL если не было указано свойство.

    Обсуждение

    Возвращает свойство из вызова. Если результат NULL, свойство не существует. Будучи вызовом копии, необходимо выпустить результат.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.8.

  • WSMethodInvocationCopySerialization WSMethodInvocationCopySerialization (OS X v10.8)

    Создает сериализацию XML вызова метода.

    Объявление

    Objective C

    CFDataRef WSMethodInvocationCopySerialization ( WSMethodInvocationRef invocation );

    Параметры

    invocation

    Вызов для сериализации.

    Возвращаемое значение

    A CFDataRef из сериализированного вызова метода XML.

    Обсуждение

    Создает сериализированную версию вызова метода, который может использоваться в более позднее время.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.8.

  • WSMethodInvocationCreate WSMethodInvocationCreate (OS X v10.8)

    Создает ссылку на вызов метода, содержа URL службы, имени работы и протокола.

    Объявление

    Objective C

    WSMethodInvocationRef WSMethodInvocationCreate ( CFURLRef url, CFStringRef methodName, CFStringRef protocol );

    Параметры

    url

    Конечная точка службы.

    methodName

    Имя работы, которую вызовут.

    protocol

    Строка, определенная выше этого, определяет тип объекта вызова создать. Существуют строковые константы для XML-RPC, SOAP 1.1 или SOAP 1.2. Другие протоколы не распознаны.

    Возвращаемое значение

    A WSMethodInvocationRef объект, который может быть передан WSMethodInvocationInvoke или запланированный с циклом выполнения.

    Обсуждение

    Создает объект вызова метода веб-сервисов. Это - фундаментальный объект, используемый когда передающие параметры метода или настройки, обратные вызовы, или пользовательские сериализаторы или deserializers. Этот объект может быть выполнен синхронно с помощью WSMethodInvocationInvoke или запланированный на цикл выполнения для асинхронного использования выполнения WSMethodInvocationScheduleWithRunLoop.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.8.

  • WSMethodInvocationCreateFromSerialization WSMethodInvocationCreateFromSerialization (OS X v10.8)

    Создает объект вызова метода из сериализации XML.

    Объявление

    Objective C

    WSMethodInvocationRef WSMethodInvocationCreateFromSerialization ( CFDataRef contract );

    Параметры

    contract

    Результат ранее сериализированного WSMethodInvocationRef.

    Возвращаемое значение

    A WSMethodInvocationRef объект, который может быть передан WSMethodInvocationInvoke или запланированный с циклом выполнения.

    Обсуждение

    Создает объект вызова метода веб-сервисов из ранее сериализированного договора. Можно использовать, это с сериализацией возвратилось из WSMethodInvocationCopySerialization.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.8.

  • WSMethodInvocationGetTypeID WSMethodInvocationGetTypeID (OS X v10.8)

    Возвращает идентификатор типа вызова существующего метода.

    Объявление

    Objective C

    CFTypeID WSMethodInvocationGetTypeID ( void );

    Возвращаемое значение

    CFTypeID.

    Обсуждение

    Возвращает ID вызова существующего метода. Необходимо сразу вызвать это после создания ссылки вызова.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.8.

  • WSMethodInvocationInvoke WSMethodInvocationInvoke (OS X v10.8)

    Вызывает работу веб-сервисов синхронно.

    Объявление

    Objective C

    CFDictionaryRef WSMethodInvocationInvoke ( WSMethodInvocationRef invocation );

    Параметры

    invocation

    Ссылка вызова метода.

    Возвращаемое значение

    a CFDictionaryRef содержа результат выполнения или отказа и дополнительной отладочной информации.

    Обсуждение

    Выполняет вызов синхронно. Если вызов был успешен, результат содержит результат вызова. Если вызов перестал работать по какой-либо причине, включая из памяти или ошибок недопустимого параметра, то результат содержит структуру отказа. Необходимо выпустить результат, когда Вы сделаны с ним. Для выполнения вызова, асинхронно (рекомендуемого), используйте WSMethodInvocationScheduleWithRunLoop.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.8.

  • WSMethodInvocationScheduleWithRunLoop WSMethodInvocationScheduleWithRunLoop (OS X v10.8)

    Запланируйте вызов метода для асинхронного выполнения на цикле выполнения.

    Объявление

    Objective C

    void WSMethodInvocationScheduleWithRunLoop ( WSMethodInvocationRef invocation, CFRunLoopRef runLoop, CFStringRef runLoopMode );

    Параметры

    invocation

    Ссылка вызова метода.

    runLoop

    Цикл выполнения, на который можно запланировать вызов.

    runLoopMode

    Режим цикла выполнения.

    Обсуждение

    Планирует вызов для выполнения на цикле выполнения. Необходимо также установить обратный вызов для обработки ответа, с помощью WSMethodInvocationSetCallBack. Это - рекомендуемый способ вызвать веб-сервисы вследствие непредсказуемых сетевых задержек, свойственных от таких операций.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.8.

  • WSMethodInvocationSetCallBack WSMethodInvocationSetCallBack (OS X v10.8)

    Установите обратный вызов для обработки ответа на вызов асинхронного метода.

    Объявление

    Objective C

    void WSMethodInvocationSetCallBack ( WSMethodInvocationRef invocation, WSMethodInvocationCallBackProcPtr clientCB, WSClientContext *context );

    Параметры

    invocation

    Ссылка вызова метода.

    clientCB

    A ProcPtr быть вызванным, когда завершается вызов.

    context

    Указатель на a WSClientContext. Структура будет скопирована.

    Обсуждение

    Устанавливает обратный вызов для обработки ответа для вызова асинхронного метода. Обратный вызов передается ссылка на вызов метода, просто завершенный, указатель на частные данные и словарь, содержащий возвращаемые значения для работы или структуры отказа. Тест для использования отказа WSMethodResultIsFault. Обратный вызов анализирует словарь ответа метода, который содержит десериализованные данные возврата и может содержать необработанный XML сообщения возврата также. Обратный вызов ответственен за выпуск результата касательно.

    Вызовите с a clientCB и контекст NULL очистить обратный вызов вызова.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.8.

  • WSMethodInvocationSetParameters WSMethodInvocationSetParameters (OS X v10.8)

    Установите названия параметра, типы и порядок на вызов метода.

    Объявление

    Objective C

    void WSMethodInvocationSetParameters ( WSMethodInvocationRef invocation, CFDictionaryRef parameters, CFArrayRef parameterOrder );

    Параметры

    invocation

    Ссылка вызова.

    parameters

    A CFDictionaryRef из CFString ключи и CFTypeRef значения.

    parameterOrder

    A CFArrayRef из CFString названия параметра для XML-RPC.

    Обсуждение

    Устанавливает параметры для вызова метода. Словарь параметров должен содержать имена и типы параметров. Массив порядка параметра должен содержать имена параметров в порядке, они должны быть переданы. parameterOrder может быть NULL, когда порядок параметров не определен. Если словарь параметров содержит больше или меньше параметров, чем указано порядком, поведение не определено.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.8.

  • WSMethodInvocationSetProperty WSMethodInvocationSetProperty (OS X v10.8)

    Устанавливает именованное свойство вызова метода.

    Объявление

    Objective C

    void WSMethodInvocationSetProperty ( WSMethodInvocationRef invocation, CFStringRef propertyName, CFTypeRef propertyValue );

    Параметры

    invocation

    Ссылка вызова метода.

    propertyName

    A CFStringRef имя свойства для установки.

    propertyValue

    A CFTypeRef содержа новое значение свойства.

    Обсуждение

    Добавляют свойства к вызову метода. Эти свойства могут быть определяемыми пользователем или одно из заявленных свойств, которые могут изменить поведение вызова. Заявленные свойства запускаются со строки «kWS», например kWSHTTPFollowsRedirects. Используйте эти свойства, чтобы добавить заголовки действия SOAP или установить свойства отладки, такой как включая необработанный XML в словаре ответа метода. Свойства сериализируются вместе с договором, таким образом, необходимо избегать использования необработанных указателей в a CFNumber, например.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.8.

  • WSMethodInvocationUnscheduleFromRunLoop WSMethodInvocationUnscheduleFromRunLoop (OS X v10.8)

    Не планирует вызов метода от цикла выполнения.

    Объявление

    Objective C

    void WSMethodInvocationUnscheduleFromRunLoop ( WSMethodInvocationRef invocation, CFRunLoopRef runLoop, CFStringRef runLoopMode );

    Параметры

    invocation

    Ссылка вызова метода.

    runLoop

    Цикл выполнения, от которого можно не запланировать вызов.

    runLoopMode

    Режим цикла выполнения.

    Обсуждение

    Не планирует вызов от данного выполненного цикла и режима. Если вызов еще не завершился, его обратный вызов не вызовут.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.8.

  • WSMethodResultIsFault WSMethodResultIsFault (OS X v10.8)

    Тестирует словарь результата метода на состояние отказа.

    Объявление

    Objective C

    Boolean WSMethodResultIsFault ( CFDictionaryRef methodResult );

    Параметры

    methodResult

    Словарь результата метода.

    Возвращаемое значение

    Булев TRUE, если результат содержит состояние отказа.

    Обсуждение

    Если результатом является отказ, загляните kWSFaultCode, kWSFaultString, и kWSFaultExtra поля словаря. Если не отказ, kWSMethodInvocationResult будет содержать результат выполнения. Если отладочную информацию требовали, это будет доступно в словаре также.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.8.

Функции обработчика протокола

Функции обработчика протокола помогают в сериализации и десериализации запросов на обслуживание и ответах. Другими словами, они переводят между сообщениями XML и словарями. Эти функции могут использоваться для поддержки или серверной стороны или приложений веб-сервисов клиентской стороны. На клиентской стороне они не обычно необходимы, поскольку сериализация и десериализация обрабатываются вызовом метода, но они могут быть полезными, когда эта работа должна быть выполнена отдельно от самого вызова метода.

  • WSProtocolHandlerCopyFaultDocument WSProtocolHandlerCopyFaultDocument (OS X v10.8)

    Создает Отказ, ответ XML для данного WSProtocolHandler и отказа подробно излагает словарь.

    Объявление

    Objective C

    CFDataRef WSProtocolHandlerCopyFaultDocument ( WSProtocolHandlerRef ref, CFDictionaryRef methodContext, CFDictionaryRef faultDict );

    Параметры

    ref

    A WSProtocolHandlerRef, как создается WSProtocolHandlerCreate.

    methodContext

    CFDictionary, содержащий контекст для этого вызова метода, как возвращено WSProtocolHandlerParseRequest.

    faultDict

    A CFDictionary содержа информацию об отказах. Посмотрите WSMethodInvocation.h для допустимых ключей.

    Возвращаемое значение

    A CFDataRef содержа отказ XML.

    Обсуждение

    Эта функция создает Отказ ответ XML для данного WSProtocolHandlerRef и отказ подробно излагает словарь. Словарь отказа содержит один или больше kWSFaultString, kWSFaultCode или kWSFaultExtra, согласно WSMethodInvocation.h.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.8.

  • WSProtocolHandlerCopyProperty WSProtocolHandlerCopyProperty (OS X v10.8)

    Возвращает копию свойства из ссылки обработчика протокола.

    Объявление

    Objective C

    CFTypeRef WSProtocolHandlerCopyProperty ( WSProtocolHandlerRef ref, CFStringRef propertyName );

    Параметры

    ref

    A WSProtocolHandlerRef, как создается WSProtocolHandlerCreate.

    propertyName

    Имя свойства для копирования.

    Возвращаемое значение

    CFTypeRef значение свойства, или NULL если не существует указанное свойство.

    Обсуждение

    Возвращает свойство из обработчика протокола. Если результат NULL, свойство не существует. Так как это - вызов Копии, необходимо выпустить результат.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.8.

  • WSProtocolHandlerCopyReplyDictionary WSProtocolHandlerCopyReplyDictionary (OS X v10.8)

    Анализирует входящий XML-документ, как будто это был ответ метода.

    Объявление

    Objective C

    CFDictionaryRef WSProtocolHandlerCopyReplyDictionary ( WSProtocolHandlerRef ref, CFStringRef methodName, CFDataRef data );

    Параметры

    ref

    A WSProtocolHandlerRef, как создается WSProtocolHandlerCreate.

    methodName

    Имя метода для обработки XML-файла в результате.

    data

    A CFDataRef из XML-документа для парсинга

    Возвращаемое значение

    A CFDictionary, как возвращено WSMethodInvocationInvoke.

    Обсуждение

    Проанализируйте входящий XML-документ, как будто это был ответ метода. Результаты совпадают с WSMethodInvocationInvoke ответ; ответ мог быть отказом. Если была ошибка анализа, NULL возвращается. Протокол определенные дополнения, такой как kWSSOAPMessageHeaders, май также присутствовать в словаре. Вызывающая сторона должна выпустить получающийся словарь.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.8.

  • WSProtocolHandlerCopyReplyDocument WSProtocolHandlerCopyReplyDocument (OS X v10.8)

    Создает XML-документ Ответа для данного WS ProtocolHandler и словарь контекста.

    Объявление

    Objective C

    CFDataRef WSProtocolHandlerCopyReplyDocument ( WSProtocolHandlerRef ref, CFDictionaryRef methodContext, CFTypeRef resultValue );

    Параметры

    ref

    WSProtocolHandler для ответа.

    methodContext

    CFDictionary содержа контекст для этого вызова метода, как возвращено WSProtocolHandlerParseRequest.

    resultValue

    A CFTypeRef представление данных, которые будут сериализированы.

    Возвращаемое значение

    A CFDataRef содержа ответ XML.

    Обсуждение

    Эта функция создает XML-документ Ответа для данного WSProtocolHandler и словарь контекста. Протокол определенный addtions (например, kWSSOAPMessageHeaders) май также присутствовать в словаре.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.8.

  • WSProtocolHandlerCopyRequestDictionary WSProtocolHandlerCopyRequestDictionary (OS X v10.8)

    Анализирует входящий XML-документ для имени метода и параметров.

    Объявление

    Objective C

    CFDictionaryRef WSProtocolHandlerCopyRequestDictionary ( WSProtocolHandlerRef ref, CFDataRef data );

    Параметры

    ref

    Обработчик протокола для использования.

    data

    XML-документ для парсинга.

    Возвращаемое значение

    A CFDictionary.

    Обсуждение

    Эта функция анализирует входящий XML-документ для имени метода и параметров. Результаты находятся в dictionory как kWSMethodName (a CFString), kWSMethodParameters (a CFDictionary), и kWSMethodParameterOrder (a CFArray). Если ошибка анализа произошла, NULL возвращается. Протокол определенные дополнения (например, kWSSOAPMessageHeaders) май также присутствовать в словаре. Словарь возвратился, также представляет контекст, с которым создаются документы ответа XML (см. WSProtocolHandlerCreateReply). Вызывающая сторона должна выпустить получающийся словарь. Обратите внимание на то, что возвращенный словарь должен использоваться в качестве входного параметра для другого WSProtocol функции, требующие параметра словаря контекста.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.8.

  • WSProtocolHandlerCopyRequestDocument WSProtocolHandlerCopyRequestDocument (OS X v10.8)

    Создает запрос XML на данный WSProtocolHandler и список параметров.

    Объявление

    Objective C

    CFDataRef WSProtocolHandlerCopyRequestDocument ( WSProtocolHandlerRef ref, CFStringRef methodName, CFDictionaryRef methodParams, CFArrayRef methodParamOrder, CFDictionaryRef methodExtras );

    Параметры

    ref

    WSProtocolHandlerRef.

    methodName

    A CFString из имени метода для вызова.

    methodParams

    A CFDictionary содержа параметры для отправки.

    methodParamOrder

    A CFArray, который, если нет NULL, указывает порядок параметров в CFDictionary.

    methodExtras

    A CFDictionary, который, если нет NULL, содержит дополнительную информацию для протокола (например, kWSSoapMessageHeaders).

    Возвращаемое значение

    A CFDataRef.

    Обсуждение

    Эта функция создает запрос XML на данный WSProtocolHandler и список параметров. Это - запрос, отправленный к серверу.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.8.

  • WSProtocolHandlerCreate WSProtocolHandlerCreate (OS X v10.8)

    Создает a WSProtocolHandlerRef для использования в переводе XML-документа.

    Объявление

    Objective C

    WSProtocolHandlerRef WSProtocolHandlerCreate ( CFAllocatorRef allocator, CFStringRef protocol );

    Параметры

    allocator

    A CFAllocatorRef используемый для выделения обработчика протокола.

    protocol

    Постоянная строка, определенная в WSMethodInvocation.h, это определяет тип реализации для создания (XML-RPC по сравнению с SOAP).

    Возвращаемое значение

    A WSProtocolHandlerRef; NULL если произошла ошибка анализа.

    Обсуждение

    Эта функция создает a WSProtocolHandlerRef для использования в переводе XML-документа. Обработчик протокола переводит словари в запросы веб-сервисов. Это создается со строкой, указывающей протокол (XML-RPC или SOAP), и может быть изменено путем установки различных свойств. Нужно отметить, что синтаксический анализатор может быть снова использован для многократных синтаксических анализов.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.8.

  • WSProtocolHandlerGetTypeID WSProtocolHandlerGetTypeID (OS X v10.8)

    Возвраты a CFTypeID для тока WSProtocolHandlerRef.

    Объявление

    Objective C

    CFTypeID WSProtocolHandlerGetTypeID ( void );

    Возвращаемое значение

    A CFTypeID.

    Обсуждение

    Возвраты CFTypeID из непрозрачного WSProtocolHandlerRef последний раз создаваемый WSProtocolHandlerCreate. CFTypeIDs только допустимы во время определенного экземпляра процесса и не должен использоваться в качестве статических значений.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.8.

  • WSProtocolHandlerSetDeserializationOverride WSProtocolHandlerSetDeserializationOverride (OS X v10.8)

    Указывает обратный вызов, который будет сделан при парсинге ответа метода XML.

    Объявление

    Objective C

    void WSProtocolHandlerSetDeserializationOverride ( WSProtocolHandlerRef protocol, CFStringRef typeNamespace, CFStringRef typeName, WSProtocolHandlerDeserializationProcPtr deserializationProc, WSClientContext *context );

    Параметры

    protocol

    ProtocolHandlerRef.

    typeNamespace

    Полностью разрешенное пространство имен для определенного типа. Если NULL, пространство имен по умолчанию будет использоваться. Например, это поле могло быть: CFSTR("http://www.w3.org/2001/XMLSchema-instance").

    typeName

    Неквалифицированное имя типа. Этот параметр не должен быть NULL.

    deserializationProc

    A ProcPtr быть вызванным для выполнения десериализации.

    context

    Указатель на a WSClientContext. Структура будет скопирована.

    Обсуждение

    Эта функция указывает обратный вызов, который будет сделан при парсинге ответа метода XML. Обратный вызов передается ссылка на элемент протокола, в настоящее время выполняемый, корень дерева синтаксического анализа ответа, текущий узел, десериализовываемый, и указатель на частные данные. Результатом возврата должно быть допустимое CFTypeRef объект, который будет выпущен вызывающей стороной. Если возвращается обратный вызов NULL, значение по умолчанию deserializer будет использоваться.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.8.

  • WSProtocolHandlerSetProperty WSProtocolHandlerSetProperty (OS X v10.8)

    Устанавливает свойство в указанном обработчике протокола.

    Объявление

    Objective C

    void WSProtocolHandlerSetProperty ( WSProtocolHandlerRef ref, CFStringRef propertyName, CFTypeRef propertyValue );

    Параметры

    ref

    Обработчик протокола.

    propertyName

    Имя свойства для установки.

    propertyValue

    Значение свойства для установки.

    Обсуждение

    Эта функция устанавливает значение именованного свойства в реализации метода.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.8.

  • WSProtocolHandlerSetSerializationOverride WSProtocolHandlerSetSerializationOverride (OS X v10.8)

    Указывает обратный вызов, который вызовут для создания XML, представляющего сериализацию данного типа касательно.

    Объявление

    Objective C

    void WSProtocolHandlerSetSerializationOverride ( WSProtocolHandlerRef protocol, CFTypeID objType, WSProtocolHandlerSerializationProcPtr serializationProc, WSClientContext *context );

    Параметры

    protocol

    Протокол, который должен быть выполнен.

    objType

    CFTypeID из объекта, который будет сериализирован.

    serializationProc

    Обратный вызов сериализации, который выполнит работу.

    context

    Указатель на a WSClientContext. Структура будет скопирована.

    Обсуждение

    Эта функция указывает обратный вызов, который вызовут для создания XML, представляющего сериализацию данного типа касательно Этого обратного вызова, вызывается каждый раз, когда тип имеет данный CFTypeID. Обратный вызов должен возвратить отрывок XML, который будет понят под сервером как корректная сериализация для данного типа. Если обратный вызов возвращает NULL, сериализатор по умолчанию используется. Для сериализации SOAP ключ параметра (имя элемента) не является частью обратного вызова; это будет substituded для всех происшествий «%» в возвращаемой строке. Если возвращается Ваш обратный вызов NULL, сериализатор по умолчанию будет использоваться.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.8.

Функции типов веб-сервисов

Функции типов Веб-сервисов переводят между WSTypes и CFTypes. Поскольку CFTypes определяются во время выполнения, не всегда возможно произвести статическое отображение между Базовыми типами Основы, и соответствие сериализировало типы XML, используемые для взаимодействия с удаленными серверами. То, что это означает, - то, что при преобразовании между сериализированными данными XML и десериализованным CFTypes, необходимо сделать преобразование от WSTypes до CFTypes, и наоборот.

  • WSGetCFTypeIDFromWSTypeID WSGetCFTypeIDFromWSTypeID (OS X v10.8)

    Получает CFType, связанный с данным WSType

    Объявление

    Objective C

    CFTypeID WSGetCFTypeIDFromWSTypeID ( WSTypeID typeID );

    Параметры

    typeID

    WSTypeID для которого Вам нужен a CFTypeID.

    Возвращаемое значение

    Возвраты a CFTypeID, или 0, если не найденный

    Обсуждение

    Возвраты CFTypeID это связано с данным WSTypeID. CFTypeIDs только допустимы во время определенного экземпляра процесса и не должен использоваться в качестве статических значений.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.8.

  • WSGetWSTypeIDFromCFType WSGetWSTypeIDFromCFType (OS X v10.8)

    Возвраты WSTypeID связанный с данным CFTypeRef.

    Объявление

    Objective C

    WSTypeID WSGetWSTypeIDFromCFType ( CFTypeRef ref );

    Параметры

    ref

    A CFTypeRef объект. Должен быть передан фактический экземпляр CFType.

    Возвращаемое значение

    WSTypeID используемый в сериализации объекта. Если нет WSTypeID соответствия, eWSUnknownType возвращается.

    Обсуждение

    Возвраты WSTypeID связанный с CFTypeRef. Поскольку нет одного к одному отображению между CFTypeID и WSTypesID должен быть передан фактический экземпляр CFType.

    Оператор импорта

    Objective C

    @import CoreServices;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.8.

Обратные вызовы

Обратные вызовы контекста

Несколько вызовов в Веб-сервисах Базовое взятие обратный вызов с дополнительным указателем контекста. Контекст копируется, и информационный указатель сохраняется. Когда обратный вызов сделан, информационный указатель передается обратному вызову.

  • WSClientContextRetainCallBackProcPtr WSClientContextRetainCallBackProcPtr

    Это - обратный вызов, сохраняющий информацию.

    Объявление

    Swift

    typealias WSClientContextRetainCallBackProcPtr = CFunctionPointer<((UnsafeMutablePointer<Void>) -> UnsafeMutablePointer<Void>)>

    Objective C

    typedef CALLBACK_API( void *, WSClientContextRetainCallBackProcPtr ) (void * info);

    Параметры

    info

    Частные данные обратного вызова, которые будут сохранены.

    Обсуждение

    Ваш обратный вызов передается указатель на частные данные для Вас для сохранения.

    Оператор импорта

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

    Доступный в OS X v10.2 и позже.

  • WSClientContextReleaseCallBackProcPtr WSClientContextReleaseCallBackProcPtr

    Это - обратный вызов, выпускающий информацию.

    Объявление

    Swift

    typealias WSClientContextReleaseCallBackProcPtr = CFunctionPointer<((UnsafeMutablePointer<Void>) -> Void)>

    Objective C

    typedef CALLBACK_API( void *, WSClientContextReleaseCallBackProcPtr ) (void * info);

    Параметры

    info

    Частные данные обратного вызова, которые будут выпущены.

    Обсуждение

    Ваш обратный вызов передается указатель на частные данные для Вас для выпуска.

    Оператор импорта

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

    Доступный в OS X v10.2 и позже.

  • WSClientContextCopyDescriptionCallBackProcPtr WSClientContextCopyDescriptionCallBackProcPtr

    Это - обратный вызов, копирующий информацию.

    Объявление

    Swift

    typealias WSClientContextCopyDescriptionCallBackProcPtr = CFunctionPointer<((UnsafeMutablePointer<Void>) -> Unmanaged<CFString>!)>

    Objective C

    typedef CALLBACK_API( CFStringRef *, WSClientContextCopyDescriptionCallBackProcPtr ) (void * info);

    Параметры

    info

    Частные данные обратного вызова, с которыми справятся.

    Возвращаемое значение

    CFStringRef, содержащий клиентскую контекстную информацию.

    Обсуждение

    Ваш обратный вызов передается указатель на частные данные для Вас для копирования.

    Оператор импорта

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

    Доступный в OS X v10.2 и позже.

Обратные вызовы вызова метода
  • WSMethodInvocationCallBackProcPtr WSMethodInvocationCallBackProcPtr

    Это - обратный вызов, обрабатывающий завершение вызова метода, когда метод вызывается асинхронно.

    Объявление

    Swift

    typealias WSMethodInvocationCallBackProcPtr = CFunctionPointer<((WSMethodInvocation!, UnsafeMutablePointer<Void>, CFDictionary!) -> Void)>

    Objective C

    typedef CALLBACK_API( void , WSMethodInvocationCallBackProcPtr ) ( WSMethodInvocationRef invocation, void *info, CFDictionaryRef outRef);

    Параметры

    invocation

    Вызов метода, для которого этот обратный вызов обрабатывает завершение.

    info

    Частные данные обратного вызова.

    outRef

    A CFDictionaryRef содержание вызова метода заканчивается или структура отказа и дополнительная отладочная информация.

    Обсуждение

    Ваш обратный вызов передается ссылка на вызов, просто завершенный, указатель на частные данные и словарь, содержащий возвращаемое значение или falut для этого вызова. Обратный вызов ответственен за выпуск словаря, когда это больше не используется.

    Оператор импорта

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

    Доступный в OS X v10.2 и позже.

  • WSMethodInvocationSerializationProcPtr WSMethodInvocationSerializationProcPtr

    Это - дополнительный обратный вызов, обрабатывающий пользовательскую сериализацию определенного типа данных для вызова метода.

    Объявление

    Swift

    typealias WSMethodInvocationSerializationProcPtr = CFunctionPointer<((WSMethodInvocation!, AnyObject!, UnsafeMutablePointer<Void>) -> Unmanaged<CFString>!)>

    Objective C

    typedef CALLBACK_API( CFStringRef , WSMethodInvocationSerializationProcPtr ) ( WSMethodInvocationRef invocation, CFTypeRef obj, void *info);

    Параметры

    invocation

    Вызов метода, для которого этот обратный вызов обрабатывает сериализацию.

    obj

    CFTypeRef, для которого этот обратный вызов производит сериализированный XML.

    info

    Частные данные обратного вызова.

    Возвращаемое значение

    A CFStringRef содержа допустимый XML. Вызывающая сторона этого обратного вызова выпустит строку. Если Вы возвращаетесь NULL, сериализатор по умолчанию используется.

    Обсуждение

    Этот обратный вызов вызывают каждый раз, когда тип, который будет сериализирован вызовом метода, имеет данный CFTypeID. Обратный вызов должен возвратить отрывок XML, который будет понят под сервером как корректная сериализация для данного типа. Если возвращается обратный вызов NULL, сериализатор по умолчанию используется.

    Оператор импорта

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

    Доступный в OS X v10.2 и позже.

  • WSMethodInvocationDeserializationProcPtr WSMethodInvocationDeserializationProcPtr

    Это - дополнительный обратный вызов, обрабатывающий пользовательскую десериализацию определенного типа данных для ответа метода.

    Объявление

    Swift

    typealias WSMethodInvocationDeserializationProcPtr = CFunctionPointer<((WSMethodInvocation!, CFXMLTree!, CFXMLTree!, UnsafeMutablePointer<Void>) -> Unmanaged<AnyObject>!)>

    Objective C

    typedef CALLBACK_API( CFTypeRef , WSMethodInvocationDeserializationProcPtr ) ( WSMethodInvocationRef invocation, CFXMLTreeRef msgRoot, CFXMLTreeRef deserializeRoot, void *info);

    Параметры

    invocation

    Вызов метода, для которого этот обратный вызов обрабатывает десериализацию.

    msgRoot

    Корневой элемент XML, который будет десериализован.

    deserializeRoot

    Древовидный элемент XML, который будет десериализован.

    info

    Частные данные обратного вызова.

    Возвращаемое значение

    A CFTypeRef представление десериализованных данных. Вызывающая сторона выпустит эти данные. Если Вы возвращаетесь NULL, значение по умолчанию deserializer используется.

    Обсуждение

    Этот обратный вызов передается ссылка на вызов, в настоящее время выполняемый, корень дерева синтаксического анализа ответа, текущий узел, десериализовываемый, и указатель на частные данные. Результатом возврата должно быть допустимое CFTypeRef объект (который будет выпущен вызывающей стороной), или NULL позволить значению по умолчанию deserializer действовать. В отличие от обратного вызова сериализации, который вызывают только для указанного типа данных, обратный вызов десериализации вызывают для каждого элемента, который будет десериализован.

    Оператор импорта

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

    Доступный в OS X v10.2 и позже.

Обратные вызовы обработчика протокола
  • WSProtocolHandlerSerializationProcPtr WSProtocolHandlerSerializationProcPtr

    Это - дополнительный обратный вызов, обрабатывающий пользовательскую сериализацию определенного типа данных для обработчика протокола.

    Объявление

    Swift

    typealias WSProtocolHandlerSerializationProcPtr = CFunctionPointer<((WSProtocolHandler!, AnyObject!, UnsafeMutablePointer<Void>) -> Unmanaged<CFString>!)>

    Objective C

    typedef CALLBACK_API( CFStringRef , WSProtocolHandlerSerializationProcPtr ) ( WSProtocolHandlerRef protocol, CFTypeRef obj, void *info);

    Параметры

    protocol

    Обработчик протокола, для которого этот обратный вызов обрабатывает сериализацию.

    obj

    CFTypeRef, для которого этот обратный вызов производит сериализированный XML.

    info

    Частные данные обратного вызова.

    Возвращаемое значение

    A CFStringRef содержа допустимый XML. Вызывающая сторона этого обратного вызова выпустит строку. Если Вы возвращаетесь NULL, сериализатор по умолчанию используется.

    Обсуждение

    Этот обратный вызов вызывают каждый раз, когда тип, который будет сериализирован обработчиком протокола, имеет данный CFTypeID. Обратный вызов должен возвратить отрывок XML, который будет понят под сервером как корректная сериализация для данного типа. Если возвращается обратный вызов NULL, сериализатор по умолчанию используется.

    Оператор импорта

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

    Доступный в OS X v10.3 и позже.

  • WSProtocolHandlerDeserializationProcPtr WSProtocolHandlerDeserializationProcPtr

    Это - дополнительный обратный вызов, обрабатывающий пользовательскую десериализацию определенного типа данных для обработчика протокола.

    Объявление

    Swift

    typealias WSProtocolHandlerDeserializationProcPtr = CFunctionPointer<((WSProtocolHandler!, CFXMLTree!, CFXMLTree!, UnsafeMutablePointer<Void>) -> Unmanaged<AnyObject>!)>

    Objective C

    typedef CALLBACK_API( CFTypeRef , WSProtocolHandlerDeserializationProcPtr ) ( WSProtocolHandlerRef protocol, CFXMLTreeRef msgRoot, CFXMLTreeRef deserializeRoot, void *info);

    Параметры

    protocol

    Обработчик протокола, для которого этот обратный вызов обрабатывает десериализацию.

    msgRoot

    Корневой элемент XML, который будет десериализован.

    deserializeRoot

    Древовидный элемент XML, который будет десериализован.

    info

    Частные данные обратного вызова.

    Возвращаемое значение

    A CFTypeRef представление десериализованных данных. Вызывающая сторона выпустит эти данные. Если Вы возвращаетесь NULL, значение по умолчанию deserializer используется.

    Обсуждение

    Этот обратный вызов передается ссылка на вызов, в настоящее время выполняемый, корень дерева синтаксического анализа ответа, текущий узел, десериализовываемый, и указатель на частные данные. Результатом возврата должно быть допустимое CFTypeRef объект (который будет выпущен вызывающей стороной), или NULL позволить значению по умолчанию deserializer действовать. В отличие от обратного вызова сериализации, который вызывают только для указанного типа данных, обратный вызов десериализации вызывают для каждого элемента, который будет десериализован.

    Оператор импорта

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

    Доступный в OS X v10.3 и позже.

Типы данных

  • WSClientContext WSClientContext

    Дополнительный контекст, который может содержать данные, которые Вы хотите, передал Вашему обратному вызову.

    Объявление

    Swift

    struct WSClientContext { var version: CFIndex var info: UnsafeMutablePointer<Void> var retain: WSClientContextRetainCallBackProcPtr var release: WSClientContextReleaseCallBackProcPtr var copyDescription: WSClientContextCopyDescriptionCallBackProcPtr }

    Objective C

    struct WSClientContext { CFIndex version; void * info; WSClientContextRetainCallBackProcPtr retain; WSClientContextReleaseCallBackProcPtr release; WSClientContextCopyDescriptionCallBackProcPtr copyDescription; }; typedef struct WSClientContext WSClientContext;

    Обсуждение

    Несколько вызовов в платформе Ядра Веб-сервисов берут обратный вызов с дополнительным указателем контекста. Контекст копируется, и информационный указатель сохраняется. Когда обратный вызов сделан, информационный указатель передается обратному вызову.

    Оператор импорта

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

    Доступный в OS X v10.2 и позже.

  • WSMethodInvocationRef WSMethodInvocationRef

    Непрозрачная ссылка на вызов метода веб-сервисов.

    Объявление

    Swift

    typealias WSMethodInvocationRef = WSMethodInvocation

    Objective C

    typedef struct OpaqueWSMethodInvocationRef* WSMethodInvocationRef;

    Обсуждение

    WSMethodInvocationRef фундаментальный объект веб-сервисов. Создайте его использование WSMethodInvocationCreate. Используйте его, чтобы установить параметры, обратные вызовы и настройки для вызова метода, и вызвать метод и получить ответ.

    Оператор импорта

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

    Доступный в OS X v10.2 и позже.

  • WSProtocolHandlerRef WSProtocolHandlerRef

    Непрозрачная ссылка на обработчика протокола веб-сервисов.

    Объявление

    Swift

    typealias WSProtocolHandlerRef = WSProtocolHandler

    Objective C

    typedef struct OpaqueWSProtocolHandlerRef* WSProtocolHandlerRef;

    Обсуждение

    WSProtocolHandlerRef представляет экземпляр обработчика протокола. Создайте его использование WSProtocolHandlerCreate.

    Оператор импорта

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

    Доступный в OS X v10.2 и позже.

Константы

Константы WSTypes

  • WSTypeID

    Ядро Веб-сервисов использует следующее перечисление при сериализации между Базовой Основой и типами XML. Поскольку CFTypes определяются во время выполнения, не всегда возможно произвести статическое отображение на определенный CFTypeRef. Это перечисление и связанный API допускают статическое определение ожидаемой сериализации.

    Объявление

    Swift

    struct WSTypeID { init(_ value: UInt32) var value: UInt32 }

    Objective C

    enum WSTypeID { eWSUnknownType = 0, eWSNullType = 1, eWSBooleanType = 2 eWSIntegerType = 3, eWSDoubleType = 4, eWSStringType = 5, eWSDateType = 6, eWSDataType = 7, eWSArrayType = 8 eWSDictionaryType = 9};

    Константы

    • eWSUnknownType

      eWSUnknownType

      Никакое отображение не известно этим типом.

      Доступный в OS X v10.2 и позже.

    • eWSNullType

      eWSNullType

      Карты к CFNullRef.

      Доступный в OS X v10.2 и позже.

    • eWSBooleanType

      eWSBooleanType

      Карты к CFBooleanRef.

      Доступный в OS X v10.2 и позже.

    • eWSIntegerType

      eWSIntegerType

      Карты к CFNumberRef для 8, 16, целые числа на 32 бита.

      Доступный в OS X v10.2 и позже.

    • eWSDoubleType

      eWSDoubleType

      Карты к CFNumberRef долгое время, дважды, или вещественные числа.

      Доступный в OS X v10.2 и позже.

    • eWSStringType

      eWSStringType

      Карты к CFStringRef.

      Доступный в OS X v10.2 и позже.

    • eWSDateType

      eWSDateType

      Карты к CFDateRef.

      Доступный в OS X v10.2 и позже.

    • eWSDataType

      eWSDataType

      Карты к CFDataRef.

      Доступный в OS X v10.2 и позже.

    • eWSArrayType

      eWSArrayType

      Карты к CFArrayRef.

      Доступный в OS X v10.2 и позже.

    • eWSDictionaryType

      eWSDictionaryType

      Карты к CFDictionaryRef.

      Доступный в OS X v10.2 и позже.

    Оператор импорта

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

    Доступный в OS X v10.2 и позже.

Строковые константы

  • Константы протокола

    Передайте эти константы как параметры за поддерживаемые протоколы при создании ссылки обработчика протокола или вызова метода.

    Объявление

    Objective C

    CFStringRef kWSXMLRPCProtocol; CFStringRef kWSSOAP1999Protocol; CFStringRef kWSSOAP2001Protocol;

    Константы

    • kWSXMLRPCProtocol

      kWSXMLRPCProtocol

      Протокол XML-RPC.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

    • kWSSOAP1999Protocol

      kWSSOAP1999Protocol

      Протокол SOAP v1.1.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

    • kWSSOAP2001Protocol

      kWSSOAP2001Protocol

      Протокол SOAP v1.2.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

  • Закончитесь и дайте сбой константы

    Эти строковые константы идентифицируют результаты метода, отказы или сетевые проблемы.

    Объявление

    Objective C

    CFStringRef kWSMethodInvocationResult; CFStringRef kWSFaultString; CFStringRef kWSFaultCode; CFStringRef kWSFaultExtra; CFStringRef kWSNetworkStreamFaultString; CFStringRef kWSStreamErrorMessage; CFStringRef kWSStreamErrorDomain; CFStringRef kWSStreamErrorError;

    Константы

    • kWSMethodInvocationResult

      kWSMethodInvocationResult

      Словарная статья, если результатом вызова не является отказ. Если Вы не знаете, какое поле попросить, можно попросить этого ключа. Можно также указать имя параметра ответа в использовании вызова kWSMethodInvocationResultParameterName. Это добавит псевдоним для имени к словарю результата так, чтобы этот ключ возвратил именованный параметр.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

    • kWSFaultString

      kWSFaultString

      Если результатом является отказ, этот ключ возвращает CFString с типом отказа. Если тип отказа kWSNetworkStreamFaultString, тогда отказ является сетевой ошибкой. В случае сетевой ошибки, kWSFaultCode должен быть проигнорирован, и kWSFaultExtra возвращает словарь, указывающий сетевую ошибку.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

    • kWSFaultCode

      kWSFaultCode

      Если результатом является отказ, этот ключ возвращает CFNumber с кодом отказа, если отказ не является сетевой ошибкой, когда должно быть проигнорировано это поле.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

    • kWSFaultExtra

      kWSFaultExtra

      Если результатом является отказ, и отказ является сетевой ошибкой, ключ возвращает CFDictionary с сетевой ошибкой. Этот ключ может также возвратить CFString, или NULL.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

    • kWSNetworkStreamFaultString

      kWSNetworkStreamFaultString

      Если kWSFaultExtra словарь, этот ключ возвращает CFString из того словаря в целях отладки.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

    • kWSStreamErrorMessage

      kWSStreamErrorMessage

      Если kWSFaultExtra словарь, этот ключ возвращает CFString из того словаря, содержащего потоковое сообщение об ошибке.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

    • kWSStreamErrorDomain

      kWSStreamErrorDomain

      Если kWSFaultExtra словарь, этот ключ возвращает a CFNumberRef из того словаря, содержащего доменное число. Посмотрите CFStream.h для доменных чисел.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

    • kWSStreamErrorError

      kWSStreamErrorError

      Если kWSFaultExtra словарь, этот ключ возвращает a CFNumberRef из того словаря, содержащего код ошибки. Посмотрите CFStream.h для кодов ошибки.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

  • HTTP передает константы

    Можно указать a CFHTTPMessageRef поскольку свойство, которое будет использоваться вместо того, чтобы создать новый исходящий HTTP или HTTPS, обменивается сообщениями для вызовов метода. CFHTTPMessageRef может содержать заголовок, прокси и информацию аутентификации. Организация сообщения будет проигнорирована и заменена выходом, сериализировал вызов. После того, как вызов выполнился, можно получить копию фактического CFHTTPMessageRef, содержа подробные данные вызова из словаря ответа при помощи kWSHTTPResponseMessage как ключ. При попытке получить свойство ответного сообщения, прежде чем завершается вызов, возвратится NULL.

    Объявление

    Objective C

    CFStringRef kWSHTTPMessage; CFStringRef kWSHTTPResponseMessage;

    Константы

    • kWSHTTPMessage

      kWSHTTPMessage

      Сообщение.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

    • kWSHTTPResponseMessage

      kWSHTTPResponseMessage

      Ключ раньше получал ответ из словаря ответа..

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

  • HTTP передает Propereties

    Избегать иметь необходимость создать все CFHTTPMessageRef, эти свойства индивидуально устанавливаемы. Если они будут установлены, то они переопределят любого CFHTTPMessageRef ранее указанный.

    Объявление

    Objective C

    CFStringRef kWSHTTPVersion; CFStringRef kWSHTTPExtraHeaders; CFStringRef kWSHTTPProxy; CFStringRef kWSHTTPFollowsRedirects;

    Константы

    • kWSHTTPVersion

      kWSHTTPVersion

      CFHTTPMessageRef версия, такая как «http/1.1».

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

    • kWSHTTPExtraHeaders

      kWSHTTPExtraHeaders

      CFDictionary { key (CFString), val (CFString) } пары.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

    • kWSHTTPProxy

      kWSHTTPProxy

      CFURLRef из прокси SOCKS.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

    • kWSHTTPFollowsRedirects

      kWSHTTPFollowsRedirects

      CFBoolean, управляющий, следует ли вызов за перенаправлениями (значение по умолчанию является ложью).

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

  • Свойства отладки

    Эти флаги заполнят WSInvocationResultRef с отладочной информацией. Имя свойства флага совпадает с полем в словаре результата.

    Объявление

    Objective C

    CFStringRef kWSDebugOutgoingHeaders; CFStringRef kWSDebugOutgoingBody; CFStringRef kWSDebugIncomingHeaders; CFStringRef kWSDebugIncomingBody;

    Константы

    • kWSDebugOutgoingHeaders

      kWSDebugOutgoingHeaders

      Если этот флаг установлен, результат включает заголовки исходящего сообщения.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

    • kWSDebugOutgoingBody

      kWSDebugOutgoingBody

      Если этот флаг установлен, результат включает организацию исходящего сообщения.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

    • kWSDebugIncomingHeaders

      kWSDebugIncomingHeaders

      Если этот флаг установлен, результат включает заголовки входящего сообщения.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

    • kWSDebugIncomingBody

      kWSDebugIncomingBody

      Если этот флаг установлен, результат включает организацию входящего сообщения.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

  • Свойства сообщения SOAP

    Это - массив CFStringRefs которые содержат допустимые элементы заголовка XML, отправляющиеся с сообщением. Они только применимы к заголовку сообщения SOAP.

    Объявление

    Objective C

    CFStringRef kWSSOAPMessageHeaders;

    Константы

    • kWSSOAPMessageHeaders

      kWSSOAPMessageHeaders

      A CFArrayRef из элементов заголовка XML, как CFStringRefs.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

  • Свойства модификатора сообщения

    Когда сериализация словаря, установка этих свойств могут изменить поведение сериализации.

    Объявление

    Objective C

    CFStringRef kWSRecordParameterOrder; CFStringRef kWSRecordNamespaceURI; CFStringRef kWSRecordType;

    Константы

    • kWSRecordParameterOrder

      kWSRecordParameterOrder

      A CFArrayRef из CFStringRefs содержа названия параметра, в порядке.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

    • kWSRecordNamespaceURI

      kWSRecordNamespaceURI

      A CFStringRef содержа пространство имен.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

    • kWSRecordType

      kWSRecordType

      A CFStringRef содержа тип записи.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

  • Название параметра результата

    Можно вынудить deserializer создать псевдоним к параметру как результат вызова путем установки названия параметра.

    Объявление

    Objective C

    CFStringRef kWSMethodInvocationResultParameterName;

    Константы

    • kWSMethodInvocationResultParameterName

      kWSMethodInvocationResultParameterName

      Установите это свойство для создания псевдонима к параметру, который будет возвращен kWSMethodInvocationResult. Передача на название параметра как a CFStringRef.

      Доступный в OS X v10.2 и позже.

      Осуждаемый в OS X v10.8.

Коды результата

  • errWSInternalError

    Произошла внутренняя ошибка платформы.

    Значение

    - 65793L

    Описание

    Произошла внутренняя ошибка платформы.

    Доступный в OS X v10.2 и позже.

  • errWSTransportError

    Сетевая ошибка произошла.

    Значение

    - 65794L

    Описание

    Сетевая ошибка произошла.

    Доступный в OS X v10.2 и позже.

  • errWSParseError

    Ответ сервера не был допустимым XML.

    Значение

    - 65795L

    Описание

    Ответ сервера не был допустимым XML.

    Доступный в OS X v10.2 и позже.

  • errWSTimeoutError

    Вызов метода испытал таймаут.

    Значение

    - 65796L

    Описание

    Вызов метода испытал таймаут.

    Доступный в OS X v10.2 и позже.

    • errWSInternalError

      Произошла внутренняя ошибка платформы.

      Значение

      - 65793L

      Описание

      Произошла внутренняя ошибка платформы.

      Доступный в OS X v10.2 и позже.

    • errWSTransportError

      Сетевая ошибка произошла.

      Значение

      - 65794L

      Описание

      Сетевая ошибка произошла.

      Доступный в OS X v10.2 и позже.

    • errWSParseError

      Ответ сервера не был допустимым XML.

      Значение

      - 65795L

      Описание

      Ответ сервера не был допустимым XML.

      Доступный в OS X v10.2 и позже.

    • errWSTimeoutError

      Вызов метода испытал таймаут.

      Значение

      - 65796L

      Описание

      Вызов метода испытал таймаут.

      Доступный в OS X v10.2 и позже.