Difference between revisions of "JAJC/Plugins/FileTransfer"

Revision as of 20:44, 16 April 2011

Плагин для передачи файлов.

1. ОСНОВНЫЕ ВОЗМОЖНОСТИ

Jabber File Exchange - программа предназначена для передачи файлов в сети джаббер, поддерживает три режима передачи:

- Socket5 stream - соответствует jep-65. В этом режиме создается прямое соединение между двумя клиентами, в случае, когда такое соединение не может быть установлено, используется специальный прокси сервер (соответствующий jep-65). Это предпочтительный режим передачи, используйте его всегда, когда это возможно;

- In-band stream - соответствует jep-47. В этом режиме никаких дополнительных соединений не требуется, а файл передается через основное соединение с джаббер сервером. Используйте его для передачи небольших файлов, когда невозможно установить socket соединения;

- Multi in-band stream - этот режим не описывается стандартом и поддерживается только этой программой. В этом случае создаются дополнительные соединения с джаббер сервером, через которые и передается файл. Используйте этот режим в крайних случаях, когда требуется передать файл значительных размеров, а установление socket соединения невозможно.

Jabber File Exchange поставляется в трёх вариантах: отдельное приложение jFileExchange.exe, плагин к JAJC Filetransfer.dll и плагин к JAJC FileTransfer96.dll, в последнем варианте реализованы только первые два режима передачи.

2. УСТАНОВКА

- если вы используете отдельную программу (jFileExchange.exe), то установка не требуется;

- Для установки плагина скопируйте его в папку "Plugins", находящуюся в папке с установленным JAJC. Если такой папки не существует, создайте её. Перезапустите JAJC.

3. НАСТРОЙКА

Для правильной работы программы необходимо её настроить. Форма настройки состоит из четырёх вкладок.

3.1 CONNECTION (эта вкладка не видна в плагинах, если не удалось автоматически определить пароль)

- Account - имя аккаунта. Можно создавать неограниченное количество аккаунтов;

- User name - параметр Node вашего JID (для test@jabber.ru/jfe node=test);

- Resource - ресурс. Рекомендуется оставить значение по умолчанию - JFE;

- Password - пароль к джаббер аккаунту. Он не отображается при повторном вызове формы;

- Server - параметр Domane вашего JID (для test@jabber.ru/jfe Domane=jabber.ru);

- Server IP - ИП адрес сервера (заполните если невозможно определить его по параметру Server);

- Server port - порт для подключения, обычно равен 5222;

- Automatically connect - автоматическое подключение при старте;

- Send visible presence - если этот параметр включен, то это соединение будет видно всем у кого вы в ростере, а ваш ростер будет отображен в списке доступных назначений;

- Send invisible presence - если этот параметр включен, то соединение не будет видно другим, но ваш ростер будет отображен в списке доступных назначений;

- Auto start with windows - если этот параметр включен, то программа будет автоматически запускаться при старте Windows.

3.2 FILETRANSFER (здесь указываются общие параметры для всех режимов передачи)

- Default path - папка, в которую по умолчанию будут сохраняться полученные файлы;

- Common room jid - адрес комнаты, которая используется для определения доступных назначений;

- NickName - псевдоним, под которым вы будете видны другим пользователям;

- Recive begins automatically - если этот параметр включен, то файл начинает приниматься автоматически без запроса;

- Show form on auto receive - если этот параметр выключен, то при автоприеме не будет отображаться форма сессии;

- Hide form on OK\Apply button - если этот параметр выключен, то при нажатии на кнопку ОК или Apply форма сессии будет автоматически закрываться;

- Send file MD5 hash - если этот параметр включен, то при завершении приёма файла будет производиться сравнение контрольных сумм файла;

- Default paket size - размер пакета передаваемых данных;

- Join common file transfer room - если этот параметр включен, то при подключении будет выполняться вход в общую комнату (комната не видна и используется для служебных нужд);

- Hide from not roster users - если эта опция включена, то вы не будете видны тем, кого нет в вашем ростере;

- Show only roster contacts - если эта опция включена, то вы будете видеть только тех, кто есть в вашем ростере;

- Drag&Drop for - тип передачи, который будет использоваться при перетаскивании файла на контакт.

3.3 IN-BAND STREAM (здесь указываются параметры передачи во втором и третьем режиме)

- Direct connection speed limit - тут задаются ограничения скорости при передаче через основное соединение (in-band stream). Не задавайте большие значения исходящей скорости, если не уверены, что ваш сервер разрешает такую скорость. Максимальное значение по умолчанию для серверов ejabberd - 1024, jabberd 1.4.x - 256. Завышение этого показателя может привести к подвисанию соединения;

- Per connection speed limits - тут задаются ограничения скорости для одного соединения при передаче через дополнительные соединения (multi in-band stream). Правила здания этих значений такие же как и для основного соединения;

- Summery speed limits - тут задаются ограничения на итоговые значения максимальных скоростей при передаче через дополнительные соединения. Как правило, эти значения устанавливаются автоматически на основе значений ограничений для отдельного соединения и значения максимального количества соединений;

- Max. connections - максимальное количество дополнительных соединений;

- Min. connections - минимальное значение дополнительных соединений. Здесь указывается сколько дополнительных соединений будет установлено при ожидании передачи;

- Auto connections - если этот параметр включен, то количество соединений будет выбираться автоматически;

- Use direct connection - если этот параметр включен, то при передаче через дополнительные соединения будет использоваться и основное для увеличения скорости передачи в случае необходимости.

3.4 SOCKET5 (здесь указываются параметры передачи в первом режиме)

- Speed limits - здесь задаются ограничения на скорости передачи и приёма;

- Use connection proxy - если этот параметр включен, то подключения к передающей стороне или прокси серверу будут происходить через прокси сервер, указанный на вкладке Connections;

- Accept only listed jep-65 proxys - если эта опция включена, то при соединении через прокси сервер будут использоваться только те прокси сервера, которые указаны в списке Jep-65 proxys;

- Hide my IP - если эта опция включена, то соединение будет устанавливаться только через прокси сервер;

- Jep-65 proxys - здесь указываются прокси сервера, которые будут использоваться при установлении соединения;

- PSI compatible - режим передачи совместимый с PSI;

- Tkabber compatible - режим передачи совместимый с Tkabber;

4. НЕКОТОРЫЕ ЗАМЕЧАНИЯ ПО РАБОТЕ ПРОГРАММЫ

- При подключении на медленных каналах возможно подвисание программы во время подключения к серверу;

- При передаче большого файла и установленной опции проверки МД5 хеша (Send file MD5 hash), после запуска передачи и завершении приёма форма сессии не будет реагировать на комманды до завершения подсчета хеша;

- Если в вашем JID присутствуют не латинские буквы, то, скорее всего, вам не удастся воспользоваться прокси сервером;

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