D-Bus интерфейс obex.FileTransfer

Интерфейс для действий с файлами.

Шина:	системная
Служба:	org.bluez.obex
Объект:	[путь к объекту сеанса]
Интерфейс:	org.bluez.obex.FileTransfer

Методы

• ChangeFolder(string folder)
• CopyFile(string sourcefile, string targetfile)
• CreateFolder(string folder)
• Delete(string file)
• object, dict GetFile(string targetfile, string sourcefile)
• array{dict} ListFolder()
• MoveFile(string sourcefile, string targetfile)
• object, dict PutFile(string sourcefile, string targetfile)

Подробное описание

Интерфейс содержит методы для действий с файлами.

Описание методов

ChangeFolder(string folder)

Изменяет текущий каталог удалённого устройства.

Возможные ошибки:

• org.bluez.obex.Error.InvalidArguments,
• org.bluez.obex.Error.Failed.

CopyFile(string sourcefile, string targetfile)

Копирует файл на удалённом устройстве из исходного файла в целевой.

Возможные ошибки:

• org.bluez.obex.Error.InvalidArguments,
• org.bluez.obex.Error.Failed.

CreateFolder(string folder)

Создаёт новый каталог на удалённом устройстве.

Возможные ошибки:

• org.bluez.obex.Error.InvalidArguments,
• org.bluez.obex.Error.Failed.

Delete(string file)

Удаляет указанный файл/каталог.

Возможные ошибки:

• org.bluez.obex.Error.InvalidArguments,
• org.bluez.obex.Error.Failed.

object, dict GetFile(string targetfile, string sourcefile)

Копирует исходный файл (с удалённого устройства) в целевой файл (в локальной файловой системе).

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

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

Свойства этой передачи также возвращаются вместе с путём к объекту, чтобы избежать вызова GetProperties.

Возможные ошибки:

• org.bluez.obex.Error.InvalidArguments,
• org.bluez.obex.Error.Failed.

array{dict} ListFolder()

Возвращает словарь, содержащий информацию о содержимом текущего каталога.

Определены следующие ключи:

• string Name: имя объекта в формате UTF-8;
• string Type: folder или file;
• uint64 Size: размер объекта или количество элементов в каталоге;
• string Permission: группа, владелец и другое разрешение;
• uint64 Modified: последнее изменение;
• uint64 Accessed: последний доступ;
• uint64 Created : дата создания.

Возможные ошибки:

• org.bluez.obex.Error.Failed.

MoveFile(string sourcefile, string targetfile)

Перемещает файл на удалённом устройстве из исходного файла в целевой.

Возможные ошибки:

• org.bluez.obex.Error.InvalidArguments,
• org.bluez.obex.Error.Failed.

object, dict PutFile(string sourcefile, string targetfile)

Копирует исходный файл (из локальной файловой системы) в целевой файл (на удалённом устройстве).

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

Свойства этой передачи также возвращаются вместе с путём к объекту, чтобы избежать вызова GetProperties.

Возможные ошибки:

• org.bluez.obex.Error.InvalidArguments,
• org.bluez.obex.Error.Failed.