FLY的狐狸

GoFrame 基础教程 - Go 语言 Web 开发快速入门

Thu, 11 Sep 2025 00:00:00 GMT

GoFrame 基础教程 - Go 语言 Web 开发快速入门

GoFrame 是一款 Go 语言开发的模块化、高性能 Web 开发框架，提供了丰富的功能模块和工具，帮助开发者快速构建 Web 应用。

一、GoFrame 简介

GoFrame 提供了完整的 Web 开发解决方案，包括：

Web 服务：HTTP 服务器、路由、中间件
请求与响应：参数解析、数据验证、响应格式化
配置管理：多环境配置、热加载
日志管理：结构化日志、日志级别控制
数据库：MySQL、PostgreSQL 等关系型数据库支持
缓存：Redis 连接与操作
工具库：字符串处理、JSON 解析、类型转换等

二、环境搭建

安装 Go

确保已安装 Go 1.18+ 版本：

go version

创建项目

mkdir myapp
cd myapp
go mod init myapp

安装 GoFrame

go get github.com/gogf/gf/v2

三、Web 服务介绍

基础 HTTP 服务器

package main

import (
    "github.com/gogf/gf/v2/frame/g"
    "github.com/gogf/gf/v2/os/gctx"
)

func main() {
    s := g.Server()
    s.BindHandler("/", func(r *g.Request) {
        r.Response.Write("Hello World!")
    })
    s.Run()
}

路由注册

GoFrame 支持多种路由注册方式：

// 基础路由
s.BindHandler("/user", GetUser)

// RESTful 风格
s.BindHandler("GET:/user/list", ListUsers)
s.BindHandler("POST:/user/create", CreateUser)
s.BindHandler("PUT:/user/update", UpdateUser)
s.BindHandler("DELETE:/user/delete", DeleteUser)

// 带参数路由
s.BindHandler("/user/:id", GetUserByID)
s.BindHandler("/article/{category}/{id}", GetArticle)

四、请求与响应

获取请求参数

func Handler(r *g.Request) {
    // 获取查询参数
    id := r.Get("id").Int()
    name := r.Get("name").String()
    
    // 获取 POST 参数
    data := r.Parse()
    
    // 获取 JSON 请求体
    var user User
    r.Parse(&user)
}

响应数据

func Handler(r *g.Request) {
    // JSON 响应
    r.Response.WriteJson(g.Map{
        "code":    0,
        "message": "success",
        "data":    result,
    })
    
    // 重定向
    r.Response.Redirect("/new-path")
    
    // 设置 Header
    r.Response.Header().Set("Content-Type", "application/json")
}

五、中间件

中间件用于处理请求前后的通用逻辑，如认证、日志、CORS 等：

// 注册中间件
s.Use(CORS, Auth, Logger)

// 中间件函数
func CORS(r *g.Request) {
    r.Response.CORSDefault()
    r.ExitAll()
}

func Auth(r *g.Request) {
    token := r.Get("token").String()
    if !validateToken(token) {
        r.Response.WriteJson(g.Map{
            "code":    401,
            "message": "unauthorized",
        })
        r.ExitAll()
    }
    r.ExitAll()
}

六、配置管理

配置文件格式

GoFrame 支持多种配置文件格式（YAML、TOML、JSON、INI）：

# config.yaml
server:
  address: ":8080"
  serverRoot: "./public"

database:
  default:
    link: "mysql:user:pass@tcp(127.0.0.1:3306)/dbname"
    debug: true

redis:
  default:
    address: "127.0.0.1:6379"
    db: 0

读取配置

import "github.com/gogf/gf/v2/frame/g"

// 读取配置
address := g.Cfg().Get(context.Background(), "server.address").String()
dbLink := g.Cfg().Get(context.Background(), "database.default.link").String()

七、日志管理

import (
    "github.com/gogf/gf/v2/frame/g"
    "github.com/gogf/gf/v2/os/gctx"
)

func main() {
    ctx := gctx.New()
    
    // 不同级别日志
    g.Log().Info(ctx, "info message")
    g.Log().Debug(ctx, "debug message")
    g.Log().Warning(ctx, "warning message")
    g.Log().Error(ctx, "error message")
    
    // 带字段日志
    g.Log().Infof(ctx, "user %s logged in", username)
}

八、数据库操作

MySQL 连接

import (
    "github.com/gogf/gf/v2/database/gdb"
    "github.com/gogf/gf/v2/frame/g"
)

// 查询
func GetUser(id int) (*gdb.Record, error) {
    result, err := g.DB().Table("user").Where("id", id).One()
    if err != nil {
        return nil, err
    }
    return result, nil
}

// 插入
func InsertUser(data gdb.Map) (int64, error) {
    result, err := g.DB().Table("user").Data(data).Insert()
    if err != nil {
        return 0, err
    }
    return result.LastInsertId()
}

// 更新
func UpdateUser(id int, data gdb.Map) (int64, error) {
    result, err := g.DB().Table("user").Data(data).Where("id", id).Update()
    if err != nil {
        return 0, err
    }
    return result.RowsAffected()
}

// 删除
func DeleteUser(id int) (int64, error) {
    result, err := g.DB().Table("user").Where("id", id).Delete()
    if err != nil {
        return 0, err
    }
    return result.RowsAffected()
}

九、Redis 操作

import (
    "github.com/gogf/gf/v2/frame/g"
    "github.com/gogf/gf/v2/os/gctx"
)

func main() {
    ctx := gctx.New()
    
    // 设置
    g.Redis().Set(ctx, "key", "value")
    
    // 获取
    value, _ := g.Redis().Get(ctx, "key")
    
    // 删除
    g.Redis().Del(ctx, "key")
    
    // 哈希操作
    g.Redis().HSet(ctx, "user:1", "name", "John")
    g.Redis().HGet(ctx, "user:1", "name")
    
    // 列表操作
    g.Redis().LPush(ctx, "list", "item1", "item2")
    g.Redis().LRange(ctx, "list", 0, -1)
}

十、常用工具

GoFrame 提供了丰富的工具函数：

字符串处理 (gstr)

import "github.com/gogf/gf/v2/util/gstr"

// 包含判断
gstr.Contains("hello world", "world")

// 分割
gstr.Split("a,b,c", ",")

// 替换
gstr.Replace("hello world", "world", "Go")

// 大小写转换
gstr.ToLower("HELLO")
gstr.ToUpper("hello")

类型转换 (gconv)

import "github.com/gogf/gf/v2/util/gconv"

// 转换为字符串
gconv.String(123)

// 转换为整数
gconv.Int("456")

// 转换为浮点数
gconv.Float64("3.14")

// 转换为切片
gconv.Ints("1,2,3")

// 转换为 Map
gconv.Map(jsonStr)

JSON 处理 (gjson)

import "github.com/gogf/gf/v2/encoding/gjson"

// 解析 JSON
j, _ := gjson.DecodeToJson(jsonBytes)

// 获取值
name := j.Get("user.name").String()
age := j.Get("user.age").Int()

// 转换为 Map
data := j.Map()

并发 Map (gmap)

import "github.com/gogf/gf/v2/container/gmap"

// 创建线程安全 Map
m := gmap.New()

// 设置
m.Set("key", "value")

// 获取
value := m.Get("key")

// 删除
m.Remove("key")

MD5 加密

import "github.com/gogf/gf/v2/crypto/gmd5"

// MD5 加密
hash := gmd5.EncryptString("password")

十一、项目资源

代码仓库

GitHub: https://github.com/goflyfox/gfstudy
Gitee: https://gitee.com/goflyfox/gfstudy

教程目录

gfstudy 项目提供了完整的 GoFrame 基础教程：

GoFrame 介绍
GoFrame 环境搭建
GoFrame 的 Web 服务介绍
GoFrame 请求与响应
GoFrame 路由注册
GoFrame 中间件
GoFrame 的 HTTP 客户端
GoFrame 配置管理
GoFrame 日志管理
GoFrame 数据库
GoFrame Redis
GoFrame 常用工具

视频教程

Bilibili 教程：GoFrame 基础教程 - 快速入门

交流方式

QQ 交流群: 479196644

总结

GoFrame 作为一款成熟的 Go Web 框架，提供了从基础 HTTP 服务到数据库操作、缓存管理、日志记录等全方位的支持。通过模块化的设计和丰富的工具库，开发者可以快速搭建高性能的 Web 应用。

本文介绍了 GoFrame 的核心功能和使用方法，更多详细内容可以参考 gfstudy 项目的完整教程和示例代码。

GManager - 基于 GoFrame V2 的后台管理系统

Wed, 13 Aug 2025 00:00:00 GMT

项目简介

GManager 是一个基于 GoFrame V2 框架开发的后台管理系统。后端采用 Go 语言结合 GoFrame 框架，前端基于 Vue3 + Vite + TypeScript + Element-Plus 构建，是一个完整的前后端分离的管理平台解决方案。

核心特性

后端框架: GoFrame V2
前端技术栈: Vue3 + Vite + TypeScript + Element-Plus
认证方式: 使用 gtoken 支持集群部署
数据库: MySQL

功能模块

1. 部门管理

配置系统组织机构信息，支持多层级部门结构管理。

2. 用户管理

用户添加与配置
用户权限分配
帐号状态管理

3. 角色管理

角色菜单权限分配
支持菜单权限和按钮权限设置
灵活的角色权限配置

4. 菜单管理

配置系统菜单
按钮权限管理
动态菜单加载

5. 配置管理

系统参数动态配置
数据字典配置
运行时配置更新

6. 日志管理

登录日志记录
登出日志记录
业务增删改操作记录
操作审计追踪

7. 其他功能

用户登录/认证/登出
访问统计
权限验证

快速开始

环境要求

Go 1.18+
Node.js 20+
pnpm 9+
MySQL 5.7+
Hugo (可选，用于文档)

后端部署

1. 克隆项目

git clone https://github.com/goflyfox/gmanager
cd gmanager

2. 数据库配置

安装 MySQL 数据库并运行初始化脚本：

# 运行 SQL 脚本
mysql -u root -p < resource/sql/gmanager.sql

3. 配置文件

复制配置文件并修改数据库连接：

cd server
cp manifest/config/config.example.yaml manifest/config/config.yaml

编辑 config.yaml，修改数据库配置：

# 数据库配置
database:
  default:
    link: "mysql:root:123456@tcp(127.0.0.1:3306)/gmanager"

4. 启动后端服务

cd server
go mod tidy
go run main.go

访问 http://localhost:8000/ping 验证后端服务，返回 pong 表示部署成功。

前端部署

1. 安装依赖

cd web
pnpm install

2. 启动开发服务器

pnpm run dev

3. 访问系统

浏览器访问 http://localhost:3000，使用默认账号登录：

账号: admin
密码: 123456

项目结构

gmanager/
├── server/                 # 后端 Go 代码
│   ├── manifest/
│   │   └── config/        # 配置文件
│   ├── api/               # API 接口
│   ├── logic/             # 业务逻辑
│   └── model/             # 数据模型
├── web/                   # 前端 Vue3 代码
│   ├── src/
│   │   ├── api/          # API 调用
│   │   ├── components/   # 组件
│   │   ├── views/        # 页面
│   │   └── utils/        # 工具函数
└── resource/
    └── sql/              # 数据库脚本

技术亮点

1. GoFrame V2 框架

GoFrame 是一款模块化、高性能的 Go 语言开发框架，提供了丰富的基础组件和工具函数，大大提升了开发效率。

2. gtoken 认证

使用 gtoken 实现用户认证，支持集群部署，解决了分布式环境下的会话共享问题。

3. 前后端分离

后端: 提供 RESTful API 接口
前端: Vue3 + TypeScript 构建响应式界面
通信: Axios 进行 HTTP 通信

4. 权限管理

RBAC（基于角色的访问控制）模型
菜单权限和按钮权限双重控制
动态权限加载

演示地址

在线演示: https://gmanager.jflyfox.com/
演示账号: admin / 123456

项目地址

GitHub: https://github.com/goflyfox/gmanager
Gitee: https://gitee.com/goflyfox/gmanager

开源协议

本项目采用 Apache License 2.0 开源协议。

总结

GManager 是一个功能完善的后台管理系统，适合学习和实际项目使用。项目代码结构清晰，注释完善，非常适合学习 GoFrame 框架和 Vue3 开发。如果你正在寻找一个后台管理系统的起点，或者想学习 Go 语言全栈开发，GManager 是一个不错的选择。

参考资源

GToken 介绍 - 基于 GoFrame 的 Token 认证插件

Tue, 22 Jul 2025 00:00:00 GMT

什么是 GToken？

GToken 是一个基于 GoFrame 框架开发的 token 认证插件，通过服务端验证方式实现 token 认证。它已经完全可以支撑线上 token 认证，并通过 Redis 支持集群模式。

版本适配

GoFrame v2.X.X：使用 gtoken v2.x 版本
GoFrame v1.X.X：使用 gtoken v1.4.x 版本

GToken 的优势

相比传统的 JWT 方案，GToken 具有以下显著优势：

1. 支持服务端退出

有效的避免了 JWT 服务端无法退出问题。在 JWT 方案中，一旦令牌颁发，在过期前都无法主动使其失效，而 GToken 通过服务端存储，可以随时销毁令牌。

2. 令牌可作废

解决 JWT 无法作废已颁布的令牌，只能等到令牌过期问题。通过服务端存储，可以随时调用 Destroy 方法使令牌立即失效。

3. 高效的扩展信息存储

通过用户扩展信息存储在服务端，有效规避了 JWT 携带大量用户扩展信息导致降低传输效率问题。JWT 需要在每个请求的 token 中携带用户信息，而 GToken 只在服务端存储，客户端只保存 token 本身。

4. 自动续期

有效避免 JWT 需要客户端实现续签功能，增加客户端复杂度。GToken 支持服务端自动续期，客户端不需要关心续签逻辑。

// 通过 MaxRefresh 配置，默认当用户第五天访问时，自动续期
// 超时时间 默认 10 天
Timeout int
// 缓存刷新时间 默认为超时时间的一半
MaxRefresh int

特性说明

支持 token 认证：不强依赖于 session 和 cookie，适用 JWT 和 session 认证所有场景
多种缓存模式：支持单机 gcache 和集群 gredis 模式

// 缓存模式 1 gcache 2 gredis 3 fileCache
CacheMode = 2

安装

获取最新版本：

go get -u -v github.com/goflyfox/gtoken/v2

快速开始

1. 初始化配置

import (
    "github.com/goflyfox/gtoken/v2"
)

// 创建 gtoken 对象
gfToken := gtoken.NewDefaultToken(gtoken.Options{
    CacheMode:    2,              // 1 gcache 2 gredis 3 fileCache
    CachePreKey:  "GToken:",      // 缓存 key 前缀
    Timeout:      10 * 24 * 3600, // 超时时间 10 天（秒）
    MaxRefresh:   5 * 24 * 3600,  // 缓存刷新时间 5 天（秒）
    TokenDelimiter: "_",          // Token 分隔符
    EncryptKey:   "12345678912345678912345678912345", // Token 加密 key
    MultiLogin:   false,          // 是否支持多端登录
    AuthExcludePaths: []string{"/login", "/register"}, // 拦截排除地址
})

2. 注册认证中间件

s := ghttp.NewServer()
s.SetPort(8199)

s.Group("/", func(group *ghttp.RouterGroup) {
    group.Middleware(CORS)
    // 注册 GfToken 中间件
    group.Middleware(gtoken.NewDefaultMiddleware(gfToken).Auth)
    
    // 需要认证的路由
    group.ALL("/system/data", func(r *ghttp.Request) {
        // 获取登陆信息
        ctx := r.Context()
        userKey := r.GetCtxVar(gtoken.KeyUserKey).String()
        _, data, err := gfToken.Get(ctx, userKey)
        if err != nil {
            r.Response.WriteJson(g.Map{"code": 500, "msg": err.Error()})
            return
        }
        r.Response.WriteJson(g.Map{"code": 0, "data": data})
    })
    
    // 登出路由
    group.ALL("/user/logout", func(r *ghttp.Request) {
        ctx := r.Context()
        userKey := r.GetCtxVar(gtoken.KeyUserKey).String()
        _ = gfToken.Destroy(ctx, userKey)
        r.Response.WriteJson(g.Map{"code": 0, "msg": "user logout"})
    })
})

3. 登录生成 Token

s.BindHandler("/login", func(r *ghttp.Request) {
    ctx := r.Context()
    username := r.Get("username").String()
    password := r.Get("password").String()
    
    // 验证用户名密码（这里省略验证逻辑）
    if !validateUser(username, password) {
        r.Response.WriteJson(g.Map{"code": 401, "msg": "invalid credentials"})
        return
    }
    
    // 认证成功调用 Generate 生成 Token
    token, err := gfToken.Generate(ctx, username, "1")
    if err != nil {
        r.Response.WriteJson(g.Map{"code": 500, "msg": err.Error()})
        r.ExitAll()
        return
    }
    
    r.Response.WriteJson(g.Map{
        "code": 0,
        "data": g.Map{
            gtoken.KeyUserKey: username,
            gtoken.KeyToken:   token,
        },
    })
})

func validateUser(username, password string) bool {
    // 实现用户验证逻辑
    return true
}

配置项说明

名称	配置字段	说明
缓存模式	`CacheMode`	1 gcache 2 gredis 3 fileCache 默认 1
缓存 key	`CachePreKey`	默认缓存前缀 GToken:
超时时间	`Timeout`	默认 10 天（秒）
缓存刷新时间	`MaxRefresh`	默认为超时时间的一半（秒）
Token 分隔符	`TokenDelimiter`	默认 `_`
Token 加密 key	`EncryptKey`	默认 12345678912345678912345678912345
是否支持多端登录	`MultiLogin`	默认 false
拦截排除地址	`AuthExcludePaths`	此路径列表不进行认证
拦截返回函数	`ResFun`	认证失败返回函数，默认返回 Code：300

使用建议

由于中间件采用洋葱模型，注册 MiddlewareAuth 认证中间件时，建议放在：

在 MiddlewareCORS 之后：确保跨域处理优先
在用户权限 MiddlewareUserPermissions 认证之前：确保先认证再授权
在 Response 处理 MiddlewareHandlerResponse 之前：确保响应处理正确

s.Group("/", func(group *ghttp.RouterGroup) {
    group.Middleware(CORS)                    // 1. CORS 中间件
    group.Middleware(gtoken.NewDefaultMiddleware(gfToken).Auth) // 2. Token 认证
    group.Middleware(MiddlewareUserPermissions) // 3. 权限验证
    // ... 业务路由
})

项目扩展

GToken-JWT

如果需要短期 token 场景，可以使用 gtoken-jwt，这是基于 gtoken 的 JWT 扩展。

总结

GToken 是一个功能完善、适用于企业生产级的 token 认证插件。它通过服务端存储的方式，有效解决了 JWT 的多个痛点问题：

✅ 支持服务端主动退出
✅ 令牌可随时作废
✅ 高效的扩展信息存储
✅ 服务端自动续期
✅ 支持单机和集群模式

如果你的项目基于 GoFrame 框架，并且需要可靠的 token 认证方案，GToken 是一个值得考虑的选择。

参考资源

Gitee: https://gitee.com/goflyfox/gtoken
GitHub: https://github.com/goflyfox/gtoken
GoFrame: https://github.com/gogf/gf

Gostudy - Golang 基础教程快速入门

Tue, 13 Jun 2023 00:00:00 GMT

项目介绍

今天给大家推荐一个优质的 Go 语言学习资源：gostudy，这是一个 golang 基础教程项目，旨在帮助开发者快速入门 Go 语言。

项目地址

Gitee: https://gitee.com/goflyfox/gostudy
GitHub: https://github.com/goflyfox/gostudy
开源协议: Apache-2.0

教程内容

教程涵盖了 Go 语言的核心知识点，从入门到进阶，内容包括：

Go 语言介绍 - 语言特性、应用场景
安装部署 - 环境配置、第一个程序
开发工具 - Goland、VSCode 等工具介绍
Go Modules - 包管理工具使用
基础语法 - 变量、常量、控制结构
常用数据结构 - 数组、切片、Map
函数 - 函数定义、返回值、可变参数
指针与结构体 - 指针操作、结构体定义
接口 - 接口定义与实现
错误处理 - error 处理机制
协程与通道 - Goroutine、Channel、Select
常用工具函数 - 标准库常用函数

教程视频

项目提供了多个平台的视频教程，方便不同习惯的学习者：

平台	地址
腾讯课堂	golang 基础教程 - 快速入门 go 语言
Bilibili	golang 基础教程 - 快速入门 go 语言
西瓜视频	golang 基础教程 - 快速入门 go 语言

学习建议

1. 循序渐进

按照教程目录顺序学习，每个章节的源码都放在对应编号前缀的目录中：

gostudy/
├── 03.hello/          # Hello World 示例
├── 04.goland/         # Goland 配置
├── 05.modules/        # Go Modules 示例
├── 06.basic/          # 基础语法
├── 07.data/           # 数据结构
├── 08.func/           # 函数示例
├── 09.ptrAndStruct/   # 指针与结构体
├── 10.errors/         # 错误处理
├── 11.goRoutines/     # 协程示例
└── 12.tools/          # 常用工具

2. 动手实践

观看视频教程理解概念
下载源码本地运行
修改代码尝试不同场景
完成课后练习巩固知识

3. 参考文档

学习过程中可以参考官方文档：

项目特色

✨ 内容丰富: 涵盖 Go 语言核心知识点
🎯 快速入门: 适合零基础学习者
📺 视频教程: 多平台视频资源
💻 代码示例: 每个章节都有配套源码
📖 持续更新: 维护活跃的开源项目
👥 社区支持: QQ 交流群 47919644

适合人群

✅ 想学习 Go 语言的开发者
✅ 有其他语言基础想转 Go 的程序员
✅ 计算机相关专业学生
✅ 对后端开发感兴趣的初学者

总结

gostudy 是一个非常适合 Go 语言初学者的入门教程，内容系统全面，配有详细的视频教程和丰富的代码示例。无论你是零基础入门，还是有其他语言基础想学习 Go，这个教程都能帮助你快速上手。

推荐大家收藏学习，边看视频边动手实践，相信很快就能掌握 Go 语言的核心技能！

JFinal CMS - 基于 JFinal 的功能强大的信息咨询网站

Wed, 13 Apr 2022 00:00:00 GMT

JFinal CMS - 基于 JFinal 的功能强大的信息咨询网站

JFinal CMS 是一个使用 Java 开发的功能强大的信息咨询网站（CMS），采用了简洁强大的 JFinal 作为 Web 框架，模板引擎使用的是 Beetl，数据库采用 MySQL，前端使用 Bootstrap 框架。

项目简介

JFinal CMS 不仅是一个简单的内容管理系统，更是一个功能完善的企业级网站解决方案。它支持 OAuth2 认证、用户注册、密码加密、评论及回复、消息提示、网站访问量统计、文章评论数和浏览量统计等功能。

技术栈

Web 框架: JFinal - 简洁强大的 Java Web 框架
模板引擎: Beetl - 高性能 Java 模板引擎
数据库: MySQL - 关系型数据库
前端框架: Bootstrap - 响应式前端框架
认证方式: OAuth2、本地账号认证

核心功能

用户功能

OAuth2 认证: 支持第三方登录
账号注册: 用户自主注册功能
密码加密: 保障用户账号安全
多端登录: 支持多设备同时在线

内容管理

文章管理: 文章的增删改查、草稿、发布
评论系统: 支持文章评论及回复功能
消息通知: 实时消息提示
数据统计:
- 网站访问量统计
- 文章评论数统计
- 文章浏览量统计

后台管理模块

JFinal CMS 的后台管理功能非常丰富，包含以下模块：

内容管理

栏目管理: 网站栏目的创建、编辑、删除
栏目公告: 每个栏目的公告管理
栏目滚动图片: 栏目轮播图管理
文章管理: 文章内容管理、审核、发布
回复管理: 用户评论回复管理
意见反馈: 用户反馈收集与管理

多媒体管理

我的相册: 个人相册管理
相册管理: 系统相册分类管理
图片管理: 图片上传、分类、管理
专辑管理: 内容专辑管理
视频管理: 视频内容管理

系统管理

缓存更新: 系统缓存管理与更新
友情链接: 友情链接管理
访问统计: 网站访问数据统计分析
联系人管理: 联系人信息管理
模板管理: 网站模板管理
组织机构管理: 组织架构管理
用户管理: 系统用户管理
角色管理: 角色权限管理
菜单管理: 系统菜单配置
数据字典管理: 系统数据字典维护

项目特点

1. 简洁高效的架构

采用 JFinal 框架，遵循"简洁即强大"的设计理念，代码量少，易于理解和维护。

2. 高性能模板引擎

使用 Beetl 模板引擎，具有以下优势：

高性能：渲染速度快
易学易用：语法简洁
功能强大：支持自定义函数
错误提示友好

3. 响应式设计

前端采用 Bootstrap 框架，实现：

响应式布局，适配多种设备
丰富的 UI 组件
良好的用户体验

4. 完善的安全机制

密码加密存储
OAuth2 认证支持
权限管理
SQL 注入防护

5. 数据统计与分析

实时访问量统计
用户行为分析
内容热度统计

快速开始

环境要求

JDK 1.8+
MySQL 5.7+
Maven 3.6+
Tomcat 8.0+（或其他 Java Web 服务器）

项目结构

jfinal_cms/
├── src/
│   ├── main/
│   │   ├── java/          # Java 源代码
│   │   ├── resources/     # 配置文件
│   │   └── webapp/        # Web 资源
│   │       ├── WEB-INF/
│   │       │   └── view/  # Beetl 模板
│   │       ├── static/    # 静态资源
│   │       └── assets/    # 前端资源
│   └── test/              # 测试代码
├── pom.xml                # Maven 配置
└── README.md              # 项目说明

配置步骤

克隆项目

git clone https://gitee.com/jflyfox/jfinal_cms.git
cd jfinal_cms

创建数据库

CREATE DATABASE jfinal_cms DEFAULT CHARACTER SET utf8mb4;

导入 SQL 脚本

导入项目中的 SQL 初始化脚本到 MySQL 数据库。

修改配置

修改 src/main/resources/config.properties 配置文件：

# 数据库配置
db.url=jdbc:mysql://localhost:3306/jfinal_cms?useUnicode=true&characterEncoding=utf8
db.user=root
db.password=your_password

# 应用配置
app.name=JFinal CMS

运行项目

mvn clean package
# 部署到 Tomcat 或使用 IDE 运行

访问系统

打开浏览器访问：http://localhost:8080/jfinal_cms

功能演示

前台功能

首页展示
文章列表
文章详情
评论互动
用户中心

后台功能

仪表盘：数据统计概览
内容管理：栏目、文章、评论管理
用户管理：用户、角色、权限管理
系统管理：配置、字典、模板管理
多媒体管理：图片、视频、相册管理

技术亮点

1. JFinal 框架特性

// 简洁的 Controller 定义
public class ArticleController extends Controller {
    public void index() {
        List<Article> articles = Article.dao.find("select * from article");
        setAttr("articles", articles);
        render("article_list.html");
    }
    
    public void detail() {
        Integer id = getParaToInt();
        Article article = Article.dao.findById(id);
        setAttr("article", article);
        render("article_detail.html");
    }
}

2. Beetl 模板示例

<!DOCTYPE html>
<html>
<head>
    <title>${article.title}</title>
</head>
<body>
    <h1>${article.title}</h1>
    <div class="content">
        ${article.content}
    </div>
    
    <!-- 评论列表 -->
    <% for(comment in comments) { %>
        <div class="comment">
            <p>${comment.content}</p>
            <span>${comment.createTime}</span>
        </div>
    <% } %>
</body>
</html>

3. 数据库操作

// 使用 JFinal 的 ActiveRecord 插件
public class Article extends Model<Article> {
    public static final Article dao = new Article().dao();
    
    // 查询文章列表
    public List<Article> findLatest(int limit) {
        return find("select * from article order by create_time desc limit ?", limit);
    }
    
    // 增加浏览量
    public void incrementViews() {
        update("update article set views = views + 1 where id = ?", getId());
    }
}

部署说明

生产环境部署

打包项目

mvn clean package -DskipTests

部署到服务器

将生成的 WAR 包部署到 Tomcat 或其他 Web 服务器。

配置生产数据库

修改数据库连接配置，使用生产环境数据库。

配置域名和 SSL

配置 Nginx 反向代理和 HTTPS 证书。

Docker 部署

FROM tomcat:8.0-jre8
COPY target/jfinal_cms.war /usr/local/tomcat/webapps/
EXPOSE 8080
CMD ["catalina.sh", "run"]

项目优势

对比其他 CMS

特性	JFinal CMS	WordPress	Drupal
技术栈	Java	PHP	PHP
性能	高	中	中
学习曲线	中等	低	高
扩展性	强	强	强
企业级支持	是	是	是

适用场景

✅ 企业官网
✅ 资讯门户
✅ 博客系统
✅ 内容管理平台
✅ 信息发布系统

开发建议

1. 代码规范

遵循 Java 编码规范，保持代码整洁和可读性。

2. 性能优化

使用缓存减少数据库查询
静态资源使用 CDN 加速
数据库查询添加索引
启用 Gzip 压缩

3. 安全加固

定期更新依赖
使用 HTTPS
实施 CSRF 防护
定期备份数据

项目资源

代码仓库

Gitee: https://gitee.com/jflyfox/jfinal_cms
GitHub: https://github.com/jflyfox/jfinal_cms

交流方式

QQ 交流群: 479196644

总结

JFinal CMS 是一个功能完善、性能优秀的 Java CMS 系统。它采用简洁强大的 JFinal 框架，配合高性能的 Beetl 模板引擎和流行的 Bootstrap 前端框架，为企业和个人提供了一个优秀的网站建设解决方案。

无论是用于学习 Java Web 开发，还是用于实际的企业项目建设，JFinal CMS 都是一个值得考虑的选择。其丰富的功能模块、清晰的代码结构和完善的文档，都能帮助开发者快速上手并构建高质量的网站系统。