又拍云 Java SDK

又拍云存储 Java SDK, основанный на ещё раз щёлкнем по облаку: HTTP REST API интерфейс, подходит для Java 6 и более поздних версий.

Содержание

• Использование
• Облачное хранилище: основные интерфейсы

  • Подготовка

    • Создание пространства *Создание UpYun клиента: UpYunClient client = UpYunClient.create("пространство", "имя авторизованного оператора", "пароль оператора");
    • Если не знаете, кто такой «авторизованный оператор», см. «Создание оператора и авторизация».
    • По умолчанию отладка отключена: client.enableDebug();
    • Ручная настройка времени ожидания: по умолчанию 30 секунд: client.timeout(60);
    • Выбор оптимального пункта доступа:
    • По умолчанию UpYun автоматически выбирает пункт доступа в зависимости от условий сети.
    • Вы можете использовать API для переключения на определённый пункт доступа:
      • Автоматический выбор пункта доступа в соответствии с условиями сети: upyun.selectAutoAPIEntry();
      • Пункт доступа Telekom: client.selectTelecomAPIEntry();
      • Пункт доступа Unicom: client.selectUnicomAPIEntry();
      • Мобильный пункт доступа: client.selectMobileAPIEntry().
    • Примечание: рекомендуется вручную настроить подходящий пункт доступа на основе состояния сети сервера для достижения оптимальной скорости доступа.

  • Загрузка файла

  • Пример 1: прямая загрузка чистого текста в облако: client.uploadFile(fileRemotePath, "test content");

  • Пример 2: загрузка файла в облако: File file = new File(localFilePath); client.uploadFile(fileRemotePath, file);

  • Другие инструкции: после успешной загрузки файла вы можете получить доступ к файлу напрямую через http://пространство.b0.upaiyun.com/savePath.

  • Создание каталогов рекурсивно: перед загрузкой файлов или изображений можно использовать метод recursionMkDir() для автоматического создания родительских каталогов до 10 уровней в глубину. client.recursionMkDir().uploadFile(fileRemotePath, file);

  • Обратите внимание: если файл с таким же именем уже существует в пространстве, он будет перезаписан, и это изменение необратимо. Поэтому, чтобы избежать перезаписи существующих файлов, вы можете сначала использовать операцию «Получение информации о файле».

  • Изображения можно загружать только в пространство для изображений, попытка загрузить другие типы файлов приведёт к ошибке «это не изображение».

  • В случае сбоя загрузки будет выброшено исключение.

  • При загрузке файла можно выполнить проверку MD5: если значение MD5 полученного файла не совпадает со значением, установленным пользователем, сервер вернёт ошибку 406 Not Acceptable. Эту опцию можно использовать для обеспечения целостности загружаемых файлов. client.contentMD5(UpYun.md5(file));

  • Пространства для изображений позволяют использовать функцию защиты исходного изображения (недоступно для пространств других типов): upyun.setFileSecret("abc"); Примечание:

    • Для использования функции защиты исходного изображения необходимо задать секретный ключ (известный только вам, например, «abc»). После успешной загрузки файла прямой доступ к нему через URL больше невозможен, вместо этого необходимо добавить секретный ключ после URL-адреса с разделительным символом (например, !). Например, если разделительный символ — это «!», а секретный ключ — «abc», то URL для доступа к загруженному файлу будет выглядеть так: http://пространство.b0.upaiyun.com/dir/sample.jpg!abc.
    • Если секретный ключ совпадает с именем версии изображения, при доступе к файлу будет использоваться функция миниатюры, а исходное изображение будет недоступно. Будьте осторожны при использовании этой функции.

  • Загрузка файла:

  • UpYunClient client = UpYunClient.create("пространство", "имя авторизованного оператора", "пароль оператора");

  • Пример 1: прямое чтение текстового содержимого: String data = client.readFileText(fileRemotePath);

  • Пример 2: скачивание файла: File file = new File(localFilePath); // путь к файлу после скачивания boolean result = client.downloadFile(fileRemotePath, file);

  • Примечание: если файла нет, будет выброшено исключение UpYunNotFoundException.

  • Получение информации о файле: UpYunClient client = ...; // получение информации о файле Map<String, String> info = client.getFileInfo(fileRemotePath);

Облачное хранилище: базовые интерфейсы

Подготовка

Создание пространства

Пользователи могут создавать собственные персонализированные пространства через основной сайт ещё раз щёлкнем по облаку. Подробные инструкции см. в [«Создание пространства»](http://wiki.upyun.com/index.php?title=Создание пространства).

Инициализация UpYun

UpYunClient client = UpYunClient.create("пространство", "имя авторизованного оператора", "пароль оператора");

Если вы не знаете, что такое «авторизованный оператор», обратитесь к «Создание оператора и авторизация».

Отладка

По умолчанию отладка выключена: client.enableDebug().

Настройка времени ожидания

По умолчанию время ожидания составляет 30 секунд: client.timeout(60).

Выбор оптимального пункта доступа

Ещё раз щёлкнем по облаку предоставляет три пункта доступа для API: Telekom, Unicom и мобильный. Если вы не укажете конкретный пункт доступа, UpYun автоматически выберет его на основе условий сети. Вы также можете использовать API для выбора определённого пункта доступа:

• Автоматический выбор на основе условий сети: upyun.selectAutoAPIEntry();
• Пункт доступа Telekom: client.selectTelecomAPIEntry();
• Пункт доступа Unicom: client.selectUnicomAPIEntry();
• Мобильный пункт доступа: client.selectMobileAPIEntry().

Примечание: рекомендуется выбрать подходящий пункт доступа вручную на основе состояния сетевой инфраструктуры сервера для оптимизации скорости доступа. Таблица кодов ошибок