NSConnection

NSConnection объект управляет коммуникацией между объектами в различных потоках или между потоком и процессом, работающим на локальной или удаленной системе. Объекты соединения формируют магистраль распределенного механизма объектов и обычно работают в фоновом режиме. Вы используете методы NSConnection явно при продаже объекта к другим приложениям, при доступе к такому продаваемому объекту через прокси, и при изменении параметров связи по умолчанию. В других случаях Вы просто взаимодействуете с продаваемым объектом или его прокси.

Единственный объект соединения может совместно использоваться многократными потоками и использоваться для доступа к продаваемому объекту.

Наследование

NSObject
NSConnection

Соответствует

NSObject

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

Не применимый

Objective C

@import Foundation;

Доступность

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

Получение экземпляра по умолчанию

defaultConnection + defaultConnection (OS X v10.6)

Возвращает значение по умолчанию NSConnection объект для текущего потока.

Оператор осуждения

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

Объявление

Objective C

+ (NSConnection *)defaultConnection

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

Значение по умолчанию NSConnection объект для текущего потока, создавая его при необходимости.

Обсуждение

Значение по умолчанию NSConnection возразите использует сингл NSPort объект и для получения и для отправки и полезен только для продажи объекта; используйте rootObject и registerName: методы, чтобы сделать это.

Специальные замечания

Одноэлементный метод NSConnection был осужден. Было трудно гарантировать, что общее соединение не использовалось другими операциями на потоке, на котором требовали соединение по умолчанию. Используя [NSConnection new] гарантирует, чтобы Вы получили уникальный объект соединения, предотвратив такие коллизии.

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.6.

Создание экземпляров

connectionWithReceivePort:sendPort: + connectionWithReceivePort:sendPort:

Возвраты NSConnection объект, передающий данное использование, отправляет и получает порты.

Объявление

Objective C

+ (instancetype)connectionWithReceivePort:(NSPort *)receivePort sendPort:(NSPort *)sendPort

Параметры

receivePort

Получить порт.

sendPort

Отправить порт.

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

NSConnection объект, передающий использование receivePort и sendPort.

Обсуждение

Посмотрите initWithReceivePort:sendPort: для получения дополнительной информации.

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

Objective C

@import Foundation;

Доступность

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

См. также

+ defaultConnection


    
    initWithReceivePort:sendPort:
    - initWithReceivePort:sendPort:

Возвраты NSConnection объект, инициализированный с данным, отправляет и получает порты.

Объявление

Objective C

- (instancetype)initWithReceivePort:(NSPort *)receivePort sendPort:(NSPort *)sendPort

Параметры

`receivePort`	Получить порт для нового соединения.
`sendPort`	Отправить порт для нового соединения.

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

NSConnection объект, инициализированный с receivePort и sendPort. Возвращенный объект мог бы отличаться, чем исходный получатель.

Обсуждение

Новое NSConnection объект добавляет receivePort к току NSRunLoop объект с NSDefaultRunLoopMode как режим. Если приложение не использует NSApplication возразите для обработки событий, это должно работать NSRunLoop объект с одним из его различных run... сообщения.

Этот метод отправляет NSConnectionDidInitializeNotification как только соединение инициализируется.

receivePort и sendPort параметры влияют на инициализацию следующим образом:

Если NSConnection объект с теми же портами уже существует, возвращает его и отбрасывает исходный получатель.
Если NSConnection объект существует, который использует те же порты, но переключенный в роль, тогда новое NSConnection объект связывается с ним. Сообщения, отправленные в прокси, сохраненный любым соединением, передаются через другой NSConnection объект. Это правило применяется и в и через адресные пространства.

Это поведение полезно для установки распределенных соединений объектов между потоками в приложении. Посмотрите Распределенные Объекты Программировать Темы для получения дополнительной информации.
Если receivePort и sendPort nil, освобождает получатель и возвраты nil.
Если receivePort nil, NSConnection объект выделяет и использует новый порт того же класса как sendPort.
Если sendPort nil или если оба порта являются тем же, NSConnection объектное использование receivePort и для отправки и для получения и полезно только для продажи объекта. Использовать registerName: и rootObject продавать объект.
Если NSConnection объект существует, который использует receivePort как оба из его портов, это обрабатывается как родитель нового NSConnection объект, и его корневой объект и все его параметры конфигурации применяются к новому NSConnection объект. Вы не должны ни регистрировать имя для, ни устанавливать корневой объект нового NSConnection объект. Посмотрите Конфигурирование Соединения для получения дополнительной информации.
Если receivePort и sendPort отличаются, и ни один не совместно используется с другим NSConnection объект, получатель может использоваться, чтобы продать объект, а также связаться с другим NSConnection объекты. Однако это не имеет никого другого NSConnection объект связаться с, пока каждый не устанавливается.
receivePort параметр не может быть совместно использован NSConnection объекты в различных потоках.

Этот метод является определяемым инициализатором для NSConnection класс.

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

Objective C

@import Foundation;

Доступность

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

См. также

+ defaultConnection

Выполнение соединения в новом потоке

runInNewThread - runInNewThread

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

Объявление

Objective C

- (void)runInNewThread

Обсуждение

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

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

Objective C

@import Foundation;

Доступность

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

Конфигурирует получатель для разрешения запросов от многократных потоков до удаленного объекта, не требуя, чтобы каждый поток каждому поддержал свое собственное соединение.

Объявление

Objective C

- (void)enableMultipleThreads

Обсуждение

В OS X v10.5 и позже, многократная поддержка потока включена по умолчанию, и этот метод ничего не делает.

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

Objective C

@import Foundation;

Доступность

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

См. также

– multipleThreadsEnabled
multipleThreadsEnabled multipleThreadsEnabled Свойство

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

Объявление

Objective C

@property(readonly) BOOL multipleThreadsEnabled

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

YEStrue если получатель поддерживает запросы от многократных потоков.

Обсуждение

YEStrue если получатель поддерживает запросы от многократных потоков, иначе NOfalse.

Значение по умолчанию YEStrue.

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

Objective C

@import Foundation;

Доступность

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

См. также

– enableMultipleThreads
addRunLoop: - addRunLoop:

Добавляет указанный цикл выполнения к списку выполненных циклов мониторы получателя и от которого это реагирует на запросы.

Объявление

Objective C

- (void)addRunLoop:(NSRunLoop *)runloop

Параметры

runloop

Цикл выполнения для добавления к получателю.

Обсуждение

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

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

Objective C

@import Foundation;

Доступность

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

См. также

– enableMultipleThreads
– removeRunLoop:
removeRunLoop: - removeRunLoop:

Удаляет данный NSRunLoop объект из списка выполненных циклов, которые контролирует получатель и от которого это реагирует на запросы.

Объявление

Objective C

- (void)removeRunLoop:(NSRunLoop *)runloop

Параметры

runloop

Цикл выполнения для удаления из получателя.

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

Objective C

@import Foundation;

Доступность

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

См. также

– addRunLoop:

Продажа службы


    
    serviceConnectionWithName:rootObject:usingNameServer:
    + serviceConnectionWithName:rootObject:usingNameServer:

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

Объявление

Objective C

+ (instancetype)serviceConnectionWithName:(NSString *)name rootObject:(id)root usingNameServer:(NSPortNameServer *)server

Параметры

`name`	Имя службы Вы хотите опубликовать.
`root`	Объект использовать в качестве корневого объекта для опубликованной службы. Это - объект, продаваемый соединением.
`server`	Сервер имен порта, в котором можно зарегистрировать Вашу службу.

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

NSConnection объект, представляющий продаваемую службу или nil если была проблема, настраивающая объект соединения.

Обсуждение

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

Если указанное имя службы соответствует службе, автозапускающейся launchd, этот метод позволяет службе регистрироваться с launchd процесс. Если служба не автозапускается launchd, этот метод регистрирует новое соединение в указанном имени. Для получения дополнительной информации о launchd и его роль в запущении услуг, см. Руководство по программированию Демонов и Служб

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

Objective C

@import Foundation;

Доступность

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

См. также

+ connectionWithRegisteredName:host:usingNameServer:
– rootObject


    
    serviceConnectionWithName:rootObject:
    + serviceConnectionWithName:rootObject:

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

Объявление

Objective C

+ (instancetype)serviceConnectionWithName:(NSString *)name rootObject:(id)root

Параметры

`name`	Имя службы Вы хотите опубликовать.
`root`	Объект использовать в качестве корневого объекта для опубликованной службы. Это - объект, продаваемый соединением.

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

Обсуждение

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

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

Objective C

@import Foundation;

Доступность

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

См. также

+ serviceConnectionWithName:rootObject:usingNameServer:
+ connectionWithRegisteredName:host:
– rootObject
systemDefaultPortNameServer (NSPortNameServer)

registerName: - registerName:

Регистрирует указанное использование службы в сервере имен системного порта по умолчанию.

Объявление

Objective C

- (BOOL)registerName:(NSString *)name

Параметры

name

Имя, под которым можно зарегистрировать получатель.

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

YEStrue если работа была успешна, иначе NOfalse (например, если другой NSConnection объект на том же узле уже регистрируется под name).

Обсуждение

Этот метод соединяет получить порт получения NSConnection объект с указанным именем службы. Это регистрирует имя с помощью сервера имен порта, возвращенного systemDefaultPortNameServer метод NSPortNameServer. Если работа успешна, другой NSConnection объекты могут связаться с получателем с помощью connectionWithRegisteredName:host: и rootProxyForConnectionWithRegisteredName:host: методы класса.

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

Не зарегистрироваться NSConnection объект, просто вызовите registerName: и предоставление nil как имя подключения. Нерегистрация в настоящее время только поддерживается для NSSocketPort- основанные соединения.

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

Objective C

@import Foundation;

Доступность

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

См. также

rootObject
– registerName:withNameServer:
systemDefaultPortNameServer (NSPortNameServer)


    
    registerName:withNameServer:
    - registerName:withNameServer:

Регистрирует службу в указанном сервере имен порта.

Объявление

Objective C

- (BOOL)registerName:(NSString *)name withNameServer:(NSPortNameServer *)server

Параметры

`name`	Имя, под которым можно зарегистрировать получатель.
`server`	Сервер имен.

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

YEStrue если работа была успешна, иначе NOfalse (например, если другой NSConnection объект на том же узле уже регистрируется под name).

Обсуждение

Этот метод соединяет получить порт получения NSConnection объект с указанным именем службы. Если работа успешна, другой NSConnection объекты могут связаться с получателем с помощью connectionWithRegisteredName:host: и rootProxyForConnectionWithRegisteredName:host: методы класса.

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

Не зарегистрироваться NSConnection объект, просто вызовите registerName: и предоставление nil как имя подключения.

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

Objective C

@import Foundation;

Доступность

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

rootObject rootObject Свойство

Объект, который получатель (или его родитель) делает доступным для других приложений или потоков.

Объявление

Objective C

@property(retain) id rootObject

Обсуждение

Объект, который получатель (или его родитель) делает доступным для других приложений или потоков, или nil если нет никакого корневого объекта.

Чтобы получить прокси к этому объекту в другом приложении или распараллелить, вызовите rootProxyForConnectionWithRegisteredName:host: метод класса с надлежащими параметрами.

Изменение корневого объекта только влияет на новые запросы на установление соединения и rootProxy сообщения к установленному NSConnection объекты — приложения, имеющие прокси к старому корневому объекту, могут все еще отправить сообщения через него.

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

Objective C

@import Foundation;

Доступность

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

См. также

– rootProxy

Получение удаленного объекта


    
    connectionWithRegisteredName:host:
    + connectionWithRegisteredName:host:

Возвраты NSConnection объект, чей отправляют каналы порта это в NSConnection объект зарегистрировался в значении по умолчанию NSPortNameServer под именем на данном узле.

Объявление

Objective C

+ (instancetype)connectionWithRegisteredName:(NSString *)name host:(NSString *)hostName

Параметры

`name`	Имя `NSConnection` объект.
`hostName`	Имя узла. Доменное имя `hostName` имя Интернет-домена (например, “`sales.anycorp.com`”). Если `hostName` `nil` или пустой, тогда только локальный узел ищется именованное `NSConnection` объект.

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

NSConnection объект, чей отправляют каналы порта это в NSConnection объект зарегистрировался в значении по умолчанию NSPortNameServer под name на названном узле hostName. Возвраты nil если нет NSConnection объект может быть найден для name и hostName.

Возвращенный NSConnection объект является дочерним элементом значения по умолчанию NSConnection объект для текущего потока (т.е. это совместно использует значение по умолчанию NSConnection объект получает порт).

Обсуждение

Продать объект NSConnection объект, используйте rootProxy метод экземпляра. rootProxyForConnectionWithRegisteredName:host: метод класса сразу возвращает этот объект.

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

Objective C

@import Foundation;

Доступность

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

См. также

+ defaultConnection
+ connectionWithRegisteredName:host:usingNameServer:


    
    connectionWithRegisteredName:host:usingNameServer:
    + connectionWithRegisteredName:host:usingNameServer:

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

Объявление

Objective C

+ (instancetype)connectionWithRegisteredName:(NSString *)name host:(NSString *)hostName usingNameServer:(NSPortNameServer *)server

Параметры

`name`	Имя подключения.
`hostName`	Имя хоста.
`server`	Сервер имен.

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

NSConnection объект, чей отправляют каналы порта это в NSConnection объект зарегистрировался в server под name на названном узле hostName.

Обсуждение

Посмотрите connectionWithRegisteredName:host: для получения дополнительной информации.

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

Objective C

@import Foundation;

Доступность

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

rootProxy rootProxy Свойство

Прокси для корневого объекта коллеги получателя в другом приложении или потоке. (только для чтения)

Объявление

Objective C

@property(readonly, retain) NSDistantObject *rootProxy

Обсуждение

Прокси возвратился, может измениться между вызовами если коллега NSConnection корневой объект объекта изменяется.

Примечание:

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

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

Objective C

@import Foundation;

Доступность

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

См. также

– rootObject


    
    rootProxyForConnectionWithRegisteredName:host:
    + rootProxyForConnectionWithRegisteredName:host:

Возвращает прокси для корневого объекта NSConnection объект зарегистрировался в значении по умолчанию NSPortNameServer под именем на данном узле.

Объявление

Objective C

+ (NSDistantObject *)rootProxyForConnectionWithRegisteredName:(NSString *)name host:(NSString *)hostName

Параметры

`name`	Имя, под которым регистрируется соединение.
`hostName`	Имя хоста. Доменное имя `hostName` имя Интернет-домена (например, `"sales.anycorp.com"`). Если `hostName` `nil` или пустой, тогда только локальный узел ищется именованное `NSConnection` объект.

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

прокси для корневого объекта NSConnection объект зарегистрировался в значении по умолчанию NSPortNameServer под name на названном узле hostName, или nil если это NSConnection объект не имеет никакого набора корневого объекта. Также возвраты nil если нет NSConnection объект может быть найден для name и hostName.

Обсуждение

NSConnection объект возвращенного прокси является дочерним элементом значения по умолчанию NSConnection объект для текущего потока (т.е. это совместно использует значение по умолчанию NSConnection объект получает порт).

Этот метод вызывает connectionWithRegisteredName:host: и отправляет получающееся NSConnection объект a rootProxy сообщение.

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

Objective C

@import Foundation;

Доступность

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

См. также

rootObject
+ rootProxyForConnectionWithRegisteredName:host:usingNameServer:


    
    rootProxyForConnectionWithRegisteredName:host:usingNameServer:
    + rootProxyForConnectionWithRegisteredName:host:usingNameServer:

Возвращает прокси для корневого объекта NSConnection объект зарегистрировался в server под name на данном узле.

Объявление

Objective C

+ (NSDistantObject *)rootProxyForConnectionWithRegisteredName:(NSString *)name host:(NSString *)hostName usingNameServer:(NSPortNameServer *)server

Параметры

`name`	Имя `NSConnection` объект.
`hostName`	Имя хоста.
`server`	Сервер.

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

Прокси для корневого объекта NSConnection объект зарегистрировался в server под name на названном узле hostName, или nil если это NSConnection объект не имеет никакого набора корневого объекта.

Обсуждение

Посмотрите rootProxyForConnectionWithRegisteredName:host: для получения дополнительной информации.

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

Objective C

@import Foundation;

Доступность

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

remoteObjects remoteObjects Свойство

Локальные прокси для удаленных объектов, полученных по соединению, но не освобожденных все же. (только для чтения)

Объявление

Objective C

@property(readonly, copy) NSArray *remoteObjects

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

Objective C

@import Foundation;

Доступность

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

См. также

– localObjects
localObjects localObjects Свойство

Локальные объекты, отправленные по соединению и все еще имеющие прокси в другом конце. (только для чтения)

Объявление

Objective C

@property(readonly, copy) NSArray *localObjects

Обсуждение

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

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

Objective C

@import Foundation;

Доступность

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

См. также

– remoteObjects

Получение разговора

currentConversation + currentConversation

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

Объявление

Objective C

+ (id)currentConversation

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

Маркерный объект, представляющий любой происходящий разговор в текущем потоке, или nil если нет никакого происходящего разговора.

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

Objective C

@import Foundation;

Доступность

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

См. также

– createConversationForConnection: (NSConnectionDelegate)

Получение всех объектов NSConnection

allConnections + allConnections

Возвраты все допустимые NSConnection объекты в процессе.

Объявление

Objective C

+ (NSArray *)allConnections

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

Массив, содержащий всех допустимых NSConnection объекты в процессе.

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

Objective C

@import Foundation;

Доступность

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

См. также

– isValid

Конфигурирование экземпляров

requestTimeout requestTimeout Свойство

Интервал тайм-аута для исходящих удаленных сообщений.

Объявление

Objective C

@property NSTimeInterval requestTimeout

Обсуждение

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

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

Objective C

@import Foundation;

Доступность

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

См. также

– replyTimeout
replyTimeout replyTimeout Свойство

Интервал тайм-аута для ответов на исходящие удаленные сообщения.

Объявление

Objective C

@property NSTimeInterval replyTimeout

Обсуждение

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

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

Objective C

@import Foundation;

Доступность

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

См. также

– requestTimeout
independentConversationQueueing independentConversationQueueing Свойство

Булево значение, указывающее, обрабатывает ли получатель удаленные сообщения атомарно.

Объявление

Objective C

@property BOOL independentConversationQueueing

Обсуждение

YEStrue если получатель обрабатывает удаленные сообщения атомарно, иначе NOfalse.

Значение по умолчанию NOfalse. NSConnection объект обычно передает удаленное сообщение к предполагаемым получателям, поскольку они входят. Посмотрите Конфигурирование Соединения для получения дополнительной информации.

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.
addRequestMode: - addRequestMode:

Добавляет mode к набору режимов ввода цикла выполнения, которые получатель использует для запросов на установление соединения.

Объявление

Objective C

- (void)addRequestMode:(NSString *)mode

Параметры

mode

Режим для добавления к получателю.

Обсуждение

Режим ввода по умолчанию NSDefaultRunLoopMode. Посмотрите NSRunLoop спецификация класса для получения дополнительной информации о режимах ввода.

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

Objective C

@import Foundation;

Доступность

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

См. также

addPort:forMode: (NSRunLoop)


    
    removeRequestMode:
    - removeRequestMode:

Удаляет mode от набора режимов ввода цикла выполнения получатель использует для запросов на установление соединения.

Объявление

Objective C

- (void)removeRequestMode:(NSString *)mode

Параметры


      mode

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

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

Objective C

@import Foundation;

Доступность

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

См. также

– requestModes
removePort:forMode: (NSRunLoop)

requestModes requestModes Свойство

Набор режимов запроса, получатель получает порт, регистрируется для с NSRunLoop объект. (только для чтения)

Объявление

Objective C

@property(readonly, copy) NSArray *requestModes

Обсуждение

Массив NSString объекты, который представляет набор режимов запроса получатель, получают порт, регистрируется для с NSRunLoop объект.

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

Objective C

@import Foundation;

Доступность

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

См. также

– addRequestMode:
addPort:forMode: (NSRunLoop)
– removeRequestMode:
лишить законной силы - лишить законной силы

Лишает законной силы получатель.

Объявление

Objective C

- (void)invalidate

Обсуждение

После снятия портов получатель зарегистрировался в текущем цикле выполнения, invalidate сообщения NSConnectionDidDieNotification и затем лишает законной силы все удаленные объекты и экспортировал локальные прокси.

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

Objective C

@import Foundation;

Доступность

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

См. также

– isValid
removePort:forMode: (NSRunLoop)
– requestModes
допустимый допустимый Свойство

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

Объявление

Objective C

@property(readonly, getter=isValid) BOOL valid

Обсуждение

YEStrue если получатель, как известно, допустим, иначе NOfalse.

NSConnection объект становится недопустимым, когда или его портов становится недопустимым, но только отмечает, что это стало недопустимым, когда это пытается отправить или получить сообщение. Когда это происходит, это отправляет NSConnectionDidDieNotification к центру уведомления по умолчанию.

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

Objective C

@import Foundation;

Доступность

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

См. также

– лишить законной силы
isValid (NSPort)

Получение портов

receivePort receivePort Свойство

Порт, на котором получатель получает входящие сетевые сообщения. (только для чтения)

Объявление

Objective C

@property(readonly, retain) NSPort *receivePort

Обсуждение

Можно проверить этот объект для отладки целей или использовать его для создания другого NSConnection объект, но не должен использовать его, чтобы отправить или получить сообщения явно. Не устанавливайте делегата получить порта; этому уже установили делегата NSConnection объект.

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

Objective C

@import Foundation;

Доступность

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

См. также

– sendPort
– initWithReceivePort:sendPort:
sendPort sendPort Свойство

Порт, что соединение отправляет исходящие сетевые сообщения через. (только для чтения)

Объявление

Objective C

@property(readonly, retain) NSPort *sendPort

Обсуждение

Можно проверить этот объект для отладки целей или использовать его для создания другого NSConnection объект, но не должен использовать его, чтобы отправить или получить сообщения явно. Не устанавливайте делегата отправить порта — ему уже установили делегата NSConnection объект.

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

Objective C

@import Foundation;

Доступность

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

См. также

– receivePort
– initWithReceivePort:sendPort:
dispatchWithComponents: - dispatchWithComponents:

Позволяет подклассам спрашивать объект соединения диспетчеризировать данные компонента.

Объявление

Objective C

- (void)dispatchWithComponents:(NSArray *)components

Параметры

components

Распределенные данные компонента Objects.

Обсуждение

NSPort подклассы должны использовать этот метод для выяснения у объекта соединения диспетчеризировать данные компонента Distributed Objects, полученные по проводу. Это будет декодировать данные, аутентифицировать и отправлять сообщение.

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

Objective C

@import Foundation;

Доступность

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

Получение статистики

статистика статистика Свойство

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

Объявление

Objective C

@property(readonly, copy) NSDictionary *statistics

Обсуждение

NSDictionary объект, содержащий различную статистику для получателя, такого как число продаваемых объектов, число запросов и ответов, и т.д.

Словарь статистики должен использоваться только для отладки целей.

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

Objective C

@import Foundation;

Доступность

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

Установка делегата

делегат делегат Свойство

Делегат получателя.

Объявление

Objective C

@property(assign) id< NSConnectionDelegate > delegate

Обсуждение

Делегат соединения может обработать входящие сообщения самостоятельно вместо разрешения NSConnection объект обрабатывает их. Делегат может также аутентифицировать сообщения и принять, отклонить или изменить новые соединения.

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

Objective C

@import Foundation;

Доступность

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

Константы

NSConnection выполняют режим цикла
NSConnection определяет следующий режим цикла выполнения — посмотрите NSRunLoop для большего количества подробных данных.

Объявление

Objective C

extern NSString *NSConnectionReplyMode;

Константы
- NSConnectionReplyMode
  
  NSConnectionReplyMode
  
  Режим для указания NSConnection объект, ожидающий ответов.
  
  Необходимо редко должны быть использовать этот режим.
  
  Доступный в OS X v10.0 и позже.
Имена исключения соединения
Имя исключения повышено в случае ошибки аутентификации.

Объявление

Objective C

extern NSString *NSFailedAuthenticationException;

Константы
- NSFailedAuthenticationException
  
  NSFailedAuthenticationException
  
  Повышенный NSConnection по получении удаленного сообщения делегат не аутентифицирует.
  
  Доступный в OS X v10.0 и позже.

Уведомления

NSConnectionDidDieNotification NSConnectionDidDieNotification

Отправленный, когда NSConnection объект освобожден или когда он уведомляется что NSPort объект стал недопустимым. Объект уведомления NSConnection объект. Это уведомление не содержит a userInfo словарь.
NSConnection объект, присоединенный к удаленному NSSocketPort объект не может обнаружить, когда удаленный порт становится недопустимым, даже если удаленный порт находится на той же машине. Когда соединение потеряно, Поэтому это не может отправить это уведомление. Вместо этого необходимо обнаружить ошибку из-за тайм-аута, когда отправляется следующее сообщение.
NSConnection объект, отправляющий это уведомление, больше не полезен, таким образом, все получатели должны не зарегистрировать себя для любых уведомлений, включающих NSConnection объект.

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

Objective C

@import Foundation;

Доступность

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

Отправленный, когда NSConnection объект инициализируется с помощью initWithReceivePort:sendPort: (определяемый инициализатор для NSConnection). Объект уведомления NSConnection объект. Это уведомление не содержит a userInfo словарь.

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

Objective C

@import Foundation;

Доступность

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

`receivePort`	Получить порт.
`sendPort`	Отправить порт.

NSConnection

Получение экземпляра по умолчанию

Оператор осуждения

Объявление

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

Обсуждение

Специальные замечания

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

Доступность

Создание экземпляров

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Выполнение соединения в новом потоке

Объявление

Обсуждение

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

Доступность

Объявление

Обсуждение

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

Доступность

См. также

Объявление

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

Доступность

См. также

Продажа службы

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

Обсуждение

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

Доступность

Объявление