蓝本介绍

此部分文档主要介绍顶点云 Web 服务器中的两个蓝本: main 以及 auth ,以及如何创建新的自定义蓝本。

Auth 蓝本

此蓝本主要用于授权用户,如注册、登录、重置密码等。蓝本位于 web/app/auth 目录下,结构为:

- auth
  - __init__.py
  - forms.py
  - views.py

上面三个文件中, __init__.py 用于初始化蓝本 Auth,forms.py 定义了 Auth 蓝本视图函数需要使用的表单类,views.py 具体处理转发给 Auth 蓝本的请求。

下面简单介绍 forms.py 中提供的表单,对于 views.py 中的视图函数,请查阅 Auth 蓝本视图函数

forms.py 提供了如下表单:

  • LoginForm :用户登录界面填写的表单
  • RegistrationForm :用户注册界面填写的表单,顶点云默认关闭了注册接口,你需要参考 扩展自定义功能 来开启此接口
  • ChangePasswordForm :用户修改密码时填写的表单
  • ChangeEmailForm :用户修改邮箱时填写的表单
  • PasswordResetForm :用户重置密码时填写的表单
  • PasswordResetRequestForm :用户申请重置密码时填写的表单

Main 蓝本

此蓝本主要用于处理用户服务请求。蓝本位于 web/app/main 目录下,结构为:

- main
  - __init__.py
  - forms.py
  - views.py
  - errors.py

上面三个文件中, __init__.py 用于初始化蓝本 Main,forms.py 定义了 Main 蓝本视图函数需要使用的表单类,views.py 具体处理转发给 Main 蓝本的请求,errors.py 处理用户遇到的错误并使用服务器模板渲染错误界面。

下面简单介绍 forms.py 中提供的表单,对于 views.py 中的视图函数,请查阅 Main 蓝本视图函数

forms.py 提供了如下表单:

  • EditProfileForm :用户编辑个人资料界面填写的表单
  • EditProfileAdminForm :管理员编辑其他用户个人资料界面填写的表单
  • UploadForm :用户上传文件时填写的表单
  • CommentForm :用户评论文件时填写的表单
  • SearchForm :用户搜索文件时填写的表单
  • FileDeleteConfirmForm :用户确认删除文件时填写的表单
  • ChatForm :用户聊天界面的对话框
  • SetShareForm :用户设置文件共享和提取码时填写的表单
  • ConfirmShareForm :用户对其他用户的共享文件执行 Fork、下载等操作前填写提取码的表单
  • NewFolderForm :用户创建新文件夹时填写的表单

自定义蓝本

关于蓝本的概念不属于本文档讨论范围,如果您尚不了解,可以参考 Flask 文档中关于蓝本的部分

对于顶点云,如果您需要添加自定义蓝本,请在目录 web/app 下创建新的蓝本目录并添加您的自定义路由。

接下来请您阅读 模型介绍