添加注释

app/src/main/java/cn/seecoder/courselearningdemo/network/CourseOrderService.java

@@ -11,6 +11,9 @@ import retrofit2.http.POST;
 import retrofit2.http.Path;
 
 public interface CourseOrderService {
+    /**
+     * 创建购买课程的订单
+     */
     @POST("/course_order/create")
     Call<ResultVO<CourseOrder>> createCourseOrder(@Body CourseOrder courseOrder);
 

app/src/main/java/cn/seecoder/courselearningdemo/network/CourseService.java

@@ -10,12 +10,40 @@ import retrofit2.http.Path;
 import retrofit2.http.Query;
 
 public interface CourseService {
+    /**
+     * 查询一门课程
+     * @param courseId 课程编号
+     * @param uid 用户编号
+     * @return 课程
+     */
     @GET("/course/{courseId}")
     Call<Course> getCourse(@Path(value = "courseId") Integer courseId, @Query(value = "uid")String uid);
+
+    /**
+     * 根据关键字分页查询课程
+     * @param page 页码数
+     * @param uid 用户编号
+     * @param key 关键字
+     * @return 符合条件的课程列表分页信息
+     */
     @GET("/course/all/{page}")
     Call<PageInfo<Course>> getAllCourses(@Path(value = "page") Integer page, @Query(value = "uid")String uid, @Query(value = "key")String key);
+
+    /**
+     * 根据课程类型分页查询课程
+     * @param page 页码数
+     * @param uid 用户编号
+     * @param type 课程类型
+     * @return 符合条件的课程列表分页信息
+     */
     @GET("/course/by_type/{page}")
     Call<PageInfo<Course>> getCoursesByType(@Path(value = "page") Integer page, @Query(value = "uid")String uid, @Query(value = "type")String type);
+
+    /**
+     * 查询用户已购买的课程
+     * @param uid 用户编号
+     * @return 符合条件的课程列表分页信息
+     */
     @GET("/course/uid/{uid}")
     Call<List<Course>> getCourseByUid(@Path(value = "uid") String uid);
 }

app/src/main/java/cn/seecoder/courselearningdemo/network/CourseWareService.java

@@ -9,6 +9,12 @@ import retrofit2.http.Path;
 import retrofit2.http.Query;
 
 public interface CourseWareService {
+    /**
+     * 获取课程的课件列表
+     * @param courseId 课程编号
+     * @param uid 用户编号
+     * @return 符合条件的课件列表
+     */
     @GET("/course_ware/course/{courseId}")
     Call<List<CourseWare>> getCourseWare(@Path(value = "courseId") Integer courseId, @Query(value = "uid") String uid);
 }

app/src/main/java/cn/seecoder/courselearningdemo/network/NotifyService.java

@@ -6,6 +6,11 @@ import retrofit2.http.POST;
 import retrofit2.http.Query;
 
 public interface NotifyService {
+    /**
+     * 发送用户购买课程成功的推送通知
+     * @param uid 用户
+     * @param courseId 课程编号
+     */
     @POST("/notify/course_order_success")
     Call<ResultVO<String>> sendCourseOrderSuccessNotify(@Query(value = "uid") String uid, @Query(value = "courseId") Integer courseId);
 }

app/src/main/java/cn/seecoder/courselearningdemo/viewmodel/HomeViewModel.java

@@ -99,12 +99,15 @@ public class HomeViewModel extends ViewModel {
     }
 
     public void createCourseOrder(Course course){
+        // 生成待支付订单
         CourseOrder order = new CourseOrder();
         order.setUserId(uid);
         order.setCourseId(course.getId());
         order.setCourseName(course.getName());
         order.setCost(course.getCost());
-        order.setStatus(Constant.ORDER_STATUS_SUCCESS);
+        // 订单状态设为未支付
+        order.setStatus(Constant.ORDER_STATUS_UNPAID);
+        // 调用后端生成订单的接口
         Call<ResultVO<CourseOrder>> courseOrderCall = RetrofitClient.courseOrderService.createCourseOrder(order);
         courseOrderCall.enqueue(new Callback<ResultVO<CourseOrder>>() {
             @Override