Подключение к хранилищу

Соединение VDF является одним из ключевых точек доступа к услугам VDF.

Соединение VDF представляет экземпляр класса VDF.Vault.Currency.Connection.Connection. Для получения объекта соединения VDF, необходимо выполнить вход на сервер хранилища через клиентские приложения. VDF поддерживает вход через GUI и программно, без GUI, что возвращает объект результата, содержащий созданное соединение VDF или прямое соединение объектов.

Для входа через GUI клиентские приложения должны вызвать метод vdf.vault.forms.library.login(). Он получает объект VDF.Vault.Forms.Settings.LoginSettings, который позволяет клиентам регулировать поведение при входе в VDF. При входе через GUI будет отображаться диалоговое окно запроса учетных данных для входа в систему, ход процесса и управление неизменностью учетных данных и т. д. Примеры его использования можно найти в комплекте поставки приложения Vault SDK (пример: VaultFileBrowser).

Вход без использования GUI позволяет клиентским приложениям предоставлять учетные данные непосредственно в VDF без необходимости запрашивать их у пользователя. Вход без GUI выполняется с помощью метода vdf.vault.library.connectionmanager.login(). Подробную информацию об обоих методах и их настройках/параметрах можно найти в документации по SDK. После создания соединения VDF клиентские приложения можно начать использовать для взаимодействия с сервером хранилища, например, через диспетчер файлов или путем внесения объекта соединения в библиотеку методов, которые требуют соединения.

Переход из Vault 2013 SDK WebServiceManager к соединению VDF

Класс соединения VDF обеспечивает доступ к WebServiceManager, который использует то же соединение с сервером хранилища, поэтому любой существующий код, написанный с помощью 2013 SDK WebServiceManager, нетрудно преобразовать для использования класса соединения VDF. Просто замените ссылки на экземпляр WebServiceManager на вызовы свойства WebServiceManager активного экземпляра соединения VDF. Кроме этого, нужно только изменить метод установки соединения клиентским приложением. Как уже упоминалось выше, в разделе клиентских приложений необходимо использовать один из способов входа для установки соединения VDF. Для клиентских приложений, которые лучше часто не менять, вход без GUI достаточно близок к конструктору WebServiceManager и, соответственно, можно просто задать создание WebServiceManager со входом в VDF. Например, эти два фрагмента дают практически такое же соединение с хранилищем:

С помощью диспетчера веб-службы (C#):

С помощью входа VDF (C#):

Кроме того, в клиентском приложении нужно будет скорректировать метод выхода/закрытия соединения с хранилищем. WebServiceManager является IDisposable, а VDF соединение — нет, и рекомендуется закрывать соединения с хранилищем, передавая соответствующее соединение VDF методу Logout() ConnectionManager.