Создание коннектора

Со стороны сервера используются следующие функции:

• PtConnectorCreate()

• PtConnectorDestroy()

• PtConnectorGetId()

Со стороны клиента используются такие функции:

• PtConnectionClientDestroy()

• PtConnectionFindId()

• PtConnectionFindName()

• PtConnectionServerDestroy()

• PtConnectionTmpName()

2. Установка объекта коннекции

Эти функции используются для установки объекта коннекции:

• PtConnectionClientGetUserData()

• PtConnectionClientSetError()

• PtConnectionClientSetUserData()

• PtConnectionServerGetUserData()

• PtConnectionServerSetError()

• PtConnectionServerSetUserData()

• PtConnectionAddMsgHandlers()

• PtConnectionAddEventHandlers()

• PtConnectionResizeEventBuffer()

3. Сообщения

Эти функции используются для получения сообщений между клиентом и сервером

• PtConnectionSend(), PtConnectionSendmx()

• PtConnectionReply(), PtConnectionReplymx()

4. Уведомления

• PtConnectionFlush()

• PtConnectionNotify()

5. Локальные коннекции

Процесс может создавать коннекцию к самому себе. Поведение такой коннекции слегка отличается от поведения нормальной коннекции:

• В случае нормальной коннекции функции PtConnectionSend(), PtConnectionSendmx() и PtConnectionNotify() просто отсылают сообщение или импульс, и никогда не исполняют никакого пользовательского кода (за исключением случая, когда функция PtConnectinNotify() требует сбросить буфер, что может привести к появлению событий Photon'а, обрабатываемых нормальным образом). Но когда коннекция локальная, функции PtConnectionSend(), PtConnectionSendmx() и PtConnectionNotify() непосредственно вызывают обработчик, и как вызывающий код, так и обработчик должны предусматривать все стороны этого эффекта.

• Другим отличием является то, что обработчики вызываются из различного контекста. Обычно ответная реакция обработчика событий или обработчика сообщений вызывается из функции ввода. Поскольку функции ввода не вызываются до тех пор, пока Вы или не вернётесь в главную петлю, или не вызовите функцию PtBkgdHandlerProcess() или PtProcessEvent(), зачастую безопасным будет принимать, что обработчик не должен вызываться, пока исполняется ответная реакция. Но если коннекция локальная, обработчик вызывается непосредственно функциями PtConnectionSend(), PtConnectionSendmx() или PtConnectionNotify(), и принятые допущения должны быть соответствующим образом пересмотрены.

• Ещё одним эффектом этого является то, что если обработчик сообщений вызывает PtConnectionNotify(), клиент получает уведомление перед ответом (перед reply). Иными словами, обработчик событий клиента вызывается до того, как выполнен возврат из функций PtConnectionSend() или PtConnectionSendmx(). Если обработчик снова вызывает функцию PtConnection() или PtConnectionSendmx(), возврат вернётся с ошибкой с errno, установленным в EBUSY (так библиотечная функция защищает себя от бесконечной рекурсии). Простейшим способом обойти это является отказ от посылки уведомлений из обработчика сообщений – вместо этого уведомление можно поместить в ответе (в reply).