欧美国产日本高清在线视频 ,欧美黑人xxxxww,99rv精品视频在线播放

public interface UserService {

User getUserById(Long id);

List<User> getAllUsers();

void createUser(User user);

}

// 不好的設(shè)計(jì)：命名不一致，參數(shù)混亂

public interface UserService {

User getTheUserWithId(Long userId);

List<User> fetchAllUsersList();

Boolean addNewUserToSystem(User userObj);

}

2. 清晰的錯誤處理

public class ApiResponse<T> {



    private boolean success;



    private T data;



    private String message;



    // 構(gòu)造器和getter/setter省略



    public static <T> ApiResponse<T> success(T data) {



        ApiResponse<T> response = new ApiResponse<>();



        response.setSuccess(true);



        response.setData(data);



        return response;



    }



    public static <T> ApiResponse<T> error(String message) {



        ApiResponse<T> response = new ApiResponse<>();



        response.setSuccess(false);



        response.setMessage(message);



        return response;



    }



}

3. REST API 示例

@RestController



@RequestMapping("/api/v1/users")



public class UserController {



    @Autowired



    private UserService userService;



    @GetMapping("/{id}")



    public ApiResponse<User> getUser(@PathVariable Long id) {



        try {



            User user = userService.getUserById(id);



            return ApiResponse.success(user);



        } catch (UserNotFoundException e) {



            return ApiResponse.error("用戶不存在");



        }



    }



    @PostMapping



    public ApiResponse<User> createUser(@RequestBody @Valid User user) {



        try {



            User createdUser = userService.createUser(user);



            return ApiResponse.success(createdUser);



        } catch (Exception e) {



            return ApiResponse.error("創(chuàng)建用戶失敗：" + e.getMessage());



        }



    }



}

實(shí)用小貼士

版本控制：為 API 添加版本號，方便后續(xù)升級
文檔化：使用 Swagger 或 Spring Doc 自動生成 API 文檔
安全性：實(shí)現(xiàn)適當(dāng)?shù)恼J(rèn)證和授權(quán)機(jī)制
性能優(yōu)化：使用緩存和分頁技術(shù)

常見錯誤和解決方案

接口過度設(shè)計(jì)：保持簡單，只暴露必要的功能
錯誤處理不當(dāng)：統(tǒng)一錯誤響應(yīng)格式
缺乏安全考慮：添加適當(dāng)?shù)尿?yàn)證和授權(quán)
文檔缺失：及時(shí)更新 API 文檔

動手練習(xí)

創(chuàng)建一個簡單的圖書管理 API，要求：

實(shí)現(xiàn)基本的 CRUD 操作
添加錯誤處理
實(shí)現(xiàn)分頁查詢
添加接口文檔

// 這是一個基礎(chǔ)的示例框架



@RestController



@RequestMapping("/api/v1/books")



public class BookController {



    @GetMapping



    public ApiResponse<Page<Book>> getBooks(



            @RequestParam(defaultValue = "0") int page,



            @RequestParam(defaultValue = "10") int size) {



        // 實(shí)現(xiàn)分頁查詢



        return null; // 你來實(shí)現(xiàn)具體邏輯



    }



    // 添加其他CRUD操作...



}