Flask 学习笔记 分页

今天开始是对Flask中分页的学习，以下是视图函数的代码：

@main.route('/',methods=['GET','POST'])
def index():
    form = PostForm()
    if form.validate_on_submit() and current_user.can(Permission.WRITE_ARTICLES):
        post = Post(body=form.body.data,author=current_user._get_current_object())
        db.session.add(post)
        return redirect(url_for('main.index'))
    page = request.args.get('page',1,type=int)
    pagination = Post.query.order_by(Post.timestamp.desc()).paginate(page,
                                                                     per_page=15,
                                                                     error_out=False)
    posts = pagination.items
    return render_template('index.html',form=form,posts=posts,pagination=pagination)

首先是之前主页渲染发表博客的部分，从
page = request.args.get('page',1,type=int)
开始，是分页的内容。
该语句中，request.args.get() 函数中，第一个参数为page，代表页码。
一开始看到这里的时候其实我是很不理解的。这个‘page’是从哪来的呢？
后来我明白了，在访问某个页码代表的网页时，需要的url为

http://127.0.0.1:5000/?page=1

这里的page便是刚刚函数中的第一个参数。
而第二个参数为默认值，当对首页进行访问的时候默认显示第二个参数所代表的页。

由于第三个参数中要求page的类型为整数，所以当我们输出类似于：

http://127.0.0.1:5000/?page=3.5

这样page为非整数的url时，不满足type=int，所以页面会自动返回默认值所代表的那一页。

探讨完了request，再说一下paginate()函数。对于

Post.query.order_by(Post.timestamp.desc()).paginate(page,
                                                                     per_page=15,
                                                                     error_out=False)

来说，前半段是将所有的博文按照时间戳降序排列，后半段的paginate()
函数中，第一个参数page是必须的参数，我们可以这样理解：以上的这段代码返回了一个Paginate()对象，该对象有以下属性：

其中page是方法的第一个参数，也是唯一必需的参数，代表了对象的页数。

per_page则是每页的记录，error_out负责在页码超出范围之后进行报错。

接下来就是比较核心的，也是不那么易懂的部分了。

我们需要在jinja2模板中写一个宏(macro)，个人理解的话，宏在jinja2模板中的作用与函数在程序语言当中的作用十分类似，都有输入输出，然后都是将整体程序模块化的工具。

下面是分页宏的jinja2模板源码：

{% macro pagination_widget(pagination,endpoint) %}
<ul class="pagination">
<li {% if not pagination.has_prev %} class="disabled"{% endif %}>
        <a