From 6a6dbc1db6b33c72659b0f57da66a7a7de37e08b Mon Sep 17 00:00:00 2001
From: pg6fnlak2 <306317677@qq.com>
Date: Sun, 9 Nov 2025 16:41:32 +0800
Subject: [PATCH] Update blogapi.py

---
 .../servermanager/api/blogapi.py              | 45 +++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/src/DjangoBlog-master/servermanager/api/blogapi.py b/src/DjangoBlog-master/servermanager/api/blogapi.py
index 8a4d6ac..4e8bfaf 100644
--- a/src/DjangoBlog-master/servermanager/api/blogapi.py
+++ b/src/DjangoBlog-master/servermanager/api/blogapi.py
@@ -1,27 +1,72 @@
+from haystack.query import SearchQuerySet
+#hz代码注释
+
 from haystack.query import SearchQuerySet
 
 from blog.models import Article, Category
 
 
 class BlogApi:
+    """
+    博客API类，提供文章搜索、分类获取等相关功能
+    
+    Attributes:
+        searchqueryset (SearchQuerySet): 搜索查询集对象
+        __max_takecount__ (int): 最大返回记录数，默认为8
+    """
     def __init__(self):
+        """
+        初始化BlogApi实例
+        """
         self.searchqueryset = SearchQuerySet()
         self.searchqueryset.auto_query('')
         self.__max_takecount__ = 8
 
     def search_articles(self, query):
+        """
+        根据查询关键字搜索文章
+        
+        Args:
+            query (str): 搜索关键字
+            
+        Returns:
+            list: 匹配的文章列表，最多返回__max_takecount__条记录
+        """
         sqs = self.searchqueryset.auto_query(query)
         sqs = sqs.load_all()
         return sqs[:self.__max_takecount__]
 
     def get_category_lists(self):
+        """
+        获取所有文章分类列表
+        
+        Returns:
+            QuerySet: 所有分类对象的查询集
+        """
         return Category.objects.all()
 
     def get_category_articles(self, categoryname):
+        """
+        根据分类名称获取该分类下的文章列表
+        
+        Args:
+            categoryname (str): 分类名称
+            
+        Returns:
+            QuerySet or None: 指定分类下的文章查询集，最多返回__max_takecount__条记录，
+                             如果没有找到相关文章则返回None
+        """
         articles = Article.objects.filter(category__name=categoryname)
         if articles:
             return articles[:self.__max_takecount__]
         return None
 
     def get_recent_articles(self):
+        """
+        获取最近发布的文章列表
+        
+        Returns:
+            QuerySet: 最近发布的文章查询集，最多返回__max_takecount__条记录
+        """
         return Article.objects.all()[:self.__max_takecount__]
+