基于Flask和Shelve的简易留言板开发实战
2025-07-01 06:05:28作者:魏侃纯Zoe
本文将详细介绍如何使用Python的Flask框架结合Shelve模块开发一个简易留言板系统。这个项目虽然简单,但涵盖了Web开发中的多个核心概念,非常适合初学者学习。
项目概述
这个留言板系统主要实现以下功能:
- 用户可以通过表单提交留言
- 系统会保存所有留言记录
- 留言按时间倒序排列显示
- 支持多行留言显示
- 提供美观的界面展示
技术栈选择
Flask框架
Flask是一个轻量级的Python Web框架,它简单易用但功能强大,非常适合快速开发小型Web应用。在本项目中,我们使用Flask处理HTTP请求、路由和模板渲染。
Shelve模块
Shelve是Python标准库中的一个简单持久化存储方案,它基于dbm模块,可以将Python对象序列化存储到文件中。相比数据库,Shelve更加轻量,适合小型应用的数据存储需求。
核心代码解析
应用初始化
application = Flask(__name__)
DATA_FILE = 'message.dat'
这里我们创建了Flask应用实例,并定义了数据存储文件名。
数据存储功能
def save_data(name, comment, create_at):
database = shelve.open(DATA_FILE)
if 'greeting_list' not in database:
greeting_list=[]
else:
greeting_list=database['greeting_list']
greeting_list.insert(0,{
'name':name,
'comment':comment,
'create_at':create_at,
})
database['greeting_list'] = greeting_list
database.close()
save_data
函数负责将留言数据保存到Shelve文件中。这里有几个关键点:
- 使用
shelve.open
打开数据文件 - 检查是否存在留言列表,不存在则初始化
- 将新留言插入到列表开头(实现最新留言显示在最前面)
- 更新并关闭数据库
数据加载功能
def load_data():
database = shelve.open(DATA_FILE)
greeting_list = database.get('greeting_list',[])
database.close()
return greeting_list
load_data
函数从Shelve文件中读取所有留言数据,如果文件不存在或没有数据,则返回空列表。
路由处理
@application.route('/')
def index():
greeting_list = load_data()
return render_template('index.html',greeting_list=greeting_list)
@application.route('/post',methods=['POST'])
def post():
name = request.form.get('name')
comment = request.form.get('comments')
create_at = datetime.now()
save_data(name, comment, create_at)
return redirect('/')
这里定义了两个路由:
- 根路由
/
:显示留言板首页,加载并显示所有留言 /post
路由:处理表单提交,保存留言后重定向到首页
模板过滤器
@application.template_filter('nl2br')
def nl2br_filters(s):
return escape(s).replace('\n', Markup('</br>'))
@application.template_filter('datetime_fmt')
def datetime_fmt_filter(dt):
return dt.strftime('%Y/%m/%d %H:%M:%S')
定义了两个模板过滤器:
nl2br
:将换行符转换为HTML的<br>
标签,解决多行留言显示问题datetime_fmt
:格式化日期时间显示
前端实现
HTML模板
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Message Board</title>
<link rel="stylesheet" href="../static/main.css">
</head>
<body>
<div id="main">
<h1>Message Board</h1>
<div id="form-area">
<p>please comment here:</p>
<form action="/post" method="POST">
<!-- 表单内容 -->
</form>
</div>
<div id="entries-area">
<h2>the comments history</h2>
<div class="entry">
{% for greeting in greeting_list %}
<h3>{{ greeting.name }} commented at {{ greeting.create_at|datetime_fmt }}</h3>
<p>{{ greeting.comment|nl2br }}</p>
{% endfor %}
</div>
</div>
</div>
</body>
</html>
模板使用了Jinja2语法,主要特点:
- 循环显示所有留言
- 使用自定义过滤器格式化时间和留言内容
- 包含表单用于提交新留言
CSS样式
body {
margin:0;
padding: 0;
color: #000E41;
background-color: #004080;
}
#form-area {
padding: 0.5em 2em;
background-color: #78B8F8;
}
#entries-area {
padding: 0.5em 2em;
background-color: #FFFFFF;
}
.entry p {
padding: 0.5em 1em;
background-color: #DBDBFF;
}
CSS样式表定义了留言板的整体外观,包括:
- 页面背景色
- 表单区域样式
- 留言显示区域样式
- 单个留言的样式
项目结构
完整的项目结构如下:
.
├── message.dat.db # Shelve数据文件
├── message_board.py # 主程序文件
├── static
│ └── main.css # 样式表文件
└── templates
└── index.html # HTML模板文件
运行与测试
启动服务
python message_board.py
服务默认运行在127.0.0.1:8000,开启debug模式方便开发调试。
测试留言
可以通过以下方式测试留言功能:
- 直接在网页表单提交
- 使用Python交互式环境导入数据:
import datetime
from message_board import save_data, load_data
# 添加测试留言
save_data('test', 'test_comment', datetime.datetime.now())
# 查看所有留言
print(load_data())
总结
这个简易留言板项目虽然功能简单,但涵盖了Web开发的多个重要方面:
- 后端路由处理
- 数据存储与读取
- 前端模板渲染
- 表单提交处理
- 简单的样式设计
对于初学者来说,这是一个很好的练手项目,可以在此基础上扩展更多功能,如:
- 用户认证
- 留言分页
- 留言编辑和删除
- 更复杂的数据验证
- 使用真正的数据库替代Shelve
通过这个项目,开发者可以快速掌握Flask框架的基本使用方法和Web开发的基本流程。
登录后查看全文
热门项目推荐
- DDeepSeek-V3.1-BaseDeepSeek-V3.1 是一款支持思考模式与非思考模式的混合模型Python00
- QQwen-Image-Edit基于200亿参数Qwen-Image构建,Qwen-Image-Edit实现精准文本渲染与图像编辑,融合语义与外观控制能力Jinja00
GitCode-文心大模型-智源研究院AI应用开发大赛
GitCode&文心大模型&智源研究院强强联合,发起的AI应用开发大赛;总奖池8W,单人最高可得价值3W奖励。快来参加吧~050CommonUtilLibrary
快速开发工具类收集,史上最全的开发工具类,欢迎Follow、Fork、StarJava04GitCode百大开源项目
GitCode百大计划旨在表彰GitCode平台上积极推动项目社区化,拥有广泛影响力的G-Star项目,入选项目不仅代表了GitCode开源生态的蓬勃发展,也反映了当下开源行业的发展趋势。06GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00openHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!C0302- WWan2.2-S2V-14B【Wan2.2 全新发布|更强画质,更快生成】新一代视频生成模型 Wan2.2,创新采用MoE架构,实现电影级美学与复杂运动控制,支持720P高清文本/图像生成视频,消费级显卡即可流畅运行,性能达业界领先水平Python00
- GGLM-4.5-AirGLM-4.5 系列模型是专为智能体设计的基础模型。GLM-4.5拥有 3550 亿总参数量,其中 320 亿活跃参数;GLM-4.5-Air采用更紧凑的设计,拥有 1060 亿总参数量,其中 120 亿活跃参数。GLM-4.5模型统一了推理、编码和智能体能力,以满足智能体应用的复杂需求Jinja00
Yi-Coder
Yi Coder 编程模型,小而强大的编程助手HTML013
热门内容推荐
最新内容推荐
项目优选
收起

React Native鸿蒙化仓库
C++
177
262

🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
864
512

🔥🔥🔥ShopXO企业级免费开源商城系统,可视化DIY拖拽装修、包含PC、H5、多端小程序(微信+支付宝+百度+头条&抖音+QQ+快手)、APP、多仓库、多商户、多门店、IM客服、进销存,遵循MIT开源协议发布、基于ThinkPHP8框架研发
JavaScript
93
15

openGauss kernel ~ openGauss is an open source relational database management system
C++
129
182

旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
261
302

deepin linux kernel
C
22
5

🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端
TypeScript
596
57

为仓颉编程语言开发者打造活跃、开放、高质量的社区环境
Markdown
1.07 K
0

本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
398
371

本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
332
1.08 K