/springDemo/src/main/java/controller/UserController.java

https://github.com/YeDaxia/JApiDocs · Java · 179 lines · 81 code · 21 blank · 77 comment · 0 complexity · 4c020583270d8f362c6ff98452960ce7 MD5 · raw file

  1. package controller;
  2. import enums.UserType;
  3. import form.GenericForm;
  4. import form.PageForm;
  5. import form.UserForm;
  6. import form.UserListForm;
  7. import io.github.yedaxia.apidocs.ApiDoc;
  8. import io.github.yedaxia.apidocs.Ignore;
  9. import org.springframework.web.bind.annotation.*;
  10. import org.springframework.web.multipart.MultipartFile;
  11. import result.ApiResult;
  12. import result.PageResult;
  13. import result.user.UserVO;
  14. import javax.servlet.http.HttpServletResponse;
  15. import javax.servlet.http.HttpSession;
  16. import java.util.ArrayList;
  17. import java.util.List;
  18. /**
  19. * 用户接口
  20. * @author yeguozhong
  21. */
  22. @RequestMapping("/api/user/")
  23. @RestController
  24. public class UserController {
  25. /**
  26. * 用户列表
  27. * @description 这是一行说明
  28. * @param listForm
  29. * @author yedaxia
  30. */
  31. @RequestMapping(path = "list", method = {RequestMethod.GET, RequestMethod.POST} )
  32. public ApiResult<PageResult<UserVO>> list(UserListForm listForm){
  33. return null;
  34. }
  35. /**
  36. * 用户信息
  37. * @param userId 用户id
  38. * @param userForm
  39. * @author 周杰伦
  40. */
  41. @GetMapping("user-info/{userId}")
  42. public ApiResult<UserVO> userInfo(@PathVariable Long userId, @RequestBody UserForm userForm){
  43. return null;
  44. }
  45. /**
  46. * 保存用户
  47. * @param req
  48. * @param userForm
  49. * @param session
  50. * @return
  51. */
  52. @PostMapping(path = "save")
  53. public ApiResult<UserVO> saveUser(HttpServletResponse req, @RequestBody UserForm userForm, HttpSession session){
  54. return null;
  55. }
  56. /**
  57. * 上传头像
  58. *
  59. * @param avatar
  60. * @return
  61. */
  62. @PostMapping("upload-avatar")
  63. public ApiResult uploadAvatar(MultipartFile avatar){
  64. return null;
  65. }
  66. /**
  67. * 修改用户信息
  68. * @param userForm
  69. * @return
  70. */
  71. @PostMapping("modify")
  72. public ApiResult<UserVO> modifyUser(UserForm userForm){
  73. return null;
  74. }
  75. /**
  76. * 删除用户
  77. * @param userId 用户ID
  78. */
  79. @PostMapping("delete")
  80. public ApiResult deleteUser(@RequestParam Long userId){
  81. return null;
  82. }
  83. public ApiResult hello(){
  84. return null;
  85. }
  86. /**
  87. * 获取图片
  88. */
  89. @GetMapping("get-image")
  90. public void getImage(){
  91. }
  92. /**
  93. * 用户列表2
  94. *
  95. * @param userId 用户ID
  96. * @param user
  97. * @return
  98. */
  99. @GetMapping("list2")
  100. public ApiResult<ArrayList<UserVO>> list2(@RequestParam Long userId, @RequestBody UserForm user){
  101. return null;
  102. }
  103. /**
  104. * 用户列表3
  105. * @param pageForm
  106. * @return
  107. */
  108. @GetMapping("list3")
  109. public List<UserVO> list3(PageForm pageForm){
  110. return null;
  111. }
  112. /**
  113. * List测试
  114. * @param ids 用户id
  115. * @return
  116. */
  117. @GetMapping("list-by-ids")
  118. public ApiResult getUserList(List<Long> ids){
  119. return null;
  120. }
  121. /**
  122. * 枚举参数测试
  123. *
  124. * @param userType
  125. * @return
  126. */
  127. @GetMapping("getByUserType")
  128. public ApiResult getByUserType(UserType userType){
  129. return null;
  130. }
  131. /**
  132. * 忽略该接口
  133. * @return
  134. */
  135. @Ignore
  136. @PostMapping("ignore")
  137. public ApiResult ignore(){
  138. return null;
  139. }
  140. /**
  141. * 字符串结果
  142. * @return
  143. */
  144. @ApiDoc(stringResult = "{code: 0, data: 'success'}")
  145. @GetMapping(value = "custom-json")
  146. public ApiResult customJsonResult(){
  147. return null;
  148. }
  149. /**
  150. * 泛型参数
  151. * @param user
  152. * @return
  153. */
  154. @GetMapping(value = "generic-form")
  155. public ApiResult testGenericForm(@RequestBody GenericForm<UserForm> user){
  156. return null;
  157. }
  158. }