<!-- Добавляем зависимость на этот проект -->
<dependency>
    <groupId>org.dromara.x-file-storage</groupId>
    <artifactId>x-file-storage-spring</artifactId>
    <version>2.2.1</version>
</dependency>
<!-- Добавляем зависимость на SDK Alibaba Cloud OSS, если используете другую платформу хранения, замените на соответствующее SDK -->
<dependency>
    <groupId>com.aliyun.oss</groupId>
    <artifactId>aliyun-sdk-oss</artifactId>
    <version>3.16.1</version>
</dependency>

dromara:
  x-file-storage: # Конфигурация хранения файлов
    default-platform: aliyun-oss-1 # По умолчанию используемая платформа хранения
    aliyun-oss:
      - platform: aliyun-oss-1 # Идентификатор платформы хранения
        enable-storage: true  # Включение хранения
        access-key: ??
        secret-key: ??
        end-point: ??
        bucket-name: ??
        domain: ?? # Адрес доступа, обратите внимание на "/" в конце, например: https://abc.oss-cn-shanghai.aliyuncs.com/
        base-path: test/ # Базовый путь

@EnableFileStorage
@SpringBootApplication
public class SpringFileStorageTestApplication {

    public static void main(String[] args) {
        SpringApplication.run(SpringFileStorageTestApplication.class,args);
    }

}

@RestController
public class FileDetailController {

    @Autowired
    private FileStorageService fileStorageService; // Инъекция экземпляра

    /**
     * Загрузка файла
     */
    @PostMapping("/upload")
    public FileInfo upload(MultipartFile file) {
        // Только одна строчка кода для успешной загрузки
        return fileStorageService.of(file).upload();
    }
    
    /**
     * Загрузка файла, успешный ответ возвращает URL файла
     */
    @PostMapping("/upload2")
    public String upload2(MultipartFile file) {
        FileInfo fileInfo = fileStorageService.of(file)
                .setPath("upload/") // Сохраняет относительный путь, удобство управления, можно не указывать
                .setObjectId("0")   // ID связанного объекта, удобство управления, можно не указывать
                .setObjectType("0") // Тип связанного объекта, удобство управления, можно не указывать
                .putAttr("role","admin") // Сохраняет атрибуты, которые могут быть использованы в аспектах, записи загрузки, пользовательских платформах хранения и т.д., можно не указывать
                .upload();  // Загружает файл на указанное место
        return fileInfo == null ? "Загрузка не удалась!" : fileInfo.getUrl();
    }

    /**
     * Загрузка изображения, успешный ответ возвращает информацию о файле
     * Обработка изображений использует https://github.com/coobird/thumbnailator
     */
    @PostMapping("/upload-image")
    public FileInfo uploadImage(MultipartFile file) {
        return fileStorageService.of(file)
                .image(img -> img.size(1000,1000))  // Изменяет размер изображения до 1000*1000
                .thumbnail(th -> th.size(200,200))  // Генерирует миниатюру размером 200*200
                .upload();
    }

    /**
     * Загрузка файла на конкретную платформу хранения, успешный ответ возвращает информацию о файле
     */
    @PostMapping("/upload-platform")
    public FileInfo uploadPlatform(MultipartFile file) {
        return fileStorageService.of(file)
                .setPlatform("aliyun-oss-1")    // Использует указанную платформу хранения
                .upload();
    }

    /**
     * Прямое чтение файла из HttpServletRequest и его загрузка, успешный ответ возвращает информацию о файле
     * При использовании этого подхода есть некоторые особенности, подробнее читайте в документации [основные возможности - загрузка](https://x-file-storage.xuyanwu.cn/#/%D0%BE%D1%81%D0%BD%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5)
     */
    @PostMapping("/upload-request")
    public FileInfo uploadRequest(HttpServletRequest request) {
        return fileStorageService.of(request).upload();
    }
}

// Создание информации о файле вручную, может использоваться для других операций
FileInfo fileInfo = new FileInfo()
        .setPlatform("huawei-obs-1")
        .setBasePath("test/")
        .setPath("aa/")
        .setFilename("image.png")
        .setThFilename("image.png.min.jpg");

// Проверка наличия файла
boolean exists = fileStorageService.exists(fileInfo);
// Скачивание
byte[] bytes = fileStorageService.download(fileInfo).bytes();
// Удаление
fileStorageService.delete(fileInfo);
// Другие операции

// Получение объекта FileInfo напрямую из базы данных, что делает выполнение других действий еще более простым
FileInfo fileInfo = fileStorageService.getFileInfoByUrl("https://abc.def.com/test/aa/image.png");
```// Проверка наличия файла
boolean exists = fileStorageService.exists("https://abc.def.com/test/aa/image.png");
// Скачивание
byte[] bytes = fileStorageService.download("https://abc.def.com/test/aa/image.png").bytes();
// Удаление
fileStorageService.delete("https://abc.def.com/test/aa/image.png");
// Другие операции

<!-- Включение текущего проекта -->
<dependency>
    <groupId>org.dromara.x-file-storage</groupId>
    <artifactId>x-file-storage-spring</artifactId>
    <version>2.2.0</version>
</dependency>
<!-- Включение Alibaba Cloud OSS SDK, если используете другую платформу хранения, замените SDK соответственно -->
<dependency>
    <groupId>com.aliyun.oss</groupId>
    <artifactId>aliyun-sdk-oss</artifactId>
    <version>3.16.1</version>
</dependency>

dromara:
  x-file-storage: # Конфигурация хранения файлов
    default-platform: aliyun-oss-1 # По умолчанию используемая платформа хранения
    aliyun-oss:
      - platform: aliyun-oss-1 # Идентификатор платформы хранения
        enable-storage: true  # Включение хранения
        access-key: ??
        secret-key: ??
        end-point: ??
        bucket-name: ??
        domain: ?? # Адрес доступа, обратите внимание на завершение "/", например: https://abc.oss-cn-shanghai.aliyuncs.com/
        base-path: test/ # Базовый путь

@EnableFileStorage
@SpringBootApplication
public class SpringFileStorageTestApplication {

    public static void main(String[] args) {
        SpringApplication.run(SpringFileStorageTestApplication.class,args);
    }

}

@RestController
public class FileDetailController {

    @Autowired
    private FileStorageService fileStorageService; // Внедрение экземпляра

    /**
     * Загрузка файла
     */
    @PostMapping("/upload")
    public FileInfo upload(MultipartFile file) {
        // Только эта одна строчка кода необходима для успешной загрузки
        return fileStorageService.of(file).upload();
    }
    
    /**
     * Загрузка файла, успешный ответ возвращает URL файла
     */
    @PostMapping("/upload2")
    public String upload2(MultipartFile file) {
        FileInfo fileInfo = fileStorageService.of(file)
                .setPath("upload/") // Сохранение относительного пути, для удобства управления, можно не указывать
                .setObjectId("0")   // ID связанного объекта, для удобства управления, можно не указывать
                .setObjectType("0") // Тип связанного объекта, для удобства управления, можно не указывать
                .putAttr("role","admin") // Сохранение некоторых свойств, которые могут быть использованы в аспектах, записи загрузки, пользовательском хранении и т.д., можно не указывать
                .upload();  // Загрузка файла на указанное место
        return fileInfo == null ? "Загрузка неудачна!" : fileInfo.getUrl();
    }

    /**
     * Загрузка изображения, успешный ответ возвращает информацию о файле
     * Обработка изображений осуществляется через https://github.com/coobird/thumbnailator
     */
    @PostMapping("/upload-image")
    public FileInfo uploadImage(MultipartFile file) {
        return fileStorageService.of(file)
                .image(img -> img.size(1000,1000))  // Изменение размера изображения до 1000*1000
                .thumbnail(th -> th.size(200,200))  // Создание миниатюры размером 200*200
                .upload();
    }

    /**
     * Загрузка файла на конкретную платформу хранения, успешный ответ возвращает информацию о файле
     */
    @PostMapping("/upload-platform")
    public FileInfo uploadPlatform(MultipartFile file) {
        return fileStorageService.of(file)
                .setPlatform("aliyun-oss-1")    // Использование конкретной платформы хранения
                .upload();
    }

    /**
     * Прямое чтение файла из HttpServletRequest и его загрузка, успешный ответ возвращает информацию о файле
     * При использовании этого подхода есть некоторые моменты внимания, читайте документацию [основные возможности - загрузка] секции
     */
    @PostMapping("/upload-request")
    public FileInfo uploadPlatform(HttpServletRequest request) {
        return fileStorageService.of(request).upload();
    }
}

//Ручное создание информации о файле, может быть использовано для других операций
FileInfo fileInfo = new FileInfo()
        .setPlatform("huawei-obs-1")
        .setBasePath("test/")
        .setPath("aa/")
        .setFilename("image.png")
        .setThFilename("image.png.min.jpg");
```// Существование файла
boolean exists = fileStorageService.exists(fileInfo);
// Загрузка
byte[] bytes = fileStorageService.download(fileInfo).bytes();
// Удаление
fileStorageService.delete(fileInfo);
// Другие более сложные операции

// Получение объекта FileInfo непосредственно из базы данных, что делает выполнение других операций ещё легче
FileInfo fileInfo = fileStorageService.getFileInfoByUrl("https://abc.def.com/test/aa/image.png");

// Существование файла
boolean exists = fileStorageService.exists("https://abc.def.com/test/aa/image.png");
// Загрузка
byte[] bytes = fileStorageService.download("https://abc.def.com/test/aa/image.png").bytes();
// Удаление
fileStorageService.delete("https://abc.def.com/test/aa/image.png");
// Другие более сложные операции

<!-- Внедрение этого проекта -->
<dependency>
    <groupId>org.dromara.x-file-storage</groupId>
    <artifactId>x-file-storage-spring</artifactId>
    <version>2.1.0</version>
</dependency>
<!-- Внедрение OSS Alibaba Cloud SDK, если используется другая платформа хранения, то используйте соответствующий SDK -->
<dependency>
    <groupId>com.aliyun.oss</groupId>
    <artifactId>aliyun-sdk-oss</artifactId>
    <version>3.16.1</version>
</dependency>

dromara:
  x-file-storage: #Настройки хранения файлов
    default-platform: aliyun-oss-1 #По умолчанию используемая платформа хранения
    aliyun-oss:
      - platform: aliyun-oss-1 # Идентификатор платформы хранения
        enable-storage: true  # Активировать хранение
        access-key: ??
        secret-key: ??
        end-point: ??
        bucket-name: ??
        domain: ?? # Домен доступа, обратите внимание на завершение "/", например: https://abc.oss-cn-shanghai.aliyuncs.com/
        base-path: test/ # Базовый путь

@EnableFileStorage
@SpringBootApplication
public class SpringFileStorageTestApplication {

    public static void main(String[] args) {
        SpringApplication.run(SpringFileStorageTestApplication.class,args);
    }

}

@RestController
public class FileDetailController {

    @Autowired
    private FileStorageService fileStorageService; // Внедрение экземпляра

    /**
     * Загрузка файла
     */
    @PostMapping("/upload")
    public FileInfo upload(MultipartFile file) {
        // Только эта одна строчка кода необходима для успешной загрузки
        return fileStorageService.of(file).upload();
    }
    
    /**
     * Загрузка файла, успешный ответ возвращает URL файла
     */
    @PostMapping("/upload2")
    public String upload2(MultipartFile file) {
        FileInfo fileInfo = fileStorageService.of(file)
                .setPath("upload/") // Сохранение относительного пути, для удобства управления, можно не указывать
                .setObjectId("0")   // ID связанного объекта, для удобства управления, можно не указывать
                .setObjectType("0") // Тип связанного объекта, для удобства управления, можно не указывать
                .putAttr("role","admin") // Сохранение некоторых атрибутов, которые могут быть использованы в аспектах, записи загрузки, пользовательских платформах хранения и т.д., можно не указывать
                .upload();  // Загрузка файла на указанное место
        return fileInfo == null ? "Загрузка не удалась!" : fileInfo.getUrl();
    }

    /**
     * Загрузка изображения, успешный ответ возвращает информацию о файле
     * Обработка изображений использует https://github.com/coobird/thumbnailator
     */
    @PostMapping("/upload-image")
    public FileInfo uploadImage(MultipartFile file) {
        return fileStorageService.of(file)
                .image(img -> img.size(1000,1000))  // Изменение размера изображения до 1000*1000
                .thumbnail(th -> th.size(200,200))  // Создание миниатюры размером 200*200
                .upload();
    }

    /**
     * Загрузка файла на указанную платформу хранения, успешный ответ возвращает информацию о файле
     */
    @PostMapping("/upload-platform")
    public FileInfo uploadPlatform(MultipartFile file) {
        return fileStorageService.of(file)
                .setPlatform("aliyun-oss-1")    // Использование указанной платформы хранения
                .upload();
    }
}```java
/**
 * Прямое чтение файла из HttpServletRequest для загрузки, успешный ответ возвращает информацию о файле.
 * При использовании этого подхода есть некоторые моменты внимания, подробнее читайте в документации раздела [основные возможности — загрузка](https://x-file-storage.xuyanwu.cn/#/%D0%BE%D1%81%D0%BD%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D0%B7%D0%B0%D0%B3%D1%80%D1%83%D0%B7%D0%B0)
 */
@PostMapping("/upload-request")
public FileInfo uploadPlatform(HttpServletRequest request) {
    return fileStorageService.of(request).upload();
}

//Ручное создание информации о файле, может быть использовано для других действий
FileInfo fileInfo = new FileInfo()
        .setPlatform("huawei-obs-1")
        .setBasePath("test/")
        .setPath("aa/")
        .setFilename("image.png")
        .setThumbFilename("image.png.min.jpg");

//Проверка наличия файла
boolean exists = fileStorageService.exists(fileInfo);
//Загрузка файла
byte[] bytes = fileStorageService.download(fileInfo).bytes();
//Удаление файла
fileStorageService.delete(fileInfo);
//Другие действия

//Прямое получение FileInfo объекта из базы данных, что позволяет легко выполнять другие действия
FileInfo fileInfo = fileStorageService.getFileInfoByUrl("https://abc.def.com/test/aa/image.png");

//Проверка наличия файла
boolean exists = fileStorageService.exists("https://abc.def.com/test/aa/image.png");
//Загрузка файла
byte[] bytes = fileStorageService.download("https://abc.def.com/test/aa/image.png").bytes();
//Удаление файла
fileStorageService.delete("https://abc.def.com/test/aa/image.png");
//Другие действия

<dependency>
    <groupId>cn.xuyanwu</groupId>
    <artifactId>spring-file-storage</artifactId>
    <version>1.0.3</version>
</dependency>

<dependency>
    <groupId>org.dromara.x-file-storage</groupId>
    <artifactId>x-file-storage-spring</artifactId>
    <version>2.0.0</version>
</dependency>

spring:
  file-storage: #конфигурация хранения файлов
    default-platform: huawei-obs-1 #по умолчанию используемая платформа хранения
    thumbnail-suffix: ".min.jpg" #суффикс миниатюр, например [.min.jpg][.png]
    #конфигурация соответствующей платформы здесь, обратите внимание на отступы

dromara:
  x-file-storage: #конфигурация хранения файлов
    default-platform: huawei-obs-1 #по умолчанию используемая платформа хранения
    thumbnail-suffix: ".min.jpg" #суффикс миниатюр, например [.min.jpg][.png]
    #конфигурация соответствующей платформы здесь, обратите внимание на отступы

cn.xuyanwu.spring.file.storage
cn.xuyanwu.spring.file.storage.spring

org.dromara.x.file.storage.core
org.dromara.x.file.storage.spring

<!-- Добавляем текущий проект -->
<dependency>
    <groupId>org.dromara.x-file-storage</groupId>
    <artifactId>x-file-storage-spring</artifactId>
    <version>2.0.0</version>
</dependency>
<!-- Добавляем библиотеку SDK Aliyun OSS, если вы используете другую платформу хранения, то добавьте соответствующую библиотеку SDK -->
<dependency>
    <groupId>com.aliyun.oss</groupId>
    <artifactId>aliyun-sdk-oss</artifactId>
    <version>3.16.1</version>
</dependency>

dromara:
  x-file-storage: #конфигурация хранения файлов
    default-platform: aliyun-oss-1 #по умолчанию используемая платформа хранения
    aliyun-oss:
      - platform: aliyun-oss-1 #идентификатор платформы хранения
        enable-storage: true  #включение хранения
        access-key: ??
        secret-key: ??
        end-point: ??
        bucket-name: ??
        domain: ?? #домен доступа, обратите внимание на завершающий "/", например: https://abc.oss-cn-shanghai.aliyuncs.com/
        base-path: test/ #базовый путь

@EnableFileStorage
@SpringBootApplication
public class SpringFileStorageTestApplication {

    public static void main(String[] args) {
        SpringApplication.run(SpringFileStorageTestApplication.class, args);
    }

}

@RestController
public class FileDetailController {

    @Autowired
    private FileStorageService fileStorageService; //инжектирование экземпляра

    /**
     * Загрузка файла
     */
    @PostMapping("/upload")
    public FileInfo upload(MultipartFile file) {
        //только эта одна строчка кода необходима для успешной загрузки
        return fileStorageService.of(file).upload();
    }
    
    /**
     * Загрузка файла, успешный ответ возвращает URL файла
     */
    @PostMapping("/upload2")
    public String upload2(MultipartFile file) {
        FileInfo fileInfo = fileStorageService.of(file)
                .setPath("upload/") //сохраняет относительный путь, чтобы было удобнее управлять, если не требуется, можно не указывать
                .setObjectId("0")   //ассоциированный объект ID, чтобы было удобнее управлять, если не требуется, можно не указывать
                .setObjectType("0") //тип ассоциированного объекта, чтобы было удобнее управлять, если не требуется, можно не указывать
                .putAttr("role","admin") //сохраняет некоторые атрибуты, которые могут быть получены и использованы в аспектах, записи загрузки, пользовательских платформах хранения и т.д., если не требуется, можно не указывать
                .upload();  //загружает файл на соответствующее место
        return fileInfo == null ? "Загрузка неудачна!" : fileInfo.getUrl();
    }

    /**
     * Загрузка изображения, успешный ответ возвращает информацию о файле
     * Обработка изображений использует https://github.com/coobird/thumbnailator
     */
    @PostMapping("/upload-image")
    public FileInfo uploadImage(MultipartFile file) {
        return fileStorageService.of(file)
                .image(img -> img.size(1000,1000))  //устанавливает размер изображения до 1000*1000
                .thumbnail(th -> th.size(200,200))  //генерирует миниатюру размером 200*200
                .upload();
    }
}```java
/**
 * Загрузка файла на указанную платформу хранения, успешный ответ возвращает информацию о файле
 */
@PostMapping("/upload-platform")
public FileInfo uploadPlatform(@RequestParam MultipartFile file) {
    return fileStorageService.of(file)
            .setPlatform("aliyun-oss-1")    // использует указанную платформу хранения
            .upload();
}

/**
 * Прямое чтение файла из HttpServletRequest для загрузки, успешный ответ возвращает информацию о файле
 * При использовании этого подхода есть несколько моментов, которые следует учесть, подробнее читайте в документации разделе [основные возможности - загрузка](https://x-file-storage.xuyanwu.cn/#/%D0%BE%D1%81%D0%BD%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5)
 */
@PostMapping("/upload-request")
public FileInfo uploadRequest(HttpServletRequest request) {
    return fileStorageService.of(request).upload();
}

// Ручное создание информации о файле, может быть использовано для других операций
FileInfo fileInfo = new FileInfo()
        .setPlatform("huawei-obs-1")
        .setBasePath("test/")
        .setPath("aa/")
        .setFilename("image.png")
        .setThumbFilename("image.png.min.jpg");

// Существование файла
boolean exists = fileStorageService.exists(fileInfo);
// Загрузка
byte[] bytes = fileStorageService.download(fileInfo).getBytes();
// Удаление
fileStorageService.delete(fileInfo);
// Другие операции

// Получение объекта FileInfo напрямую из базы данных, что делает выполнение других операций ещё проще
FileInfo fileInfo = fileStorageService.getFileInfoByUrl("https://abc.def.com/test/aa/image.png");

// Существование файла
boolean exists = fileStorageService.exists("https://abc.def.com/test/aa/image.png");
// Загрузка
byte[] bytes = fileStorageService.download("https://abc.def.com/test/aa/image.png").getBytes();
// Удаление
fileStorageService.delete("https://abc.def.com/test/aa/image.png");
// Другие операции

<dependency>
    <groupId>cn.xuyanwu</groupId>
    <artifactId>spring-file-storage</artifactId>
    <version>1.0.3</version>
</dependency>

<dependency>
    <groupId>cn.xuyanwu</groupId>
    <artifactId>spring-file-storage</artifactId>
    <version>1.0.2</version>
</dependency>

<dependency>
    <groupId>cn.xuyanwu</groupId>
    <artifactId>spring-file-storage</artifactId>
    <version>1.0.1</version>
</dependency>

<dependency>
    <groupId>cn.xuyanwu</groupId>
   <artifactId>spring-file-storage</artifactId>
    <version>1.0.0</version>
</dependency>

<dependency>
    <groupId>cn.xuyanwu</groupId>
    <artifactId>spring-file-storage</artifactId>
    <version>0.7.0</version>
</dependency>

<dependency>
    <groupId>cn.xuyanwu</groupId>
    <artifactId>spring-file-storage</artifactId>
    <version>0.6.1</version>
</dependency>

<dependency>
    <groupId>cn.xuyanwu</groupId>
    <artifactId>spring-file-storage</artifactId>
    <version>0.6.0</version>
</dependency>

<dependency>
    <groupId>cn.xuyanwu</groupId>
    <artifactId>spring-file-storage</artifactId>
    <version>0.5.0</version>
</dependency>

<dependency>
    <groupId>cn.xuyanwu</groupId>
    <artifactId>spring-file-storage</artifactId>
    <version>0.4.0</version>
</dependency>

<dependency>
    <groupId>cn.xuyanwu</groupId>
   <artifactId>spring-file-storage</artifactId>
    <version>0.3.0</version>
</dependency>

<dependency>
    <groupId>cn.xuyanwu</groupId>
    <artifactId>spring-file-storage</artifactId>
    <version>0.2.1</version>
</dependency>

<dependency>
    <groupId>cn.xuyanwu</groupId>
    <artifactId>spring-file-storage</artifactId>
    <version>0.2.0</version>
</dependency>

<dependency>
    <groupId>cn.xuyanwu</groupId>
    <artifactId>spring-file-storage</artifactId>
    <version>0.1.6</version>
</dependency>