ОРИГИНАЛ ПЕРЕВОД Titanium.Network Titanium.Network submodule of Titanium submodule of Titanium

0.1 0.1

The top level Network module. The Network module is used accessing Модуль Network высшего уровня. Модуль Network используется для доступа Networking related functionality. к сетевым возможностям.

Objects Объекты

Name Description Название Описание The BonjourBrowser instance returned Экземпляр BonjourBrowser from возвращается из Titanium.Network.createBonjourBrowser. Titanium . Network .createBonjourBrowser. Titanium.Network.BonjourBrowser Titanium.Network.Bo njourBrowser This object is a browser for the discovery Этот объект является браузером для and retrieval of Bonjour services available поиска и обнаружения доступного в on the network. сети сервиса Bonjour. The BonjourService instance returned Экземпляр BonjourService возвращается either from либо из Titanium.Network.createBonjourService or Titanium . Network .createBonjourService, Titanium.Network.BonjourService via the service list from a BonjourBrowser Titanium.Network.BonjourService либо через список сервисов из события updatedServices event. This object BonjourBrowser updatedServices. Этот describes a service on the network which is объект описывает сервис в сети, published by Bonjour. опубликованный Bonjour. The HttpClient instance returned from Экземпляр HttpClient возвращается из Titanium.Network.createHTTPClient. This Titanium . Network .createHTTPClient. Titanium.Network.HTTPClient object (mostly) implements the Titanium.Network.HTTPClient Этот объект (по большей части) XMLHttpRequest specification. реализует спецификацию The TCPSocket instance returned from XMLHttpRequest. Titanium.Network.createTCPSocket. This Экземпляр TCPSocket возвращается из object represents a socket which either Titanium . Network .createTCPSocket. Этот Titanium.Network.TCPSocket listens locally on the device for объект представляет собой сокет, Titanium.Network.TCPSocket connections, or connects to a remote который либо ожидает соединения на machine. устройстве, либо соединяет его с удаленной машиной Methods Методы Объекты Titanium.Network.BonjourBrowser Titanium.Network.BonjourBrowser object of Titanium.Network объект Titanium.Network

1.2.0 1.2.0

The BonjourBrowser instance returned from Экземпляр BonjourBrowser возвращается из Titanium.Network.createBonjourBrowser. Titanium.Network.createBonjourBrowser. Этот объект является браузером для поиска и обнаружения доступного в сети сервиса Bonjour. Methods Методы Name Description Conduct a search for Bonjour services matching the type and Название Описание search domain specified during creation Производит поиск сервисов Bonjour, соответствующих типу и search stopSearch Halt an ongoing search домену, указанному при создании stopSearch Останавливает текущий поиск

Properties

Название Тип Описание Properties domain string Домен, в котором браузер производит поиск Производит ли браузер поиск в данный isSearching boolean Name Type Description момент domain string The domain the browser is searching in serviceType string Тип сервиса, который ищет браузер isSearching boolean Whether or not the browser is currently searching serviceType string The type of the service the browser searches for Events Название Описание -event

Events Свойства события

Name Description source объект, инициировавший событие updatedServices type название сработавшего события массив объектов BonjourService, соответствующих Event properties -event доступным на данный момент сервисам. Если вы кэшируете значение, включая использование его в source the source object that fired the event качестве табличных данных, вам нужно знать, что оно type the name of the event fired может устареть в любой момент. Это происходит из-за An array of BonjourService objects corresponding to currently services асинхронности обнаружения сервисов Bonjour. available services. If you cache this value, including using it as table data, be aware that it could become out of date at any Свойства события time due to the asynchronous nature of Bonjour service discovery. source объект, инициировавший событие services type название сработавшего события Event properties Срабатывает при обновлении найденного списка сервисов

source the source object that fired the event Свойства события type the name of the event fired updatedServices Fired when the discovered services list is updated source объект, инициировавший событие type название сработавшего события Event properties updatedServices Примечания source the source object that fired the event type the name of the event fired Если ваше приложение само публикует сервисы Bonjour, браузер при необходимости будет его обнаруживать; будьте готовы произвести проверку, если не хотите, чтобы локальные сервисы попали в список доступных сервисов. Поиск сервисов Bonjour – асинхронная операция. Это означает, что нужно быть предельно осторожным при кэшировании значений из свойств сервисов, возвращаемых событием updatedServices. В частности, если вы поддерживаете локальную копию доступных сервисов Notes и пользователь пытается подсоединиться, будьте готовы стойко переносить неудачи. Следующее событие updatedServices предоставит If your application publishes Bonjour services itself, that service will be новый список сервисов, но не надейтесь получить их раньше ввода discovered by the browser if necessary; be prepared to perform a check if you пользователем данных. При закрытии окна, которое пользуется поиском do not want to list local services as available. Bonjour service browsing is an Bonjour, нужно вызвать метод остановки, если вы не будете продолжать asynchronous operation, meaning that you should be extremely careful when поиск. caching values from the 'services' property returned by the updatedServices event. In particular, if you maintain a local copy of available services and a user tries to connect to one, you should be prepared to handle failures gracefully; the next updatedServices event should provide the new services list, but you should not rely on it being delivered before user input. When a window which uses Bonjour browsing is closed, if you do not want to continue searching, you must call the stop() method.

Titanium.Network.BonjourService Titanium.Network.BonjourService object of Titanium.Network объект Titanium.Network

1.2.0 1.2.0

The BonjourService instance returned either from Экземпляр BonjourService возвращается либо из Titanium.Network.createBonjourService or via the service list from a Titanium.Network.createBonjourService либо через список сервисов из BonjourBrowser updatedServices event. This object describes a service on события BonjourBrowser updatedServices. Этот объект описывает сервис the network which is published by Bonjour. в сети, опубликованный Bonjour.

Methods Методы

Name Description Назва Описание Publish a Bonjour service to the network. Only works if isLocal is ние publish TRUE Публикует сервис Bonjour в сети. Работает, только если isLocal publish Resolve a Bonjour service from the network. Must be done before является ИСТИНОЙ resolve attempting to access the service's socket information, if a remote Получает сервис Bonjour из сети. Должен осуществляться перед service. You cannot resolve a locally published service. resolve попыткой доступа к информации сокета сервиса, если сервис stop Halts publication of a service. удаленный. Нельзя получить сервис, опубликованный локально stop Останавливает публикацию сервиса Properties Свойства Name Type Description Назва domain string the domain of the service Тип Описание isLocal boolean whether or not the service is local to the device ние name string the name of the service domain string Домен сервиса socket object the TCPSocket object that is used to connect to the service isLocal boolean является ли сервис локальным для устройства type string the type of the service name string имя сервиса socket object объект TCPSocket, используемый для присоединения к сервису Events type string тип сервиса

This object has no events События

Notes Данный объект не имеет событий

You can only publish Bonjour services attached to a socket which is currently Примечания listening; you cannot publish a service for a remotely connected socket. If you stop the Bonjour service and wish to close the socket it uses, it is strongly Публиковать можно только Bonjour-сервисы, привязанные сокету, recommended that you stop the service first. When a window which publishes a который в данный момент ожидает соединения; нельзя публиковать сервис Bonjour service is closed, you must stop the service if the associated socket is для удаленно подсоединенного сокета. Если вы отключаете сервис Bonjour also to be closed, or if it is no longer necessary to publish. Unlike other network и хотите закрыть сокет, который он использует, настоятельно operations, Bonjour service resolution and publishing is synchronous, so be рекомендуется сначала отключить сервис. При закрытии окна, которое aware that your code may block while resolution is going on. In particular, you публикует сервис Bonjour, нужно отключить сервис, если нужно закрыть may wish to display UI elements indicating background activity before соответствующий сокет или если больше нет необходимости его beginning resolution. публиковать. В отличие от других сетевых операций, разрешение и публикация сервиса Bonjour синхронны, нужно знать, что ваш код может блокироваться в процессе разрешения. В частности, может возникнуть необходимость показать элементы UI, отображающие фоновую деятельность до начала разрешения. Titanium.Network.HTTPClient Titanium.Network.HTTPClient object of Titanium.Network Объект Titanium.Network

0.1 0.1

The HttpClient instance returned from Titanium.Network.createHTTPClient. Экземпляр HttpClient возвращается из Titanium . Network .createHTTPClient. This object (mostly) implements the XMLHttpRequest specification. Этот объект (по большей части) реализует спецификацию XMLHttpRequest. Methods Методы Name Description abort abort a pending request Название Описание getResponseHeader return the response header. abort прерывает отложенный запрос open open the request and ready the connection getResponseHeader возвращает заголовок ответа send send the request open открывает запрос и подготавливает соединение set the request header. Must be called after but before send отправляет запрос setRequestHeader open . устанавливает заголовок запроса. Должен вызваться send setRequestHeader setTimeout set the request timeout после open, но до send. setTimeout устанавливает тайм-аут запроса Properties Свойства Name Type Description DONE int the DONE readyState constant Название Тип Описание the HEADERS_RECEIVED readyState DONE int константа DONE readyState HEADERS_RECEIVED int constant константа HEADERS_RECEIVED HEADERS_RECEIVED int LOADING int the LOADING readyState constant readyState OPENED int the OPENED readyState constant LOADING int константа LOADING readyState UNSENT int the UNSET readyState constant OPENED int константа OPENED readyState boolean to indicate that the response was UNSENT int константа UNSET readyState connected boolean successful булеан для обозначения успешного connected boolean the connection type, normally either or ответа connectionType string GET POST. connectionType string тип соединения, обычно либо GET, либо location string the absolute URL of the request POST ondatastream function set this to a function before calling open to location string абсолютный URL запроса cause the function to be called at regular устанавливается для функции перед intervals as the request data is being вызовом open, чтобы функция received. the progress property of the вызывалась с регулярными интервалами event will contain a value from 0.0-1.0 ondatastream function по мере получения ответной with the progress. информации. Свойство progress set this to a function before calling open to события будет содержать значение от onerror function cause the function to be called upon a error 0.0-1.0 с шагом развитием. response устанавливается до вызова open, чтобы set this to a function before calling open to onerror function функция вызывалась при ошибочном onload function cause the function to be called upon a ответе successful response устанавливается до вызова open, чтобы set this to a function before calling open to onload function функция вызывалась при успешном onreadystatechange function cause the function to be called for each ответе readyState change установите его до вызова open, чтобы set this to a function before calling open to onreadystatechange function функция вызывалась при каждом cause the function to be called at regular изменении readyState intervals as the request data is being устанавливается до вызова open, чтобы onsendstream function transmitted. the progress property of the функция вызывалась при каждом event will contain a value from 0.0-1.0 изменении readyState с регулярными with the progress. onsendstream function интервалами при передаче данных readyState int the readyState value запроса. Свойство progress события responseData object the response data as a Blob object. будет содержать значение от 0.0-1.0 с шагом развития. the response as text or null if an error was responseText string received or no data was returned readyState int значение readyState responseData object данные ответа в виде двоичного объекта the response object as an XML DOMDocument object. returns null if the ответ в виде текста или пустого responseXML object content type returned by the server was not responseText string значения, если была получена ошибка XML or the content could not be parsed или данные были возвращены status int the response HTTP status code объект ответа в виде объекта XML DOMDocument. возвращает пустое timeout is milliseconds when the timeout int значение, если тип содержания, connection should be aborted responseXML object возвращаемый сервером, не является set this to control how SSL certification XML или содержание не могло быть validation is performed on connection. validatesSecureCertificat проанализировано boolean defaults to false if in simulator or device e status int код состояния HTTP ответа testing and true if release for distribution тайм-аут в миллисекундах, в который mode. timeout int соединение должно быть прервано устанавливается для контроля над Events выполнением проверки сертификата SSL при соединении. По умолчанию ложь validatesSecureCertificate boolean This object has no events для симулятора или тестирования утсройства, истина при выпуске для режима дистрибуции

События

Данный объект не имеет событий Titanium.Network.TCPSocket Titanium.Network.TCPSocket object of Titanium.Network Объект Titanium.Network

1.2.0 1.2.0 The TCPSocket instance returned from Titanium.Network.createTCPSocket. This object represents a socket which either listens locally on the device for Экземпляр TCPSocket возвращается из Titanium . Network .createTCPSocket. connections, or connects to a remote machine. Этот объект представляет собой сокет, который либо ожидает соединения на устройстве, либо соединяет его с удаленной машиной.

Методы Methods Назван Описание Name Description ие close close the socket close закрывает сокет connect connect the scocket to a TCP server connect соединяет сокет с TCP сервером listen set up the socket to receive connections listen устанавливает сокет для приема соединений write data to the socket, if the mode is WRITE_MODE or write записывает данные в сокет в режимах записи или чтения и записи write READ_WRITE_MODE Свойства Properties Названи Тип Описание Name Type Description е the host name to connect to. Must be INADDR_ANY or an hostName string имя компьютера, к которому совершается соединение. hostName string identifier for the local device in order to listen Для прослушивания должен быть INADDR_ANY или isValid boolean whether or not the socket is valid идентификатор для локального устройства mode int the socket's mode isValid boolean является ли сокет допустимым port int the port to connect/listen on mode int режим сокета port int порт для соединения/прослушивания

События

Название Описание Events новые данные были считаны с сокета

Name Description Свойства события new data was read off the socket двоичный объект, представляющий собой read Event properties data[object] прочитанные данные, может интерпретироваться с помощью toString a blob representing the data read, can be interpreted via from[int] ссылка на сокет, с которого были получены данные data[object] read toString source объект, инициировавший событие the reference for the socket that data was retrieved type название сработавшего события from[int] from произошла ошибка во время чтения source the source object that fired the event type the name of the event fired Свойства события an error occured when reading readError code[int] код ошибки BSD-сокета Event properties error[string] описание ошибки source объект, инициировавший событие readError code[int] the BSD socket error code type название сработавшего события error[string] a description of the error произошла ошибка во время записи source the source object that fired the event type the name of the event fired Свойства события writeError an error occured when writing writeError code[int] код ошибки BSD-сокета Event properties error[string] описание ошибки source объект, инициировавший событие code[int] the BSD socket error code type название сработавшего события error[string] a description of the error source the source object that fired the event type the name of the event fired Примечания

Сокеты нетривиальны; каждому, кто их использует рекомендуется Notes ознакомиться с основами работы с BSD-сокетами. Все сокеты используют TCP-соединения и являются асинхроными для операций чтения, поэтому Sockets are nontrivial; it is recommended that anyone using them be familiar ваша программа должна быть готова к получению события 'read' в любой with the basics of BSD sockets. All sockets use TCP connections, and are момент. Ссылки на сокет не могут передаваться объектам сокета, и asynchronous for read operations, so your program should be ready to receive наоборот – ссылки на сокет являются внутренним механизмом для 'read' events at any point. Socket references cannot be transferred to socket определния, какому сокету отправляются данные и с какого считываются. objects, and vice-versa - socket references are an internal mechanism which is Для слушающих сокетов настоятельно рекомендуется использовать used only to determine which sockets to send data to and read data from. For константу Titanium . Network . INADDR _ ANY в качестве имени компьютера. listening sockets, it is highly recommended that you use the Если закрывается окно, содержащее сокет, сокет также ДОЛЖЕН быть Titanium.Network.INADDR_ANY constant as the host name. If a window закрыт, если только вы не собираетесь продолжать прием данных, иначе containing a socket is closed, the socket MUST be closed also unless you intend сокет будет потреблять ресурсы (и будет потенциально создавать to continue to receive data, otherwise the socket will consume resources (and конфликты при очередном открытии окна, если он является слушающим) potentially cause conflicts with opening the window again, if a listener) until the до перезапуска программы. Не забывайте о различиях между функциями program is restarted. Be aware of the differences between the listen() and listen() и connect(); попытка заменить одну другой может привести к connect() functions; attempting to use one when you mean the other may result ошибке, непредсказуемому поведению или тому и другому одновременно. in errors, unpredictable behavior, or both.