flask-使用SQLAlchemy对博客文章进行分页

最新推荐文章于 2024-07-15 21:02:11 发布

yy19890521

最新推荐文章于 2024-07-15 21:02:11 发布

阅读量615

点赞数

分类专栏： flask

flask 专栏收录该内容

26 篇文章 1 订阅

订阅专栏

我们在浏览某个博客网站时，如果博客文章过多，往往都进行了分页显示，比如CSDN中个人博客的首页显示。在flask中SQLAlchemy不但可以进行数据建模和数据查询等等，由于其支持分页查询，我们还可以利用其对我们的文章进行分页。

一、创建博客数据模型

在介绍使用SQLAlchemy对博客进行分页之前，我们需要先创建博客的数据模型，并向数据库中插入试验用的博客的数据。我们将博客的数据模型定义如下：

class Post(db.Model):
__tablename__='posts'
id=db.Column(db.Integer,primary_key=True)
body=db.Column(db.Text)
timestamp=db.Column(db.DateTime,index=True,default=datetime.utcnow)

博客的数据表中只含有3个字段：博客id、博客内容和时间戳，定义完成之后，我们向数据库中插入两个Post对象，以此作为试验数据：

二、定义视图函数，利用SQLAlchemy进行分页查询

@main.route('/',methods=['GET','POST'])
def index():
page=request.args.get('page',1,type=int)
pagination=Post.query.paginate(page,per_page=1,error_out=False)
posts=pagination.items
return render_template('index.html',posts=posts,pagination=pagination)

通过request.args.get我们可以获取一个url所带的参数，比如 http://localhost:5000/?page=1 携带参数page，值为1。request.args.get('page',1,type=int)的意思是从request的参数中获取参数page的值，如果参数不存在那么返回默认值1，type=int保证返回的默认值是整形数字。

SQLAlchemy中查询对象query的paginate方法返回一个分页对象pagination，Post.query.pagination(page，per_page=1,error_out=False)中第一个参数表示我们要查询的页数，这里用了上面获取的url的参数；第二个参数是每页显示的数量，我们这里设置成了1，如果不设置默认显示20条；第3个参数如果设置成True，当请求的页数超过了总的页数范围，就会返回一个404错误，如果设为False，就会返回一个空列表。

通过上面的分页，如果我们简单在index.html进行如下设置，就可以实现根据不同参数的url显示不同的博客文章：

index.html：

{% for post in posts %}
{{ post.body }}
{% endfor %}

url：http://localhost:5000/?page=1

url：http://localhost:5000/?page=2

三、添加分页导航

上面只是简单根据不同的url参数显示不同的博客文章，在实际应用时我们还需要给分页添加分页导航。paginate()方法返回的Pagination类对象包含很多属性和方法，我们可以利用它的属性和方法实现分页导航。它的属性和方法如下：

属性	说明
items	当前页面的记录
query	分页的源查询
page	当前的页数
prev_num	上一页数
next_num	下一页数
has_prev	是否有上一页
has_next	是否有下一页
pages	总的页数
per_page	每页显示的记录条数
total	总的记录条数

方法	说明
iter_pages (left_edge=2, left_current=2,right_current=5,right_age=2)	一个迭代器，返回选中当前页时显示的页数列表。如这个例子中最左边显示2个页数，当前页的左边显示2个页数，当前页的右边显示5个页数而当前页的最右边显示2个页数
prev()	上一页的分页对象
next()	下一页的分页对象

使用上面的属性和方法，我们可以修改index.html文件，对当前的博客列表实现分页导航：

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<style type="text/css">
#menu {
font:12px verdana, arial, sans-serif; /* 设置文字大小和字体样式 */
}
#menu, #menu li {
list-style:none; /* 将默认的列表符号去掉 */
padding:0; /* 将默认的内边距去掉 */
margin:0; /* 将默认的外边距去掉 */
}
</style>
<style type="text/css">
#menu li {
float:left; /* 往左浮动 */
}
</style>
<style type="text/css">
#menu li a {
display:block; /* 将链接设为块级元素 */
padding:8px 50px; /* 设置内边距 */
background:#3A4953; /* 设置背景色 */
color:#fff; /* 设置文字颜色 */
text-decoration:none; /* 去掉下划线 */
border-right:1px solid #000; /* 在左侧加上分隔线 */
}
</style>
<title></title>
</head>
<body>
{% for post in posts %}
{{ post.body }}
{% endfor %}
<ul id="menu">
<li>
<a href="{% if pagination.has_prev %}{{url_for('.index',page=pagination.page-1)}}{% else %}#{% endif %}" >«</a>
</li>
{% for p in pagination.iter_pages() %}
<li>
<a href="{{ url_for('.index',page=p)}}">{{p}}</a>
</li>
{% endfor %}
<li>
<a href="{%if pagination.has_next %}{{url_for('.index',page=pagination.page+1)}}{% else %}#{% endif %}" >»</a>
</li>
</ul>
</body>
</html>

我们重点关注li标签中针对pagination的操作，首先根据当前的pagination是否有上一页对a标签进行了不同href的赋值，创建出<<的超链接；与之对应的是在最后根据当前pagination是否有下一页而再次对a标签赋予不同的url，创建出>>超链接；中间调用pagination的迭代器iter_pages()，便利每个分页对象，在以每个分页对象定义不同的超链接。

实现的效果如下：