快捷導(dǎo)航

springboot實(shí)現(xiàn)圖片上傳至服務(wù)器本地保存

更新時(shí)間：2026年06月01日 08:34:37 作者：安久1

這篇文章主要為大家詳細(xì)介紹了如何基于springboot實(shí)現(xiàn)圖片上傳至服務(wù)器本地保存,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下

定義config映射文件：本地存儲(chǔ)路徑為x:xxx,映射路徑為"/uploads/avatar/**"

package com.example.demo.config;

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

import java.nio.file.Path;
import java.nio.file.Paths;

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        Path uploadPath = Paths.get("F:", "aaa");
        registry.addResourceHandler("/uploads/avatar/**")
                .addResourceLocations(uploadPath.toUri().toString());
    }
}

編寫mapper

package com.example.demo.mapper;

import com.example.demo.pojo.Member;
import com.example.demo.pojo.MemberQuery;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

@Mapper
public interface UserMapper {
    
     Integer insertUserProfile(
             @Param("userId") Integer userId,
             @Param("userName") String userName,
             @Param("userGender") String userGender,
             @Param("userAvatar") String userAvatar
     );
}

實(shí)現(xiàn)UserMapper.xml文件作為Sql查詢

<insert id="insertUserProfile">
    INSERT INTO t_user
    <trim prefix="(" suffix=")" suffixOverrides=",">
        user_id,
        <if test="userName != null and userName != ''">
            user_name,
        </if>
        <if test="userGender != null and userGender != ''">
            user_gender,
        </if>
        <if test="userAvatar != null and userAvatar != ''">
            user_avatar,
        </if>
    </trim>
    <trim prefix="VALUES (" suffix=")" suffixOverrides=",">
        #{userId},
        <if test="userName != null and userName != ''">
            #{userName},
        </if>
        <if test="userGender != null and userGender != ''">
            #{userGender},
        </if>
        <if test="userAvatar != null and userAvatar != ''">
            #{userAvatar},
        </if>
    </trim>
</insert>

編寫service層接口

package com.example.demo.service;

import com.example.demo.common.PageResult;
import com.example.demo.common.UploadImageResult;
import com.example.demo.pojo.Member;
import com.example.demo.pojo.MemberQuery;
import com.example.demo.pojo.UserAvatarBase64Request;
import org.springframework.web.multipart.MultipartFile;

public interface UserService {
    UploadImageResult uploadUserAvatarBase64(UserAvatarBase64Request request);
}

實(shí)現(xiàn)接口uploadUserAvatarBase64方法，parseBase64Image方法判斷圖片格式，saveUserProfile方法保存或更新用戶的基本信息到數(shù)據(jù)庫(kù)

package com.example.demo.service.impl;

import com.example.demo.common.PageResult;
import com.example.demo.common.UploadImageResult;
import com.example.demo.mapper.UserMapper;
import com.example.demo.pojo.Member;
import com.example.demo.pojo.MemberQuery;
import com.example.demo.pojo.UserAvatarBase64Request;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.util.StringUtils;
import org.springframework.web.multipart.MultipartFile;

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.Base64;
import java.util.List;
import java.util.Locale;
import java.util.Set;
import java.util.UUID;

@Service
public class UserServiceImpl implements UserService {

    private static final Set<String> ALLOWED_IMAGE_EXTENSIONS = Set.of("jpg", "jpeg", "png", "gif", "webp");

    @Autowired
    private UserMapper userMapper;

    @Override
    public PageResult<Member> getUserList(MemberQuery query) {
        MemberQuery safeQuery = query == null ? new MemberQuery() : query;
        int safeIndex = (safeQuery.getIndex() == null || safeQuery.getIndex() < 1) ? 1 : safeQuery.getIndex();
        int safePageSize = (safeQuery.getPageSize() == null || safeQuery.getPageSize() < 1) ? 10 : safeQuery.getPageSize();
        int offset = (safeIndex - 1) * safePageSize;
        List<Member> users = userMapper.selectUserList(safeQuery, offset, safePageSize);
        Long total = userMapper.selectUserCount(safeQuery);
        return new PageResult<>(users, total, safeIndex, safePageSize);
    }

    

    @Override
    public UploadImageResult uploadUserAvatarBase64(UserAvatarBase64Request request) {
        if (request == null) {
            throw new IllegalArgumentException("請(qǐng)求參數(shù)不能為空");
        }
        Integer userId = request.getUserId();
        String userName = request.getUserName();
        String userGender = request.getUserGender();
        String userAvatar = request.getUserAvatar();

        if (userId == null) {
            throw new IllegalArgumentException("用戶id不能為空");
        }
        String avatarPath = null;
        if (StringUtils.hasText(userAvatar)) {
            Base64Image base64Image = parseBase64Image(userAvatar);
            String fileName = UUID.randomUUID() + "." + base64Image.extension;
            Path uploadDir = Paths.get("F:", "aaa");
            Path targetPath = uploadDir.resolve(fileName);

            try {
                Files.createDirectories(uploadDir);
                Files.write(targetPath, base64Image.bytes);
            } catch (IOException e) {
                throw new RuntimeException("圖片保存失敗", e);
            }

            avatarPath = "/uploads/avatar/" + fileName;
        }

        return saveUserProfile(userId, userName, userGender, avatarPath);
    }

    private UploadImageResult saveUserProfile(Integer userId, String userName, String userGender, String userAvatar) {
        if (!StringUtils.hasText(userName) && !StringUtils.hasText(userGender) && !StringUtils.hasText(userAvatar)) {
            throw new IllegalArgumentException("用戶名稱、用戶性別、用戶頭像至少傳一個(gè)");
        }

        Integer exists = userMapper.selectUserById(userId);
        Integer affectedRows;
        if (exists != null && exists > 0) {
            affectedRows = userMapper.updateUserProfile(userId, userName, userGender, userAvatar);
        } else {
            affectedRows = userMapper.insertUserProfile(userId, userName, userGender, userAvatar);
        }

        if (affectedRows == null || affectedRows == 0) {
            throw new IllegalArgumentException("用戶信息保存失敗");
        }
        return new UploadImageResult(userId, userName, userGender, userAvatar);
    }

    private String getFileExtension(String originalFilename) {
        String filename = StringUtils.cleanPath(originalFilename == null ? "" : originalFilename);
        int dotIndex = filename.lastIndexOf('.');
        if (dotIndex < 0 || dotIndex == filename.length() - 1) {
            throw new IllegalArgumentException("圖片文件后綴不能為空");
        }
        return filename.substring(dotIndex + 1).toLowerCase(Locale.ROOT);
    }

    private Base64Image parseBase64Image(String userAvatar) {
        String base64Content = userAvatar.trim();
        String extension = "png";

        if (base64Content.startsWith("data:image/")) {
            int mimeEndIndex = base64Content.indexOf(";base64,");
            if (mimeEndIndex < 0) {
                throw new IllegalArgumentException("圖片base64格式錯(cuò)誤");
            }
            extension = base64Content.substring("data:image/".length(), mimeEndIndex).toLowerCase(Locale.ROOT);
            if ("jpg".equals(extension)) {
                extension = "jpeg";
            }
            base64Content = base64Content.substring(mimeEndIndex + ";base64,".length());
        }

        if (!ALLOWED_IMAGE_EXTENSIONS.contains(extension)) {
            throw new IllegalArgumentException("只支持 jpg、jpeg、png、gif、webp 格式圖片");
        }

        try {
            byte[] bytes = Base64.getDecoder().decode(base64Content);
            if (bytes.length == 0) {
                throw new IllegalArgumentException("用戶頭像base64不能為空");
            }
            return new Base64Image(extension, bytes);
        } catch (IllegalArgumentException e) {
            throw new IllegalArgumentException("圖片base64解析失敗");
        }
    }

    private static class Base64Image {
        private final String extension;
        private final byte[] bytes;

        private Base64Image(String extension, byte[] bytes) {
            this.extension = extension;
            this.bytes = bytes;
        }
    }
}

contrller層調(diào)用

@PostMapping("/uploadAvatarBase64")
public org.springframework.http.ResponseEntity<ResponseEntity<UploadImageResult>> uploadAvatarBase64(
        @RequestBody UserAvatarBase64Request request
) {
    try {
        UploadImageResult result = userService.uploadUserAvatarBase64(request);
        return org.springframework.http.ResponseEntity.ok(
                ResponseEntity.success(200, result, "用戶信息保存成功")
        );
    } catch (IllegalArgumentException e) {
        return org.springframework.http.ResponseEntity
                .status(HttpStatus.BAD_REQUEST)
                .body(ResponseEntity.fail(400, e.getMessage()));
    } catch (RuntimeException e) {
        return org.springframework.http.ResponseEntity
                .status(HttpStatus.INTERNAL_SERVER_ERROR)
                .body(ResponseEntity.fail(500, e.getMessage()));
    }
}

到此這篇關(guān)于springboot實(shí)現(xiàn)圖片上傳至服務(wù)器本地保存的文章就介紹到這了,更多相關(guān)springboot圖片上傳服務(wù)器內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: