启动方式 Docker 启动：如果有 docker 环境，这种方式最为简便快速。使用 docker compose 可以一次性解决 JDK 环境、MySQL 数据库 和 程序部署 三个问题。具体请参考安装部署文档的“Docker启动”。 Jar 启动：需要预先安装 JDK 环境 和 MySQL 数...

UJCMS 是一款基于 Java 的企业级网站内容管理系统（Java CMS），采用 SpringBoot、MyBatis、Spring Security、Vue3、Vite、ElementPlus 等前沿技术开发，支持 无头 CMS 架构。 系统提供 模板 + 标签 和 Vue (React) + API 两种开发模式，适用于传统模板渲染...

访问统计用于记录网站的访问情况。由于系统可生成静态页面，而访问静态页面不经过程序，所以页面上必须增加相应的js代码，才能正确统计到网站的访问数据。 默认演示模板中自带有访问统计的js代码：/templates/1/default/_files/js/visit.js(源码为/src/main...

常用策略 自增主键 依赖数据库的功能，mysql、sqlserver有主键自增功能，oracle、db2则没有；postgresql可以将序列值设置成默认值，实现主键自增功能。 没有跨平台需求时，可以考虑使用。分库、分表时，不能使用。 数据库序列 依赖数据库的功能，mysql没有序...

每个Mapper接口对应一个mapper.xml文件，每个Mapper接口的方法，对一个mapper.xml文件的sql。 mapper.xml src/main/resource/com/ujcms/cms/ext/mapper/ExampleMapper.xml <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE ...

MyBatis使用Mapper接口操作数据库。 Mapper接口 com.ujcms.cms.ext.mapper.ExampleMapper @Mapper @Repository public interface ExampleMapper { /** * 插入数据 * * @param bean 实体对象 * @return 插入条数 */ int insert(Example bean); /** * 更新数...

实体类的主要作用是与数据库的表、字段相对应。一般来说，一个表对应一个实体类（Domain），一个字段对应一个属性。 数据库表结构改变，实体类就要做相应的改变。这部分工作是重复性的，一般由代码生成器代劳。修改表结构后，只要再次执行代码生成器，即可完...

代码生成器可以很大程度提高开发效率。特别是实体类（Domain）与Mapper.xml中实体类属性与数据库字段的对应关系，以及常用的insert、update语句，这些都是重复性工作，手动编写非常枯燥且容易出错。 MyBatisPlus的一个重要作用就是不用编写Mapper.xml。但如...

UJCMS使用Liquibase作为数据库表结构版本管理工具。 Liquibase文件目录：src/main/resources/db/changelog。 优缺点 通过Liquibase中立的描述语言，可以跨数据库平台创建表结构；并通过版本管理的方式，自动判断当前数据库表结构版本，自动更新表结构。免去...

后台使用前后端分离的方式开发，后台前端工程为ujcms-cp。 如项目不需要国际化功能，除日志模块外，其它国际化代码可以直接用中文代替。 路由 src/router/index.ts { path: 'example', name: 'ExampleList', component: () => import('@/views/interacti...

为了让用户更容易掌握二次开发方法，系统中专门提供了二次开发的示例代码。示例代码完整的演示了二次开发中的各个步骤，非常符合实际的开发工作。 建表语句 src/main/resources/db/changelog/db.changelog-8.0.yaml 其中示例表的建表内容如下： - changeSet...

访问量指的是每篇文章、每个栏目甚至每个站点的访问量。访问量与数据库中某一数据相对应，比如文章访问量和文章数据对应，栏目访问量和栏目数据对应，站点访问量和站点数据对应。 由于系统同时支持动态页访问和生成静态页访问，所以在页面中必须要加相应的代...

UJCMS前台的搜索使用的是Lucene全文检索，全文检索和数据库检索是两套不同的体系。 全文检索需要另外生成索引文件。全文索引文件保存在WEB-INF/lucene目录下。 正常情况下，录入、修改或删除文章时，除了会操作数据库，同时也会更新lucene的全文索引。因此，...

为更方便的查询数据库，UJCMS设计了查询解析器。要使用这个查询解析器，数据库表名、字段名必须符合一定的命名规范。同时代码生成器对数据库字段类型也有一定的要求。 以下规范皆为强制性要求，如有不符的地方，可能导致系统运行异常。 表名一律使用小写字母...

UJCMS采用前后端分离的开发模式，即后端提供API接口，前端(Vue)调用API接口。 前台网站除了以API提供接口外，还提供了传统的Freemarkder模板引擎生成页面的方式，有利于搜索引擎优化（SEO）。 后端主要技术栈： Spring Boot：提供开箱即用的Spring功能 Spri...

浏览器发起请求 在UJCMS搜索框中输入搜索关键字，点击搜索按钮，即可向服务器发起一个请求。 URL地址为：https://demo.ujcms.com/search?q=%E4%B8%AD%E5%9B%BD Controller 这个请求由程序的com.ujcms.cms.core.web.frontend.SearchController#search方法处理...

程序默认包含商业版功能的链接，但点击后会提示商业版功能。如希望关闭商业版功能，可以修改/src/main/resources/application.yaml文件中的ujcms.ep-display配置项改为false。 # 是否显示商业版功能。默认：true ujcms.ep-display: false

为了使MyBatis查询更加方便，UJCMS使用了查询解析器。相关代码的包名：com.ujcms.commons.query 单表查询 只检索本表字段。 # t.username_ like ? Like_username # t.price_ = ? EQ_price_Int Many-to-One 查询 # 符合规则的 # join ujcms_user user_ on t....