hy1

src/com/yj/bean/Book.java

@@ -5,88 +5,176 @@ import java.math.BigDecimal;
 /**
  * @author yj
  * @create 2020-10-02 19:51
+ *
+ * Book类表示一本书的信息，包含了书籍的基本属性，如ID、书名、作者、价格、销量、库存、分类和图片路径等。
  */
 public class Book {
-    private Integer id;//id
-    private String name;//姓名
-    private String author;//作者
+
+    // 书籍的唯一标识符
+    private Integer id;
+
+    // 书籍的名称
+    private String name;
+
+    // 书籍的作者
+    private String author;
+
+    // 书籍的价格，使用BigDecimal类型以确保精度
     private BigDecimal price;
+
+    // 书籍的销量
     private Integer sales;
+
+    // 书籍的库存数量
     private Integer stock;
+
+    // 书籍的分类
     private String classification;
-    private String imgPath="static/img/default.jpg";
 
+    // 书籍的图片路径，默认值为"static/img/default.jpg"
+    private String imgPath = "static/img/default.jpg";
+
+    /**
+     * 获取书籍的分类
+     * @return 书籍的分类
+     */
     public String getClassification() {
         return classification;
     }
 
+    /**
+     * 设置书籍的分类
+     * @param classification 书籍的分类
+     */
     public void setClassification(String classification) {
         this.classification = classification;
     }
 
-
-
+    /**
+     * 获取书籍的ID
+     * @return 书籍的ID
+     */
     public Integer getId() {
         return id;
     }
 
+    /**
+     * 设置书籍的ID
+     * @param id 书籍的ID
+     */
     public void setId(Integer id) {
         this.id = id;
     }
 
+    /**
+     * 获取书籍的名称
+     * @return 书籍的名称
+     */
     public String getName() {
         return name;
     }
 
+    /**
+     * 设置书籍的名称
+     * @param name 书籍的名称
+     */
     public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * 获取书籍的作者
+     * @return 书籍的作者
+     */
     public String getAuthor() {
         return author;
     }
 
+    /**
+     * 设置书籍的作者
+     * @param author 书籍的作者
+     */
     public void setAuthor(String author) {
         this.author = author;
     }
 
+    /**
+     * 获取书籍的价格
+     * @return 书籍的价格
+     */
     public BigDecimal getPrice() {
         return price;
     }
 
+    /**
+     * 设置书籍的价格
+     * @param price 书籍的价格
+     */
     public void setPrice(BigDecimal price) {
         this.price = price;
     }
 
+    /**
+     * 获取书籍的销量
+     * @return 书籍的销量
+     */
     public Integer getSales() {
         return sales;
     }
 
+    /**
+     * 设置书籍的销量
+     * @param sales 书籍的销量
+     */
     public void setSales(Integer sales) {
         this.sales = sales;
     }
 
+    /**
+     * 获取书籍的库存数量
+     * 如果库存数量小于0，则返回0
+     * @return 书籍的库存数量
+     */
     public Integer getStock() {
-        if(stock<0) stock=0;return stock;
+        if (stock < 0) stock = 0;
+        return stock;
     }
 
+    /**
+     * 设置书籍的库存数量
+     * 如果库存数量小于0，则将其设置为0
+     * @param stock 书籍的库存数量
+     */
     public void setStock(Integer stock) {
-        if(stock<0) stock=0;
+        if (stock < 0) stock = 0;
         this.stock = stock;
     }
 
+    /**
+     * 获取书籍的图片路径
+     * @return 书籍的图片路径
+     */
     public String getImgPath() {
         return imgPath;
     }
 
+    /**
+     * 设置书籍的图片路径
+     * 如果传入的图片路径为null或空字符串，则使用默认图片路径"static/img/default.jpg"
+     * @param imgPath 书籍的图片路径
+     */
     public void setImgPath(String imgPath) {
-        if(imgPath==null||"".equals(imgPath)) {
+        if (imgPath == null || "".equals(imgPath)) {
             this.imgPath = "static/img/default.jpg";
         } else {
             this.imgPath = imgPath;
         }
     }
 
+    /**
+     * 重写toString方法，返回书籍的详细信息
+     * @return 书籍的详细信息字符串
+     */
     @Override
     public String toString() {
         return "Book{" +
@@ -101,9 +189,23 @@ public class Book {
                 '}';
     }
 
+    /**
+     * 无参构造方法
+     */
     public Book() {
     }
 
+    /**
+     * 全参构造方法
+     * @param id 书籍的ID
+     * @param name 书籍的名称
+     * @param author 书籍的作者
+     * @param price 书籍的价格
+     * @param sales 书籍的销量
+     * @param stock 书籍的库存数量
+     * @param classification 书籍的分类
+     * @param imgPath 书籍的图片路径
+     */
     public Book(Integer id, String name, String author, BigDecimal price, Integer sales, Integer stock, String classification, String imgPath) {
         this.id = id;
         this.name = name;
@@ -114,4 +216,4 @@ public class Book {
         this.classification = classification;
         this.imgPath = imgPath;
     }
-}
+}

src/com/yj/dao/BookDao.java

@@ -8,34 +8,108 @@ import java.util.List;
 /**
  * @author yj
  * @create 2020-08-23 21:08
+ *
+ * BookDao接口定义了对书籍数据的操作方法，包括增删改查、分页查询、按价格范围查询、按名称或作者查询等功能。
  */
 public interface BookDao {
 
+    /**
+     * 添加一本书籍到数据库
+     * @param book 要添加的书籍对象
+     * @return 受影响的行数，成功返回1，失败返回0
+     */
     public int addBook(Book book);
 
+    /**
+     * 根据书籍ID删除书籍
+     * @param id 要删除的书籍ID
+     * @return 受影响的行数，成功返回1，失败返回0
+     */
     public int deleteBookById(Integer id);
 
+    /**
+     * 更新书籍信息
+     * @param book 包含更新信息的书籍对象
+     * @return 受影响的行数，成功返回1，失败返回0
+     */
     public int updateBook(Book book);
 
+    /**
+     * 根据书籍ID查询书籍信息
+     * @param id 要查询的书籍ID
+     * @return 查询到的书籍对象，如果未找到返回null
+     */
     public Book queryBookById(Integer id);
 
+    /**
+     * 查询所有书籍信息
+     * @return 包含所有书籍的列表
+     */
     public List<Book> queryBooks();
 
+    /**
+     * 查询所有书籍的总记录数
+     * @return 所有书籍的总记录数
+     */
     Integer queryForPageTotalCount();
 
+    /**
+     * 分页查询书籍信息
+     * @param begin 分页的起始索引
+     * @param pageSize 每页显示的记录数
+     * @return 当前页的书籍列表
+     */
     List<Book> queryForPageItems(int begin, int pageSize);
 
+    /**
+     * 根据价格范围查询书籍的总记录数
+     * @param min 价格范围的最小值
+     * @param max 价格范围的最大值
+     * @return 符合价格范围的书籍总记录数
+     */
     Integer queryForPageTotalCountByPrice(int min, int max);
 
+    /**
+     * 根据价格范围分页查询书籍信息
+     * @param begin 分页的起始索引
+     * @param pageSize 每页显示的记录数
+     * @param min 价格范围的最小值
+     * @param max 价格范围的最大值
+     * @return 当前页的书籍列表
+     */
     List<Book> queryForPageItemsByPrice(int begin, int pageSize, int min, int max);
 
+    /**
+     * 根据书籍名称或作者查询书籍的总记录数
+     * @param nameorauthor 书籍名称或作者的关键字
+     * @return 符合条件的书籍总记录数
+     */
     Integer queryForPageTotalCountByNameOrAuthor(String nameorauthor);
 
+    /**
+     * 根据书籍名称或作者分页查询书籍信息
+     * @param begin 分页的起始索引
+     * @param pageSize 每页显示的记录数
+     * @param nameorauthor 书籍名称或作者的关键字
+     * @return 当前页的书籍列表
+     */
     List<Book> queryForPageItemsByNameOrAuthor(int begin, int pageSize, String nameorauthor);
 
+    /**
+     * 查询所有书籍并按某种顺序排序（如销量、价格等）
+     * @return 按顺序排序的书籍列表
+     */
     List<Book> queryForPageItemsOrder();
 
+    /**
+     * 查询所有书籍的总金额（价格总和）
+     * @return 所有书籍的总金额
+     */
     BigDecimal queryTotalMoney();
 
+    /**
+     * 查询书籍的总数量
+     * @return 书籍的总数量
+     */
     public Integer queryBooknums();
-}
+}

src/com/yj/service/BookService.java

@@ -9,28 +9,84 @@ import java.util.List;
 /**
  * @author yj
  * @create 2020-08-24 14:40
+ *
+ * BookService接口定义了与书籍相关的业务逻辑操作，包括书籍的增删改查、分页查询、按价格范围查询、按名称或作者查询等功能。
  */
 public interface BookService {
 
+    /**
+     * 添加一本书籍
+     * @param book 要添加的书籍对象
+     */
     public void addBook(Book book);
 
+    /**
+     * 更新书籍信息
+     * @param book 包含更新信息的书籍对象
+     */
     public void updateBook(Book book);
 
+    /**
+     * 根据书籍ID删除书籍
+     * @param id 要删除的书籍ID
+     */
     public void deleteBookById(Integer id);
 
+    /**
+     * 根据书籍ID查询书籍信息
+     * @param id 要查询的书籍ID
+     * @return 查询到的书籍对象，如果未找到返回null
+     */
     public Book queryBookById(Integer id);
 
+    /**
+     * 查询所有书籍信息
+     * @return 包含所有书籍的列表
+     */
     public List<Book> queryBooks();
 
+    /**
+     * 分页查询书籍信息
+     * @param pageNo 当前页码
+     * @param pageSize 每页显示的记录数
+     * @return 分页对象，包含当前页的书籍列表和分页信息
+     */
     Page<Book> page(int pageNo, int pageSize);
 
+    /**
+     * 根据价格范围分页查询书籍信息
+     * @param pageNo 当前页码
+     * @param pageSize 每页显示的记录数
+     * @param min 价格范围的最小值
+     * @param max 价格范围的最大值
+     * @return 分页对象，包含当前页的书籍列表和分页信息
+     */
     Page<Book> pageByPrice(int pageNo, int pageSize, int min, int max);
 
+    /**
+     * 根据书籍名称或作者分页查询书籍信息
+     * @param pageNo 当前页码
+     * @param pageSize 每页显示的记录数
+     * @param nameOrAuthor 书籍名称或作者的关键字
+     * @return 分页对象，包含当前页的书籍列表和分页信息
+     */
     Page<Book> pageByNameOrAuthor(int pageNo, int pageSize, String nameOrAuthor);
 
+    /**
+     * 查询所有书籍并按某种顺序排序（如销量、价格等）
+     * @return 分页对象，包含按顺序排序的书籍列表和分页信息
+     */
     Page<Book> pageOrder();
 
+    /**
+     * 查询书籍的总数量
+     * @return 书籍的总数量
+     */
     public Integer queryTotalBooks();
 
+    /**
+     * 查询所有书籍的总金额（价格总和）
+     * @return 所有书籍的总金额
+     */
     BigDecimal queryTotalMoney();
-}
+}

src/com/yj/test/BookDaoTest.java

@@ -10,59 +10,102 @@ import java.math.BigDecimal;
 /**
  * @author yj
  * @create 2020-08-24 11:01
+ *
+ * BookDaoTest类用于测试BookDao接口的实现类BookDaoImpl中的各个方法。
+ * 通过JUnit测试框架，验证数据库操作的正确性。
  */
 public class BookDaoTest {
+
+    // 创建BookDao接口的实现类BookDaoImpl对象
     BookDao bookDao = new BookDaoImpl();
 
+    /**
+     * 测试添加书籍的方法
+     */
     @Test
     public void addBook() {
-        //`name`,`author`,`classification`,`price`,`sales`,`stock`,`img_path`
-        //Integer id, String name, String author, BigDecimal price, Integer sales, Integer stock, String classification, String imgPath)
-        bookDao.addBook(new Book(null,"舌的中国","yjjj",new BigDecimal("5"),100,23,"",""));
+        // 创建一个新的Book对象，并调用addBook方法将其添加到数据库中
+        bookDao.addBook(new Book(null, "舌的中国", "yjjj", new BigDecimal("5"), 100, 23, "", ""));
     }
 
+    /**
+     * 测试删除书籍的方法
+     */
     @Test
     public void deleteBook() {
+        // 调用deleteBookById方法，删除ID为3的书籍
         bookDao.deleteBookById(3);
     }
 
+    /**
+     * 测试根据ID查询书籍的方法
+     */
     @Test
     public void queryById() {
+        // 调用queryBookById方法，查询ID为64的书籍，并打印结果
         System.out.println(bookDao.queryBookById(64));
     }
 
+    /**
+     * 测试更新书籍信息的方法
+     */
     @Test
     public void update() {
-        bookDao.updateBook(new Book(35,"舌尖的中国","yj",new BigDecimal("5"),100,23,"文学",""));
+        // 创建一个新的Book对象，并调用updateBook方法更新ID为35的书籍信息
+        bookDao.updateBook(new Book(35, "舌尖的中国", "yj", new BigDecimal("5"), 100, 23, "文学", ""));
     }
 
+    /**
+     * 测试查询所有书籍的方法
+     */
     @Test
     public void queryList() {
+        // 调用queryBooks方法，查询所有书籍，并打印结果
         System.out.println(bookDao.queryBooks());
     }
 
+    /**
+     * 测试查询书籍总记录数的方法
+     */
     @Test
     public void queryForPageTotalCount() {
+        // 调用queryForPageTotalCount方法，查询所有书籍的总记录数，并打印结果
         System.out.println(bookDao.queryForPageTotalCount());
     }
 
+    /**
+     * 测试分页查询书籍的方法
+     */
     @Test
     public void queryForPageItems() {
-        System.out.println(bookDao.queryForPageItems(1,4));
+        // 调用queryForPageItems方法，分页查询书籍，并打印结果
+        System.out.println(bookDao.queryForPageItems(1, 4));
     }
 
+    /**
+     * 测试根据价格范围查询书籍总记录数的方法
+     */
     @Test
     public void queryForPageTotalCountByPrice() {
-        System.out.println(bookDao.queryForPageTotalCountByPrice(10,50));
+        // 调用queryForPageTotalCountByPrice方法，查询价格在10到50之间的书籍总记录数，并打印结果
+        System.out.println(bookDao.queryForPageTotalCountByPrice(10, 50));
     }
 
+    /**
+     * 测试根据价格范围分页查询书籍的方法
+     */
     @Test
     public void queryForPageItemsByPrice() {
-        System.out.println(bookDao.queryForPageItemsByPrice(1,4,10,50));
+        // 调用queryForPageItemsByPrice方法，根据价格范围分页查询书籍，并打印结果
+        System.out.println(bookDao.queryForPageItemsByPrice(1, 4, 10, 50));
     }
 
+    /**
+     * 测试查询书籍总数量的方法
+     */
     @Test
     public void queryBooknums() {
+        // 调用queryBooknums方法，查询书籍的总数量，并打印结果
         System.out.println(bookDao.queryBooknums());
     }
-}
+}

src/com/yj/test/BookServiceTest.java

@@ -12,43 +12,78 @@ import java.math.BigDecimal;
 /**
  * @author yj
  * @create 2020-08-24 14:57
+ *
+ * BookServiceTest类用于测试BookService接口的实现类BookServiceImpl中的各个方法。
+ * 通过JUnit测试框架，验证业务逻辑的正确性。
  */
 public class BookServiceTest {
 
+    // 创建BookDao接口的实现类BookDaoImpl对象
     private BookDao bookDao = new BookDaoImpl();
+
+    // 创建BookService接口的实现类BookServiceImpl对象
     private BookService bookService = new BookServiceImpl();
+
+    /**
+     * 测试添加书籍的方法
+     */
     @Test
     public void addBook() {
-        bookDao.addBook(new Book(null,"舌尖上的中国","yj",new BigDecimal("5"),100,23,"文学",""));
+        // 创建一个新的Book对象，并调用addBook方法将其添加到数据库中
+        bookDao.addBook(new Book(null, "舌尖上的中国", "yj", new BigDecimal("5"), 100, 23, "文学", ""));
     }
 
+    /**
+     * 测试更新书籍信息的方法
+     */
     @Test
     public void updateBook() {
-        bookDao.updateBook(new Book(null,"舌尖上的中国","yj",new BigDecimal("5"),100,23,"文学",""));
+        // 创建一个新的Book对象，并调用updateBook方法更新书籍信息
+        bookDao.updateBook(new Book(null, "舌尖上的中国", "yj", new BigDecimal("5"), 100, 23, "文学", ""));
     }
 
+    /**
+     * 测试根据ID删除书籍的方法
+     */
     @Test
     public void deleteBookById() {
+        // 调用deleteBookById方法，删除ID为25的书籍，并打印受影响的行数
         System.out.println(bookDao.deleteBookById(25));
     }
 
+    /**
+     * 测试根据ID查询书籍的方法
+     */
     @Test
     public void queryBookById() {
+        // 调用queryBookById方法，查询ID为23的书籍，并打印结果
         System.out.println(bookDao.queryBookById(23));
     }
 
+    /**
+     * 测试查询所有书籍的方法
+     */
     @Test
     public void queryBooks() {
+        // 调用queryBooks方法，查询所有书籍，并打印结果
         System.out.println(bookDao.queryBooks());
     }
 
+    /**
+     * 测试分页查询书籍总记录数的方法
+     */
     @Test
     public void page() {
+        // 调用queryForPageTotalCount方法，查询所有书籍的总记录数，并打印结果
         System.out.println(bookDao.queryForPageTotalCount());
     }
 
+    /**
+     * 测试查询所有书籍的总金额的方法
+     */
     @Test
     public void queryTotalMoney() {
+        // 调用queryTotalMoney方法，查询所有书籍的总金额，并打印结果
         System.out.println(bookDao.queryTotalMoney());
     }
 }

src/com/yj/web/BaseServlet.java

@@ -10,26 +10,54 @@ import java.lang.reflect.Method;
 /**
  * @author yj
  * @create 2020-08-23 16:51
+ *
+ * BaseServlet类是一个抽象的Servlet基类，用于简化Servlet的开发。
+ * 它通过反射机制动态调用子类中的方法，避免了在每个Servlet中重复编写doGet和doPost方法。
  */
 public abstract class BaseServlet extends HttpServlet {
 
+    /**
+     * 处理GET请求，直接调用doPost方法
+     * @param req HttpServletRequest对象
+     * @param resp HttpServletResponse对象
+     * @throws ServletException
+     * @throws IOException
+     */
     @Override
     protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
-        doPost(req,resp);
+        doPost(req, resp);
     }
 
+    /**
+     * 处理POST请求，通过反射机制动态调用子类中的方法
+     * @param req HttpServletRequest对象
+     * @param resp HttpServletResponse对象
+     * @throws ServletException
+     * @throws IOException
+     */
+    @Override
     protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
-        //解决post请求中文乱码
+        // 解决POST请求中文乱码问题
         req.setCharacterEncoding("utf-8");
-        //解决相应的中文乱码
+
+        // 解决响应的中文乱码问题
         resp.setContentType("text/html;charset=UTF-8");
+
+        // 获取请求参数action，该参数用于指定要调用的方法名
         String action = req.getParameter("action");
+
         try {
-            Method method = this.getClass().getDeclaredMethod(action, HttpServletRequest.class,HttpServletResponse.class);
-            method.invoke(this,req,resp);
+            // 通过反射获取当前类中指定名称的方法
+            Method method = this.getClass().getDeclaredMethod(action, HttpServletRequest.class, HttpServletResponse.class);
+
+            // 调用方法，传入请求和响应对象
+            method.invoke(this, req, resp);
         } catch (Exception e) {
+            // 捕获异常并打印堆栈信息
             e.printStackTrace();
+
+            // 将异常包装为运行时异常抛出，便于上层处理
             throw new RuntimeException(e);
         }
     }
-}
+}

src/com/yj/web/BookServlet.java

@@ -15,72 +15,137 @@ import java.util.List;
 /**
  * @author yj
  * @create 2020-08-24 15:25
+ *
+ * BookServlet类继承自BaseServlet，用于处理与书籍相关的请求。
+ * 通过调用BookService接口的实现类BookServiceImpl，完成书籍的增删改查、分页查询等操作。
  */
 public class BookServlet extends BaseServlet {
 
+    // 创建BookService接口的实现类BookServiceImpl对象
     private BookService bookService = new BookServiceImpl();
 
+    /**
+     * 处理添加书籍的请求
+     * @param req HttpServletRequest对象
+     * @param resp HttpServletResponse对象
+     * @throws ServletException
+     * @throws IOException
+     */
     protected void add(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
-        int pageNo = WebUtils.parseInt(req.getParameter("pageNo"),0);
-        pageNo+=1;
-        Book book = (Book) WebUtils.copyParamToBean(req.getParameterMap(),new Book());
+        // 获取当前页码，默认从0开始
+        int pageNo = WebUtils.parseInt(req.getParameter("pageNo"), 0);
+        // 页码加1，表示添加书籍后跳转到下一页
+        pageNo += 1;
+
+        // 将请求参数封装到Book对象中
+        Book book = (Book) WebUtils.copyParamToBean(req.getParameterMap(), new Book());
+
+        // 调用BookService的addBook方法添加书籍
         bookService.addBook(book);
-        //req.getRequestDispatcher("/manager/bookServlet?action=list").forward(req,resp);
-        resp.sendRedirect(req.getContextPath() + "/manager/bookServlet?action=page&pageNo="+pageNo);
-    }
 
+        // 重定向到书籍管理页面，并跳转到添加书籍后的页码
+        resp.sendRedirect(req.getContextPath() + "/manager/bookServlet?action=page&pageNo=" + pageNo);
+    }
 
+    /**
+     * 处理删除书籍的请求
+     * @param req HttpServletRequest对象
+     * @param resp HttpServletResponse对象
+     * @throws ServletException
+     * @throws IOException
+     */
     protected void delete(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
-       String id = req.getParameter("id");
-       int i = Integer.parseInt(id);
-       bookService.deleteBookById(i);
-       resp.sendRedirect(req.getContextPath() + "/manager/bookServlet?action=page&pageNo="+req.getParameter("pageNo"));
-    }
+        // 获取要删除的书籍ID
+        String id = req.getParameter("id");
+        int i = Integer.parseInt(id);
 
+        // 调用BookService的deleteBookById方法删除书籍
+        bookService.deleteBookById(i);
 
+        // 重定向到书籍管理页面，并保持当前页码
+        resp.sendRedirect(req.getContextPath() + "/manager/bookServlet?action=page&pageNo=" + req.getParameter("pageNo"));
+    }
+
+    /**
+     * 处理更新书籍的请求
+     * @param req HttpServletRequest对象
+     * @param resp HttpServletResponse对象
+     * @throws ServletException
+     * @throws IOException
+     */
     protected void update(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
-        Book book = (Book) WebUtils.copyParamToBean(req.getParameterMap(),new Book());
+        // 将请求参数封装到Book对象中
+        Book book = (Book) WebUtils.copyParamToBean(req.getParameterMap(), new Book());
+
+        // 调用BookService的updateBook方法更新书籍
         bookService.updateBook(book);
-        resp.sendRedirect(req.getContextPath() + "/manager/bookServlet?action=page&pageNo="+req.getParameter("pageNo"));
+
+        // 重定向到书籍管理页面，并保持当前页码
+        resp.sendRedirect(req.getContextPath() + "/manager/bookServlet?action=page&pageNo=" + req.getParameter("pageNo"));
     }
 
     /**
-     *
-     * @param req
-     * @param resp
+     * 处理获取单个书籍信息的请求
+     * @param req HttpServletRequest对象
+     * @param resp HttpServletResponse对象
      * @throws ServletException
      * @throws IOException
      */
     protected void getBook(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
+        // 获取要查询的书籍ID
         String id = req.getParameter("id");
         int i = Integer.parseInt(id);
+
+        // 调用BookService的queryBookById方法查询书籍
         Book book = bookService.queryBookById(i);
-        req.setAttribute("book",book);
-        req.getRequestDispatcher("/pages/manager/book_edit.jsp").forward(req,resp);
-    }
 
+        // 将查询到的书籍信息保存到request域中
+        req.setAttribute("book", book);
 
+        // 请求转发到书籍编辑页面
+        req.getRequestDispatcher("/pages/manager/book_edit.jsp").forward(req, resp);
+    }
+
+    /**
+     * 处理查询所有书籍的请求
+     * @param req HttpServletRequest对象
+     * @param resp HttpServletResponse对象
+     * @throws ServletException
+     * @throws IOException
+     */
     protected void list(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
-        //1、通过BookService查询数据
-        List<Book>books = bookService.queryBooks();
-        //2、将数据保存在request域中
-        req.setAttribute("books",books);
-        //3、请求转发到pages/manager/book_manager.jsp
-        req.getRequestDispatcher("/pages/manager/book_manager.jsp").forward(req,resp);
+        // 调用BookService的queryBooks方法查询所有书籍
+        List<Book> books = bookService.queryBooks();
+
+        // 将查询到的书籍列表保存到request域中
+        req.setAttribute("books", books);
+
+        // 请求转发到书籍管理页面
+        req.getRequestDispatcher("/pages/manager/book_manager.jsp").forward(req, resp);
     }
 
+    /**
+     * 处理分页查询书籍的请求
+     * @param req HttpServletRequest对象
+     * @param resp HttpServletResponse对象
+     * @throws ServletException
+     * @throws IOException
+     */
     protected void page(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
-        //1、获取请求的参数pageNo和pageSize
-        int pageNo = WebUtils.parseInt(req.getParameter("pageNo"),1);
+        // 获取请求参数pageNo和pageSize
+        int pageNo = WebUtils.parseInt(req.getParameter("pageNo"), 1);
         int pageSize = WebUtils.parseInt(req.getParameter("pageSize"), Page.PAGE_SIZE);
 
-        //2、调用BookService.page(pageNo,pageSize)方法：返回page对象
-        Page<Book> page = bookService.page(pageNo,pageSize);
+        // 调用BookService的page方法进行分页查询
+        Page<Book> page = bookService.page(pageNo, pageSize);
+
+        // 设置分页请求的URL
         page.setUrl("manager/bookServlet?action=page");
 
-        //3、保存Page对象到request域中
-        req.setAttribute("page",page);
-        //4、请求转发到page/manager/book_manager.jsp页面
-        req.getRequestDispatcher("/pages/manager/book_manager.jsp").forward(req,resp);
+        // 将分页对象保存到request域中
+        req.setAttribute("page", page);
+
+        // 请求转发到书籍管理页面
+        req.getRequestDispatcher("/pages/manager/book_manager.jsp").forward(req, resp);
     }
-}
+}

web/pages/client/index.jsp

@@ -16,18 +16,18 @@
     <%@include file="/pages/common/header.jsp"%>
     <script type="text/javascript">
         $(function () {
-            //给加入购物车绑定单击事件
+            // 给加入购物车按钮绑定单击事件
             $("button.addToCart").click(function () {
                 var bookId = $(this).attr("bookId");
-                //发ajax请求添加商品到购物车
+                // 发送AJAX请求，将商品添加到购物车
                 $.getJSON("http://localhost:8080/Book/cartServlet", "action=ajaxAddItem&id=" + bookId, function (data) {
+                    // 更新购物车商品总数
                     $("#cartTotalCount").text("您的购物车中有" + data.totalCount + "件商品");
+                    // 更新购物车中最新添加的商品名称
                     $("#cartLastName").html("您刚刚将【" + data.lastName + "】加入到了购物车中");
                 });
-
             });
         });
-
     </script>
 </head>
 <body>
@@ -35,25 +35,27 @@
     <img class="logo_img" alt="" src="static/img/logo1.jpg" >
     <span class="wel_word">Bookstore</span>
     <div>
+        <!-- 判断用户是否登录 -->
         <c:if test="${empty sessionScope.user}">
-
+            <!-- 未登录状态 -->
             <a href="pages/user/login.jsp">登录</a> |
             <a href="pages/user/regist.jsp">注册</a> &nbsp;&nbsp;
             <a href="client/bookServlet?action=pageOrder">热榜</a>
         </c:if>
-
         <c:if test="${not empty sessionScope.user}">
+            <!-- 已登录状态 -->
             <span>欢迎<span class="um_span">${sessionScope.user.username}</span>光临书城</span>
             <a href="client/orderServlet?action=myOrders">我的订单</a>
             <a href="pages/user/userinfo.jsp">个人信息</a>
             <a href="userServlet?action=logout">注销</a>&nbsp;&nbsp;
         </c:if>
-
+        <!-- 购物车和后台管理链接 -->
         <a href="pages/cart/cart.jsp">购物车</a>
         <a href="pages/manager/manager.jsp">后台管理</a>
     </div>
 </div>
 <div id="main">
+    <!-- 图书搜索功能 -->
     <div class="book_check">
         <form action="client/bookServlet" method="get">
             <input type="hidden" name="action" value="pageByNameOrAuthor">
@@ -62,6 +64,7 @@
         </form>
     </div>
     <div id="book">
+        <!-- 价格区间筛选功能 -->
         <div class="book_cond">
             <form action="client/bookServlet" method="get">
                 <input type="hidden" name="action" value="pageByPrice">
@@ -71,6 +74,7 @@
             </form>
         </div>
         <div style="text-align: center">
+            <!-- 判断购物车是否为空 -->
             <c:if test="${empty sessionScope.cart.items}">
                 <span id="cartTotalCount"></span>
                 <div>
@@ -78,13 +82,16 @@
                 </div>
             </c:if>
             <c:if test="${not empty sessionScope.cart.items}">
+                <!-- 显示购物车商品总数 -->
                 <span id="cartTotalCount">您的购物车中有${sessionScope.cart.totalCount}件商品</span>
                 <div>
+                    <!-- 显示最新加入购物车的商品名称 -->
                     您刚刚将<span style="color: red" id="cartLastName">${sessionScope.lastName}</span>加入到了购物车中
                 </div>
             </c:if>
         </div>
 
+        <!-- 遍历书籍列表 -->
         <c:forEach items="${requestScope.page.items}" var="book">
             <div class="b_list">
                 <div class="img_div">
@@ -112,6 +119,7 @@
                         <span class="sp2">${book.stock}</span>
                     </div>
                     <div class="book_add">
+                        <!-- 加入购物车按钮 -->
                         <button bookId=${book.id} class="addToCart">加入购物车</button>
                     </div>
                 </div>
@@ -120,10 +128,12 @@
 
     </div>
 
+    <!-- 分页导航 -->
     <%@include file="/pages/common/page_nav.jsp"%>
 
 </div>
 
+<!-- 页脚 -->
 <%@include file="/pages/common/footer.jsp"%>
 </body>
-</html>
+</html>

web/pages/common/header.jsp

@@ -7,17 +7,27 @@
 --%>
 <%@ page contentType="text/html;charset=UTF-8" language="java" %>
 <%
-    String basePath = request.getScheme()
-            +"://"
-            +request.getServerName()
-    +":"
-    +request.getServerPort()
-    +request.getContextPath()
-    +"/";
-    pageContext.setAttribute("bastPath",basePath);
+    // 获取当前请求的协议（如http或https）
+    String scheme = request.getScheme();
+    // 获取服务器的主机名或IP地址
+    String serverName = request.getServerName();
+    // 获取服务器的端口号
+    int serverPort = request.getServerPort();
+    // 获取当前应用的上下文路径
+    String contextPath = request.getContextPath();
 
+    // 拼接basePath，用于构建项目的根路径
+    String basePath = scheme + "://" + serverName + ":" + serverPort + contextPath + "/";
+
+    // 将basePath存储到pageContext中，方便在页面中使用
+    pageContext.setAttribute("basePath", basePath);
 %>
+
 <!-- 写base标签，永远固定相对路径跳转的结果 -->
-<base href=<%=basePath%>>
-<link type="text/css" rel="stylesheet" href="static/css/style.css" >
-<script type="text/javascript" src="static/script/jquery-1.7.2.js"></script>
+<base href="<%=basePath%>">
+
+<!-- 引入外部的CSS样式文件 -->
+<link type="text/css" rel="stylesheet" href="static/css/style.css">
+
+<!-- 引入外部的jQuery库 -->
+<script type="text/javascript" src="static/script/jquery-1.7.2.js"></script>

web/pages/common/page_nav.jsp

@@ -8,71 +8,82 @@
 <%@ page contentType="text/html;charset=UTF-8" language="java" %>
 
 <div id="page_nav">
+    <!-- 首页链接 -->
     <a href="${requestScope.page.url}&pageNo=1">首页</a>
-    <c:if test="${requestScope.page.pageNo>1}">
-        <a href="${requestScope.page.url}&pageNo=${requestScope.page.pageNo-1}">上一页</a>
+
+    <!-- 上一页链接 -->
+    <c:if test="${requestScope.page.pageNo > 1}">
+        <a href="${requestScope.page.url}&pageNo=${requestScope.page.pageNo - 1}">上一页</a>
     </c:if>
 
+    <!-- 分页逻辑 -->
     <c:choose>
         <%-- 当总页码小于等于5的情况 --%>
-        <c:when test="${ requestScope.page.pageTotal <= 5 }">
-
+        <c:when test="${requestScope.page.pageTotal <= 5}">
             <c:set var="begin" value="1"></c:set>
-            <c:set var="end" value="${ requestScope.page.pageTotal }"></c:set>
-
+            <c:set var="end" value="${requestScope.page.pageTotal}"></c:set>
         </c:when>
         <c:otherwise>
             <%-- 当总页码大于5的情况 --%>
             <c:choose>
                 <%-- 当前页码是前三 --%>
-                <c:when test="${ requestScope.page.pageNo <= 3 }">
-
+                <c:when test="${requestScope.page.pageNo <= 3}">
                     <c:set var="begin" value="1"></c:set>
                     <c:set var="end" value="5"></c:set>
-
                 </c:when>
                 <%-- 当前页码是后三 --%>
-                <c:when test="${ requestScope.page.pageNo >= requestScope.page.pageTotal - 2 }">
-
-                    <c:set var="begin" value="${ requestScope.page.pageTotal - 4 }"></c:set>
-                    <c:set var="end" value="${ requestScope.page.pageTotal }"></c:set>
-
+                <c:when test="${requestScope.page.pageNo >= requestScope.page.pageTotal - 2}">
+                    <c:set var="begin" value="${requestScope.page.pageTotal - 4}"></c:set>
+                    <c:set var="end" value="${requestScope.page.pageTotal}"></c:set>
                 </c:when>
                 <c:otherwise>
-
-                    <c:set var="begin" value="${ requestScope.page.pageNo - 2 }"></c:set>
-                    <c:set var="end" value="${  requestScope.page.pageNo + 2 }"></c:set>
-
+                    <%-- 当前页码在中间 --%>
+                    <c:set var="begin" value="${requestScope.page.pageNo - 2}"></c:set>
+                    <c:set var="end" value="${requestScope.page.pageNo + 2}"></c:set>
                 </c:otherwise>
             </c:choose>
         </c:otherwise>
     </c:choose>
 
-
-
-
-    <c:forEach begin="${ begin }" end="${ end }" var="i">
-        <c:if test="${ i == requestScope.page.pageNo }">【${ i }】</c:if>
-        <c:if test="${ i != requestScope.page.pageNo }"><a href="${requestScope.page.url}&pageNo=${i}">${i}</a></c:if>
+    <!-- 显示页码 -->
+    <c:forEach begin="${begin}" end="${end}" var="i">
+        <c:if test="${i == requestScope.page.pageNo}">【${i}】</c:if>
+        <c:if test="${i != requestScope.page.pageNo}">
+            <a href="${requestScope.page.url}&pageNo=${i}">${i}</a>
+        </c:if>
     </c:forEach>
 
-    <c:if test="${requestScope.page.pageNo<requestScope.page.pageTotal}">
-        <a href="${requestScope.page.url}&pageNo=${requestScope.page.pageNo+1}">下一页</a>
+    <!-- 下一页链接 -->
+    <c:if test="${requestScope.page.pageNo < requestScope.page.pageTotal}">
+        <a href="${requestScope.page.url}&pageNo=${requestScope.page.pageNo + 1}">下一页</a>
     </c:if>
 
+    <!-- 末页链接 -->
     <a href="${requestScope.page.url}&pageNo=${requestScope.page.pageTotal}">末页</a>
+
+    <!-- 显示总页数和总记录数 -->
     共${requestScope.page.pageTotal}页，${requestScope.page.pageTotalCount}条记录
+
+    <!-- 跳转页码输入框 -->
     到第<input value="${param.pageNo}" name="pn" id="pn_input"/>页
     <input id="searchPageBtn" type="button" value="确定">
 
+    <!-- 跳转页码的JavaScript脚本 -->
     <script type="text/javascript">
         $(function () {
+            // 点击“确定”按钮时触发跳转
             $("#searchPageBtn").click(function () {
-                var pageNo = $("#pn_input").val()
-                var pageTotal = ${requestScope.page.pageTotal}
-                if(pageNo<1) pageNo=1
-                if(pageNo>pageTotal) pageNo=pageTotal
-                location.href="${requestScope.basePath}${requestScope.page.url}&pageNo="+pageNo;
+                // 获取用户输入的页码
+                var pageNo = $("#pn_input").val();
+                // 获取总页数
+                var pageTotal = ${requestScope.page.pageTotal};
+
+                // 校验页码范围
+                if (pageNo < 1) pageNo = 1;
+                if (pageNo > pageTotal) pageNo = pageTotal;
+
+                // 跳转到指定页码
+                location.href = "${requestScope.basePath}${requestScope.page.url}&pageNo=" + pageNo;
             });
         });
     </script>

web/pages/manager/book_edit.jsp

@@ -2,59 +2,74 @@
 <!DOCTYPE html>
 <html>
 <head>
-<meta charset="UTF-8">
-<title>编辑图书</title>
+	<meta charset="UTF-8">
+	<title>编辑图书</title>
 	<%@include file="/pages/common/header.jsp"%>
-<style type="text/css">
-	h1 {
-		text-align: center;
-		margin-top: 200px;
-	}
-	
-	h1 a {
-		color:red;
-	}
-	
-	input {
-		text-align: center;
-	}
-</style>
+	<style type="text/css">
+		h1 {
+			text-align: center;
+			margin-top: 200px;
+		}
+
+		h1 a {
+			color:red;
+		}
+
+		input {
+			text-align: center;
+		}
+	</style>
 </head>
 <body>
-		<div id="header">
-			<img class="logo_img" alt="" src="static/img/logo1.jpg" >
-			<span class="wel_word">编辑图书</span>
-			<%@include file="/pages/common/manager_menu.jsp"%>
-		</div>
-		
-		<div id="main">
-			<form action="manager/bookServlet" method="post">
-				<input type="hidden" name="pageNo" value="${param.pageNo}">
-				<input type="hidden" name="action" value="${empty param.id ? "add":"update"}"/>
-				<input type="hidden" name="id" value="${requestScope.book.id}"/>
-				<table>
-					<tr>
-						<td>名称</td>
-						<td>价格</td>
-						<td>作者</td>
-						<td>销量</td>
-						<td>库存</td>
-						<td colspan="2">操作</td>
-					</tr>		
-					<tr>
-						<td><input name="name" type="text" value="${requestScope.book.name}"/></td>
-						<td><input name="price" type="text" value="${requestScope.book.price}"/></td>
-						<td><input name="author" type="text" value="${requestScope.book.author}"/></td>
-						<td><input name="sales" type="text" value="${requestScope.book.sales}"/></td>
-						<td><input name="stock" type="text" value="${requestScope.book.stock}"/></td>
-						<td><input type="submit" value="提交"/></td>
-					</tr>	
-				</table>
-			</form>
-			
-	
-		</div>
-
-		<%@include file="/pages/common/footer.jsp"%>
+<div id="header">
+	<img class="logo_img" alt="" src="static/img/logo1.jpg" >
+	<span class="wel_word">编辑图书</span>
+	<%@include file="/pages/common/manager_menu.jsp"%>
+</div>
+
+<div id="main">
+	<form action="manager/bookServlet" method="post">
+		<!-- 隐藏域，用于传递当前页码 -->
+		<input type="hidden" name="pageNo" value="${param.pageNo}">
+
+		<!-- 隐藏域，用于判断是添加还是更新操作 -->
+		<input type="hidden" name="action" value="${empty param.id ? "add":"update"}"/>
+
+		<!-- 隐藏域，用于传递图书ID -->
+		<input type="hidden" name="id" value="${requestScope.book.id}"/>
+
+		<table>
+			<tr>
+				<td>名称</td>
+				<td>价格</td>
+				<td>作者</td>
+				<td>销量</td>
+				<td>库存</td>
+				<td colspan="2">操作</td>
+			</tr>
+			<tr>
+				<!-- 图书名称输入框 -->
+				<td><input name="name" type="text" value="${requestScope.book.name}"/></td>
+
+				<!-- 图书价格输入框 -->
+				<td><input name="price" type="text" value="${requestScope.book.price}"/></td>
+
+				<!-- 图书作者输入框 -->
+				<td><input name="author" type="text" value="${requestScope.book.author}"/></td>
+
+				<!-- 图书销量输入框 -->
+				<td><input name="sales" type="text" value="${requestScope.book.sales}"/></td>
+
+				<!-- 图书库存输入框 -->
+				<td><input name="stock" type="text" value="${requestScope.book.stock}"/></td>
+
+				<!-- 提交按钮 -->
+				<td><input type="submit" value="提交"/></td>
+			</tr>
+		</table>
+	</form>
+</div>
+
+<%@include file="/pages/common/footer.jsp"%>
 </body>
 </html>