pbn32vpxk
/
tamguo
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

solved problem

Browse Source
后台运营yy
李宏杰 8 months ago
parent a524fc12c9 2152260c1f
commit 8375311bc4
65 changed files with 4212 additions and 1642 deletions
Show Stats Download Patch File Download Diff File

1
.idea/misc.xml
Unescape View File

@ -1,6 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<project version="4"> <project version="4">
<component name="ProjectRootManager" version="2" project-jdk-name="17 (2)" project-jdk-type="JavaSDK">
<output url="file://$PROJECT_DIR$/out" /> <output url="file://$PROJECT_DIR$/out" />
</component> </component>
</project> </project>

1
.idea/tamguo.iml
Unescape View File

@ -2,7 +2,6 @@
<module type="JAVA_MODULE" version="4"> <module type="JAVA_MODULE" version="4">
<component name="NewModuleRootManager" inherit-compiler-output="true"> <component name="NewModuleRootManager" inherit-compiler-output="true">
<exclude-output /> <exclude-output />
<content url="file://$MODULE_DIR$" />
<orderEntry type="inheritedJdk" /> <orderEntry type="inheritedJdk" />
<orderEntry type="sourceFolder" forTests="false" /> <orderEntry type="sourceFolder" forTests="false" />
</component> </component>

124
.idea/uiDesigner.xml
Unescape View File

@ -0,0 +1,124 @@
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
<component name="Palette2">
<group name="Swing">
<item class="com.intellij.uiDesigner.HSpacer" tooltip-text="Horizontal Spacer" icon="/com/intellij/uiDesigner/icons/hspacer.svg" removable="false" auto-create-binding="false" can-attach-label="false">
<default-constraints vsize-policy="1" hsize-policy="6" anchor="0" fill="1" />
</item>
<item class="com.intellij.uiDesigner.VSpacer" tooltip-text="Vertical Spacer" icon="/com/intellij/uiDesigner/icons/vspacer.svg" removable="false" auto-create-binding="false" can-attach-label="false">
<default-constraints vsize-policy="6" hsize-policy="1" anchor="0" fill="2" />
</item>
<item class="javax.swing.JPanel" icon="/com/intellij/uiDesigner/icons/panel.svg" removable="false" auto-create-binding="false" can-attach-label="false">
<default-constraints vsize-policy="3" hsize-policy="3" anchor="0" fill="3" />
</item>
<item class="javax.swing.JScrollPane" icon="/com/intellij/uiDesigner/icons/scrollPane.svg" removable="false" auto-create-binding="false" can-attach-label="true">
<default-constraints vsize-policy="7" hsize-policy="7" anchor="0" fill="3" />
</item>
<item class="javax.swing.JButton" icon="/com/intellij/uiDesigner/icons/button.svg" removable="false" auto-create-binding="true" can-attach-label="false">
<default-constraints vsize-policy="0" hsize-policy="3" anchor="0" fill="1" />
<initial-values>
<property name="text" value="Button" />
</initial-values>
</item>
<item class="javax.swing.JRadioButton" icon="/com/intellij/uiDesigner/icons/radioButton.svg" removable="false" auto-create-binding="true" can-attach-label="false">
<default-constraints vsize-policy="0" hsize-policy="3" anchor="8" fill="0" />
<initial-values>
<property name="text" value="RadioButton" />
</initial-values>
</item>
<item class="javax.swing.JCheckBox" icon="/com/intellij/uiDesigner/icons/checkBox.svg" removable="false" auto-create-binding="true" can-attach-label="false">
<default-constraints vsize-policy="0" hsize-policy="3" anchor="8" fill="0" />
<initial-values>
<property name="text" value="CheckBox" />
</initial-values>
</item>
<item class="javax.swing.JLabel" icon="/com/intellij/uiDesigner/icons/label.svg" removable="false" auto-create-binding="false" can-attach-label="false">
<default-constraints vsize-policy="0" hsize-policy="0" anchor="8" fill="0" />
<initial-values>
<property name="text" value="Label" />
</initial-values>
</item>
<item class="javax.swing.JTextField" icon="/com/intellij/uiDesigner/icons/textField.svg" removable="false" auto-create-binding="true" can-attach-label="true">
<default-constraints vsize-policy="0" hsize-policy="6" anchor="8" fill="1">
<preferred-size width="150" height="-1" />
</default-constraints>
</item>
<item class="javax.swing.JPasswordField" icon="/com/intellij/uiDesigner/icons/passwordField.svg" removable="false" auto-create-binding="true" can-attach-label="true">
<default-constraints vsize-policy="0" hsize-policy="6" anchor="8" fill="1">
<preferred-size width="150" height="-1" />
</default-constraints>
</item>
<item class="javax.swing.JFormattedTextField" icon="/com/intellij/uiDesigner/icons/formattedTextField.svg" removable="false" auto-create-binding="true" can-attach-label="true">
<default-constraints vsize-policy="0" hsize-policy="6" anchor="8" fill="1">
<preferred-size width="150" height="-1" />
</default-constraints>
</item>
<item class="javax.swing.JTextArea" icon="/com/intellij/uiDesigner/icons/textArea.svg" removable="false" auto-create-binding="true" can-attach-label="true">
<default-constraints vsize-policy="6" hsize-policy="6" anchor="0" fill="3">
<preferred-size width="150" height="50" />
</default-constraints>
</item>
<item class="javax.swing.JTextPane" icon="/com/intellij/uiDesigner/icons/textPane.svg" removable="false" auto-create-binding="true" can-attach-label="true">
<default-constraints vsize-policy="6" hsize-policy="6" anchor="0" fill="3">
<preferred-size width="150" height="50" />
</default-constraints>
</item>
<item class="javax.swing.JEditorPane" icon="/com/intellij/uiDesigner/icons/editorPane.svg" removable="false" auto-create-binding="true" can-attach-label="true">
<default-constraints vsize-policy="6" hsize-policy="6" anchor="0" fill="3">
<preferred-size width="150" height="50" />
</default-constraints>
</item>
<item class="javax.swing.JComboBox" icon="/com/intellij/uiDesigner/icons/comboBox.svg" removable="false" auto-create-binding="true" can-attach-label="true">
<default-constraints vsize-policy="0" hsize-policy="2" anchor="8" fill="1" />
</item>
<item class="javax.swing.JTable" icon="/com/intellij/uiDesigner/icons/table.svg" removable="false" auto-create-binding="true" can-attach-label="false">
<default-constraints vsize-policy="6" hsize-policy="6" anchor="0" fill="3">
<preferred-size width="150" height="50" />
</default-constraints>
</item>
<item class="javax.swing.JList" icon="/com/intellij/uiDesigner/icons/list.svg" removable="false" auto-create-binding="true" can-attach-label="false">
<default-constraints vsize-policy="6" hsize-policy="2" anchor="0" fill="3">
<preferred-size width="150" height="50" />
</default-constraints>
</item>
<item class="javax.swing.JTree" icon="/com/intellij/uiDesigner/icons/tree.svg" removable="false" auto-create-binding="true" can-attach-label="false">
<default-constraints vsize-policy="6" hsize-policy="6" anchor="0" fill="3">
<preferred-size width="150" height="50" />
</default-constraints>
</item>
<item class="javax.swing.JTabbedPane" icon="/com/intellij/uiDesigner/icons/tabbedPane.svg" removable="false" auto-create-binding="true" can-attach-label="false">
<default-constraints vsize-policy="3" hsize-policy="3" anchor="0" fill="3">
<preferred-size width="200" height="200" />
</default-constraints>
</item>
<item class="javax.swing.JSplitPane" icon="/com/intellij/uiDesigner/icons/splitPane.svg" removable="false" auto-create-binding="false" can-attach-label="false">
<default-constraints vsize-policy="3" hsize-policy="3" anchor="0" fill="3">
<preferred-size width="200" height="200" />
</default-constraints>
</item>
<item class="javax.swing.JSpinner" icon="/com/intellij/uiDesigner/icons/spinner.svg" removable="false" auto-create-binding="true" can-attach-label="true">
<default-constraints vsize-policy="0" hsize-policy="6" anchor="8" fill="1" />
</item>
<item class="javax.swing.JSlider" icon="/com/intellij/uiDesigner/icons/slider.svg" removable="false" auto-create-binding="true" can-attach-label="false">
<default-constraints vsize-policy="0" hsize-policy="6" anchor="8" fill="1" />
</item>
<item class="javax.swing.JSeparator" icon="/com/intellij/uiDesigner/icons/separator.svg" removable="false" auto-create-binding="false" can-attach-label="false">
<default-constraints vsize-policy="6" hsize-policy="6" anchor="0" fill="3" />
</item>
<item class="javax.swing.JProgressBar" icon="/com/intellij/uiDesigner/icons/progressbar.svg" removable="false" auto-create-binding="true" can-attach-label="false">
<default-constraints vsize-policy="0" hsize-policy="6" anchor="0" fill="1" />
</item>
<item class="javax.swing.JToolBar" icon="/com/intellij/uiDesigner/icons/toolbar.svg" removable="false" auto-create-binding="false" can-attach-label="false">
<default-constraints vsize-policy="0" hsize-policy="6" anchor="0" fill="1">
<preferred-size width="-1" height="20" />
</default-constraints>
</item>
<item class="javax.swing.JToolBar$Separator" icon="/com/intellij/uiDesigner/icons/toolbarSeparator.svg" removable="false" auto-create-binding="false" can-attach-label="false">
<default-constraints vsize-policy="0" hsize-policy="0" anchor="0" fill="1" />
</item>
<item class="javax.swing.JScrollBar" icon="/com/intellij/uiDesigner/icons/scrollbar.svg" removable="false" auto-create-binding="true" can-attach-label="false">
<default-constraints vsize-policy="6" hsize-policy="0" anchor="0" fill="2" />
</item>
</group>
</component>
</project>

15
tamguo-mms/src/main/java/com/tamguo/config/dao/MyMetaObjectHandler.java
Unescape View File

@ -8,15 +8,28 @@ import org.slf4j.LoggerFactory;
/** /**
* 注入公共字段自动填充,任选注入方式即可 * 注入公共字段自动填充,任选注入方式即可
*/ */
//@Component // 可以将 @Component 注释添加在这里，以将该类注册为 Spring 组件
public class MyMetaObjectHandler extends MetaObjectHandler { public class MyMetaObjectHandler extends MetaObjectHandler {
// 定义一个静态的日志记录器
protected final static Logger logger = LoggerFactory.getLogger(MyMetaObjectHandler.class); protected final static Logger logger = LoggerFactory.getLogger(MyMetaObjectHandler.class);
/**
* 在插入操作时进行字段填充的方法
*
* @param metaObject 元对象
*/
@Override @Override
public void insertFill(MetaObject metaObject) { public void insertFill(MetaObject metaObject) {
} }
/**
* 在更新操作时进行字段填充的方法
*
*
* @param metaObject 元对象
*/
@Override @Override
public void updateFill(MetaObject metaObject) { public void updateFill(MetaObject metaObject) {
} }

53
tamguo-mms/src/main/java/com/tamguo/config/dao/MybatisPlusConfig.java
Unescape View File

@ -19,50 +19,58 @@ import com.baomidou.mybatisplus.plugins.parser.tenant.TenantSqlParser;
import net.sf.jsqlparser.expression.Expression; import net.sf.jsqlparser.expression.Expression;
import net.sf.jsqlparser.expression.LongValue; import net.sf.jsqlparser.expression.LongValue;
@Configuration /**
@MapperScan("com.tamguo.modules.*.dao*") * MybatisPlusConfig 类，用于配置 Mybatis-Plus 的相关设置
*/
@Configuration // 表示这是一个配置类
@MapperScan("com.tamguo.modules.*.dao*") // 扫描指定包下的 Mapper 接口
public class MybatisPlusConfig { public class MybatisPlusConfig {
/**
* 创建 PerformanceInterceptor 实例的方法
* @return PerformanceInterceptor 性能拦截器实例
*/
@Bean @Bean
public PerformanceInterceptor performanceInterceptor() { public PerformanceInterceptor performanceInterceptor() {
return new PerformanceInterceptor(); return new PerformanceInterceptor(); // 创建并返回性能拦截器实例
} }
/** /**
* mybatis-plus分页插件<br> * 创建 PaginationInterceptor 分页拦截器实例的方法
* 文档：http://mp.baomidou.com<br> * @return PaginationInterceptor 分页拦截器实例
*/ */
@Bean @Bean
public PaginationInterceptor paginationInterceptor() { public PaginationInterceptor paginationInterceptor() {
PaginationInterceptor paginationInterceptor = new PaginationInterceptor(); PaginationInterceptor paginationInterceptor = new PaginationInterceptor(); // 创建分页拦截器实例
paginationInterceptor.setLocalPage(true); // 开启 PageHelper 的支持 paginationInterceptor.setLocalPage(true); // 开启 PageHelper 的支持
/* /*
* 【测试多租户】 SQL 解析处理拦截器<br> * 【测试多租户】SQL 解析处理拦截器相关设置
* 这里固定写成住户 1 实际情况你可以从cookie读取，因此数据看不到 【 麻花藤 】 这条记录（ 注意观察 SQL ）<br>
*/ */
List<ISqlParser> sqlParserList = new ArrayList<>(); List<ISqlParser> sqlParserList = new ArrayList<>(); // 创建 SQL 解析器列表
TenantSqlParser tenantSqlParser = new TenantSqlParser(); TenantSqlParser tenantSqlParser = new TenantSqlParser(); // 创建租户 SQL 解析器实例
tenantSqlParser.setTenantHandler(new TenantHandler() {
tenantSqlParser.setTenantHandler(new TenantHandler() { // 设置租户处理逻辑
@Override @Override
public Expression getTenantId() { public Expression getTenantId() {
return new LongValue(1L); return new LongValue(1L); // 返回表示租户 ID 的表达式
} }
@Override @Override
public String getTenantIdColumn() { public String getTenantIdColumn() {
return "course_id"; return "course_id"; // 返回租户 ID 所在的列名
} }
@Override @Override
public boolean doTableFilter(String tableName) { public boolean doTableFilter(String tableName) {
// 这里可以判断是否过滤表 // 这里可以判断是否过滤表
return true; return true; // 返回是否过滤表的标志
} }
}); });
sqlParserList.add(tenantSqlParser); // 将租户 SQL 解析器添加到列表中
paginationInterceptor.setSqlParserList(sqlParserList); // 设置分页拦截器的 SQL 解析器列表
sqlParserList.add(tenantSqlParser);
paginationInterceptor.setSqlParserList(sqlParserList);
// 以下过滤方式与 @SqlParser(filter = true) 注解等效 // 以下过滤方式与 @SqlParser(filter = true) 注解等效
// paginationInterceptor.setSqlParserFilter(new ISqlParserFilter() { // paginationInterceptor.setSqlParserFilter(new ISqlParserFilter() {
// @Override // @Override
@ -78,16 +86,23 @@ public class MybatisPlusConfig {
return paginationInterceptor; return paginationInterceptor;
} }
/**
* 创建 MetaObjectHandler 实例的方法
* @return MetaObjectHandler 元对象处理实例
*/
@Bean @Bean
public MetaObjectHandler metaObjectHandler(){ public MetaObjectHandler metaObjectHandler(){
return new MyMetaObjectHandler(); return new MyMetaObjectHandler(); // 创建并返回元对象处理实例
} }
/** /**
* 注入sql注入器 *
* 创建 ISqlInjector 实例的方法
* @return ISqlInjector SQL 注入器实例
*/ */
@Bean @Bean
public ISqlInjector sqlInjector(){ public ISqlInjector sqlInjector(){
return new LogicSqlInjector(); return new LogicSqlInjector(); // 创建并返回逻辑 SQL 注入器实例
} }
} }

41
tamguo-mms/src/main/java/com/tamguo/config/shiro/MemberRealm.java
Unescape View File

@ -1,6 +1,7 @@
package com.tamguo.config.shiro; package com.tamguo.config.shiro;
import java.util.Set; import java.util.Set;
import org.apache.shiro.authc.AuthenticationException; import org.apache.shiro.authc.AuthenticationException;
import org.apache.shiro.authc.AuthenticationInfo; import org.apache.shiro.authc.AuthenticationInfo;
import org.apache.shiro.authc.AuthenticationToken; import org.apache.shiro.authc.AuthenticationToken;
@ -12,61 +13,87 @@ import org.apache.shiro.authz.AuthorizationInfo;
import org.apache.shiro.authz.SimpleAuthorizationInfo; import org.apache.shiro.authz.SimpleAuthorizationInfo;
import org.apache.shiro.crypto.hash.Sha256Hash; import org.apache.shiro.crypto.hash.Sha256Hash;
import org.apache.shiro.realm.AuthorizingRealm; import org.apache.shiro.realm.AuthorizingRealm;
import org.apache.shiro.subject.PrincipalCollection;
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import com.tamguo.modules.member.model.MemberEntity; import com.tamguo.modules.member.model.MemberEntity;
import com.tamguo.modules.member.service.IMemberService; import com.tamguo.modules.member.service.IMemberService;
/** /**
* 认证 * 认证 Realm 类
* *
*/ */
public class MemberRealm extends AuthorizingRealm { public class MemberRealm extends AuthorizingRealm {
// 依赖注入 MemberService 实例
@Autowired @Autowired
private IMemberService iMemberService; private IMemberService iMemberService;
/** /**
* 授权(验证权限时调用) * 授权方法（验证权限时调用）
*
* @param principals 主体集合
* @return 授权信息
*/ */
@Override @Override
protected AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principals) { protected AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principals) {
// 权限集合
Set<String> permsSet = null; Set<String> permsSet = null;
// 创建简单授权信息对象
SimpleAuthorizationInfo info = new SimpleAuthorizationInfo(); SimpleAuthorizationInfo info = new SimpleAuthorizationInfo();
// 设置权限集合
info.setStringPermissions(permsSet); info.setStringPermissions(permsSet);
return info; return info;
} }
/** /**
* 认证(登录时调用) * 认证方法（登录时调用）
*
* @param token 认证令牌
* @return 认证信息
* @throws AuthenticationException 认证异常
*/ */
@Override @Override
protected AuthenticationInfo doGetAuthenticationInfo( protected AuthenticationInfo doGetAuthenticationInfo(AuthenticationToken token) throws AuthenticationException {
AuthenticationToken token) throws AuthenticationException { // 获取用户名
String username = (String) token.getPrincipal(); String username = (String) token.getPrincipal();
// 获取密码
String password = new String((char[]) token.getCredentials()); String password = new String((char[]) token.getCredentials());
// 根据用户名查询 MemberEntity 对象
MemberEntity member = iMemberService.findByUsername(username); MemberEntity member = iMemberService.findByUsername(username);
// 如果用户不存在
if (member == null) { if (member == null) {
throw new UnknownAccountException("用户名或密码有误，请重新输入或找回密码"); throw new UnknownAccountException("用户名或密码有误，请重新输入或找回密码");
} }
// 获取登录失败次数
Integer loginFailureCount = iMemberService.getLoginFailureCount(member); Integer loginFailureCount = iMemberService.getLoginFailureCount(member);
// 如果登录失败次数大于 10
if (loginFailureCount > 10) { if (loginFailureCount > 10) {
throw new LockedAccountException("账号被锁定"); throw new LockedAccountException("账号被锁定");
} }
// 如果密码不匹配
if (!new Sha256Hash(password).toHex().equals(member.getPassword())) { if (!new Sha256Hash(password).toHex().equals(member.getPassword())) {
loginFailureCount++; loginFailureCount++;
iMemberService.updateLoginFailureCount(member, loginFailureCount); iMemberService.updateLoginFailureCount(member, loginFailureCount);
throw new IncorrectCredentialsException("用户名或密码有误，请重新输入或找回密码"); throw new IncorrectCredentialsException("用户名或密码有误，请重新输入或找回密码");
} }
// 更新登录时间 // 更新登录时间
iMemberService.updateLastLoginTime(member.getId()); iMemberService.updateLastLoginTime(member.getId());
// 创建简单认证信息对象
SimpleAuthenticationInfo info = new SimpleAuthenticationInfo(member, password, getName()); SimpleAuthenticationInfo info = new SimpleAuthenticationInfo(member, password, getName());
return info; return info;
} }
} }

43
tamguo-mms/src/main/java/com/tamguo/config/shiro/ShiroConfiguration.java
Unescape View File

@ -12,55 +12,96 @@ import org.springframework.aop.framework.autoproxy.DefaultAdvisorAutoProxyCreato
import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Configuration;
/**
* Shiro 配置类
*/
@Configuration @Configuration
public class ShiroConfiguration { public class ShiroConfiguration {
// 定义过滤链定义映射，用于配置 Shiro 的权限控制规则
private static Map<String, String> filterChainDefinitionMap = new LinkedHashMap<String, String>(); private static Map<String, String> filterChainDefinitionMap = new LinkedHashMap<String, String>();
/**
* 获取 Shiro 领域对象，即自定义的 MemberRealm 实例
* @return MemberRealm 对象
*/
@Bean(name = "shiroRealm") @Bean(name = "shiroRealm")
public MemberRealm getShiroRealm() { public MemberRealm getShiroRealm() {
// 创建 MemberRealm 实例
return new MemberRealm(); return new MemberRealm();
} }
/**
* 获取 EhCache 管理器，用于缓存 Shiro 的相关数据
* @return EhCacheManager 对象
*/
@Bean(name = "shiroEhcacheManager") @Bean(name = "shiroEhcacheManager")
public EhCacheManager getEhCacheManager() { public EhCacheManager getEhCacheManager() {
// 创建 EhCacheManager 实例，并设置其配置文件路径
EhCacheManager em = new EhCacheManager(); EhCacheManager em = new EhCacheManager();
em.setCacheManagerConfigFile("classpath:ehcache-shiro.xml"); em.setCacheManagerConfigFile("classpath:ehcache-shiro.xml");
return em; return em;
} }
/**
* 获取生命周期 Bean 后处理器，用于管理 Shiro 相关 Bean 的生命周期
* @return LifecycleBeanPostProcessor 对象
*/
@Bean(name = "lifecycleBeanPostProcessor") @Bean(name = "lifecycleBeanPostProcessor")
public LifecycleBeanPostProcessor getLifecycleBeanPostProcessor() { public LifecycleBeanPostProcessor getLifecycleBeanPostProcessor() {
// 创建 LifecycleBeanPostProcessor 实例
return new LifecycleBeanPostProcessor(); return new LifecycleBeanPostProcessor();
} }
/**
* 获取默认顾问自动代理创建器，用于自动创建代理对象
* @return DefaultAdvisorAutoProxyCreator 对象
*/
@Bean @Bean
public DefaultAdvisorAutoProxyCreator getDefaultAdvisorAutoProxyCreator() { public DefaultAdvisorAutoProxyCreator getDefaultAdvisorAutoProxyCreator() {
// 创建 DefaultAdvisorAutoProxyCreator 实例，并设置代理目标类为 true
DefaultAdvisorAutoProxyCreator daap = new DefaultAdvisorAutoProxyCreator(); DefaultAdvisorAutoProxyCreator daap = new DefaultAdvisorAutoProxyCreator();
daap.setProxyTargetClass(true); daap.setProxyTargetClass(true);
return daap; return daap;
} }
/**
* 获取默认 Web 安全管理器，用于整合 Shiro 的各种组件
* @return DefaultWebSecurityManager 对象
*/
@Bean(name = "securityManager") @Bean(name = "securityManager")
public DefaultWebSecurityManager getDefaultWebSecurityManager() { public DefaultWebSecurityManager getDefaultWebSecurityManager() {
// 创建 DefaultWebSecurityManager 实例，并设置相关属性
DefaultWebSecurityManager dwsm = new DefaultWebSecurityManager(); DefaultWebSecurityManager dwsm = new DefaultWebSecurityManager();
dwsm.setRealm(getShiroRealm()); dwsm.setRealm(getShiroRealm());
dwsm.setCacheManager(getEhCacheManager()); dwsm.setCacheManager(getEhCacheManager());
return dwsm; return dwsm;
} }
/**
* 获取授权属性源顾问，用于在 Spring AOP 中进行授权检查
* @return AuthorizationAttributeSourceAdvisor 对象
*/
@Bean @Bean
public AuthorizationAttributeSourceAdvisor getAuthorizationAttributeSourceAdvisor() { public AuthorizationAttributeSourceAdvisor getAuthorizationAttributeSourceAdvisor() {
// 创建 AuthorizationAttributeSourceAdvisor 实例，并设置相关属性
AuthorizationAttributeSourceAdvisor aasa = new AuthorizationAttributeSourceAdvisor(); AuthorizationAttributeSourceAdvisor aasa = new AuthorizationAttributeSourceAdvisor();
aasa.setSecurityManager(getDefaultWebSecurityManager()); aasa.setSecurityManager(getDefaultWebSecurityManager());
return new AuthorizationAttributeSourceAdvisor(); return aasa;
} }
/**
* 获取 Shiro 过滤器工厂 Bean，用于配置 Shiro 的过滤器链
* @return ShiroFilterFactoryBean 对象
*/
@Bean(name = "shiroFilter") @Bean(name = "shiroFilter")
public ShiroFilterFactoryBean getShiroFilterFactoryBean() { public ShiroFilterFactoryBean getShiroFilterFactoryBean() {
// 创建 ShiroFilterFactoryBean 实例，并设置相关属性
ShiroFilterFactoryBean shiroFilterFactoryBean = new ShiroFilterFactoryBean(); ShiroFilterFactoryBean shiroFilterFactoryBean = new ShiroFilterFactoryBean();
shiroFilterFactoryBean.setSecurityManager(getDefaultWebSecurityManager()); shiroFilterFactoryBean.setSecurityManager(getDefaultWebSecurityManager());
shiroFilterFactoryBean.setLoginUrl("/login"); shiroFilterFactoryBean.setLoginUrl("/login");
shiroFilterFactoryBean.setSuccessUrl("/index"); shiroFilterFactoryBean.setSuccessUrl("/index");
// 设置过滤链定义映射
filterChainDefinitionMap.put("/member/**", "authc"); filterChainDefinitionMap.put("/member/**", "authc");
filterChainDefinitionMap.put("/**", "anon"); filterChainDefinitionMap.put("/**", "anon");
shiroFilterFactoryBean.setFilterChainDefinitionMap(filterChainDefinitionMap); shiroFilterFactoryBean.setFilterChainDefinitionMap(filterChainDefinitionMap);

23
tamguo-mms/src/main/java/com/tamguo/config/web/ErrorConfigurar.java
Unescape View File

@ -6,16 +6,33 @@ import org.springframework.boot.web.server.ErrorPageRegistry;
import org.springframework.http.HttpStatus; import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Component; import org.springframework.stereotype.Component;
/**
* 定义一个错误配置类，实现 ErrorPageRegistrar 接口
*/
@Component @Component
public class ErrorConfigurar implements ErrorPageRegistrar { public class ErrorConfigurar implements ErrorPageRegistrar {
/**
*
* 注册错误页面的方法
* @param registry 错误页面注册表
*/
@Override @Override
public void registerErrorPages(ErrorPageRegistry registry) { public void registerErrorPages(ErrorPageRegistry registry) {
// 创建一个错误页面数组
ErrorPage[] errorPages = new ErrorPage[2]; ErrorPage[] errorPages = new ErrorPage[2];
errorPages[0]=new ErrorPage(HttpStatus.NOT_FOUND,"/error404");
errorPages[1]=new ErrorPage(HttpStatus.INTERNAL_SERVER_ERROR,"/error500");
// 创建一个表示 404 状态的错误页面，并指定其重定向路径
ErrorPage errorPage404 = new ErrorPage(HttpStatus.NOT_FOUND, "/error404");
// 创建一个表示 500 状态的错误页面，并指定其重定向路径
ErrorPage errorPage500 = new ErrorPage(HttpStatus.INTERNAL_SERVER_ERROR, "/error500");
// 将两个错误页面添加到错误页面数组中
errorPages[0] = errorPage404;
errorPages[1] = errorPage500;
// 将错误页面数组添加到错误页面注册表中
registry.addErrorPages(errorPages); registry.addErrorPages(errorPages);
} }
} }

55
tamguo-mms/src/main/java/com/tamguo/config/web/ThymeleafConfig.java
Unescape View File

@ -10,32 +10,83 @@ import org.springframework.stereotype.Component;
import org.thymeleaf.spring5.view.ThymeleafViewResolver; import org.thymeleaf.spring5.view.ThymeleafViewResolver;
import com.tamguo.common.utils.SystemConstant; import com.tamguo.common.utils.SystemConstant;
/**
* ThymeleafConfig 类，实现 EnvironmentAware 接口
*/
@Component @Component
public class ThymeleafConfig implements EnvironmentAware { public class ThymeleafConfig implements EnvironmentAware {
/**
* 注入环境变量对象
*/
@Resource @Resource
private Environment env; private Environment env;
/**
* 配置 Thymeleaf 静态变量的方法
* @param viewResolver ThymeleafViewResolver 对象
*/
@Resource @Resource
private void configureThymeleafStaticVars(ThymeleafViewResolver viewResolver) { private void configureThymeleafStaticVars(ThymeleafViewResolver viewResolver) {
if (viewResolver!= null) { if (viewResolver!= null) {
/**
* 创建一个存储静态变量的 Map
*/
Map<String, Object> vars = new HashMap<>(); Map<String, Object> vars = new HashMap<>();
/**
* 将环境变量中 domain.name 的值放入变量中
*/
vars.put("domainName", env.getProperty("domain.name")); vars.put("domainName", env.getProperty("domain.name"));
/**
* 将环境变量中 book.domain.name 的值放入变量中
*/
vars.put("bookDomainName", env.getProperty("book.domain.name")); vars.put("bookDomainName", env.getProperty("book.domain.name"));
/**
* 将环境变量中 tamguo.domain.name 的值放入变量中
*/
vars.put("tamguoDomainName", env.getProperty("tamguo.domain.name")); vars.put("tamguoDomainName", env.getProperty("tamguo.domain.name"));
/**
* 将系统常量中 ZHENGTI_PAPER_ID 的值放入变量中
*/
vars.put("PAPER_TYPE_ZHENTI", SystemConstant.ZHENGTI_PAPER_ID); vars.put("PAPER_TYPE_ZHENTI", SystemConstant.ZHENGTI_PAPER_ID);
/**
* 将系统常量中 MONI_PAPER_ID 的值放入变量中
*/
vars.put("PAPER_TYPE_MONI", SystemConstant.MONI_PAPER_ID); vars.put("PAPER_TYPE_MONI", SystemConstant.MONI_PAPER_ID);
/**
* 将系统常量中 YATI_PAPER_ID 的值放入变量中
*/
vars.put("PAPER_TYPE_YATI", SystemConstant.YATI_PAPER_ID); vars.put("PAPER_TYPE_YATI", SystemConstant.YATI_PAPER_ID);
/**
* 将系统常量中 MINGXIAO_PAPER_ID 的值放入变量中
*/
vars.put("PAPER_TYPE_MINGXIAO", SystemConstant.MINGXIAO_PAPER_ID); vars.put("PAPER_TYPE_MINGXIAO", SystemConstant.MINGXIAO_PAPER_ID);
/**
* 将系统常量中 BEIJING_AREA_ID 的值放入变量中
*/
vars.put("BEIJING_AREA_ID", SystemConstant.BEIJING_AREA_ID); vars.put("BEIJING_AREA_ID", SystemConstant.BEIJING_AREA_ID);
/**
* 设置 ThymeleafViewResolver 的静态变量
*/
viewResolver.setStaticVariables(vars); viewResolver.setStaticVariables(vars);
} }
} }
/**
* 实现 EnvironmentAware 接口的方法，设置环境变量
* @param environment 环境变量对象
*/
@Override @Override
public void setEnvironment(Environment environment) { public void setEnvironment(Environment environment) {
env = environment; env = environment;
} }
} }

34
tamguo-mms/src/main/java/com/tamguo/config/web/WebConfig.java
Unescape View File

@ -12,36 +12,64 @@ import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import com.tamguo.web.interceptor.MemberInterceptor; import com.tamguo.web.interceptor.MemberInterceptor;
/**
* WebConfig 类，实现 WebMvcConfigurer 接口，用于配置 Web 相关的设置
*/
@Configuration @Configuration
public class WebConfig implements WebMvcConfigurer { public class WebConfig implements WebMvcConfigurer {
/**
* 从配置文件中获取文件存储路径的值
*/
@Value("${file.storage.path}") @Value("${file.storage.path}")
private String fileStoragePath; private String fileStoragePath;
/**
* 从配置文件中获取 Cookie 域名的值
*/
@Value("${cookie.domian.name}") @Value("${cookie.domian.name}")
private String cookieDomianName; private String cookieDomianName;
/**
* 自动注入 MemberInterceptor 实例
*/
@Autowired @Autowired
private MemberInterceptor memberInterceptor; private MemberInterceptor memberInterceptor;
/**
* 重写 addInterceptors 方法，添加拦截器
* @param registry 拦截器注册器
*/
@Override @Override
public void addInterceptors(InterceptorRegistry registry) { public void addInterceptors(InterceptorRegistry registry) {
// 添加拦截器，并设置拦截路径和排除路径
registry.addInterceptor(memberInterceptor).addPathPatterns("/**").excludePathPatterns("/login.html", "/register.html", "/password/**", "/captcha.jpg", "/submitLogin.html", "/miniLogin.html", "/static/**", "/sendFindPasswordSms", "/subRegister", "/checkMobile.html", "/checkUsername.html"); registry.addInterceptor(memberInterceptor).addPathPatterns("/**").excludePathPatterns("/login.html", "/register.html", "/password/**", "/captcha.jpg", "/submitLogin.html", "/miniLogin.html", "/static/**", "/sendFindPasswordSms", "/subRegister", "/checkMobile.html", "/checkUsername.html");
} }
/**
* 重写 addResourceHandlers 方法，添加资源处理器
* @param registry 资源处理器注册器
*/
@Override @Override
public void addResourceHandlers(ResourceHandlerRegistry registry) { public void addResourceHandlers(ResourceHandlerRegistry registry) {
// 添加资源处理器，处理/files/** 路径的资源，并设置资源位置为文件系统中的指定路径
registry.addResourceHandler("/files/**").addResourceLocations("file:" + fileStoragePath); registry.addResourceHandler("/files/**").addResourceLocations("file:" + fileStoragePath);
} }
/**
* 创建默认的 CookieSerializer 实例的方法
* @return 默认的 CookieSerializer 实例
*/
@Bean @Bean
public CookieSerializer defaultCookieSerializer() { public CookieSerializer defaultCookieSerializer() {
// 创建默认的 CookieSerializer 实例
DefaultCookieSerializer defaultCookieSerializer = new DefaultCookieSerializer(); DefaultCookieSerializer defaultCookieSerializer = new DefaultCookieSerializer();
// 设置 Cookie 名称
defaultCookieSerializer.setCookieName("sessionId"); defaultCookieSerializer.setCookieName("sessionId");
// 设置 Cookie 域名
defaultCookieSerializer.setDomainName(cookieDomianName); defaultCookieSerializer.setDomainName(cookieDomianName);
// 设置 Cookie 路径
defaultCookieSerializer.setCookiePath("/"); defaultCookieSerializer.setCookiePath("/");
return defaultCookieSerializer; return defaultCookieSerializer;
} }
} }

43
tamguo-mms/src/main/java/com/tamguo/utils/FileMd5Utils.java
Unescape View File

@ -1,37 +1,42 @@
package com.tamguo.utils; package com.tamguo.utils;
import java.io.FileInputStream; import java.io.FileInputStream; // 导入文件输入流类
import java.io.IOException; import java.io.IOException; // 导入输入输出异常类
import java.security.MessageDigest; import java.security.MessageDigest; // 导入消息摘要类
import org.apache.commons.codec.binary.Hex; import org.apache.commons.codec.binary.Hex; // 导入十六进制编码类
/**
* FileMd5Utils 类，用于获取文件的 MD5 值（可处理大文件）
*/
public class FileMd5Utils { public class FileMd5Utils {
/** /**
* 获取一个文件的md5值(可处理大文件) * 获取一个文件的 MD5 值的方法
* @return md5 value * @param fileInputStream 文件输入流
* @return MD5 值字符串
*/ */
public static String getMD5(FileInputStream fileInputStream) { public static String getMD5(FileInputStream fileInputStream) {
try { try {
// 获取 MD5 消息摘要实例
MessageDigest MD5 = MessageDigest.getInstance("MD5"); MessageDigest MD5 = MessageDigest.getInstance("MD5");
// 创建字节数组，大小为 8192 字节
byte[] buffer = new byte[8192]; byte[] buffer = new byte[8192];
int length; int length; // 定义读取到的字节长度变量
while ((length = fileInputStream.read(buffer)) != -1) { while ((length = fileInputStream.read(buffer))!= -1) { // 循环读取文件内容
MD5.update(buffer, 0, length); MD5.update(buffer, 0, length); // 更新消息摘要
} }
return new String(Hex.encodeHex(MD5.digest())); return new String(Hex.encodeHex(MD5.digest())); // 将消息摘要的结果进行十六进制编码并转换为字符串返回
} catch (Exception e) { } catch (Exception e) { // 捕获异常
e.printStackTrace(); e.printStackTrace(); // 打印异常信息
return null; return null; // 返回空值
} finally { } finally { // 无论是否发生异常，都会执行以下代码块
try { try {
if (fileInputStream != null){ if (fileInputStream!= null) { // 如果文件输入流不为空
fileInputStream.close(); fileInputStream.close(); // 关闭文件输入流
} }
} catch (IOException e) { } catch (IOException e) { // 捕获输入输出异常
e.printStackTrace(); e.printStackTrace(); // 打印异常信息
} }
} }
} }
} }

53
tamguo-mms/src/main/java/com/tamguo/utils/ShiroUtils.java
Unescape View File

@ -1,43 +1,68 @@
package com.tamguo.utils; package com.tamguo.utils;
import org.apache.shiro.SecurityUtils; import org.apache.shiro.SecurityUtils; // 导入 Shiro 的安全工具类
import org.apache.shiro.session.Session; import org.apache.shiro.session.Session; // 导入 Shiro 的会话类
import org.apache.shiro.subject.Subject; import org.apache.shiro.subject.Subject; // 导入 Shiro 的主体类
import com.tamguo.modules.member.model.MemberEntity; // 导入会员实体类
import com.tamguo.modules.member.model.MemberEntity;
/**
* ShiroUtils 类，提供与 Shiro 相关的工具方法
*/
public class ShiroUtils { public class ShiroUtils {
/**
* 获取当前会话
*/
public static Session getSession() { public static Session getSession() {
return SecurityUtils.getSubject().getSession(); return SecurityUtils.getSubject().getSession(); // 获取 Shiro 主体的会话
} }
/**
* 获取当前主体
*/
public static Subject getSubject() { public static Subject getSubject() {
return SecurityUtils.getSubject(); return SecurityUtils.getSubject(); // 获取 Shiro 主体
} }
/**
* 获取当前登录的会员实体
*/
public static MemberEntity getMember() { public static MemberEntity getMember() {
return (MemberEntity)SecurityUtils.getSubject().getPrincipal(); return (MemberEntity)SecurityUtils.getSubject().getPrincipal(); // 获取 Shiro 主体的主要对象（会员实体）
} }
/**
* 获取当前登录会员的 ID
*/
public static String getMemberId() { public static String getMemberId() {
return getMember().getId(); return getMember().getId(); // 获取会员实体的 ID
} }
/**
* 设置会话属性
*/
public static void setSessionAttribute(Object key, Object value) { public static void setSessionAttribute(Object key, Object value) {
getSession().setAttribute(key, value); getSession().setAttribute(key, value); // 在会话中设置属性键值对
} }
/**
* 获取会话属性
*/
public static Object getSessionAttribute(Object key) { public static Object getSessionAttribute(Object key) {
return getSession().getAttribute(key); return getSession().getAttribute(key); // 获取会话中指定键的属性值
} }
/**
* 判断是否登录
*/
public static boolean isLogin() { public static boolean isLogin() {
return SecurityUtils.getSubject().getPrincipal() != null; return SecurityUtils.getSubject().getPrincipal()!= null; // 判断 Shiro 主体的主要对象是否不为空
} }
/**
* 注销登录
*/
public static void logout() { public static void logout() {
SecurityUtils.getSubject().logout(); SecurityUtils.getSubject().logout(); // 执行 Shiro 主体的注销操作
} }
} }

46
tamguo-mms/src/main/java/com/tamguo/web/AccountController.java
Unescape View File

@ -18,7 +18,6 @@ import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody; import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.multipart.MultipartFile;
import org.springframework.web.servlet.ModelAndView; import org.springframework.web.servlet.ModelAndView;
import com.tamguo.common.utils.DateUtils; import com.tamguo.common.utils.DateUtils;
@ -29,21 +28,51 @@ import com.tamguo.config.redis.CacheService;
import com.tamguo.modules.member.service.IMemberService; import com.tamguo.modules.member.service.IMemberService;
import com.tamguo.utils.ShiroUtils; import com.tamguo.utils.ShiroUtils;
/**
* AccountController 类，处理账户相关的请求
*/
@Controller @Controller
public class AccountController { public class AccountController {
/**
* 文件存储路径配置项
*/
@Value("${file.storage.path}") @Value("${file.storage.path}")
String fileStoragePath; String fileStoragePath;
/**
* 域名配置项
*/
@Value("${tamguo.domain.name}") @Value("${tamguo.domain.name}")
String tamguoDomainName; String tamguoDomainName;
/**
* 注入会员服务
*/
@Autowired @Autowired
IMemberService iMemberService; IMemberService iMemberService;
/**
* 注入缓存服务
*/
@Autowired @Autowired
CacheService cacheService; CacheService cacheService;
/**
* 头像编号无格式字符串
*/
private static final String AVATOR_NO_FORMAT = "00000"; private static final String AVATOR_NO_FORMAT = "00000";
/**
* 头像前缀
*/
private static final String AVATOR_PREFIX = "MTX"; private static final String AVATOR_PREFIX = "MTX";
/**
* 处理 "account.html" 请求，返回账户页面视图和会员信息
* @param model 模型视图对象
* @return 模型视图对象
*/
@RequestMapping(value = {"account.html"}, method = RequestMethod.GET) @RequestMapping(value = {"account.html"}, method = RequestMethod.GET)
public ModelAndView list(ModelAndView model) { public ModelAndView list(ModelAndView model) {
model.setViewName("account"); model.setViewName("account");
@ -51,12 +80,23 @@ public class AccountController {
return model; return model;
} }
/**
* 获取当前会员信息的请求处理
* @return 结果对象，包含会员信息和状态信息
*/
@RequestMapping(value = {"getCurrentMember"}, method = RequestMethod.GET) @RequestMapping(value = {"getCurrentMember"}, method = RequestMethod.GET)
@ResponseBody @ResponseBody
public Result getCurrentMember() { public Result getCurrentMember() {
return Result.result(0, iMemberService.findByUid(ShiroUtils.getMemberId()), "success"); return Result.result(0, iMemberService.findByUid(ShiroUtils.getMemberId()), "success");
} }
/**
* 处理文件上传请求
* @param file 上传的文件
* @param request HTTP 请求对象
* @return 文件上传消息对象
* @throws IOException 文件操作异常
*/
@RequestMapping(value = "uploadFile", method = RequestMethod.POST) @RequestMapping(value = "uploadFile", method = RequestMethod.POST)
@ResponseBody @ResponseBody
public UploaderMessage uploadFileHandler(@RequestParam("file") MultipartFile file, HttpServletRequest request) throws IOException { public UploaderMessage uploadFileHandler(@RequestParam("file") MultipartFile file, HttpServletRequest request) throws IOException {
@ -111,6 +151,10 @@ public class AccountController {
} }
} }
/**
* 获取头像编号的方法
* @return 头像编号
*/
private String getAvatorNo() { private String getAvatorNo() {
SimpleDateFormat sdf = new SimpleDateFormat("yyyyMM"); SimpleDateFormat sdf = new SimpleDateFormat("yyyyMM");
String format = sdf.format(new Date()); String format = sdf.format(new Date());

82
tamguo-mms/src/main/java/com/tamguo/web/BookCategoryController.java
Unescape View File

@ -1,63 +1,75 @@
package com.tamguo.web; package com.tamguo.web;
import java.util.List; import java.util.List;
import org.slf4j.Logger; import org.slf4j.Logger; // 导入日志记录器接口
import org.slf4j.LoggerFactory; import org.slf4j.LoggerFactory; // 导入日志工厂类
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired; // 导入自动注入注解
import org.springframework.stereotype.Controller; import org.springframework.stereotype.Controller; // 导入控制器注解
import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMapping; // 导入请求映射注解
import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RequestMethod; // 导入请求方法注解
import org.springframework.web.bind.annotation.ResponseBody; import org.springframework.web.bind.annotation.ResponseBody; // 导入响应体注解
import com.alibaba.druid.util.StringUtils;
import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import com.baomidou.mybatisplus.mapper.Condition;
import com.tamguo.common.utils.Result;
import com.tamguo.modules.book.model.BookCategoryEntity;
import com.tamguo.modules.book.service.IBookCategoryService;
import com.alibaba.druid.util.StringUtils; // 导入字符串工具类
import com.alibaba.fastjson.JSONArray; // 导入 JSON 数组类
import com.alibaba.fastjson.JSONObject; // 导入 JSON 对象类
import com.baomidou.mybatisplus.mapper.Condition; // 导入条件构建器类
import com.tamguo.modules.book.model.BookCategoryEntity; // 导入图书分类实体类
import com.tamguo.modules.book.service.IBookCategoryService; // 导入图书分类服务接口
/**
* BookCategoryController 类，处理图书分类相关的请求
*/
@Controller @Controller
public class BookCategoryController { public class BookCategoryController {
private Logger logger = LoggerFactory.getLogger(getClass()); private Logger logger = LoggerFactory.getLogger(getClass()); // 创建日志记录器实例
@Autowired @Autowired
private IBookCategoryService iBookCategoryService; private IBookCategoryService iBookCategoryService; // 自动注入图书分类服务实例
/**
* 处理获取图书分类的请求，通过 POST 方法
* @param parentId 父分类 ID
* @return 返回处理结果
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@RequestMapping(value = {"getBookCategory.html"}, method = RequestMethod.POST) @RequestMapping(value = {"getBookCategory.html"}, method = RequestMethod.POST)
@ResponseBody @ResponseBody
public Result getBookCategory(String parentId) { public Result getBookCategory(String parentId) {
try { try {
List<BookCategoryEntity> bookCategoryList = null; List<BookCategoryEntity> bookCategoryList = null; // 定义图书分类列表变量
if(StringUtils.isEmpty(parentId)) { if(StringUtils.isEmpty(parentId)) { // 如果父分类 ID 为空
bookCategoryList = iBookCategoryService.selectList(Condition.create().eq("parent_id", "0")); bookCategoryList = iBookCategoryService.selectList(Condition.create().eq("parent_id", "0")); // 查询父分类为 0 的图书分类列表
} else { } else {
bookCategoryList = iBookCategoryService.selectList(Condition.create().eq("parent_id", parentId)); bookCategoryList = iBookCategoryService.selectList(Condition.create().eq("parent_id", parentId)); // 查询指定父分类 ID 的图书分类列表
} }
return Result.successResult(processBookCategoryList(bookCategoryList)); return Result.successResult(processBookCategoryList(bookCategoryList)); // 返回处理后的图书分类列表结果，并标记为成功
} catch (Exception e) { } catch (Exception e) {
logger.error(e.getMessage() , e); logger.error(e.getMessage(), e); // 记录异常日志
return Result.failResult("查询失败！"); return Result.failResult("查询失败！"); // 返回失败结果及错误信息
} }
} }
/**
* 处理图书分类列表，生成 JSON 数组
* @param bookCategoryList 图书分类列表
* @return 返回处理后的 JSON 数组
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
private JSONArray processBookCategoryList(List<BookCategoryEntity> bookCategoryList) { private JSONArray processBookCategoryList(List<BookCategoryEntity> bookCategoryList) {
JSONArray entitys = new JSONArray(); JSONArray entitys = new JSONArray(); // 创建 JSON 数组实例
for(int i=0 ; i<bookCategoryList.size() ; i++) { for(int i = 0; i < bookCategoryList.size(); i++) { // 遍历图书分类列表
BookCategoryEntity bc = bookCategoryList.get(i); BookCategoryEntity bc = bookCategoryList.get(i); // 获取当前图书分类实体
JSONObject entity = new JSONObject(); JSONObject entity = new JSONObject(); // 创建 JSON 对象实例
entity.put("label", bc.getName()); entity.put("label", bc.getName()); // 设置标签为分类名称
entity.put("value", bc.getId()); entity.put("value", bc.getId()); // 设置值为分类 ID
Integer count = iBookCategoryService.selectCount(Condition.create().eq("parent_id", bc.getId())); Integer count = iBookCategoryService.selectCount(Condition.create().eq("parent_id", bc.getId())); // 获取当前分类的子分类数量
if(count > 0) { if(count > 0) {
entity.put("children", new JSONArray()); entity.put("children", new JSONArray()); // 如果有子分类，设置子分类数组
} }
entitys.add(entity); entitys.add(entity); // 将当前分类对象添加到 JSON 数组中
} }
return entitys; return entitys; // 返回处理后的 JSON 数组
} }
} }

134
tamguo-mms/src/main/java/com/tamguo/web/BookController.java
Unescape View File

@ -28,105 +28,145 @@ import com.tamguo.modules.book.service.IBookService;
import com.tamguo.modules.book.service.IDocumentService; import com.tamguo.modules.book.service.IDocumentService;
import com.tamguo.utils.ShiroUtils; import com.tamguo.utils.ShiroUtils;
/**
* BookController 类，处理图书相关的请求
*/
@Controller @Controller
public class BookController { public class BookController {
private Logger logger = LoggerFactory.getLogger(getClass()); private Logger logger = LoggerFactory.getLogger(getClass()); // 创建日志记录器对象
@Autowired @Autowired
private IBookService iBookService; private IBookService iBookService; // 自动注入图书服务
@Autowired @Autowired
private IDocumentService iDocumentService; private IDocumentService iDocumentService; // 自动注入文档服务
/**
* 处理编辑图书的请求
* @param bookId 图书 ID
* @param model 模型视图对象
* @return 模型视图对象
*/
@RequestMapping(value = "editBook/{bookId}", method = RequestMethod.GET) @RequestMapping(value = "editBook/{bookId}", method = RequestMethod.GET)
public ModelAndView edit(@PathVariable String bookId, ModelAndView model) { public ModelAndView edit(@PathVariable String bookId, ModelAndView model) {
model.setViewName("book/edit"); model.setViewName("book/edit"); // 设置视图名称
model.addObject("bookId", bookId); model.addObject("bookId", bookId); // 添加图书 ID 到模型中
return model; return model; // 返回模型视图对象
} }
/**
* 处理图书列表的请求
* @param model 模型视图对象
* @return 模型视图对象
*/
@RequestMapping(value = {"booklist.html"}, method = RequestMethod.GET) @RequestMapping(value = {"booklist.html"}, method = RequestMethod.GET)
public ModelAndView list(ModelAndView model) { public ModelAndView list(ModelAndView model) {
model.setViewName("booklist"); model.setViewName("booklist"); // 设置视图名称
return model; return model; // 返回模型视图对象
} }
/**
* 处理获取文档列表的请求
* @param id 图书 ID
* @return 返回处理结果
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@RequestMapping(value = "getDocumentList", method = RequestMethod.POST) @RequestMapping(value = "getDocumentList", method = RequestMethod.POST)
@ResponseBody @ResponseBody
public Result getDocumentList(String id) { public Result getDocumentList(String id) {
Map<String, Object> map = new HashMap<>(); Map<String, Object> map = new HashMap<>(); // 创建一个 Map 对象
try { try {
BookEntity book = iBookService.selectById(id); BookEntity book = iBookService.selectById(id); // 根据图书 ID 获取图书信息
List<DocumentEntity> documentList = iDocumentService.selectList(Condition.create().eq("book_id", id).eq("status", DocumentStatusEnum.NORMAL.getValue())); List<DocumentEntity> documentList = iDocumentService.selectList(Condition.create().eq("book_id", id).eq("status", DocumentStatusEnum.NORMAL.getValue())); // 根据图书 ID 和文档状态获取文档列表
map.put("documentList", this.processDocumentList(documentList)); map.put("documentList", this.processDocumentList(documentList)); // 处理文档列表并将结果放入 Map 中
map.put("book", book); map.put("book", book); // 将图书信息放入 Map 中
} catch (Exception e) { } catch (Exception e) {
logger.error(e.getMessage() , e ); logger.error(e.getMessage(), e); // 记录错误日志
return Result.failResult("查询失败"); return Result.failResult("查询失败"); // 返回查询失败的结果
} }
return Result.successResult(map); return Result.successResult(map); // 返回查询成功的结果
} }
/**
* 处理获取图书列表的请求
* @return 返回处理结果
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@RequestMapping(value = {"getBookList.html"}, method = RequestMethod.POST) @RequestMapping(value = {"getBookList.html"}, method = RequestMethod.POST)
@ResponseBody @ResponseBody
public Result getBookList() { public Result getBookList() {
try { try {
List<BookEntity> bookList = iBookService.selectList(Condition.create().eq("owner", ShiroUtils.getMemberId()).orderDesc(Arrays.asList("create_date"))); List<BookEntity> bookList = iBookService.selectList(Condition.create().eq("owner", ShiroUtils.getMemberId()).orderByDesc(Arrays.asList("create_date"))); // 根据当前用户 ID 获取图书列表
return Result.successResult(bookList); return Result.successResult(bookList); // 返回图书列表
} catch (Exception e) { } catch (Exception e) {
logger.error(e.getMessage() , e); logger.error(e.getMessage(), e); // 记录错误日志
return Result.failResult("查询失败！"); return Result.failResult("查询失败！"); // 返回查询失败的结果
} }
} }
/**
* 处理保存图书的请求
* @param book 图书实体
* @return 返回处理结果
*/
@RequestMapping(value = {"saveBook"}, method = RequestMethod.POST) @RequestMapping(value = {"saveBook"}, method = RequestMethod.POST)
@ResponseBody @ResponseBody
public Result saveBook(@RequestBody BookEntity book) { public Result saveBook(@RequestBody BookEntity book) {
try { try {
book.setOwner(ShiroUtils.getMemberId()); book.setOwner(ShiroUtils.getMemberId()); // 设置图书的所有者为当前用户
book.setCategoryId(StringUtils.join(book.getCategoryIds(), ",")); book.setCategoryId(StringUtils.join(book.getCategoryIds(), ",")); // 设置图书的分类 ID 为逗号分隔的字符串
iBookService.saveBook(book); iBookService.saveBook(book); // 保存图书
return Result.result(0, null, "保存成功"); return Result.result(0, null, "保存成功"); // 返回保存成功的结果
} catch (Exception e) { } catch (Exception e) {
logger.error(e.getMessage() , e); logger.error(e.getMessage(), e); // 记录错误日志
return Result.result(1, null, "保存失败"); return Result.result(1, null, "保存失败"); // 返回保存失败的结果
} }
} }
/**
* 处理文档列表，生成 JSON 数组
* @param documentList 文档列表
* @return 返回处理后的 JSON 数组
*/
private JSONArray processDocumentList(List<DocumentEntity> documentList) { private JSONArray processDocumentList(List<DocumentEntity> documentList) {
JSONArray entitys = new JSONArray(); JSONArray entitys = new JSONArray(); // 创建 JSON 数组对象
for(int i=0 ; i<documentList.size() ; i ++) { for (int i = 0; i < documentList.size(); i++) { // 遍历文档列表
DocumentEntity doc = documentList.get(i); DocumentEntity doc = documentList.get(i); // 获取当前文档
JSONObject entity = new JSONObject(); JSONObject entity = new JSONObject(); // 创建 JSON 对象
entity.put("id", doc.getId()); entity.put("id", doc.getId()); // 设置文档 ID
entity.put("text", doc.getName()); entity.put("text", doc.getName()); // 设置文档名称
entity.put("parent", "0".equals(doc.getParentId()) ? "#" : doc.getParentId()); entity.put("parent", "0".equals(doc.getParentId())? "#" : doc.getParentId()); // 设置文档的父节点
entity.put("identify", doc.getId()); entity.put("identify", doc.getId()); // 设置文档的标识
entity.put("version", doc.getCreateDate().getTime()); entity.put("version", doc.getCreateDate().getTime()); // 设置文档的版本
JSONObject attr = new JSONObject(); JSONObject attr = new JSONObject(); // 创建属性对象
attr.put("is_open", "0".equals(doc.getIsOpen()) ? false : true); attr.put("is_open", "0".equals(doc.getIsOpen())? false : true); // 设置文档是否展开
entity.put("a_attr", attr); entity.put("a_attr", attr); // 设置文档的属性
entitys.add(entity);
entitys.add(entity); // 将文档对象添加到 JSON 数组中
} }
return entitys; return entitys; // 返回 JSON 数组
} }
/**
* 处理获取图书的请求
* @param id 图书 ID
* @return 返回处理结果
*/
@RequestMapping(value = "book/{id}.html", method = RequestMethod.GET) @RequestMapping(value = "book/{id}.html", method = RequestMethod.GET)
@ResponseBody @ResponseBody
public Result book(@PathVariable String id) { public Result book(@PathVariable String id) {
try { try {
BookEntity book = iBookService.selectById(id); BookEntity book = iBookService.selectById(id); // 根据图书 ID 获取图书信息
String categoryIds = book.getCategoryId(); // 获取图书的分类 ID 字符串
book.setCategoryIds(Arrays.asList(categoryIds.split(","))); // 将分类 ID 字符串转换为列表
String categoryIds = book.getCategoryId();
book.setCategoryIds(Arrays.asList(categoryIds.split(",")));
// 获取 categoryIds // 获取 categoryIds
return Result.result(0, book, "查询成功！"); return Result.result(0, book, "查询成功！"); // 返回查询成功的结果
} catch (Exception e) { } catch (Exception e) {
logger.error(e.getMessage() , e); logger.error(e.getMessage(), e); // 记录错误日志
return Result.result(1, null, "查询失败！"); return Result.result(1, null, "查询失败！"); // 返回查询失败的结果
} }
} }
} }

196
tamguo-mms/src/main/java/com/tamguo/web/DocumentController.java
Unescape View File

@ -15,7 +15,7 @@ import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value; import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Controller; import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable; import org.springframework.web.bind.annotation.PathPathVariable;
import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RequestParam;
@ -35,31 +35,41 @@ import com.tamguo.modules.book.service.IFileEntityService;
import com.tamguo.modules.book.service.IFileUploadService; import com.tamguo.modules.book.service.IFileUploadService;
import com.tamguo.utils.FileMd5Utils; import com.tamguo.utils.FileMd5Utils;
/**
* DocumentController 类，处理文档相关的请求
*/
@Controller @Controller
@RequestMapping(value = "document") @RequestMapping(value = "document")
public class DocumentController { public class DocumentController {
private Logger logger = LoggerFactory.getLogger(getClass()); private Logger logger = LoggerFactory.getLogger(getClass()); // 创建日志记录器对象
@Autowired @Autowired
IDocumentService iDocumentService; IDocumentService iDocumentService; // 自动注入文档服务
@Autowired @Autowired
IFileEntityService iFileEntityService; IFileEntityService iFileEntityService; // 自动注入文件实体服务
@Autowired @Autowired
IFileUploadService iFileUploadService; IFileUploadService iFileUploadService; // 自动注入文件上传服务
@Value("${file.storage.path}") @Value("${file.storage.path}")
private String fileStoragePath; private String fileStoragePath; // 文件存储路径配置
@Value("${tamguo.domain.name}") @Value("${tamguo.domain.name}")
private String domainName; private String domainName; // 域名配置
@SuppressWarnings("unchecked") /**
* 获取文档信息的请求处理
* @param id 文档 ID
* @return 返回处理结果
*/
@RequestMapping(value = "{id}", method = RequestMethod.GET) @RequestMapping(value = "{id}", method = RequestMethod.GET)
@ResponseBody @ResponseBody
public Result getDocument(@PathVariable String id) { public Result getDocument(@PathVariable String id) {
DocumentEntity document = null; DocumentEntity document = null; // 定义文档对象
try { try {
document = iDocumentService.selectById(id); document = iDocumentService.selectById(id); // 根据 ID 获取文档信息
// 查询附件 // 查询附件
List<FileUploadEntity> fileUploads = iFileUploadService.selectList(Condition.create().eq("biz_key", document.getId()).eq("biz_type", BizTypeEnum.DOCUMENT.getValue())); List<FileUploadEntity> fileUploads = iFileUploadService.selectList(Condition.create().eq("biz_key", document.getId()).eq("biz_type", BizTypeEnum.DOCUMENT.getValue()));
if (!CollectionUtils.isEmpty(fileUploads)) { if (!CollectionUtils.isEmpty(fileUploads)) {
@ -72,152 +82,172 @@ public class DocumentController {
document.setFileUploads(fileUploads); document.setFileUploads(fileUploads);
} }
} catch (Exception e) { } catch (Exception e) {
logger.error(e.getMessage() , e ); logger.error(e.getMessage(), e); // 记录错误日志
return Result.failResult("查询失败"); return Result.failResult("查询失败"); // 返回查询失败结果
} }
return Result.successResult(document); return Result.successResult(document); // 返回查询成功结果
} }
/** /**
* 编辑内容 * 编辑文档内容的请求处理
* @param document 文档对象
* @return 返回处理结果
*/ */
@RequestMapping(value = "modify", method = RequestMethod.POST) @RequestMapping(value = "modify", method = RequestMethod.POST)
@ResponseBody @ResponseBody
public Result modify(DocumentEntity document) { public Result modify(DocumentEntity document) {
try { try {
iDocumentService.modify(document); iDocumentService.modify(document); // 修改文档内容
} catch (Exception e) { } catch (Exception e) {
logger.error(e.getMessage() , e ); logger.error(e.getMessage(), e); // 记录错误日志
return Result.failResult("保存失败"); return Result.failResult("保存失败"); // 返回保存失败结果
} }
return Result.successResult("保存成功"); return Result.successResult("保存成功"); // 返回保存成功结果
} }
/** /**
* 创建文档 * 创建文档的请求处理
* @param document 文档对象
* @return 返回处理结果
*/ */
@RequestMapping(value = "create", method = RequestMethod.POST) @RequestMapping(value = "create", method = RequestMethod.POST)
@ResponseBody @ResponseBody
public Result create(DocumentEntity document) { public Result create(DocumentEntity document) {
try { try {
iDocumentService.create(document); iDocumentService.create(document); // 创建文档
} catch (Exception e) { } catch (Exception e) {
logger.error(e.getMessage() , e ); logger.error(e.getMessage(), e); // 记录错误日志
return Result.failResult("保存失败"); return Result.failResult("保存失败"); // 返回保存失败结果
} }
return Result.successResult(document); return Result.successResult(document); // 返回保存成功结果
} }
@SuppressWarnings("unchecked") /**
* 上传图片的请求处理
* @param file 图片文件
* @param bookId 图书 ID
* @param request HTTP 请求对象
* @return 返回处理结果
*/
@RequestMapping(value = "uploadImage", method = RequestMethod.POST) @RequestMapping(value = "uploadImage", method = RequestMethod.POST)
@ResponseBody @ResponseBody
public Result uploadImage(@RequestParam("editormd-image-file") MultipartFile file, String bookId, HttpServletRequest request) { public Result uploadImage(@RequestParam("editormd-image-file") MultipartFile file, String bookId, HttpServletRequest request) {
try { try {
String fileMd5 = FileMd5Utils.getMD5((FileInputStream)file.getInputStream()); String fileMd5 = FileMd5Utils.getMD5((FileInputStream) file.getInputStream()); // 获取文件的 MD5 值
FileEntity sysFile = iFileEntityService.selectOne(Condition.create().eq("file_md5", fileMd5)); FileEntity sysFile = iFileEntityService.selectOne(Condition.create().eq("file_md5", fileMd5)); // 根据 MD5 值查询系统文件
if (sysFile!= null) { if (sysFile!= null) {
sysFile.setFilePath(domainName + "files/" + sysFile.getFilePath()); sysFile.setFilePath(domainName + "files/" + sysFile.getFilePath());
return Result.successResult(sysFile); return Result.successResult(sysFile); // 如果文件已存在，直接返回文件信息
} }
String filePath = fileStoragePath + "book/" + DateUtil.fomatDate(new Date(), "yyyyMM") + "/" + bookId; String filePath = fileStoragePath + "book/" + DateUtil.fomatDate(new Date(), "yyyyMM") + "/" + bookId; // 生成文件存储路径
File dest = new File(filePath); File dest = new File(filePath);
if (!dest.exists()) { if (!dest.exists()) {
dest.mkdirs(); dest.mkdirs(); // 创建存储目录
} }
// save 文件 // save 文件
FileUtils.writeByteArrayToFile(new File(filePath + "/" + file.getOriginalFilename()) , file.getBytes()); FileUtils.writeByteArrayToFile(new File(filePath + "/" + file.getOriginalFilename()), file.getBytes()); // 保存文件
FileEntity fileEntity = new FileEntity(); // 创建文件实体对象
FileEntity fileEntity = new FileEntity(); fileEntity.setFileContentType(file.getContentType()); // 设置文件类型
fileEntity.setFileContentType(file.getContentType()); fileEntity.setFileExtension(file.getOriginalFilename()); // 设置文件扩展名
fileEntity.setFileExtension(file.getOriginalFilename()); fileEntity.setFileMd5(FileMd5Utils.getMD5((FileInputStream) file.getInputStream())); // 设置文件 MD5 值
fileEntity.setFileMd5(FileMd5Utils.getMD5((FileInputStream)file.getInputStream())); fileEntity.setFileSize(file.getSize()); // 设置文件大小
fileEntity.setFileSize(file.getSize()); fileEntity.setFilePath("book/" + DateUtil.fomatDate(new Date(), "yyyyMM") + "/" + bookId + "/" + file.getOriginalFilename()); // 设置文件路径
fileEntity.setFilePath("book/" + DateUtil.fomatDate(new Date(), "yyyyMM") + "/" + bookId + "/" + file.getOriginalFilename()); iFileEntityService.insert(fileEntity); // 插入文件实体到数据库
iFileEntityService.insert(fileEntity);
fileEntity.setFilePath(domainName + "files/" + fileEntity.getFilePath()); // 设置文件路径
fileEntity.setFilePath(domainName + "files/" + fileEntity.getFilePath());
return Result.successResult(fileEntity); // 返回文件信息
return Result.successResult(fileEntity);
} catch (IOException e) { } catch (IOException e) {
e.printStackTrace(); e.printStackTrace();
return Result.failResult("上传失败"); return Result.failResult("上传失败"); // 如果上传失败，返回失败结果
} }
} }
/** /**
* 上传附件 * 上传附件的请求处理
* @param file 附件文件
* @param documentId 文档 ID
* @param bookId 图书 ID
* @param request HTTP 请求对象
* @return 返回处理结果
*/ */
@SuppressWarnings("unchecked")
@RequestMapping(value = "uploadFile", method = RequestMethod.POST) @RequestMapping(value = "uploadFile", method = RequestMethod.POST)
@ResponseBody @ResponseBody
public Result uploadFile(@RequestParam("editormd-file-file") MultipartFile file, String documentId, String bookId, HttpServletRequest request) { public Result uploadFile(@RequestParam("editormd-file-file") MultipartFile file, String documentId, String bookId, HttpServletRequest request) {
try { try {
String fileMd5 = FileMd5Utils.getMD5((FileInputStream)file.getInputStream()); String fileMd5 = FileMd5Utils.getMD5((FileInputStream) file.getInputStream()); // 获取文件的 MD5 值
FileEntity sysFile = iFileEntityService.selectOne(Condition.create().eq("file_md5", fileMd5)); FileEntity sysFile = iFileEntityService.selectOne(Condition.create().eq("file_md5", fileMd5)); // 根据 MD5 值查询系统文件
// 文件不存在 // 文件不存在
if (sysFile == null) { if (sysFile == null) {
String filePath = fileStoragePath + "book/" + DateUtil.fomatDate(new Date(), "yyyyMM") + "/" + bookId; String filePath = fileStoragePath + "book/" + DateUtil.fomatDate(new Date(), "yyyyMM") + "/" + bookId; // 生成文件存储路径
File dest = new File(filePath); File dest = new File(filePath);
if (!dest.exists()) { if (!dest.exists()) {
dest.mkdirs(); dest.mkdirs(); // 创建存储目录
} }
// save 文件 // save 文件
FileUtils.writeByteArrayToFile(new File(filePath + "/" + file.getOriginalFilename()) , file.getBytes()); FileUtils.writeByteArrayToFile(new File(filePath + "/" + file.getOriginalFilename()), file.getBytes()); // 保存文件
sysFile = new FileEntity(); sysFile = new FileEntity(); // 创建文件实体对象
sysFile.setFileContentType(file.getContentType()); sysFile.setFileContentType(file.getContentType()); // 设置文件类型
sysFile.setFileExtension(file.getOriginalFilename()); sysFile.setFileExtension(file.getOriginalFilename()); // 设置文件扩展名
sysFile.setFileMd5(FileMd5Utils.getMD5((FileInputStream)file.getInputStream())); sysFile.setFileMd5(FileMd5Utils.getMD5((FileInputStream) file.getInputStream())); // 设置文件 MD5 值
sysFile.setFileSize(file.getSize()); sysFile.setFileSize(file.getSize()); // 设置文件大小
sysFile.setFilePath("book/" + DateUtil.fomatDate(new Date(), "yyyyMM") + "/" + bookId + "/" + file.getOriginalFilename()); sysFile.setFilePath("book/" + DateUtil.fomatDate(new Date(), "yyyyMM") + "/" + bookId + "/" + file.getOriginalFilename()); // 设置文件路径
iFileEntityService.insert(sysFile); iFileEntityService.insert(sysFile); // 插入文件实体到数据库
} }
// 创建上传记录 // 创建上传记录
FileUploadEntity fileUpload = new FileUploadEntity(); FileUploadEntity fileUpload = new FileUploadEntity(); // 创建文件上传记录对象
fileUpload.setBizKey(documentId); fileUpload.setBizKey(documentId); // 设置业务键
fileUpload.setBizType(BizTypeEnum.DOCUMENT); fileUpload.setBizType(BizTypeEnum.DOCUMENT); // 设置业务类型
fileUpload.setCreateBy("system"); fileUpload.setCreateBy("system"); // 设置创建者
fileUpload.setCreateDate(new Date()); fileUpload.setCreateDate(new Date()); // 设置创建日期
fileUpload.setFileId(sysFile.getFileId()); fileUpload.setFileId(sysFile.getFileId()); // 设置文件 ID
fileUpload.setFileName(sysFile.getFileExtension()); fileUpload.setFileName(sysFile.getFileExtension()); // 设置文件名称
fileUpload.setFileType(file.getContentType()); fileUpload.setFileType(file.getContentType()); // 设置文件类型
fileUpload.setUpdateBy("system"); fileUpload.setUpdateBy("system"); // 设置更新者
fileUpload.setUpdateDate(new Date()); fileUpload.setUpdateDate(new Date()); // 设置更新日期
fileUpload.setStatus(FileUploadStatusEnum.NORMAL); fileUpload.setStatus(FileUploadStatusEnum.NORMAL); // 设置状态为正常
iFileUploadService.insert(fileUpload); iFileUploadService.insert(fileUpload); // 插入文件上传记录到数据库
fileUpload.setFilePath(domainName + "files/" + sysFile.getFilePath()); fileUpload.setFilePath(domainName + "files/" + sysFile.getFilePath()); // 设置文件路径
fileUpload.setFileSize(sysFile.getFileSize()); fileUpload.setFileSize(sysFile.getFileSize()); // 设置文件大小
return Result.successResult(fileUpload);
return Result.successResult(fileUpload); // 返回文件上传记录信息
} catch (IOException e) { } catch (IOException e) {
e.printStackTrace(); e.printStackTrace();
return Result.failResult("上传失败"); return Result.failResult("上传失败"); // 如果上传失败，返回失败结果
} }
} }
/** /**
* 移除文件 * 移除文件的请求处理
* @param id 文件上传记录 ID
* @return 返回处理结果
*/ */
@RequestMapping(value = "removeFile", method = RequestMethod.POST) @RequestMapping(value = "removeFile", method = RequestMethod.POST)
@ResponseBody @ResponseBody
public Result removeFile(String id) { public Result removeFile(String id) {
try { try {
iFileUploadService.deleteById(id); iFileUploadService.deleteById(id); // 根据 ID 删除文件上传记录
} catch (Exception e) { } catch (Exception e) {
return Result.result(1, null, "删除失败"); return Result.result(1, null, "删除失败"); // 如果删除失败，返回失败结果
} }
return Result.result(0, null, "删除成功"); return Result.result(0, null, "删除成功"); // 如果删除成功，返回成功结果
} }
@SuppressWarnings("unchecked") /**
* 删除文档的请求处理
* @param id 文档 ID
* @return 返回处理结果
*/
@RequestMapping(value = "delete", method = RequestMethod.POST) @RequestMapping(value = "delete", method = RequestMethod.POST)
@ResponseBody @ResponseBody
public Result delete(String id) { public Result delete(String id) {
try { try {
DocumentEntity document = iDocumentService.selectById(id); DocumentEntity document = iDocumentService.selectById(id); // 根据 ID 获取文档信息
iDocumentService.delete(Condition.create().eq("batch_no", document.getBatchNo())); iDocumentService.delete(Condition.create().eq("batch_no", document.getBatchNo())); // 根据批次号删除文档
} catch (Exception e) { } catch (Exception e) {
return Result.result(1, null, "删除失败"); return Result.result(1, null, "删除失败"); // 如果删除失败，返回失败结果
} }
return Result.result(0, null, "删除成功"); return Result.result(0, null, "删除成功"); // 如果删除成功，返回成功结果
} }
} }

33
tamguo-mms/src/main/java/com/tamguo/web/EmailController.java
Unescape View File

@ -1,34 +1,45 @@
package com.tamguo.web; package com.tamguo.web;
import org.apache.commons.mail.EmailException; import org.apache.commons.mail.EmailException; // 导入邮件异常类
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired; // 导入自动注入注解
import org.springframework.stereotype.Controller; import org.springframework.stereotype.Controller; // 标注为控制器类
import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMapping; // 处理请求映射
import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RequestMethod; // 请求方法
import org.springframework.web.bind.annotation.ResponseBody; import org.springframework.web.bind.annotation.ResponseBody; // 返回响应体
import com.tamguo.common.utils.Result; import com.tamguo.common.utils.Result; // 通用结果类
import com.tamguo.common.utils.SystemConstant; import com.tamguo.common.utils.SystemConstant; // 系统常量类
import com.tamguo.modules.sys.service.IEmailService; import com.tamguo.modules.sys.service.IEmailService; // 邮件服务接口
/**
* EmailController 类，处理邮件相关的请求
*/
@Controller @Controller
public class EmailController { public class EmailController {
@Autowired @Autowired // 自动注入邮件服务实例
private IEmailService iEmailService; private IEmailService iEmailService;
/**
* 处理发送找回密码邮件的请求
* @param email 接收邮件的地址
* @return 响应结果
*/
@RequestMapping(value = {"sendFindPasswordEmail"}, method = RequestMethod.GET) @RequestMapping(value = {"sendFindPasswordEmail"}, method = RequestMethod.GET)
@ResponseBody @ResponseBody
public Result sendFindPasswordEmail(String email) { public Result sendFindPasswordEmail(String email) {
try { try {
// 调用邮件服务发送找回密码邮件，并获取结果
Integer result = iEmailService.sendFindPasswordEmail(email, SystemConstant.ALIYUN_MAIL_SUBJECT_FINDPASSWORD); Integer result = iEmailService.sendFindPasswordEmail(email, SystemConstant.ALIYUN_MAIL_SUBJECT_FINDPASSWORD);
if (result == 0) { if (result == 0) {
// 如果结果为 0，返回服务器异常的结果
return Result.result(200, null, "服务器异常"); return Result.result(200, null, "服务器异常");
} }
} catch (EmailException e) { } catch (EmailException e) {
// 捕获邮件异常并打印堆栈信息
e.printStackTrace(); e.printStackTrace();
} }
// 无论是否发生异常，都返回服务器异常的结果
return Result.result(500, null, "服务器异常"); return Result.result(500, null, "服务器异常");
} }
} }

98
tamguo-mms/src/main/java/com/tamguo/web/FileController.java
Unescape View File

@ -1,73 +1,81 @@
package com.tamguo.web; package com.tamguo.web;
import java.io.File; import java.io.File; // 文件类
import java.io.FileInputStream; import java.io.FileInputStream; // 文件输入流类
import java.io.IOException; import java.io.IOException; // 输入输出异常类
import java.util.Date; import java.util.Date; // 日期类
import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletRequest; // HTTP 请求类
import org.apache.commons.io.FileUtils; import org.apache.commons.io.FileUtils; // 文件工具类
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired; // 自动注入注解
import org.springframework.beans.factory.annotation.Value; import org.springframework.beans.factory.annotation.Value; // 值注入注解
import org.springframework.stereotype.Controller; import org.springframework.stereotype.Controller; // 控制器类
import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMapping; // 请求映射
import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RequestMethod; // 请求方法
import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RequestParam; // 请求参数
import org.springframework.web.bind.annotation.ResponseBody; import org.springframework.web.bind.annotation.ResponseBody; // 返回响应体
import org.springframework.web.multipart.MultipartFile;
import com.baomidou.mybatisplus.mapper.Condition; import com.baomidou.mybatisplus.mapper.Condition; // 条件类
import com.tamguo.common.utils.DateUtil; import com.tamguo.common.utils.DateUtil; // 日期工具类
import com.tamguo.common.utils.Result; import com.tamguo.common.utils.Result; // 通用结果类
import com.tamguo.modules.book.model.FileEntity; import com.tamguo.modules.book.model.FileEntity; // 文件实体类
import com.tamguo.modules.book.service.IFileEntityService; import com.tamguo.modules.book.service.IFileEntityService; // 文件服务接口
import com.tamguo.utils.FileMd5Utils;
/**
* FileController 类，处理文件上传相关的请求
*/
@Controller @Controller
public class FileController { public class FileController {
@Value("${file.storage.path}") @Value("${file.storage.path}") // 获取配置文件中文件存储路径的值
private String fileStoragePath; private String fileStoragePath;
@Value("${tamguo.domain.name}")
@Value("${tamguo.domain.name}") // 获取配置文件中域名的值
private String domainName; private String domainName;
@Autowired
@Autowired // 自动注入文件服务实例
private IFileEntityService iFileEntityService; private IFileEntityService iFileEntityService;
/**
* 处理上传图片的请求
* @param file 上传的文件
* @param request HTTP 请求对象
* @return 响应结果
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@RequestMapping(value = "uploadImage", method = RequestMethod.POST) @RequestMapping(value = "uploadImage", method = RequestMethod.POST)
@ResponseBody @ResponseBody
public Result uploadImage(@RequestParam("file") MultipartFile file, HttpServletRequest request) { public Result uploadImage(@RequestParam("file") MultipartFile file, HttpServletRequest request) {
try { try {
String fileMd5 = FileMd5Utils.getMD5((FileInputStream)file.getInputStream()); String fileMd5 = FileMd5Utils.getMD5((FileInputStream)file.getInputStream()); // 获取文件的 MD5 值
FileEntity sysFile = iFileEntityService.selectOne(Condition.create().eq("file_md5", fileMd5)); FileEntity sysFile = iFileEntityService.selectOne(Condition.create().eq("file_md5", fileMd5)); // 根据文件 MD5 查找文件实体
if(sysFile != null) { if (sysFile!= null) { // 如果找到文件实体
sysFile.setFilePath(domainName + "files/" + sysFile.getFilePath()); sysFile.setFilePath(domainName + "files/" + sysFile.getFilePath()); // 设置文件路径
return Result.successResult(sysFile); return Result.successResult(sysFile); // 返回文件实体
} }
String filePath = fileStoragePath + DateUtil.fomatDate(new Date(), "yyyyMM") + "/avatar"; String filePath = fileStoragePath + DateUtil.fomatDate(new Date(), "yyyyMM") + "/avatar"; // 设置文件存储路径
File dest = new File(filePath); File dest = new File(filePath); // 创建文件对象
if(!dest.exists()) { if (!dest.exists()) { // 如果文件不存在
dest.mkdirs(); dest.mkdirs(); // 创建文件夹
} }
// save 文件 // 保存文件
FileUtils.writeByteArrayToFile(new File(filePath + "/" + file.getOriginalFilename()), file.getBytes()); FileUtils.writeByteArrayToFile(new File(filePath + "/" + file.getOriginalFilename()), file.getBytes());
FileEntity fileEntity = new FileEntity(); FileEntity fileEntity = new FileEntity(); // 创建文件实体对象
fileEntity.setFileContentType(file.getContentType()); fileEntity.setFileContentType(file.getContentType()); // 设置文件类型
fileEntity.setFileExtension(file.getOriginalFilename()); fileEntity.setFileExtension(file.getOriginalFilename()); // 设置文件扩展名
fileEntity.setFileMd5(FileMd5Utils.getMD5((FileInputStream)file.getInputStream())); fileEntity.setFileMd5(FileMd5Utils.getMD5((FileInputStream)file.getInputStream())); // 设置文件 MD5 值
fileEntity.setFileSize(file.getSize()); fileEntity.setFileSize(file.getSize()); // 设置文件大小
fileEntity.setFilePath(DateUtil.fomatDate(new Date(), "yyyyMM") + "/avatar/" + file.getOriginalFilename()); fileEntity.setFilePath(DateUtil.fomatDate(new Date(), "yyyyMM") + "/avatar/" + file.getOriginalFilename()); // 设置文件路径
iFileEntityService.insert(fileEntity); iFileEntityService.insert(fileEntity); // 插入文件实体到数据库
fileEntity.setFilePath(domainName + "files/" + fileEntity.getFilePath()); fileEntity.setFilePath(domainName + "files/" + fileEntity.getFilePath()); // 设置文件路径
return Result.successResult(fileEntity); return Result.successResult(fileEntity); // 返回文件实体
} catch (IOException e) { } catch (IOException e) {
e.printStackTrace(); e.printStackTrace(); // 打印异常信息
return Result.failResult("上传失败"); return Result.failResult("上传失败"); // 返回上传失败的结果
} }
} }
} }

64
tamguo-mms/src/main/java/com/tamguo/web/HistoryDocController.java
Unescape View File

@ -18,74 +18,108 @@ import com.tamguo.modules.book.model.DocumentEntity;
import com.tamguo.modules.book.model.enums.DocumentStatusEnum; import com.tamguo.modules.book.model.enums.DocumentStatusEnum;
import com.tamguo.modules.book.service.IDocumentService; import com.tamguo.modules.book.service.IDocumentService;
/**
* HistoryDocController 类，处理历史文档相关的请求
*/
@Controller @Controller
@RequestMapping(value="document") @RequestMapping(value="document")
public class HistoryDocController { public class HistoryDocController {
// 日志记录器
private Logger logger = LoggerFactory.getLogger(getClass()); private Logger logger = LoggerFactory.getLogger(getClass());
@Autowired @Autowired
private IDocumentService iDocumentService; private IDocumentService iDocumentService;
/** /**
* 历史记录 * 历史记录请求处理方法
* @param id 文档 ID
* @param model 模型视图对象
* @return 模型视图
*/ */
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@RequestMapping(value = "history", method = RequestMethod.POST) @RequestMapping(value = "history", method = RequestMethod.POST)
public ModelAndView history(String id, ModelAndView model) { public ModelAndView history(String id, ModelAndView model) {
model.setViewName("book/history"); model.setViewName("book/history"); // 设置视图名称
// 根据 ID 查询文档实体
DocumentEntity document = iDocumentService.selectById(id); DocumentEntity document = iDocumentService.selectById(id);
model.addObject("document", document); model.addObject("document", document); // 添加文档到模型
// 查询与该批次号且状态为历史的文档列表，并按创建日期降序排序
model.addObject("historyList", iDocumentService.selectList(Condition.create().eq("batch_no", document.getBatchNo()).eq("status", DocumentStatusEnum.HISTORY.getValue()).orderDesc(Arrays.asList("create_date")))); model.addObject("historyList", iDocumentService.selectList(Condition.create().eq("batch_no", document.getBatchNo()).eq("status", DocumentStatusEnum.HISTORY.getValue()).orderDesc(Arrays.asList("create_date"))));
return model; return model;
} }
/** /**
* 删除 * 删除请求处理方法
* @param id 文档 ID
* @return 删除结果
*/ */
@RequestMapping(value = "history/delete", method = RequestMethod.POST) @RequestMapping(value = "history/delete", method = RequestMethod.POST)
@ResponseBody @ResponseBody
public Result delete(String id) { public Result delete(String id) {
try { try {
// 根据 ID 删除文档
iDocumentService.deleteById(id); iDocumentService.deleteById(id);
} catch (Exception e) { } catch (Exception e) {
logger.error(e.getMessage() , e); logger.error(e.getMessage(), e); // 记录错误日志
return Result.failResult("删除失败！"); return Result.failResult("删除失败！"); // 返回删除失败结果
} }
return Result.successResult("删除成功！"); return Result.successResult("删除成功！"); // 返回删除成功结果
} }
/** /**
* 恢复 * 恢复请求处理方法
* @param id 文档 ID
* @return 恢复结果
*/ */
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@RequestMapping(value = "history/restore", method = RequestMethod.POST) @RequestMapping(value = "history/restore", method = RequestMethod.POST)
@ResponseBody @ResponseBody
public Result restore(String id) { public Result restore(String id) {
try { try {
// 根据 ID 查询历史文档
DocumentEntity history = iDocumentService.selectById(id); DocumentEntity history = iDocumentService.selectById(id);
// 获取历史文档的内容和 markdown
String content = history.getContent(); String content = history.getContent();
String markdown = history.getMarkdown(); String markdown = history.getMarkdown();
// 查询与该批次号且状态为正常的文档
DocumentEntity document = iDocumentService.selectOne(Condition.create().eq("batch_no", history.getBatchNo()).eq("status", DocumentStatusEnum.NORMAL.getValue())); DocumentEntity document = iDocumentService.selectOne(Condition.create().eq("batch_no", history.getBatchNo()).eq("status", DocumentStatusEnum.NORMAL.getValue()));
// 设置文档的内容和 markdown
document.setContent(content); document.setContent(content);
document.setMarkdown(markdown); document.setMarkdown(markdown);
document.setCover("no"); document.setCover("no");
// 修改文档
iDocumentService.modify(document); iDocumentService.modify(document);
return Result.successResult(document); return Result.successResult(document); // 返回恢复成功结果和文档
} catch (Exception e) { } catch (Exception e) {
logger.error(e.getMessage() , e); logger.error(e.getMessage(), e); // 记录错误日志
return Result.failResult("恢复失败！"); return Result.failResult("恢复失败！"); // 返回恢复失败结果
} }
} }
/**
* 比较请求处理方法
* @param id 文档 ID
* @param model 模型视图对象
* @return 模型视图
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@RequestMapping(value = "history/compare/{id}", method = RequestMethod.POST) @RequestMapping(value = "history/compare/{id}", method = RequestMethod.POST)
@ResponseBody
public ModelAndView compare(@PathVariable String id, ModelAndView model) { public ModelAndView compare(@PathVariable String id, ModelAndView model) {
model.setViewName("book/compare"); model.setViewName("book/compare"); // 设置视图名称
// 根据 ID 查询历史文档
DocumentEntity history = iDocumentService.selectById(id); DocumentEntity history = iDocumentService.selectById(id);
model.addObject("history", history); model.addObject("history", history); // 添加历史文档到模型
model.addObject("document", iDocumentService.selectOne(Condition.create().eq("status", DocumentStatusEnum.NORMAL.getValue()).eq("batch_no", history.getBatchNo())));
// 查询与该批次号且状态为正常的文档
model.addObject("document", iDocumentService.selectOne(Condition.create().eq("batch_no", history.getBatchNo()).eq("status", DocumentStatusEnum.NORMAL.getValue())));
return model; return model;
} }
} }

28
tamguo-mms/src/main/java/com/tamguo/web/IndexController.java
Unescape View File

@ -1,12 +1,13 @@
package com.tamguo.web; package com.tamguo.web;
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired; // 注入依赖
import org.springframework.stereotype.Controller; import org.springframework.stereotype.Controller; // 定义为控制器
import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMapping; // 处理请求映射
import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RequestMethod; // 请求方法
import org.springframework.web.servlet.ModelAndView; import org.springframework.web.servlet.ModelAndView; // 模型和视图
import com.tamguo.modules.member.service.IMemberService;
import com.tamguo.utils.ShiroUtils; import com.tamguo.modules.member.service.IMemberService; // 会员服务接口
import com.tamguo.utils.ShiroUtils; // Shiro 工具类
/** /**
* 会员中心-首页 * 会员中心-首页
@ -17,14 +18,19 @@ import com.tamguo.utils.ShiroUtils;
@Controller @Controller
public class IndexController { public class IndexController {
@Autowired @Autowired // 自动注入会员服务实例
IMemberService iMemberService; IMemberService iMemberService;
/**
* 处理 index.html 或 / 的 GET 请求
*
* @param model 模型和视图对象
* @return 模型和视图对象
*/
@RequestMapping(value = {"index.html", "/"}, method = RequestMethod.GET) @RequestMapping(value = {"index.html", "/"}, method = RequestMethod.GET)
public ModelAndView index(ModelAndView model) { public ModelAndView index(ModelAndView model) {
model.setViewName("index"); model.setViewName("index"); // 设置视图名称为 "index"
model.addObject("member", iMemberService.selectById(ShiroUtils.getMemberId())); model.addObject("member", iMemberService.selectById(ShiroUtils.getMemberId())); // 添加会员信息到模型中
return model; return model;
} }
} }

52
tamguo-mms/src/main/java/com/tamguo/web/LoginController.java
Unescape View File

@ -22,9 +22,23 @@ import com.tamguo.common.utils.Result;
import com.tamguo.common.utils.SystemConstant; import com.tamguo.common.utils.SystemConstant;
import com.tamguo.utils.ShiroUtils; import com.tamguo.utils.ShiroUtils;
/**
* 登录控制器
*
* @author tamguo
*
*/
@Controller @Controller
public class LoginController { public class LoginController {
/**
* 生成验证码图片并设置到响应头和会话中
*
* @param response 响应对象
* @param session 会话对象
* @throws ServletException 可能抛出的 Servlet 异常
* @throws IOException 可能抛出的 IO 异常
*/
@RequestMapping("captcha.jpg") @RequestMapping("captcha.jpg")
public void captcha(HttpServletResponse response, HttpSession session) throws ServletException, IOException { public void captcha(HttpServletResponse response, HttpSession session) throws ServletException, IOException {
response.setHeader("Cache-Control", "no-store, no-cache"); response.setHeader("Cache-Control", "no-store, no-cache");
@ -34,6 +48,13 @@ public class LoginController {
session.setAttribute(SystemConstant.KAPTCHA_SESSION_KEY, a); session.setAttribute(SystemConstant.KAPTCHA_SESSION_KEY, a);
} }
/**
* 处理登录页面的 GET 请求，设置模型和视图属性
*
* @param redirectUrl 重定向 URL
* @param model 模型和视图对象
* @return 模型和视图对象
*/
@RequestMapping(value = "/login.html", method = RequestMethod.GET) @RequestMapping(value = "/login.html", method = RequestMethod.GET)
public ModelAndView login(String redirectUrl, ModelAndView model) { public ModelAndView login(String redirectUrl, ModelAndView model) {
model.setViewName("login"); model.setViewName("login");
@ -42,9 +63,23 @@ public class LoginController {
return model; return model;
} }
/**
* 处理提交登录的 POST 请求，进行登录验证和处理
*
* @param username 用户名
* @param password 密码
* @param verifyCode 验证码
* @param redirectUrl 重定向 URL
* @param model 模型和视图对象
* @param session 会话对象
* @param response 响应对象
* @return 模型和视图对象或 null
* @throws IOException 可能抛出的 IO 异常
*/
@RequestMapping(value = "/submitLogin.html", method = RequestMethod.POST) @RequestMapping(value = "/submitLogin.html", method = RequestMethod.POST)
public ModelAndView submitLogin(String username, String password, String verifyCode, String redirectUrl, ModelAndView model, HttpSession session, HttpServletResponse response) throws IOException { public ModelAndView submitLogin(String username, String password, String verifyCode, String redirectUrl, ModelAndView model, HttpSession session, HttpServletResponse response) throws IOException {
Result result = Result.successResult(null); Result result = Result.successResult(null);
if (StringUtils.isEmpty(verifyCode)) { if (StringUtils.isEmpty(verifyCode)) {
result = Result.result(202, null, "请输入验证码"); result = Result.result(202, null, "请输入验证码");
} else if (StringUtils.isNotEmpty(verifyCode)) { } else if (StringUtils.isNotEmpty(verifyCode)) {
@ -73,6 +108,7 @@ public class LoginController {
} }
} }
} }
model.setViewName("login"); model.setViewName("login");
model.addObject("code", result.getCode()); model.addObject("code", result.getCode());
model.addObject("msg", result.getMessage()); model.addObject("msg", result.getMessage());
@ -80,10 +116,21 @@ public class LoginController {
return model; return model;
} }
/**
* 处理迷你登录的 GET 请求，进行登录验证和处理
*
* @param username 用户名
* @param password 密码
* @param captcha 验证码
* @param model 模型和视图对象
* @param session 会话对象
* @return 结果对象
*/
@RequestMapping(value = "/miniLogin.html", method = RequestMethod.GET) @RequestMapping(value = "/miniLogin.html", method = RequestMethod.GET)
@ResponseBody @ResponseBody
public Result miniLogin(String username, String password, String captcha, ModelAndView model, HttpSession session) { public Result miniLogin(String username, String password, String captcha, ModelAndView model, HttpSession session) {
Result result = null; Result result = null;
if (StringUtils.isEmpty(captcha)) { if (StringUtils.isEmpty(captcha)) {
result = Result.result(204, null, "请输入验证码"); result = Result.result(204, null, "请输入验证码");
} else if (StringUtils.isNotEmpty(captcha)) { } else if (StringUtils.isNotEmpty(captcha)) {
@ -109,6 +156,11 @@ public class LoginController {
return result; return result;
} }
/**
* 检查是否登录
*
* @return 结果对象
*/
@RequestMapping(value = "/isLogin.html", method = RequestMethod.GET) @RequestMapping(value = "/isLogin.html", method = RequestMethod.GET)
@ResponseBody @ResponseBody
public Result isLogin() { public Result isLogin() {

31
tamguo-mms/src/main/java/com/tamguo/web/LogoutController.java
Unescape View File

@ -1,28 +1,27 @@
package com.tamguo.web; package com.tamguo.web;
import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletRequest; // 导入 HttpServletRequest 类
import javax.servlet.http.HttpServletResponse; import javax.servlet.http.HttpServletResponse; // 导入 HttpServletResponse 类
import javax.servlet.http.HttpSession; import javax.servlet.http.HttpSession; // 导入 HttpSession 类
import org.springframework.stereotype.Controller; import org.springframework.stereotype.Controller; // 表示这是一个控制器类
import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMapping; // 用于处理请求映射
import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RequestMethod; // 用于指定请求方法
import com.tamguo.utils.ShiroUtils; import com.tamguo.utils.ShiroUtils; // 导入 ShiroUtils 类
@Controller @Controller // 声明这是一个控制器
public class LogoutController { public class LogoutController {
/** /**
* 注销 * 注销方法
*/ */
@RequestMapping(value = "logout.html", method = RequestMethod.GET) @RequestMapping(value = "logout.html", method = RequestMethod.GET) // 映射到 "logout.html" 且使用 GET 方法的请求
public String logout(HttpServletRequest request, HttpServletResponse response, HttpSession session) { public String logout(HttpServletRequest request, HttpServletResponse response, HttpSession session) { // 接收请求、响应和会话对象
if (session.getAttribute("currMember") != null) { if (session.getAttribute("currMember")!= null) { // 如果会话中当前成员不为空
session.removeAttribute("currMember"); session.removeAttribute("currMember"); // 从会话中移除当前成员属性
ShiroUtils.logout(); ShiroUtils.logout(); // 执行 ShiroUtils 的注销操作
} }
return "redirect:/"; return "redirect:/"; // 重定向到根路径
} }
} }

116
tamguo-mms/src/main/java/com/tamguo/web/PasswordController.java
Unescape View File

@ -1,81 +1,95 @@
package com.tamguo.web; package com.tamguo.web;
import javax.servlet.http.HttpSession; import javax.servlet.http.HttpSession; // 导入 HttpSession 类
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired; // 表示自动注入
import org.springframework.stereotype.Controller; import org.springframework.stereotype.Controller; // 声明这是一个控制器类
import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMapping; // 处理请求映射
import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RequestMethod; // 指定请求方法
import org.springframework.web.bind.annotation.ResponseBody; import org.springframework.web.bind.annotation.ResponseBody; // 用于返回响应体
import org.springframework.web.servlet.ModelAndView; import org.springframework.web.servlet.ModelAndView; // 模型和视图类
import com.tamguo.common.utils.Result; import com.tamguo.common.utils.Result; // 通用结果类
import com.tamguo.common.utils.SystemConstant; import com.tamguo.common.utils.SystemConstant; // 系统常量类
import com.tamguo.modules.member.service.IMemberService; import com.tamguo.modules.member.service.IMemberService; // 会员服务接口
@Controller @Controller // 控制器注解
public class PasswordController { public class PasswordController {
@Autowired @Autowired // 自动注入会员服务
private IMemberService iMemberService; private IMemberService iMemberService;
/**
* 确认账号页面的请求映射
*/
@RequestMapping(value = "password/find.html", method = RequestMethod.GET) @RequestMapping(value = "password/find.html", method = RequestMethod.GET)
public ModelAndView confirmAccount(ModelAndView model){ public ModelAndView confirmAccount(ModelAndView model) { // 处理方法，接收模型和视图对象
model.setViewName("password/confirmAccount"); model.setViewName("password/confirmAccount"); // 设置视图名称
return model; return model; // 返回模型和视图
} }
/**
* 提交确认账号的请求映射
*/
@RequestMapping(value = "password/confirmAccount.html", method = RequestMethod.POST) @RequestMapping(value = "password/confirmAccount.html", method = RequestMethod.POST)
public ModelAndView submitConfirmAccount(String username , String veritycode , ModelAndView model , HttpSession session){ public ModelAndView submitConfirmAccount(String username, String veritycode, ModelAndView model, HttpSession session) { // 处理方法，接收参数、模型和视图对象、会话对象
Result result = iMemberService.confirmAccount(username, veritycode); Result result = iMemberService.confirmAccount(username, veritycode); // 调用会员服务的确认账号方法
String kaptcha = session.getAttribute(SystemConstant.KAPTCHA_SESSION_KEY).toString(); String kaptcha = session.getAttribute(SystemConstant.KAPTCHA_SESSION_KEY).toString(); // 获取验证码
if (!veritycode.equalsIgnoreCase(kaptcha)) { if (!veritycode.equalsIgnoreCase(kaptcha)) { // 比较验证码是否正确
result = Result.result(202, null, "验证码错误"); result = Result.result(202, null, "验证码错误"); // 设置错误结果
} }
if(result.getCode() == 200){ if (result.getCode() == 200) { // 如果结果码为 200
model.setViewName("password/securityCheck"); model.setViewName("password/securityCheck"); // 设置视图名称
model.addObject("result", result); model.addObject("result", result); // 添加结果到模型
model.addObject("isEmail", username.contains("@") ? "1" : "0"); model.addObject("isEmail", username.contains("@")? "1" : "0"); // 添加是否为邮箱的标识到模型
} else { } else {
model.setViewName("password/confirmAccount"); model.setViewName("password/confirmAccount"); // 设置视图名称
model.addObject("account", username); model.addObject("account", username); // 添加账号到模型
model.addObject("username",username); model.addObject("username", username); // 添加用户名到模型
model.addObject("veritycode", veritycode); model.addObject("veritycode", veritycode); // 添加验证码到模型
model.addObject("code", result.getCode()); model.addObject("code", result.getCode()); // 添加结果码到模型
} }
return model; return model; // 返回模型和视图
} }
/**
* 安全检查页面的请求映射
*/
@RequestMapping(value = "password/securityCheck.html", method = RequestMethod.POST) @RequestMapping(value = "password/securityCheck.html", method = RequestMethod.POST)
public ModelAndView securityCheck(String username , String isEmail , String mobileVcode , ModelAndView model){ public ModelAndView securityCheck(String username, String isEmail, String mobileVcode, ModelAndView model) { // 处理方法，接收参数、模型和视图对象
Result result = iMemberService.securityCheck(username , isEmail , mobileVcode); Result result = iMemberService.securityCheck(username, isEmail, mobileVcode); // 调用会员服务的安全检查方法
if(result.getCode() == 200){ if (result.getCode() == 200) { // 如果结果码为 200
model.addObject("username", username); model.addObject("username", username); // 添加用户名到模型
model.addObject("resetPasswordKey" , result.getResult()); model.addObject("resetPasswordKey", result.getResult()); // 添加重置密码键到模型
model.setViewName("password/resetPassword"); model.setViewName("password/resetPassword"); // 设置视图名称
} else { } else {
model.addObject("result", result); model.addObject("result", result); // 添加结果到模型
model.addObject("isEmail", isEmail); model.addObject("isEmail", isEmail); // 添加是否为邮箱的标识到模型
model.addObject("codeError", "1"); model.addObject("codeError", "1"); // 添加错误标识到模型
model.setViewName("password/securityCheck"); model.setViewName("password/securityCheck"); // 设置视图名称
} }
return model; return model; // 返回模型和视图
} }
/**
* 重置密码页面的请求映射
*/
@RequestMapping(value = "password/resetPassword.html", method = RequestMethod.POST) @RequestMapping(value = "password/resetPassword.html", method = RequestMethod.POST)
public ModelAndView resetPassword(String resetPasswordKey , String username , String password , String verifypwd , ModelAndView model){ public ModelAndView resetPassword(String resetPasswordKey, String username, String password, String verifypwd, ModelAndView model) { // 处理方法，接收参数、模型和视图对象
Result result = iMemberService.resetPassword(resetPasswordKey , username , password , verifypwd); Result result = iMemberService.resetPassword(resetPasswordKey, username, password, verifypwd); // 调用会员服务的重置密码方法
if(result.getCode() == 200){ if (result.getCode() == 200) { // 如果结果码为 200
model.setViewName("password/resetPwSuccess"); model.setViewName("password/resetPwSuccess"); // 设置视图名称
} else { } else {
model.setViewName("password/resetPassword"); model.setViewName("password/resetPassword"); // 设置视图名称
} }
return model; return model; // 返回模型和视图
} }
/**
* 检查账号的请求映射
*/
@RequestMapping(value = "password/checkAccount.html", method = RequestMethod.GET) @RequestMapping(value = "password/checkAccount.html", method = RequestMethod.GET)
@ResponseBody @ResponseBody // 返回响应体
public Result checkAccount(String account){ public Result checkAccount(String account) { // 处理方法，接收账号参数
return iMemberService.checkAccount(account); return iMemberService.checkAccount(account); // 调用会员服务的检查账号方法并返回结果
} }
} }

34
tamguo-mms/src/main/java/com/tamguo/web/RegisterController.java
Unescape View File

@ -19,41 +19,74 @@ import com.tamguo.modules.member.model.MemberEntity;
import com.tamguo.modules.member.service.IMemberService; import com.tamguo.modules.member.service.IMemberService;
import com.tamguo.utils.ShiroUtils; import com.tamguo.utils.ShiroUtils;
/**
* RegisterController 类，处理注册相关的请求
*/
@Controller @Controller
public class RegisterController { public class RegisterController {
/**
* 依赖注入 IMemberService
*/
@Autowired @Autowired
private IMemberService iMemberService; private IMemberService iMemberService;
/**
* 处理 /register.html 的 GET 请求，返回注册页面的视图
* @param model 模型视图对象
* @param session HttpSession 对象
* @return 模型视图对象
*/
@RequestMapping(value = "/register.html", method = RequestMethod.GET) @RequestMapping(value = "/register.html", method = RequestMethod.GET)
public ModelAndView register(ModelAndView model, HttpSession session) { public ModelAndView register(ModelAndView model, HttpSession session) {
model.setViewName("register"); model.setViewName("register");
return model; return model;
} }
/**
* 处理 /checkUsername.html 的 GET 请求，检查用户名是否可用，并返回结果
* @param username 用户名
* @return 检查结果
*/
@RequestMapping(value = "/checkUsername.html", method = RequestMethod.GET) @RequestMapping(value = "/checkUsername.html", method = RequestMethod.GET)
@ResponseBody @ResponseBody
public Result checkUsername(String username) { public Result checkUsername(String username) {
return iMemberService.checkUsername(username); return iMemberService.checkUsername(username);
} }
/**
* 处理 /checkMobile.html 的 GET 请求，检查手机号是否可用，并返回结果
* @param mobile 手机号
* @return 检查结果
*/
@RequestMapping(value = "/checkMobile.html", method = RequestMethod.GET) @RequestMapping(value = "/checkMobile.html", method = RequestMethod.GET)
@ResponseBody @ResponseBody
public Result checkMobile(String mobile) { public Result checkMobile(String mobile) {
return iMemberService.checkMobile(mobile); return iMemberService.checkMobile(mobile);
} }
/**
* 处理 /subRegister 的 POST 请求，进行注册操作
* @param member 会员实体对象
* @param session HttpSession 对象
* @return 注册结果
*/
@RequestMapping(value = "/subRegister", method = RequestMethod.POST) @RequestMapping(value = "/subRegister", method = RequestMethod.POST)
@ResponseBody @ResponseBody
public Result subRegister(@RequestBody MemberEntity member, HttpSession session) { public Result subRegister(@RequestBody MemberEntity member, HttpSession session) {
Result result = iMemberService.register(member); Result result = iMemberService.register(member);
if (result.getCode() == 200) { if (result.getCode() == 200) {
// 获取 Shiro 主体
Subject subject = ShiroUtils.getSubject(); Subject subject = ShiroUtils.getSubject();
// 获取注册成功的会员实体对象
MemberEntity memberEntity = (MemberEntity) result.getResult(); MemberEntity memberEntity = (MemberEntity) result.getResult();
// 创建用户名密码令牌
UsernamePasswordToken token = new UsernamePasswordToken(memberEntity.getUsername(), member.getPassword()); UsernamePasswordToken token = new UsernamePasswordToken(memberEntity.getUsername(), member.getPassword());
try { try {
// 主体登录
subject.login(token); subject.login(token);
// 设置当前会员到会话中
session.setAttribute("currMember", ShiroUtils.getMember()); session.setAttribute("currMember", ShiroUtils.getMember());
} catch (UnknownAccountException e) { } catch (UnknownAccountException e) {
return Result.result(201, null, "用户名或密码有误，请重新输入或找回密码"); return Result.result(201, null, "用户名或密码有误，请重新输入或找回密码");
@ -65,5 +98,4 @@ public class RegisterController {
} }
return result; return result;
} }
} }

17
tamguo-mms/src/main/java/com/tamguo/web/SmsController.java
Unescape View File

@ -10,21 +10,34 @@ import com.aliyuncs.exceptions.ClientException;
import com.tamguo.common.utils.Result; import com.tamguo.common.utils.Result;
import com.tamguo.modules.sys.service.ISmsService; import com.tamguo.modules.sys.service.ISmsService;
/**
* SmsController 类，处理短信相关的请求
*/
@Controller @Controller
public class SmsController { public class SmsController {
/**
* 依赖注入 ISmsService
*/
@Autowired @Autowired
ISmsService iSmsService; private ISmsService iSmsService;
/**
* 处理 /sendFindPasswordSms 的 GET 请求，发送找回密码短信
* @param mobile 手机号
* @return 发送结果
*/
@RequestMapping(value = {"sendFindPasswordSms"}, method = RequestMethod.GET) @RequestMapping(value = {"sendFindPasswordSms"}, method = RequestMethod.GET)
@ResponseBody @ResponseBody
public Result sendFindPasswordSms(String mobile) { public Result sendFindPasswordSms(String mobile) {
try { try {
// 调用 ISmsService 发送找回密码短信，并返回结果
return iSmsService.sendFindPasswordSms(mobile); return iSmsService.sendFindPasswordSms(mobile);
} catch (ClientException e) { } catch (ClientException e) {
// 打印异常信息
e.printStackTrace(); e.printStackTrace();
} }
// 返回错误结果
return Result.result(500, null, ""); return Result.result(500, null, "");
} }
} }

70
tamguo-mms/src/main/java/com/tamguo/web/interceptor/MemberInterceptor.java
Unescape View File

@ -1,55 +1,59 @@
package com.tamguo.web.interceptor; package com.tamguo.web.interceptor;
import java.net.URLEncoder; import java.net.URLEncoder; // 导入用于编码的类
import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletRequest; // 导入 Http 请求类
import javax.servlet.http.HttpServletResponse; import javax.servlet.http.HttpServletResponse; // 导入 Http 响应类
import org.springframework.stereotype.Component; import org.springframework.stereotype.Component; // 标记为组件
import org.springframework.web.servlet.handler.HandlerInterceptorAdapter; import org.springframework.web.servlet.handler.HandlerInterceptorAdapter; // 继承的拦截器适配器类
/**
* MemberInterceptor 类，处理会员相关的拦截器
*/
@Component @Component
public class MemberInterceptor extends HandlerInterceptorAdapter{ public class MemberInterceptor extends HandlerInterceptorAdapter { // 继承自拦截器适配器
/** "重定向 URL"参数名称 */ /** "重定向 URL"参数名称 */
private static final String REDIRECT_URL_PARAMETER_NAME = "redirectUrl"; private static final String REDIRECT_URL_PARAMETER_NAME = "redirectUrl"; // 定义重定向 URL 参数名称
/** 默认登录 URL */ /** 默认登录 URL */
private static final String DEFAULT_LOGIN_URL = "/login.html"; private static final String DEFAULT_LOGIN_URL = "/login.html"; // 定义默认登录 URL
/** 登录 URL */ /** 登录 URL */
private String loginUrl = DEFAULT_LOGIN_URL; private String loginUrl = DEFAULT_LOGIN_URL; // 定义登录 URL
/** /**
* 请求前处理 * 请求前处理
* *
* @param request * @param request HttpServletRequest
* HttpServletRequest * @param response HttpServletResponse
* @param response * @param handler 处理器
* HttpServletResponse
* @param handler
* 处理器
* @return 是否继续执行 * @return 是否继续执行
*/ */
@Override @Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 重写预处理方法
Object currMember = request.getSession().getAttribute("currMember");
if (currMember != null) { Object currMember = request.getSession().getAttribute("currMember"); // 获取当前会话中的会员对象
return true;
} else { if (currMember!= null) { // 如果会员对象不为空
String requestType = request.getHeader("X-Requested-With"); return true; // 返回 true，继续执行
if (requestType != null && requestType.equalsIgnoreCase("XMLHttpRequest")) { } else { // 否则
response.addHeader("loginStatus", "accessDenied");
response.sendError(HttpServletResponse.SC_FORBIDDEN); String requestType = request.getHeader("X-Requested-With"); // 获取请求头中的"X-Requested-With"
return false;
} else { if (requestType!= null && requestType.equalsIgnoreCase("XMLHttpRequest")) { // 如果是 XMLHttpRequest 请求
if (request.getMethod().equalsIgnoreCase("GET")) { response.addHeader("loginStatus", "accessDenied"); // 在响应头中添加登录状态
String redirectUrl = request.getQueryString() != null ? request.getRequestURI() + "?" + request.getQueryString() : request.getRequestURI(); response.sendError(HttpServletResponse.SC_FORBIDDEN); // 发送禁止访问错误
response.sendRedirect(request.getContextPath() + loginUrl + "?" + REDIRECT_URL_PARAMETER_NAME + "=" + URLEncoder.encode(redirectUrl, "UTF-8")); return false; // 返回 false，停止执行
} else { } else { // 否则
response.sendRedirect(request.getContextPath() + loginUrl);
if (request.getMethod().equalsIgnoreCase("GET")) { // 如果是 GET 请求
String redirectUrl = request.getQueryString()!= null? request.getRequestURI() + "?" + request.getQueryString() : request.getRequestURI(); // 获取重定向 URL
response.sendRedirect(request.getContextPath() + loginUrl + "?" + REDIRECT_URL_PARAMETER_NAME + "=" + URLEncoder.encode(redirectUrl, "UTF-8")); // 发送重定向响应
} else { // 如果是其他请求
response.sendRedirect(request.getContextPath() + loginUrl); // 发送重定向响应
} }
return false; return false; // 返回 false，停止执行
} }
} }
} }
} }

221
tamguo-modules-core/src/main/java/com/tamguo/config/redis/CacheService.java
Unescape View File

@ -18,15 +18,19 @@ import redis.clients.jedis.ShardedJedis;
*/ */
@Service("cacheService") @Service("cacheService")
public class CacheService { public class CacheService {
// 定义 Redis 键的前缀
private final static String REDIS_PRE_KEY = "TAMGUO:"; private final static String REDIS_PRE_KEY = "TAMGUO:";
// 创建对象序列化工具
private SerializeTranscoder objectSerialize = new ObjectUtil(); private SerializeTranscoder objectSerialize = new ObjectUtil();
@Autowired @Autowired
private RedisXMLConfigure redisXMLConfigure; private RedisXMLConfigure redisXMLConfigure;
/** /**
* 获取指定键的值
* *
* @Title: get @Description: @param @return String 返回类型 @throws * @param key 键
* @return 值
*/ */
public String get(String key) { public String get(String key) {
key = getPreKey(key); key = getPreKey(key);
@ -40,8 +44,10 @@ public class CacheService {
} }
/** /**
* 设置指定键的值
* *
* @Title: set @Description: @param @return void 返回类型 @throws * @param key 键
* @param value 值
*/ */
public void set(String key, String value) { public void set(String key, String value) {
key = getPreKey(key); key = getPreKey(key);
@ -55,16 +61,11 @@ public class CacheService {
} }
/** /**
* 设置指定键的值，并指定过期时间（单位：秒）
* *
* set 设置带过期时间的字符缓存 * @param key 键
* * @param value 值
* @param key * @param time 过期时间（单位：秒）
* @param value
* @param time
* 过期时间，秒
* @description
* @exception @since
* 1.0.0
*/ */
public void set(String key, String value, int time) { public void set(String key, String value, int time) {
key = getPreKey(key); key = getPreKey(key);
@ -79,10 +80,10 @@ public class CacheService {
} }
/** /**
* redis中存放对象 * 存储对象到 Redis
* *
* @param key 对象key * @param key 键
* @param value 可序列化的对象 * @param value 对象
*/ */
public void setObject(String key, Object value) { public void setObject(String key, Object value) {
key = getPreKey(key); key = getPreKey(key);
@ -98,11 +99,11 @@ public class CacheService {
} }
/** /**
* 设置过期时间存储对象 * 存储对象到 Redis，并设置过期时间（单位：秒）
* *
* @param key 对象key * @param key 键
* @param value 对象值 * @param value 对象
* @param time 过期时间 秒 * @param time 过期时间（单位：秒）
*/ */
public void setObject(String key, Object value, int time) { public void setObject(String key, Object value, int time) {
key = getPreKey(key); key = getPreKey(key);
@ -118,10 +119,10 @@ public class CacheService {
} }
/** /**
* 获取存储的对象 * 获取 Redis 中存储的对象
* *
* @param key 对象key * @param key 键
* @return 存储的对象 * @return 对象
*/ */
public Object getObject(String key) { public Object getObject(String key) {
key = getPreKey(key); key = getPreKey(key);
@ -141,10 +142,10 @@ public class CacheService {
} }
/** /**
* 删除一个对象 * 删除 Redis 中存储的对象
* *
* @param key 对象key值 * @param key 键
* @return * @return 是否删除成功
*/ */
public boolean deleteObject(String key) { public boolean deleteObject(String key) {
key = getPreKey(key); key = getPreKey(key);
@ -161,9 +162,10 @@ public class CacheService {
} }
/** /**
* 判断指定键是否存在
* *
* @Title: isExist @Description: 判断key是否存在 @param @return boolean * @param key 键
* 返回类型 @throws * @return 是否存在
*/ */
public boolean isExist(String key) { public boolean isExist(String key) {
key = getPreKey(key); key = getPreKey(key);
@ -179,10 +181,22 @@ public class CacheService {
return false; return false;
} }
/**
* 判断指定键是否不存在
*
* @param key 键
* @return 是否不存在
*/
public boolean notExist(String key) { public boolean notExist(String key) {
return!isExist(key); return!isExist(key);
} }
/**
* 删除指定键的值
*
* @param key 键
* @return 是否删除成功
*/
public boolean delete(String key) { public boolean delete(String key) {
key = getPreKey(key); key = getPreKey(key);
ShardedJedis conn = null; ShardedJedis conn = null;
@ -198,11 +212,11 @@ public class CacheService {
} }
/** /**
* 关于 redis list的操作 将 值 value 插入到列表 key 的表尾(最右边)。 * 将值插入到列表的末尾
* *
* @param key * @param key 键
* @param value * @param value 值
* @return * @return 列表的长度
*/ */
public long putToListEnd(String key, String value) { public long putToListEnd(String key, String value) {
key = getPreKey(key); key = getPreKey(key);
@ -217,28 +231,25 @@ public class CacheService {
} }
/** /**
* 将value插入集合key的尾部, 并设置过期时间 * 将值插入到有序集合中，并设置过期时间
* *
* @author zhangxin * @param key 键
* @param key * @param value 值
* @param value * @param seconds 过期时间（单位：秒）
* @param seconds * @param score 分数
* @param score * @return 添加的新成员数量
* @return long 被成功添加的新成员的数量，不包括那些被更新的、已经存在的成员
*/ */
public long addToSortedSetAndExpire(String key, String value, int seconds, double score) { public long addToSortedSetAndExpire(String key, String value, int seconds, double score) {
return addToSortedSet(key, value, seconds, true, score); return addToSortedSet(key, value, seconds, true, score);
} }
/** /**
* 将value插入集合key的尾部 增加value的score * 将值插入到有序集合中，并增加其分数
* *
* @author zhangxin * @param key 键
* @param key * @param value 值
* @param value * @param score 分数
* @param score * @return 添加的新成员的分数
* @return long 被成功添加的新成员的分数
*/ */
public double addToSortedSetScore(String key, String value, double score) { public double addToSortedSetScore(String key, String value, double score) {
key = getPreKey(key); key = getPreKey(key);
@ -253,42 +264,23 @@ public class CacheService {
} }
/** /**
* 获取member的Score * 将值插入到有序集合中
* @param key
* @param value
* @return
*/
public Double getMemberScore(String key, String member) {
key = getPreKey(key);
ShardedJedis conn = null;
try {
conn = redisXMLConfigure.getConnection();
Double zscore = conn.zscore(key, member);
return zscore == null ? 0 : zscore;
} finally {
redisXMLConfigure.closeConnection(conn);
}
}
/**
* 将value插入集合key的尾部, 不设置过期时间
* *
* @author zhangxin * @param key 键
* @param key * @param value 值
* @param value * @param score 分数
* @param score * @return 添加的新成员数量
* @return long 被成功添加的新成员的数量，不包括那些被更新的、已经存在的成员
*/ */
public long addToSortedSet(String key, String value, double score) { public long addToSortedSet(String key, String value, double score) {
return addToSortedSet(key, value, -1, false, score); return addToSortedSet(key, value, -1, false, score);
} }
/** /**
* 判断member在集合里是否存在 * 判断有序集合中是否存在指定成员
* *
* @return isExist 存在 true 不存在 * @param key 键
* @param member 成员
* @return 是否存在
*/ */
public boolean isExistSortedSet(String key, String member) { public boolean isExistSortedSet(String key, String member) {
key = getPreKey(key); key = getPreKey(key);
@ -303,9 +295,11 @@ public class CacheService {
} }
/** /**
* 删除member * 删除有序集合中的指定成员
* *
* @return isExist 存在 true 不存在 * @param key 键
* @param member 成员
* @return 是否删除成功
*/ */
public boolean delSortedSetMember(String key, String[] member) { public boolean delSortedSetMember(String key, String[] member) {
key = getPreKey(key); key = getPreKey(key);
@ -320,9 +314,14 @@ public class CacheService {
} }
/** /**
* 将value插入集合key的尾部, 对于setExpire为false的情况, seconds无效 * 将值插入到有序集合中，并设置过期时间（可选）
* *
* @return 被成功添加的新成员的数量，不包括那些被更新的、已经存在的成员 * @param key 键
* @param value 值
* @param seconds 过期时间（单位：秒）
* @param setExpire 是否设置过期时间
* @param score 分数
* @return 添加的新成员数量
*/ */
private long addToSortedSet(String key, String value, int seconds, boolean setExpire, double score) { private long addToSortedSet(String key, String value, int seconds, boolean setExpire, double score) {
key = getPreKey(key); key = getPreKey(key);
@ -340,14 +339,12 @@ public class CacheService {
} }
/** /**
* 按score降序分页获取有序集合中内容 * 按分数降序分页获取有序集合中的内容
* *
* @author zhangxin * @param key 键
* @param key * @param pageNo 页码（从 1 开始）
* @param pageNo * @param pageSize 每页大小
* 首页从1开始 * @return 有序集合的内容
* @param pageSize
* @return Set<String>
*/ */
public Set<String> getSortedSetByPage(String key, int pageNo, int pageSize) { public Set<String> getSortedSetByPage(String key, int pageNo, int pageSize) {
key = getPreKey(key); key = getPreKey(key);
@ -370,6 +367,12 @@ public class CacheService {
return null; return null;
} }
/**
* 获取列表的表头元素
*
* @param key 键
* @return 列表的表头元素
*/
public List<String> getListHead(String key) { public List<String> getListHead(String key) {
key = getPreKey(key); key = getPreKey(key);
ShardedJedis conn = null; ShardedJedis conn = null;
@ -386,12 +389,12 @@ public class CacheService {
} }
/** /**
* 存储map * 存储 Map 到 Redis
* *
* @param key 键值 * @param key 键
* @param field map field * @param field Map 的字段
* @param value map value * @param value Map 的值
* @return if filed exist return 0 else return 1 * @return 如果字段已存在返回 0，否则返回 1
*/ */
public Long hset(String key, String field, String value) { public Long hset(String key, String field, String value) {
key = getPreKey(key); key = getPreKey(key);
@ -404,6 +407,13 @@ public class CacheService {
} }
} }
/**
* 存储 Map 到 Redis
*
* @param key 键
* @param values Map
* @return 设置结果
*/
public String hset(String key, Map<String, String> values) { public String hset(String key, Map<String, String> values) {
key = getPreKey(key); key = getPreKey(key);
ShardedJedis conn = null; ShardedJedis conn = null;
@ -415,6 +425,14 @@ public class CacheService {
} }
} }
/**
* 存储 Map 到 Redis，并设置过期时间
*
* @param key 键
* @param values Map
* @param time 过期时间（单位：秒）
* @return 设置结果
*/
public String hset(String key, Map<String, String> values, int time) { public String hset(String key, Map<String, String> values, int time) {
key = getPreKey(key); key = getPreKey(key);
ShardedJedis conn = null; ShardedJedis conn = null;
@ -429,11 +447,11 @@ public class CacheService {
} }
/** /**
* 得到map中存储的field值 * 获取 Map 中指定字段的值
* *
* @param key 键值 * @param key 键
* @param field map field * @param field 字段
* @return * @return 值
*/ */
public String hget(String key, String field) { public String hget(String key, String field) {
key = getPreKey(key); key = getPreKey(key);
@ -447,10 +465,10 @@ public class CacheService {
} }
/** /**
* 名称为key的string减1操作 * 将名称为 key 的字符串减 1
* *
* @param key * @param key 键
* @return * @return 减 1 后的结果
*/ */
public Long decr(String key) { public Long decr(String key) {
key = getPreKey(key); key = getPreKey(key);
@ -464,10 +482,10 @@ public class CacheService {
} }
/** /**
* 名称为key的string加1操作 * 将名称为 key 的字符串加 1
* *
* @param key * @param key 键
* @return * @return 加 1 后的结果
*/ */
public Long incr(String key) { public Long incr(String key) {
key = getPreKey(key); key = getPreKey(key);
@ -480,6 +498,12 @@ public class CacheService {
} }
} }
/**
* 获取 Redis 键的完整路径
*
* @param key 键
* @return 完整路径
*/
private String getPreKey(String key) { private String getPreKey(String key) {
String temp_pre = redisXMLConfigure.getPreKey(); String temp_pre = redisXMLConfigure.getPreKey();
if (null == temp_pre) { if (null == temp_pre) {
@ -487,5 +511,4 @@ public class CacheService {
} }
return temp_pre + key; return temp_pre + key;
} }
} }

44
tamguo-modules-core/src/main/java/com/tamguo/config/redis/PoolConfigBean.java
Unescape View File

@ -1,13 +1,28 @@
package com.tamguo.config.redis; package com.tamguo.config.redis;
/**
* PoolConfigBean 类，用于配置 Redis 连接池
*/
public class PoolConfigBean { public class PoolConfigBean {
// 最大活跃连接数
private int max_active; private int max_active;
// 最大空闲连接数
private int max_idle; private int max_idle;
// 最大等待时间（毫秒）
private long max_wait; private long max_wait;
/**
* 无参构造函数
*/
public PoolConfigBean() { public PoolConfigBean() {
} }
/**
* 全参构造函数
* @param max_active 最大活跃连接数
* @param max_idle 最大空闲连接数
* @param max_wait 最大等待时间（毫秒）
*/
public PoolConfigBean(int max_active, int max_idle, long max_wait) { public PoolConfigBean(int max_active, int max_idle, long max_wait) {
super(); super();
this.max_active = max_active; this.max_active = max_active;
@ -15,33 +30,60 @@ public class PoolConfigBean {
this.max_wait = max_wait; this.max_wait = max_wait;
} }
/**
* 获取最大活跃连接数
* @return 最大活跃连接数
*/
public int getMax_active() { public int getMax_active() {
return max_active; return max_active;
} }
/**
* 设置最大活跃连接数
* @param max_active 最大活跃连接数
*/
public void setMax_active(int max_active) { public void setMax_active(int max_active) {
this.max_active = max_active; this.max_active = max_active;
} }
/**
* 获取最大空闲连接数
* @return 最大空闲连接数
*/
public int getMax_idle() { public int getMax_idle() {
return max_idle; return max_idle;
} }
/**
* 设置最大空闲连接数
* @param max_idle 最大空闲连接数
*/
public void setMax_idle(int max_idle) { public void setMax_idle(int max_idle) {
this.max_idle = max_idle; this.max_idle = max_idle;
} }
/**
* 获取最大等待时间（毫秒）
* @return 最大等待时间（毫秒）
*/
public long getMax_wait() { public long getMax_wait() {
return max_wait; return max_wait;
} }
/**
* 设置最大等待时间（毫秒）
* @param max_wait 最大等待时间（毫秒）
*/
public void setMax_wait(long max_wait) { public void setMax_wait(long max_wait) {
this.max_wait = max_wait; this.max_wait = max_wait;
} }
/**
* 重写 toString 方法，返回对象的字符串表示
* @return 对象的字符串表示
*/
@Override @Override
public String toString() { public String toString() {
return "PoolConfig [max_active=" + max_active + ", max_idle=" + max_idle + ", max_wait=" + max_wait + "]"; return "PoolConfig [max_active=" + max_active + ", max_idle=" + max_idle + ", max_wait=" + max_wait + "]";
} }
} }

61
tamguo-modules-core/src/main/java/com/tamguo/config/redis/RedisServerNodeBean.java
Unescape View File

@ -1,11 +1,26 @@
package com.tamguo.config.redis; package com.tamguo.config.redis;
/**
* RedisServerNodeBean 类，用于表示 Redis 服务器节点的信息
*/
public class RedisServerNodeBean { public class RedisServerNodeBean {
// Redis 服务器的 IP 地址
private String ip; private String ip;
// Redis 服务器的端口号
private int port; private int port;
// 是否需要身份验证
private boolean needAuth; private boolean needAuth;
// 身份验证密码
private String auth; private String auth;
/**
* 构造函数，用于创建 RedisServerNodeBean 对象
*
* @param ip Redis 服务器的 IP 地址
* @param port Redis 服务器的端口号
* @param needAuth 是否需要身份验证
* @param auth 身份验证密码
*/
public RedisServerNodeBean(String ip, int port, boolean needAuth, String auth) { public RedisServerNodeBean(String ip, int port, boolean needAuth, String auth) {
this.ip = ip; this.ip = ip;
this.port = port; this.port = port;
@ -13,41 +28,85 @@ public class RedisServerNodeBean {
this.auth = auth; this.auth = auth;
} }
/**
* 获取 Redis 服务器的 IP 地址
*
* @return Redis 服务器的 IP 地址
*/
public String getIp() { public String getIp() {
return ip; return ip;
} }
/**
* 设置 Redis 服务器的 IP 地址
*
* @param ip Redis 服务器的 IP 地址
*/
public void setIp(String ip) { public void setIp(String ip) {
this.ip = ip; this.ip = ip;
} }
/**
* 获取 Redis 服务器的端口号
*
* @return Redis 服务器的端口号
*/
public int getPort() { public int getPort() {
return port; return port;
} }
/**
* 设置 Redis 服务器的端口号
*
* @param port Redis 服务器的端口号
*/
public void setPort(int port) { public void setPort(int port) {
this.port = port; this.port = port;
} }
/**
* 获取是否需要身份验证
*
* @return 是否需要身份验证
*/
public boolean isNeedAuth() { public boolean isNeedAuth() {
return needAuth; return needAuth;
} }
/**
* 设置是否需要身份验证
*
* @param needAuth 是否需要身份验证
*/
public void setNeedAuth(boolean needAuth) { public void setNeedAuth(boolean needAuth) {
this.needAuth = needAuth; this.needAuth = needAuth;
} }
/**
* 获取身份验证密码
*
* @return 身份验证密码
*/
public String getAuth() { public String getAuth() {
return auth; return auth;
} }
/**
* 设置身份验证密码
*
* @param auth 身份验证密码
*/
public void setAuth(String auth) { public void setAuth(String auth) {
this.auth = auth; this.auth = auth;
} }
/**
* 重写 toString 方法，返回 RedisServerNodeBean 对象的字符串表示
*
* @return RedisServerNodeBean 对象的字符串表示
*/
@Override @Override
public String toString() { public String toString() {
return "RedisServer [ip=" + ip + ", port=" + port + ", needAuth=" + needAuth + ", auth=" + auth + "]"; return "RedisServer [ip=" + ip + ", port=" + port + ", needAuth=" + needAuth + ", auth=" + auth + "]";
} }
} }

209
tamguo-modules-core/src/main/java/com/tamguo/config/redis/RedisXMLConfigure.java
Unescape View File

@ -18,158 +18,187 @@ import redis.clients.jedis.JedisShardInfo;
import redis.clients.jedis.ShardedJedis; import redis.clients.jedis.ShardedJedis;
import redis.clients.jedis.ShardedJedisPool; import redis.clients.jedis.ShardedJedisPool;
/**
* RedisXMLConfigure 类，用于从 XML 配置文件中读取 Redis 服务器节点信息，并创建 ShardedJedisPool
*/
@Component("redisConfigure") @Component("redisConfigure")
public class RedisXMLConfigure implements InitializingBean { public class RedisXMLConfigure implements InitializingBean {
private static final Logger logger = Logger.getLogger(RedisXMLConfigure.class); private static final Logger logger = Logger.getLogger(RedisXMLConfigure.class); // 日志记录器
private static String preKey; private static String preKey; // Redis 键的前缀
private static Document document = null; private static Document document = null; // XML 文档对象
private ShardedJedisPool shardedJedisPool; private ShardedJedisPool shardedJedisPool; // ShardedJedis 连接池
/**
* 在所有属性设置后执行的初始化方法
* 从 XML 配置文件中读取 Redis 服务器节点信息，并创建 ShardedJedisPool
* @throws Exception 可能抛出的异常
*/
@Override @Override
public void afterPropertiesSet() throws Exception { public void afterPropertiesSet() throws Exception {
XMLConfiguration xmlConfiguration = new XMLConfiguration(); XMLConfiguration xmlConfiguration = new XMLConfiguration(); // 创建 XML 配置对象
String REDIS_PATH = "redis.xml"; String REDIS_PATH = "redis.xml"; // XML 配置文件路径
InputStream stream = null; InputStream stream = null; // 输入流对象
try { try {
stream = this.getClass().getClassLoader().getResourceAsStream(REDIS_PATH); stream = this.getClass().getClassLoader().getResourceAsStream(REDIS_PATH); // 获取 XML 配置文件的输入流
if (stream == null) { if (stream == null) { // 如果输入流为空
logger.error("load redis.xml failed!!!" + REDIS_PATH); logger.error("load redis.xml failed!!!" + REDIS_PATH); // 记录错误日志
throw new RuntimeException("load redis.xml failed"); throw new RuntimeException("load redis.xml failed"); // 抛出运行时异常
} }
logger.info("Redis XML config path:" + REDIS_PATH); logger.info("Redis XML config path:" + REDIS_PATH); // 记录日志
if (xmlConfiguration.readConfigFile(stream)) { if (xmlConfiguration.readConfigFile(stream)) { // 如果成功读取 XML 配置文件
document = xmlConfiguration.getDocument(); document = xmlConfiguration.getDocument(); // 获取 XML 文档对象
} else { } else {
logger.error("load redis.xml failed!!!"); logger.error("load redis.xml failed!!!"); // 记录错误日志
} }
} finally { } finally {
if (null != stream) if (null!= stream) // 如果输入流不为空
stream.close(); stream.close(); // 关闭输入流
} }
// 初始化参数 // 初始化参数
initPreKey(); initPreKey(); // 初始化 Redis 键的前缀
PoolConfigBean pcb = initPoolConfigBean(); PoolConfigBean pcb = initPoolConfigBean(); // 初始化连接池配置对象
List<RedisServerNodeBean> rsnbs = initRedisServerNodeBeans(); List<RedisServerNodeBean> rsnbs = initRedisServerNodeBeans(); // 初始化 Redis 服务器节点信息列表
//实现shardedJedisPool
// 创建 JedisPoolConfig 对象
JedisPoolConfig jedisPoolConfig = new JedisPoolConfig(); JedisPoolConfig jedisPoolConfig = new JedisPoolConfig();
//no maxActive config // 设置最大空闲连接数
jedisPoolConfig.setMaxIdle(pcb.getMax_idle()); jedisPoolConfig.setMaxIdle(pcb.getMax_idle());
// 设置最大等待时间（毫秒）
jedisPoolConfig.setMaxWaitMillis(pcb.getMax_wait()); jedisPoolConfig.setMaxWaitMillis(pcb.getMax_wait());
// 创建 ShardedJedisPool 对象
shardedJedisPool = new ShardedJedisPool(jedisPoolConfig, getJedisShardInfo(rsnbs)); shardedJedisPool = new ShardedJedisPool(jedisPoolConfig, getJedisShardInfo(rsnbs));
if(shardedJedisPool == null){ if (shardedJedisPool == null) { // 如果 ShardedJedisPool 对象为空
throw new RuntimeException("config redis.xml error"); throw new RuntimeException("config redis.xml error"); // 抛出运行时异常
} }
} }
/** /**
* 初始化jedis参数 * 初始化连接池配置对象
* @return 连接池配置对象
*/ */
private PoolConfigBean initPoolConfigBean() { private PoolConfigBean initPoolConfigBean() {
PoolConfigBean poolConfigBean = new PoolConfigBean(); PoolConfigBean poolConfigBean = new PoolConfigBean(); // 创建连接池配置对象
Element poolElement = (Element) document.getElementsByTagName("pool").item(0); Element poolElement = (Element) document.getElementsByTagName("pool").item(0); // 获取 pool 元素
int max_active = poolElement.hasAttribute("maxActive") ? Integer.parseInt(poolElement.getAttribute("maxActive")) : -1;
int max_idle = poolElement.hasAttribute("maxIdle") ? Integer.parseInt(poolElement.getAttribute("maxIdle")) : -1; int max_active = poolElement.hasAttribute("maxActive")? Integer.parseInt(poolElement.getAttribute("maxActive")) : -1; // 获取最大活跃连接数
long max_wait = poolElement.hasAttribute("maxWait") ? Long.parseLong(poolElement.getAttribute("maxWait")) : -1; int max_idle = poolElement.hasAttribute("maxIdle")? Integer.parseInt(poolElement.getAttribute("maxIdle")) : -1; // 获取最大空闲连接数
poolConfigBean.setMax_active(max_active); long max_wait = poolElement.hasAttribute("maxWait")? Long.parseLong(poolElement.getAttribute("maxWait")) : -1; // 获取最大等待时间（毫秒）
poolConfigBean.setMax_idle(max_idle);
poolConfigBean.setMax_wait(max_wait); poolConfigBean.setMax_active(max_active); // 设置最大活跃连接数
poolConfigBean.setMax_idle(max_idle); // 设置最大空闲连接数
poolConfigBean.setMax_wait(max_wait); // 设置最大等待时间（毫秒）
return poolConfigBean; return poolConfigBean;
} }
/** /**
* 解析配置redis的server列表 * 初始化 Redis 服务器节点信息列表
* @return Redis 服务器节点信息列表
*/ */
private List<RedisServerNodeBean> initRedisServerNodeBeans() { private List<RedisServerNodeBean> initRedisServerNodeBeans() {
List<RedisServerNodeBean> redisServers = new ArrayList<RedisServerNodeBean>(); List<RedisServerNodeBean> redisServers = new ArrayList<RedisServerNodeBean>(); // 创建 Redis 服务器节点信息列表
NodeList serverElements = document.getElementsByTagName("server");
int serverLen = serverElements.getLength(); NodeList serverElements = document.getElementsByTagName("server"); // 获取所有 server 元素
if (serverLen < 1) { int serverLen = serverElements.getLength(); // 获取 server 元素的数量
logger.error("redis.servers.server must have one !");
return null; if (serverLen < 1) { // 如果 server 元素的数量小于 1
} logger.error("redis.servers.server must have one!"); // 记录错误日志
for (int i = 0; i < serverLen; i++) { return null; // 返回空列表
Element serverElement = (Element) serverElements.item(i); }
String temp_ip = serverElement.hasAttribute("ip") ? serverElement.getAttribute("ip") : null;
if (temp_ip == null) { for (int i = 0; i < serverLen; i++) { // 遍历所有 server 元素
logger.error("redis.servers.server.ip must be supplied!"); Element serverElement = (Element) serverElements.item(i); // 获取当前 server 元素
return null;
} String temp_ip = serverElement.hasAttribute("ip")? serverElement.getAttribute("ip") : null; // 获取 IP 地址
if (temp_ip == null) { // 如果 IP 地址为空
String temp_port = serverElement.hasAttribute("port") ? serverElement.getAttribute("port") : "6379"; logger.error("redis.servers.server.ip must be supplied!"); // 记录错误日志
String temp_needAuth = serverElement.hasAttribute("needAuth") ? serverElement.getAttribute("needAuth") : "false"; return null; // 返回空列表
String temp_auth = null; }
// need auth
String temp_port = serverElement.hasAttribute("port")? serverElement.getAttribute("port") : "6379"; // 获取端口号
String temp_needAuth = serverElement.hasAttribute("needAuth")? serverElement.getAttribute("needAuth") : "false"; // 获取是否需要身份验证
String temp_auth = null; // 身份验证密码
// 需要身份验证
if ("true".equals(temp_needAuth)) { if ("true".equals(temp_needAuth)) {
temp_auth = serverElement.hasAttribute("auth") ? serverElement.getAttribute("auth") : null; temp_auth = serverElement.hasAttribute("auth")? serverElement.getAttribute("auth") : null; // 获取身份验证密码
if (null == temp_auth) { if (null == temp_auth) { // 如果身份验证密码为空
logger.error("since needAuth is true,auth must be supplied!"); logger.error("since needAuth is true, auth must be supplied!"); // 记录错误日志
return null; return null; // 返回空列表
} }
} }
RedisServerNodeBean rs = null; RedisServerNodeBean rs = null; // 创建 Redis 服务器节点对象
try { try {
rs = new RedisServerNodeBean(temp_ip, Integer.parseInt(temp_port), Boolean.parseBoolean(temp_needAuth), temp_auth); rs = new RedisServerNodeBean(temp_ip, Integer.parseInt(temp_port), Boolean.parseBoolean(temp_needAuth), temp_auth); // 创建 Redis 服务器节点对象
} catch (NumberFormatException e) { } catch (NumberFormatException e) { // 如果端口号转换为整数时发生异常
logger.error("port must be a number!\n" + e.getMessage()); logger.error("port must be a number!\n" + e.getMessage()); // 记录错误日志
return null; return null; // 返回空列表
} }
redisServers.add(rs); redisServers.add(rs); // 将 Redis 服务器节点对象添加到列表中
} }
return redisServers; return redisServers;
} }
/** /**
* 转换自定义配置为JedisShardInfo对象 * 将自定义配置转换为 JedisShardInfo 对象列表
* @param redisServers * @param redisServers Redis 服务器节点信息列表
* @return * @return JedisShardInfo 对象列表
*/ */
private List<JedisShardInfo> getJedisShardInfo(List<RedisServerNodeBean> redisServers) { private List<JedisShardInfo> getJedisShardInfo(List<RedisServerNodeBean> redisServers) {
if(redisServers == null){ if (redisServers == null) { // 如果 Redis 服务器节点信息列表为空
logger.error("redisServers must not be empty null"); logger.error("redisServers must not be empty null"); // 记录错误日志
return null; return null; // 返回空列表
} }
int serverLen = redisServers.size(); int serverLen = redisServers.size(); // 获取 Redis 服务器节点的数量
if (serverLen < 1) { if (serverLen < 1) { // 如果 Redis 服务器节点的数量小于 1
logger.error("redisServers must not be empty "); logger.error("redisServers must not be empty "); // 记录错误日志
return null; return null; // 返回空列表
} }
List<JedisShardInfo> servers = new ArrayList<JedisShardInfo>(serverLen); List<JedisShardInfo> servers = new ArrayList<JedisShardInfo>(serverLen); // 创建 JedisShardInfo 对象列表
for (int i = 0; i < serverLen; i++) {
RedisServerNodeBean redisServer = redisServers.get(i); for (int i = 0; i < serverLen; i++) { // 遍历 Redis 服务器节点信息列表
JedisShardInfo jedisShardInfo = new JedisShardInfo(redisServer.getIp(), redisServer.getPort()); RedisServerNodeBean redisServer = redisServers.get(i); // 获取当前 Redis 服务器节点对象
if (redisServer.isNeedAuth()) { JedisShardInfo jedisShardInfo = new JedisShardInfo(redisServer.getIp(), redisServer.getPort()); // 创建 JedisShardInfo 对象
jedisShardInfo.setPassword(redisServer.getAuth()); if (redisServer.isNeedAuth()) { // 如果需要身份验证
jedisShardInfo.setPassword(redisServer.getAuth()); // 设置身份验证密码
} }
servers.add(jedisShardInfo); servers.add(jedisShardInfo); // 将 JedisShardInfo 对象添加到列表中
} }
return servers; return servers;
} }
/* /**
* 初始化redis的key前缀 * 初始化 Redis 键的前缀
*/ */
private void initPreKey() { private void initPreKey() {
Element preKeyElement = (Element) document.getElementsByTagName("preKey").item(0); Element preKeyElement = (Element) document.getElementsByTagName("preKey").item(0); // 获取 preKey 元素
preKey = preKeyElement.hasAttribute("value") ? preKeyElement.getAttribute("value") : ""; preKey = preKeyElement.hasAttribute("value")? preKeyElement.getAttribute("value") : ""; // 获取前缀值
} }
/**
* 获取 Redis 键的前缀
* @return Redis 键的前缀
*/
public String getPreKey() { public String getPreKey() {
return preKey; return preKey;
} }
/** /**
* 从jedis连接池获得一个连接 * 从 Jedis 连接池获取一个连接
* @return * @return Jedis 连接
*/ */
public ShardedJedis getConnection() { public ShardedJedis getConnection() {
return shardedJedisPool.getResource(); return shardedJedisPool.getResource();
} }
/** /**
* 把连接放回jedis连接池 * 将连接放回 Jedis 连接池
* @param resource * @param resource Jedis 连接
*/ */
public void closeConnection(ShardedJedis resource) { public void closeConnection(ShardedJedis resource) {
resource.close(); resource.close();
} }
} }

34
tamguo-modules-core/src/main/java/com/tamguo/modules/book/model/BookCategoryEntity.java
Unescape View File

@ -8,31 +8,35 @@ import com.baomidou.mybatisplus.annotations.TableId;
import com.baomidou.mybatisplus.annotations.TableName; import com.baomidou.mybatisplus.annotations.TableName;
import lombok.Data; import lombok.Data;
/**
* BookCategoryEntity 类，用于表示书籍分类信息
*/
@Data @Data
@TableName(value="b_book_category") @TableName(value="b_book_category")
public class BookCategoryEntity extends Model<BookCategoryEntity> { public class BookCategoryEntity extends Model<BookCategoryEntity> {
private static final long serialVersionUID = 1L; private static final long serialVersionUID = 1L;
// 定义字段
@TableId @TableId
private String id; private String id; // 分类 ID
private String parentId; private String parentId; // 父分类 ID
private String parentIds; private String parentIds; // 父分类 ID 列表
private String treeSort; private String treeSort; // 树排序
private String treeSorts; private String treeSorts; // 树排序列表
private String treeLeaf; private String treeLeaf; // 是否叶子节点
private String treeLevel; private String treeLevel; // 树层次
private String treeNames; private String treeNames; // 树名称
private String name; private String name; // 分类名称
private String seoTitle; private String seoTitle; // SEO 标题
private String seoKeywords; private String seoKeywords; // SEO 关键词
private String seoDescription; private String seoDescription; // SEO 描述
private Date createDate; private Date createDate; // 创建日期
private Date updateDate; private Date updateDate; // 更新日期
// 重写 pkVal 方法，返回 ID 作为主键值
@Override @Override
protected Serializable pkVal() { protected Serializable pkVal() {
return getId(); return getId();
} }
} }

32
tamguo-modules-core/src/main/java/com/tamguo/modules/book/model/BookEntity.java
Unescape View File

@ -10,31 +10,37 @@ import com.baomidou.mybatisplus.annotations.TableId;
import com.baomidou.mybatisplus.annotations.TableName; import com.baomidou.mybatisplus.annotations.TableName;
import lombok.Data; import lombok.Data;
/**
* BookEntity 类，用于表示书籍信息
*/
@Data @Data
@TableName(value="b_book") @TableName(value="b_book")
public class BookEntity extends Model<BookEntity> { public class BookEntity extends Model<BookEntity> {
private static final long serialVersionUID = 1L; private static final long serialVersionUID = 1L;
// 定义字段
@TableId @TableId
private String id; private String id; // 书籍 ID
private String categoryId; private String categoryId; // 书籍分类 ID
private String bookImage; private String bookImage; // 书籍图片
private String owner; private String owner; // 书籍所有者
private String name; private String name; // 书籍名称
private String seoTitle; private String seoTitle; // SEO 标题
private String seoKeywords; private String seoKeywords; // SEO 关键词
private String seoDescription; private String seoDescription; // SEO 描述
private Date createDate; private Date createDate; // 创建日期
private Date updateDate; private Date updateDate; // 更新日期
// 定义关联字段
@TableField(exist=false) @TableField(exist=false)
private List<String> categoryIds; private List<String> categoryIds; // 分类 ID 列表
@TableField(exist=false) @TableField(exist=false)
private String memberName; private String memberName; // 会员名称
@TableField(exist=false) @TableField(exist=false)
private String categoryName; private String categoryName; // 分类名称
// 重写 pkVal 方法，返回 ID 作为主键值
@Override @Override
protected Serializable pkVal() { protected Serializable pkVal() {
return getId(); return getId();

43
tamguo-modules-core/src/main/java/com/tamguo/modules/book/model/DocumentEntity.java
Unescape View File

@ -13,46 +13,51 @@ import com.baomidou.mybatisplus.annotations.TableName;
import com.tamguo.modules.book.model.enums.DocumentStatusEnum; import com.tamguo.modules.book.model.enums.DocumentStatusEnum;
import lombok.Data; import lombok.Data;
/**
* DocumentEntity 类，用于表示文档信息
*/
@Data @Data
@TableName(value="b_document") @TableName(value="b_document")
public class DocumentEntity extends Model<DocumentEntity> { public class DocumentEntity extends Model<DocumentEntity> {
private static final long serialVersionUID = 1L; private static final long serialVersionUID = 1L;
// 定义字段
@TableId @TableId
private String id; private String id; // 文档 ID
private String batchNo; private String batchNo; // 批次号
private String parentId; private String parentId; // 父文档 ID
private String bookId; private String bookId; // 所属书籍 ID
private String owner; private String owner; // 所有者
private String name; private String name; // 文档名称
@JSONField(serialzeFeatures=SerializerFeature.WriteEnumUsingToString) @JSONField(serialzeFeatures=SerializerFeature.WriteEnumUsingToString)
private DocumentStatusEnum status; private DocumentStatusEnum status; // 文档状态
@TableField(value="is_open") @TableField(value="is_open")
private String isOpen; private String isOpen; // 是否公开
private Date createDate; private Date createDate; // 创建日期
private Date updateDate; private Date updateDate; // 更新日期
private String content; // 定义关联字段
private String markdown; private String content; // 文档内容
private String markdown; // Markdown 内容
@TableField(exist=false) @TableField(exist=false)
private Integer level; private Integer level; // 层级
@TableField(exist=false) @TableField(exist=false)
private String rootId; private String rootId; // 根文档 ID
@TableField(exist=false) @TableField(exist=false)
private boolean leaf; private boolean leaf; // 是否叶子节点
@TableField(exist=false) @TableField(exist=false)
private List<DocumentEntity> children; private List<DocumentEntity> children; // 子文档列表
@TableField(exist=false) @TableField(exist=false)
private String cover; private String cover; // 封面
@TableField(exist=false) @TableField(exist=false)
private List<FileUploadEntity> fileUploads; private List<FileUploadEntity> fileUploads; // 文件上传列表
// 重写 pkVal 方法，返回 ID 作为主键值
@Override @Override
protected Serializable pkVal() { protected Serializable pkVal() {
return getId(); return getId();
} }
} }

13
tamguo-modules-core/src/main/java/com/tamguo/modules/book/model/FileEntity.java
Unescape View File

@ -4,16 +4,29 @@ import com.baomidou.mybatisplus.annotations.TableId;
import com.baomidou.mybatisplus.annotations.TableName; import com.baomidou.mybatisplus.annotations.TableName;
import lombok.Data; import lombok.Data;
/**
* FileEntity 类，用于表示文件实体
*/
@Data @Data
@TableName(value="b_file_entity") @TableName(value="b_file_entity")
public class FileEntity { public class FileEntity {
// 文件 ID
@TableId("file_id") @TableId("file_id")
private String fileId; private String fileId;
// 文件 MD5 值
private String fileMd5; private String fileMd5;
// 文件路径
private String filePath; private String filePath;
// 文件类型
private String fileContentType; private String fileContentType;
// 文件扩展名
private String fileExtension; private String fileExtension;
// 文件大小（字节数）
private Long fileSize; private Long fileSize;
} }

20
tamguo-modules-core/src/main/java/com/tamguo/modules/book/model/FileUploadEntity.java
Unescape View File

@ -12,33 +12,51 @@ import com.tamguo.modules.book.model.enums.BizTypeEnum;
import com.tamguo.modules.book.model.enums.FileUploadStatusEnum; import com.tamguo.modules.book.model.enums.FileUploadStatusEnum;
import lombok.Data; import lombok.Data;
/**
* FileUploadEntity 类，用于表示文件上传信息
*/
@Data @Data
@TableName(value="b_file_upload") @TableName(value="b_file_upload")
public class FileUploadEntity extends Model<FileUploadEntity> { public class FileUploadEntity extends Model<FileUploadEntity> {
private static final long serialVersionUID = 1L; private static final long serialVersionUID = 1L;
// 文件上传 ID
private String id; private String id;
// 文件 ID
private String fileId; private String fileId;
// 文件名
private String fileName; private String fileName;
// 文件类型
private String fileType; private String fileType;
// 业务键
private String bizKey; private String bizKey;
// 业务类型
@JSONField(serialzeFeatures = SerializerFeature.WriteEnumUsingToString) @JSONField(serialzeFeatures = SerializerFeature.WriteEnumUsingToString)
private BizTypeEnum bizType; private BizTypeEnum bizType;
// 文件上传状态
@JSONField(serialzeFeatures = SerializerFeature.WriteEnumUsingToString) @JSONField(serialzeFeatures = SerializerFeature.WriteEnumUsingToString)
private FileUploadStatusEnum status; private FileUploadStatusEnum status;
// 创建人
private String createBy; private String createBy;
// 创建日期
private Date createDate; private Date createDate;
// 更新人
private String updateBy; private String updateBy;
// 更新日期
private Date updateDate; private Date updateDate;
// 备注
private String remarks; private String remarks;
// 文件路径（不存在数据库中，通过查询关联表得到）
@TableField(exist=false) @TableField(exist=false)
private String filePath; private String filePath;
// 文件大小（字节数）（不存在数据库中，通过查询关联表得到）
@TableField(exist=false) @TableField(exist=false)
private Long fileSize; private Long fileSize;
// 重写 pkVal 方法，返回 ID 作为主键值
@Override @Override
protected Serializable pkVal() { protected Serializable pkVal() {
return getId(); return getId();
} }
} }

28
tamguo-modules-core/src/main/java/com/tamguo/modules/book/model/enums/BizTypeEnum.java
Unescape View File

@ -1,30 +1,48 @@
package com.tamguo.modules.book.model.enums; package com.tamguo.modules.book.model.enums;
import java.io.Serializable; import java.io.Serializable; // 导入 Serializable 接口
import com.baomidou.mybatisplus.enums.IEnum; import com.baomidou.mybatisplus.enums.IEnum; // 导入 IEnum 接口
/** /**
* 用户状态 * 用户状态枚举类，实现了 IEnum 接口
*/ */
public enum BizTypeEnum implements IEnum { public enum BizTypeEnum implements IEnum {
// 文档类型
DOCUMENT("document", "文档"); DOCUMENT("document", "文档");
private String value; private String value; // 枚举值
private String desc; private String desc; // 枚举描述
/**
* 构造函数，用于初始化枚举值和描述
* @param value 枚举值
* @param desc 枚举描述
*/
BizTypeEnum(final String value, final String desc) { BizTypeEnum(final String value, final String desc) {
this.value = value; this.value = value;
this.desc = desc; this.desc = desc;
} }
/**
* 获取枚举值
* @return 枚举值
*/
public Serializable getValue() { public Serializable getValue() {
return this.value; return this.value;
} }
/**
* 获取枚举描述
* @return 枚举描述
*/
public String getDesc(){ public String getDesc(){
return this.desc; return this.desc;
} }
/**
* 重写 toString 方法，返回枚举值
* @return 枚举值
*/
@Override @Override
public String toString() { public String toString() {
return this.value; return this.value;

29
tamguo-modules-core/src/main/java/com/tamguo/modules/book/model/enums/DocumentStatusEnum.java
Unescape View File

@ -4,28 +4,51 @@ import java.io.Serializable;
import com.baomidou.mybatisplus.enums.IEnum; import com.baomidou.mybatisplus.enums.IEnum;
/** /**
* 用户状态 * 文档状态枚举类
*/ */
public enum DocumentStatusEnum implements IEnum { public enum DocumentStatusEnum implements IEnum {
/**
* 正常状态
*/
NORMAL("normal", "正常"), NORMAL("normal", "正常"),
/**
* 历史版本状态
*/
HISTORY("history", "历史版本"); HISTORY("history", "历史版本");
private String value; private String value; // 状态值
private String desc; private String desc; // 状态描述
/**
* 构造函数，用于初始化状态值和描述
* @param value 状态值
* @param desc 状态描述
*/
DocumentStatusEnum(final String value, final String desc) { DocumentStatusEnum(final String value, final String desc) {
this.value = value; this.value = value;
this.desc = desc; this.desc = desc;
} }
/**
* 获取状态值
* @return 状态值
*/
public Serializable getValue() { public Serializable getValue() {
return this.value; return this.value;
} }
/**
* 获取状态描述
* @return 状态描述
*/
public String getDesc(){ public String getDesc(){
return this.desc; return this.desc;
} }
/**
* 重写 toString 方法，返回状态值
* @return 状态值
*/
@Override @Override
public String toString() { public String toString() {
return this.value; return this.value;

29
tamguo-modules-core/src/main/java/com/tamguo/modules/book/model/enums/FileUploadStatusEnum.java
Unescape View File

@ -4,28 +4,51 @@ import java.io.Serializable;
import com.baomidou.mybatisplus.enums.IEnum; import com.baomidou.mybatisplus.enums.IEnum;
/** /**
* 用户状态 * 文件上传状态枚举类
*/ */
public enum FileUploadStatusEnum implements IEnum { public enum FileUploadStatusEnum implements IEnum {
/**
* 正常状态
*/
NORMAL("normal", "正常"), NORMAL("normal", "正常"),
/**
* 删除状态
*/
DELETE("delete", "删除"); DELETE("delete", "删除");
private String value; private String value; // 状态值
private String desc; private String desc; // 状态描述
/**
* 构造函数，用于初始化状态值和描述
* @param value 状态值
* @param desc 状态描述
*/
FileUploadStatusEnum(final String value, final String desc) { FileUploadStatusEnum(final String value, final String desc) {
this.value = value; this.value = value;
this.desc = desc; this.desc = desc;
} }
/**
* 获取状态值
* @return 状态值
*/
public Serializable getValue() { public Serializable getValue() {
return this.value; return this.value;
} }
/**
* 获取状态描述
* @return 状态描述
*/
public String getDesc(){ public String getDesc(){
return this.desc; return this.desc;
} }
/**
* 重写 toString 方法，返回状态值
* @return 状态值
*/
@Override @Override
public String toString() { public String toString() {
return this.value; return this.value;

26
tamguo-modules-core/src/main/java/com/tamguo/modules/book/service/impl/BookServiceImpl.java
Unescape View File

@ -11,22 +11,30 @@ import com.tamguo.modules.book.dao.BookMapper;
import com.tamguo.modules.book.model.BookEntity; import com.tamguo.modules.book.model.BookEntity;
import com.tamguo.modules.book.service.IBookService; import com.tamguo.modules.book.service.IBookService;
/**
* BookServiceImpl 类，实现了 IBookService 接口
*/
@Service(value="bbookServiceImpl") @Service(value="bbookServiceImpl")
public class BookServiceImpl extends ServiceImpl<BookMapper, BookEntity> implements IBookService { public class BookServiceImpl extends ServiceImpl<BookMapper, BookEntity> implements IBookService {
/**
* 保存书籍信息
*
* @param book 书籍实体
*/
@Transactional(readOnly=false) @Transactional(readOnly=false)
@Override @Override
public void saveBook(BookEntity book) { public void saveBook(BookEntity book) {
book.setCreateDate(new Date()); book.setCreateDate(new Date()); // 设置创建日期为当前日期
book.setUpdateDate(new Date()); book.setUpdateDate(new Date()); // 设置更新日期为当前日期
book.setSeoDescription(book.getName()); book.setSeoDescription(book.getName()); // 设置 SEO 描述为书籍名称
book.setSeoKeywords(book.getName()); book.setSeoKeywords(book.getName()); // 设置 SEO 关键词为书籍名称
book.setSeoTitle(book.getName()); book.setSeoTitle(book.getName()); // 设置 SEO 标题为书籍名称
if(StringUtils.isEmpty(book.getId())) {
this.insert(book); if (StringUtils.isEmpty(book.getId())) { // 如果书籍 ID 为空
this.insert(book); // 执行插入操作
} else { } else {
this.updateById(book); this.updateById(book); // 执行更新操作
} }
} }
} }

43
tamguo-modules-core/src/main/java/com/tamguo/modules/book/service/impl/DocumentServiceImpl.java
Unescape View File

@ -12,13 +12,22 @@ import com.tamguo.modules.book.model.DocumentEntity;
import com.tamguo.modules.book.model.enums.DocumentStatusEnum; import com.tamguo.modules.book.model.enums.DocumentStatusEnum;
import com.tamguo.modules.book.service.IDocumentService; import com.tamguo.modules.book.service.IDocumentService;
/**
* DocumentServiceImpl 类，实现了 IDocumentService 接口
*/
@Service @Service
public class DocumentServiceImpl extends ServiceImpl<DocumentMapper, DocumentEntity> implements IDocumentService { public class DocumentServiceImpl extends ServiceImpl<DocumentMapper, DocumentEntity> implements IDocumentService {
/**
* 修改文档
*
* @param document 文档实体
*/
@Transactional(readOnly = false) @Transactional(readOnly = false)
@Override @Override
public void modify(DocumentEntity document) { public void modify(DocumentEntity document) {
DocumentEntity entity = this.selectById(document.getId()); DocumentEntity entity = this.selectById(document.getId()); // 根据 ID 获取文档实体
if ("yes".equals(document.getCover())) { if ("yes".equals(document.getCover())) {
// 覆盖修改 // 覆盖修改
entity.setContent(document.getContent()); entity.setContent(document.getContent());
@ -35,28 +44,33 @@ public class DocumentServiceImpl extends ServiceImpl<DocumentMapper, DocumentEnt
this.updateById(entity); this.updateById(entity);
// 新增历史 // 新增历史
document.setId(null); Document.setId(null);
document.setContent(content); Document.setContent(content);
document.setMarkdown(markdown); Document.setMarkdown(markdown);
document.setBookId(entity.getBookId()); Document.setBookId(entity.getBookId());
document.setCreateDate(new Date()); Document.setCreateDate(new Date());
document.setIsOpen(entity.getIsOpen()); Document.setIsOpen(entity.getIsOpen());
document.setName(entity.getName()); Document.setName(entity.getName());
document.setOwner(entity.getOwner()); Document.setOwner(entity.getOwner());
document.setParentId(entity.getParentId()); Document.setParentId(entity.getParentId());
document.setUpdateDate(new Date()); Document.setUpdateDate(new Date());
document.setStatus(DocumentStatusEnum.HISTORY); Document.setStatus(DocumentStatusEnum.HISTORY);
document.setBatchNo(entity.getBatchNo()); Document.setBatchNo(entity.getBatchNo());
this.insert(document); this.insert(document);
} }
} }
/**
* 创建文档
*
* @param document 文档实体
*/
@SuppressWarnings("static-access") @SuppressWarnings("static-access")
@Transactional(readOnly = false) @Transactional(readOnly = false)
@Override @Override
public void create(DocumentEntity document) { public void create(DocumentEntity document) {
if (StringUtils.isEmpty(document.getId())) { if (StringUtils.isEmpty(document.getId())) {
// 如果文档 ID 为空
document.setStatus(DocumentStatusEnum.NORMAL); document.setStatus(DocumentStatusEnum.NORMAL);
document.setCreateDate(new Date()); document.setCreateDate(new Date());
document.setUpdateDate(new Date()); document.setUpdateDate(new Date());
@ -70,5 +84,4 @@ public class DocumentServiceImpl extends ServiceImpl<DocumentMapper, DocumentEnt
this.updateById(entity); this.updateById(entity);
} }
} }
} }

19
tamguo-modules-core/src/main/java/com/tamguo/modules/member/model/MemberEntity.java
Unescape View File

@ -9,27 +9,44 @@ import com.baomidou.mybatisplus.annotations.TableName;
import com.tamguo.config.dao.SuperEntity; import com.tamguo.config.dao.SuperEntity;
import lombok.Data; import lombok.Data;
/**
* MemberEntity 类，用于表示会员信息
*/
@Data @Data
@TableName(value="t_member") @TableName(value="t_member")
public class MemberEntity extends SuperEntity<MemberEntity> implements Serializable { public class MemberEntity extends SuperEntity<MemberEntity> implements Serializable {
private static final long serialVersionUID = 1L; private static final long serialVersionUID = 1L;
// 用户名
private String username; private String username;
// 昵称
private String nickName; private String nickName;
// 密码
private String password; private String password;
// 头像
private String avatar; private String avatar;
// 手机号
private String mobile; private String mobile;
// 邮箱
private String email; private String email;
// 积分
private Integer point; private Integer point;
// 余额
private BigDecimal amount; private BigDecimal amount;
// 最后登录时间
private Date lastLoginTime; private Date lastLoginTime;
// 发布文章数
private Integer paperNum; private Integer paperNum;
// 提问数
private Integer questionNum; private Integer questionNum;
// 下载数
private Integer downNum; private Integer downNum;
// 点击数
private Integer hitsNum; private Integer hitsNum;
// 验证码（数据库中不存在该字段）
@TableField(exist=false) @TableField(exist=false)
private String verifyCode; private String verifyCode;
// 当前密码（数据库中不存在该字段）
@TableField(exist=false) @TableField(exist=false)
private String nowPassword; private String nowPassword;
} }

58
tamguo-modules-core/src/main/java/com/tamguo/modules/member/model/condition/MemberCondition.java
Unescape View File

@ -1,43 +1,99 @@
package com.tamguo.modules.member.model.condition; package com.tamguo.modules.member.model.condition;
/**
* MemberCondition 类，用于封装会员查询条件
*/
public class MemberCondition { public class MemberCondition {
// 当前页码
private Integer pageNo; private Integer pageNo;
// 每页显示数量
private Integer pageSize; private Integer pageSize;
// 手机号码
private String mobile; private String mobile;
// 用户名
private String username; private String username;
// 昵称
private String nickName; private String nickName;
/**
* 获取手机号码
* @return 手机号码
*/
public String getMobile() { public String getMobile() {
return mobile; return mobile;
} }
/**
* 设置手机号码
* @param mobile 手机号码
*/
public void setMobile(String mobile) { public void setMobile(String mobile) {
this.mobile = mobile; this.mobile = mobile;
} }
/**
* 获取用户名
* @return 用户名
*/
public String getUsername() { public String getUsername() {
return username; return username;
} }
/**
* 设置用户名
* @param username 用户名
*/
public void setUsername(String username) { public void setUsername(String username) {
this.username = username; this.username = username;
} }
/**
* 获取昵称
* @return 昵称
*/
public String getNickName() { public String getNickName() {
return nickName; return nickName;
} }
/**
* 设置昵称
* @param nickName 昵称
*/
public void setNickName(String nickName) { public void setNickName(String nickName) {
this.nickName = nickName; this.nickName = nickName;
} }
/**
* 获取当前页码
* @return 当前页码
*/
public Integer getPageNo() { public Integer getPageNo() {
return pageNo; return pageNo;
} }
/**
* 设置当前页码
* @param pageNo 当前页码
*/
public void setPageNo(Integer pageNo) { public void setPageNo(Integer pageNo) {
this.pageNo = pageNo; this.pageNo = pageNo;
} }
/**
* 获取每页显示数量
* @return 每页显示数量
*/
public Integer getPageSize() { public Integer getPageSize() {
return pageSize; return pageSize;
} }
/**
* 设置每页显示数量
* @param pageSize 每页显示数量
*/
public void setPageSize(Integer pageSize) { public void setPageSize(Integer pageSize) {
this.pageSize = pageSize; this.pageSize = pageSize;
} }
} }

491
tamguo-modules-core/src/main/java/com/tamguo/modules/member/service/impl/MemberService.java
Unescape View File

@ -239,10 +239,490 @@ public class MemberService extends ServiceImpl<MemberMapper, MemberEntity> imple
if(!entity.getPassword().equals(new Sha256Hash(member.getPassword()).toHex())) { if(!entity.getPassword().equals(new Sha256Hash(member.getPassword()).toHex())) {
return Result.result(501, null, "旧密码错误！"); return Result.result(501, null, "旧密码错误！");
} }
package com.tamguo.modules.member.service.impl;
import java.math.BigDecimal;
import java.util.Date;
import java.util.List;
import java.util.UUID;
import org.apache.commons.lang3.StringUtils;
import org.apache.shiro.crypto.hash.Sha256Hash;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import com.aliyuncs.exceptions.ClientException;
import com.baomidou.mybatisplus.mapper.Condition;
import com.baomidou.mybatisplus.plugins.Page;
import com.baomidou.mybatisplus.service.impl.ServiceImpl;
import com.tamguo.common.utils.Result;
import com.tamguo.common.utils.SystemConstant;
import com.tamguo.config.redis.CacheService;
import com.tamguo.modules.book.model.BookEntity;
import com.tamguo.modules.book.service.IBookService;
import com.tamguo.modules.member.dao.MemberMapper;
import com.tamguo.modules.member.model.MemberEntity;
import com.tamguo.modules.member.model.condition.MemberCondition;
import com.tamguo.modules.member.service.IMemberService;
import com.tamguo.modules.sys.service.ISmsService;
/**
* MemberServiceImpl 类，实现了 IMemberService 接口
*/
@Service
public class MemberServiceImpl extends ServiceImpl<MemberMapper, MemberEntity> implements IMemberService {
// 注入 MemberMapper
@Autowired
private MemberMapper memberMapper;
// 注入 CacheService
@Autowired
private CacheService cacheService;
// 注入 ISmsService
@Autowired
private ISmsService iSmsService;
// 注入 IBookService
@Autowired
private IBookService iBookService;
/**
* 登录方法
*
* @param username 用户名
* @param password 密码
* @return 登录结果
*/
@Override
public Result login(String username, String password) {
// 创建 MemberEntity 对象
MemberEntity condition = new MemberEntity();
// 设置用户名
condition.setUsername(username);
// 从数据库中查询该用户
MemberEntity member = memberMapper.selectOne(condition);
// 如果用户不存在
if (member == null) {
// 返回错误结果，提示用户名 或 password 有误
return Result.result(201, member, "用户名或密码有误，请重新输入或找回密码");
}
// 获取该用户的登录失败次数
Integer loginFailureCount = this.getLoginFailureCount(member);
// 如果密码错误
if (!new Sha256Hash(password).toHex().equals(member.getPassword())) {
// 登录失败次数加 1
loginFailureCount++;
// 更新登录失败次数
this.updateLoginFailureCount(member, loginFailureCount);
// 返回错误结果，提示用户名 或 password 有误
return Result.result(202, member, "用户名或密码有误，请重新输入或找回密码");
}
// 更新登录失败次数为 0
this.updateLoginFailureCount(member, 0);
// 返回正确结果，提示登录成功
return Result.result(200, member, "登录成功");
}
/**
* 更新登录失败次数
*
* @param member 会员实体
* @param loginFailureCount 登录失败次数
*/
public void updateLoginFailureCount(MemberEntity member, Integer loginFailureCount) {
// 将登录失败次数存储到缓存中，key 为 LOGIN_FAILURE_COUNT + member.getId()
cacheService.setObject(SystemConstant.LOGIN_FAILURE_COUNT + member.getId(), loginFailureCount, 2 * 60 * 60);
}
/**
* 获取登录失败次数
*
* @param member 会员实体
* @return 登录失败次数
*/
public Integer getLoginFailureCount(MemberEntity member) {
// 如果 member 为空
if (member == null) {
// 返回 0
return 0;
}
// 如果缓存中不存在登录失败次数
if (!cacheService.isExist(SystemConstant.LOGIN_FAILURE_COUNT + member.getId())) {
// 返回 0
return 0;
}
// 从缓存中获取登录失败次数
return (Integer) cacheService.getObject(SystemConstant.LOGIN_FAILURE_COUNT + member.getId());
}
/**
* 检查用户名是否存在
*
* @param username 用户名
* @return 检查结果
*/
@Override
public Result checkUsername(String username) {
// 创建 MemberEntity 对象
MemberEntity condition = new MemberEntity();
// 设置用户名
condition.setUsername(username);
// 从数据库中查询该用户
MemberEntity member = memberMapper.selectOne(condition);
// 如果用户存在
if (member!= null) {
// 返回错误结果，提示该用户名已经存在
return Result.result(201, null, "该用户名已经存在");
}
// 返回正确结果，提示该用户名可用
return Result.result(200, null, "该用户名可用");
}
/**
* 检查手机号是否存在
*
* @param mobile 手机号
* @return 检查结果
*/
@Override
public Result checkMobile(String mobile) {
// 创建 MemberEntity 对象
MemberEntity condition = new MemberEntity();
// 设置手机号
condition.setMobile(mobile);
// 从数据库中查询该用户
MemberEntity member = memberMapper.selectOne(condition);
// 如果用户存在
if (member!= null) {
// 返回错误结果，提示该手机号已经存在
return Result.result(201, null, "该手机号已经存在");
}
// 返回正确结果，提示该手机号可用
return Result.result(200, null, "该手机号可用");
}
/**
* 注册方法
*
* @param member 会员实体
* @return 注册结果
*/
@Transactional(readOnly = false)
@Override
public Result register(MemberEntity member) {
// 创建 MemberEntity 对象
MemberEntity condition = new MemberEntity();
// 设置用户名
condition.setUsername(member.getUsername());
// 从数据库中查询该用户
MemberEntity m = memberMapper.selectOne(condition);
// 如果用户已存在
if (m!= null) {
// 返回错误结果，提示该用户已经存在
return Result.result(201, null, "该用户已经存在");
}
// 创建 MemberEntity 对象
condition = new MemberEntity();
// 设置手机号
condition.setMobile(member.getMobile());
// 从数据库中查询该用户
m = memberMapper.selectOne(condition);
// 如果手机号已存在
if (m!= null) {
// 返回错误结果，提示该手机号已经存在
return Result.result(202, null, "该手机号已经存在");
}
// 如果缓存中不存在验证码
if (!cacheService.isExist(SystemConstant.ALIYUN_MOBILE_SMS_PREFIX + member.getMobile())) { if (!cacheService.isExist(SystemConstant.ALIYUN_MOBILE_SMS_PREFIX + member.getMobile())) {
// 返回错误结果，提示验证码错误
return Result.result(203, null, "验证码错误");
}
// 从缓存中获取验证码
String code = (String) cacheService.getObject(SystemConstant.ALIYUN_MOBILE_SMS_PREFIX + member.getMobile());
// 如果验证码错误
if (!code.equals(member.getVerifyCode())) {
// 返回错误结果，提示验证码错误
return Result.result(204, null, "验证码错误");
}
// 创建 MemberEntity 对象
MemberEntity entity = new MemberEntity();
// 设置头像
entity.setAvatar(SystemConstant.DEFAULT_MEMBER_AVATAR);
// 设置手机号
entity.setMobile(member.getMobile());
// 设置密码
entity.setPassword(new Sha256Hash(member.getPassword()).toHex());
// 设置用户名
entity.setUsername(member.getUsername());
// 设置昵称
entity.setNickName(member.getUsername());
// 设置邮箱
entity.setEmail(member.getEmail());
// 插入会员信息
memberMapper.insert(entity);
// 返回正确结果，提示注册成功
return Result.result(200, entity, "注册成功");
}
/**
* 检查帐号是否存在
*
* @param account 帐号
* @return 检查结果
*/
@SuppressWarnings("unchecked")
@Override
public Result checkAccount(String account) {
// 如果帐号为空
if (StringUtils.isEmpty(account)) {
// 返回错误结果，提示帐号不存在
return Result.result(201, null, "帐号不存在！");
}
// 创建 Condition 对象
Condition query = Condition.create();
// 添加条件，根据帐号查询会员信息
query.eq("user_name", account).or().eq("mobile", account);
// 从数据库中查询会员信息
List<MemberEntity> members = memberMapper.selectList(query);
// 如果没有查询到会员信息
if (members.size() == 0) {
// 返回错误结果，提示帐号不存在
return Result.result(201, null, "帐号不存在！");
}
// 返回正确结果，提示帐号存在，并返回会员信息
return Result.result(200, members.get(0), "该帐号存在");
}
/**
* 确认帐号是否存在
*
* @param account 帐号
* @param veritycode 验证码
* @return 确认结果
*/
@SuppressWarnings("unchecked")
@Override
public Result confirmAccount(String account, String veritycode) {
// 如果帐号为空
if (StringUtils.isEmpty(account)) {
// 返回错误结果，提示帐号不存在
return Result.result(201, null, "帐号不存在！");
}
// 创建 Condition 对象
Condition query = Condition.create();
// 添加条件，根据帐号查询会员信息
query.eq("username", account).or().eq("mobile", account);
// 从数据库中查询会员信息
List<MemberEntity> members = memberMapper.selectList(query);
// 如果没有查询到会员信息
if (members.size() == 0) {
// 返回错误结果，提示帐号不存在
return Result.result(201, null, "帐号不存在！");
}
// 返回正确结果，提示帐号存在，并返回会员信息
return Result.result(200, members.get(0), "该帐号存在");
}
/**
* 安全检查
*
* @param username 用户名
* @param isEmail 是否为邮箱
* @param vcode 验证码
* @return 安全检查结果
*/
@Override
public Result securityCheck(String username, String isEmail, String vcode) {
// 创建 MemberEntity 对象
MemberEntity condition = new MemberEntity();
// 设置用户名
condition.setUsername(username);
// 从数据库中查询该用户
MemberEntity member = memberMapper.selectOne(condition);
// 如果用户不存在
if (member == null) {
// 返回错误结果，提示用户不存在
return Result.result(201, member, "用户不存在");
}
// 如果是邮箱验证
if ("1".equals(isEmail)) {
// 如果缓存中不存在验证码
if (!cacheService.isExist(SystemConstant.ALIYUN_MAIL_FIND_PASSWORD_PREFIX + member.getEmail())) {
// 返回错误结果，提示验证码错误
return Result.result(201, member, "验证码错误");
}
// 从缓存中获取验证码
String code = (String) cacheService.getObject(SystemConstant.ALIYUN_MAIL_FIND_PASSWORD_PREFIX + member.getEmail());
// 如果验证码错误
if (!code.equals(vcode)) {
// 返回错误结果，提示验证码错误
return Result.result(202, member, "验证码错误");
}
} else {
// 如果缓存中不存在验证码
if (!cacheService.isExist(SystemConstant.ALIYUN_MOBILE_SMS_PREFIX + member.getMobile())) {
// 返回错误结果，提示验证码错误
return Result.result(203, member, "验证码错误");
}
// 从缓存中获取验证码
String code = (String) cacheService.getObject(SystemConstant.ALIYUN_MOBILE_SMS_PREFIX + member.getMobile());
// 如果验证码错误
if (!code.equals(vcode)) {
// 返回错误结果，提示验证码错误
return Result.result(204, member, "验证码错误");
}
}
// 创建随机字符串
String key = UUID.randomUUID().toString();
// 将用户名存储到缓存中，key 为 SECURITY_CHECK_PREFIX + key
cacheService.setObject(SystemConstant.SECURITY_CHECK_PREFIX + key, username, 2 * 60 * 60);
// 返回正确结果，提示安全验证通过，并返回随机字符串
return Result.result(200, key, "安全验证通过");
}
/**
* 重置密码
*
* @param resetPasswordKey 重置密码 key
* @param username 用户名
* @param password 新密码
* @param verifypwd 确认密码
* @return 重置密码结果
*/
@Override
public Result resetPassword(String resetPasswordKey, String username, String password, String verifypwd) {
// 如果缓存中存在重置密码 key
if (cacheService.isExist(SystemConstant.SECURITY_CHECK_PREFIX + resetPasswordKey)) {
// 创建 MemberEntity 对象
MemberEntity condition = new MemberEntity();
// 设置用户名
condition.setUsername(username);
// 从数据库中查询该用户
MemberEntity member = memberMapper.selectOne(condition);
// 如果密码和确认密码不一致
if (!password.equals(verifypwd)) {
// 返回错误结果，提示密码不一致
return Result.result(201, null, "密码不一致");
}
// 设置密码
member.setPassword(new Sha256Hash(password).toHex());
// 更新会员信息
memberMapper.updateById(member);
}
// 返回正确结果，提示更新成功
return Result.result(200, null, "更新成功");
}
/**
* 更新会员信息
*
* @param member 会员实体
*/
@Transactional(readOnly = false)
@Override
public void updateMember(MemberEntity member) {
// 获取会员信息
MemberEntity entity = memberMapper.selectById(member.getId());
// 设置头像
entity.setAvatar(member.getAvatar());
// 设置邮箱
entity.setEmail(member.getEmail());
// 设置手机号
entity.setMobile(member.getMobile());
// 设置昵称
entity.setNickName(member.getNickName());
// 更新会员信息
memberMapper.updateById(entity);
}
/**
* 根据 uid 查询会员信息
*
* @param uid uid
* @return 会员信息
*/
@Transactional(readOnly = true)
@Override
public MemberEntity findByUid(String uid) {
// 根据 uid 查询会员信息
return memberMapper.selectById(uid);
}
/**
* 根据用户名查询会员信息
*
* @param username 用户名
* @return 会员信息
*/
@SuppressWarnings("unchecked")
@Transactional(readOnly = true)
@Override
public MemberEntity findByUsername(String username) {
// 创建 Condition 对象
Condition query = Condition.create();
// 添加条件，根据用户名查询会员信息
query.eq("username", username).or().eq("mobile", username).or().eq("email", username);
// 从数据库中查询会员信息
return this.selectOne(query);
}
/**
* 更新会员最后登录时间
*
* @param uid uid
*/
@Transactional(readOnly = false)
@Override
public void updateLastLoginTime(String uid) {
// 获取会员信息
MemberEntity member = memberMapper.selectById(uid);
// 设置最后登录时间为当前时间
member.setLastLoginTime(new Date());
// 更新会员信息
memberMapper.updateById(member);
}
/**
* 获取当前会员信息
*
* @param id id
* @return 会员信息
*/
@Override
public MemberEntity findCurrMember(String id) {
// 获取会员信息
MemberEntity member = memberMapper.selectById(id);
// 将密码设置为 null
member.setPassword(null);
// 返回会员信息
return member;
}
/**
* 更新密码
*
* @param member 会员实体
* @return 更新结果
*/
@Transactional(readOnly = false)
@Override
public Result updatePwd(MemberEntity member) {
// 获取会员信息
MemberEntity entity = memberMapper.selectById(member.getId());
// 如果旧密码错误
if (!entity.getPassword().equals(new Sha256Hash(member.getPassword()).toHex())) {
// 返回错误结果，提示旧密码错误
return Result.result(501, null, "旧密码错误！");
}
// 如果缓存中不存在验证码
if (!cacheService.isExist(SystemConstant.ALIYUN_MOBILE_SMS_PREFIX + member.getMobile())){
// 如果缓存服务中不存在指定的验证码前缀与会员手机号的组合
return Result.result(502, null, "验证码错误"); return Result.result(502, null, "验证码错误");
} }
entity.setPassword(new Sha256Hash(member.getNowPassword()).toHex()); entity.setPassword(new Sha256Hash(member.getNowPassword()).toHex());
// 设置实体的密码为会员当前密码的 Sha256 哈希值的十六进制表示
return Result.result(0, null, "修改成功"); return Result.result(0, null, "修改成功");
} }
@ -250,14 +730,18 @@ public class MemberService extends ServiceImpl<MemberMapper, MemberEntity> imple
@Transactional(readOnly=true) @Transactional(readOnly=true)
@Override @Override
public Page<MemberEntity> listData(MemberCondition condition) { public Page<MemberEntity> listData(MemberCondition condition) {
// 创建分页对象
Page<MemberEntity> page = new Page<>(condition.getPageNo(), condition.getPageSize()); Page<MemberEntity> page = new Page<>(condition.getPageNo(), condition.getPageSize());
Condition query = Condition.create(); Condition query = Condition.create();
// 如果条件中的手机号不为空
if(!StringUtils.isEmpty(condition.getMobile())) { if(!StringUtils.isEmpty(condition.getMobile())) {
query.eq("mobile", condition.getMobile()); query.eq("mobile", condition.getMobile());
} }
// 如果条件中的昵称不为空
if(!StringUtils.isEmpty(condition.getNickName())) { if(!StringUtils.isEmpty(condition.getNickName())) {
query.like("nick_name", condition.getNickName()); query.like("nick_name", condition.getNickName());
} }
// 如果条件中的用户名不为空
if(!StringUtils.isEmpty(condition.getUsername())) { if(!StringUtils.isEmpty(condition.getUsername())) {
query.eq("username", condition.getUsername()); query.eq("username", condition.getUsername());
} }
@ -268,13 +752,14 @@ public class MemberService extends ServiceImpl<MemberMapper, MemberEntity> imple
@Override @Override
public void reward(String id,String bookId, Integer rewardPoint, BigDecimal rewardMoney) { public void reward(String id,String bookId, Integer rewardPoint, BigDecimal rewardMoney) {
MemberEntity member = memberMapper.selectById(id); MemberEntity member = memberMapper.selectById(id);
// 获取会员实体
// 更新记录 // 更新会员的积分和金额
member.setPoint(member.getPoint() + rewardPoint); member.setPoint(member.getPoint() + rewardPoint);
member.setAmount(member.getAmount().add(rewardMoney)); member.setAmount(member.getAmount().add(rewardMoney));
this.updateById(member); this.updateById(member);
BookEntity book = iBookService.selectById(bookId); BookEntity book = iBookService.selectById(bookId);
// 获取书籍实体
// 发送短信 // 发送短信
try { try {
@ -283,5 +768,3 @@ public class MemberService extends ServiceImpl<MemberMapper, MemberEntity> imple
e.printStackTrace(); e.printStackTrace();
} }
} }
}

25
tamguo-modules-core/src/main/java/com/tamguo/modules/sys/model/SysAreaEntity.java
Unescape View File

@ -14,48 +14,67 @@ import com.baomidou.mybatisplus.enums.FieldFill;
import com.tamguo.modules.sys.model.enums.SysAreaStatusEnum; import com.tamguo.modules.sys.model.enums.SysAreaStatusEnum;
import lombok.Data; import lombok.Data;
/** /**
* The persistent class for the sys_area database table. * SysAreaEntity 类，用于表示系统区域实体
*
*/ */
@Data @Data
@TableName(value = "sys_area") @TableName(value = "sys_area")
public class SysAreaEntity implements Serializable { public class SysAreaEntity implements Serializable {
private static final long serialVersionUID = 1L; private static final long serialVersionUID = 1L;
// 根区域编码
public static final String ROOT_AREA_CODE = "0"; public static final String ROOT_AREA_CODE = "0";
// 区域编码分隔符
public static final String TREE_CODE_AREA_SEPARATE = ","; public static final String TREE_CODE_AREA_SEPARATE = ",";
// 区域名称分隔符
public static final String TREE_NAME_AREA_SEPARATE = "/"; public static final String TREE_NAME_AREA_SEPARATE = "/";
// 区域编码
@TableId @TableId
private String areaCode; private String areaCode;
// 区域名称
private String areaName; private String areaName;
// 区域类型
private String areaType; private String areaType;
// 创建人
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private String createBy; private String createBy;
// 创建时间
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private Date createDate; private Date createDate;
// 父区域编码
private String parentCode; private String parentCode;
// 父区域编码列表
private String parentCodes; private String parentCodes;
// 备注
private String remarks; private String remarks;
// 区域状态枚举
@JSONField(serialzeFeatures = SerializerFeature.WriteEnumUsingToString) @JSONField(serialzeFeatures = SerializerFeature.WriteEnumUsingToString)
private SysAreaStatusEnum status; private SysAreaStatusEnum status;
// 是否为叶子节点
private Boolean treeLeaf; private Boolean treeLeaf;
// 树层次
private BigDecimal treeLevel; private BigDecimal treeLevel;
// 树名称
private String treeNames; private String treeNames;
// 树排序
private BigDecimal treeSort; private BigDecimal treeSort;
// 树排序字符串
private String treeSorts; private String treeSorts;
// 更新人
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private String updateBy; private String updateBy;
// 更新时间
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private Date updateDate; private Date updateDate;
// 子区域列表
@TableField(exist = false) @TableField(exist = false)
private List<SysAreaEntity> children; private List<SysAreaEntity> children;
// 获取区域编码
public String getId() { public String getId() {
return areaCode; return areaCode;
} }

28
tamguo-modules-core/src/main/java/com/tamguo/modules/sys/model/SysCompanyEntity.java
Unescape View File

@ -11,44 +11,72 @@ import com.baomidou.mybatisplus.annotations.TableName;
import com.baomidou.mybatisplus.enums.FieldFill; import com.baomidou.mybatisplus.enums.FieldFill;
import lombok.Data; import lombok.Data;
/**
* SysCompanyEntity 类，用于表示系统公司实体
*/
@Data @Data
@TableName(value = "sys_company") @TableName(value = "sys_company")
@KeySequence @KeySequence
public class SysCompanyEntity implements Serializable { public class SysCompanyEntity implements Serializable {
private static final long serialVersionUID = 1L; private static final long serialVersionUID = 1L;
// 根公司编码
public static final String ROOT_COMPANY_CODE = "0"; public static final String ROOT_COMPANY_CODE = "0";
// 公司编码分隔符
public static final String TREE_CODE_COMPANY_SEPARATE = ","; public static final String TREE_CODE_COMPANY_SEPARATE = ",";
// 公司名称分隔符
public static final String TREE_NAME_COMPANY_SEPARATE = "/"; public static final String TREE_NAME_COMPANY_SEPARATE = "/";
// 公司编码
@TableId @TableId
private String companyCode; private String companyCode;
// 区域编码
private String areaCode; private String areaCode;
// 公司名称
private String companyName; private String companyName;
// 企业编码
private String corpCode; private String corpCode;
// 企业名称
private String corpName; private String corpName;
// 创建人
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private String createBy; private String createBy;
// 创建时间
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private Date createDate; private Date createDate;
// 公司全称
private String fullName; private String fullName;
// 父公司编码
private String parentCode; private String parentCode;
// 父公司编码列表
private String parentCodes; private String parentCodes;
// 备注
private String remarks; private String remarks;
// 公司状态
private String status; private String status;
// 是否为叶子节点
private Boolean treeLeaf; private Boolean treeLeaf;
// 树层次
private BigDecimal treeLevel; private BigDecimal treeLevel;
// 树名称
private String treeNames; private String treeNames;
// 树排序
private String treeSort; private String treeSort;
// 树排序字符串
private String treeSorts; private String treeSorts;
// 更新人
@TableField(fill = FieldFill.INSERT) @TableField(fill = FieldFill.INSERT)
private String updateBy; private String updateBy;
// 更新时间
@TableField(fill = FieldFill.INSERT) @TableField(fill = FieldFill.INSERT)
private Date updateDate; private Date updateDate;
// 视图编码
private String viewCode; private String viewCode;
// 树区域名称
@TableField(exist = false) @TableField(exist = false)
private String treeAreaNames; private String treeAreaNames;
// 获取公司编码
public String getId() { public String getId() {
return companyCode; return companyCode;
} }

31
tamguo-modules-core/src/main/java/com/tamguo/modules/sys/model/SysMenuEntity.java
Unescape View File

@ -13,47 +13,78 @@ import com.baomidou.mybatisplus.enums.FieldFill;
import com.tamguo.modules.sys.model.enums.SysMenuStatusEnum; import com.tamguo.modules.sys.model.enums.SysMenuStatusEnum;
import lombok.Data; import lombok.Data;
/**
* SysMenuEntity 类，用于表示系统菜单实体
*/
@Data @Data
@TableName(value = "sys_menu") @TableName(value = "sys_menu")
public class SysMenuEntity implements Serializable { public class SysMenuEntity implements Serializable {
private static final long serialVersionUID = 1L; private static final long serialVersionUID = 1L;
// 根菜单编码
public static final String ROOT_MENU_CODE = "0"; public static final String ROOT_MENU_CODE = "0";
// 菜单编码分隔符
public static final String TREE_CODE_MENU_SEPARATE = ","; public static final String TREE_CODE_MENU_SEPARATE = ",";
// 菜单名称分隔符
public static final String TREE_NAME_MENU_SEPARATE = "/"; public static final String TREE_NAME_MENU_SEPARATE = "/";
// 菜单编码
@TableId @TableId
private String menuCode; private String menuCode;
// 创建人
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private String createBy; private String createBy;
// 创建时间
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private Date createDate; private Date createDate;
// 是否显示
private String isShow; private String isShow;
// 菜单颜色
private String menuColor; private String menuColor;
// 菜单链接
private String menuHref; private String menuHref;
// 菜单图标
private String menuIcon; private String menuIcon;
// 菜单名称
private String menuName; private String menuName;
// 菜单目标
private String menuTarget; private String menuTarget;
// 菜单类型
private String menuType; private String menuType;
// 父菜单编码
private String parentCode; private String parentCode;
// 父菜单编码列表
private String parentCodes; private String parentCodes;
// 权限
private String permission; private String permission;
// 备注
private String remarks; private String remarks;
// 菜单状态枚举
@JSONField(serialzeFeatures = SerializerFeature.WriteEnumUsingToString) @JSONField(serialzeFeatures = SerializerFeature.WriteEnumUsingToString)
private SysMenuStatusEnum status; private SysMenuStatusEnum status;
// 系统编码
private String sysCode; private String sysCode;
// 是否为叶子节点
private Boolean treeLeaf; private Boolean treeLeaf;
// 树层次
private BigDecimal treeLevel; private BigDecimal treeLevel;
// 树名称
private String treeNames; private String treeNames;
// 树排序
private BigDecimal treeSort; private BigDecimal treeSort;
// 树排序字符串
private String treeSorts; private String treeSorts;
// 更新人
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private String updateBy; private String updateBy;
// 更新时间
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private Date updateDate; private Date updateDate;
// 权重
private BigDecimal weight; private BigDecimal weight;
// 获取菜单编码
public String getId() { public String getId() {
return menuCode; return menuCode;
} }

34
tamguo-modules-core/src/main/java/com/tamguo/modules/sys/model/SysOfficeEntity.java
Unescape View File

@ -10,53 +10,79 @@ import com.baomidou.mybatisplus.annotations.TableName;
import com.baomidou.mybatisplus.enums.FieldFill; import com.baomidou.mybatisplus.enums.FieldFill;
import lombok.Data; import lombok.Data;
/** /**
* The persistent class for the sys_office database table. * SysOfficeEntity 类，用于表示系统部门实体
*
*/ */
@Data @Data
@TableName(value = "sys_office") @TableName(value = "sys_office")
public class SysOfficeEntity implements Serializable { public class SysOfficeEntity implements Serializable {
private static final long serialVersionUID = 1L; private static final long serialVersionUID = 1L;
// 根部门编码
public static final String ROOT_OFFICE_CODE = "0"; public static final String ROOT_OFFICE_CODE = "0";
// 部门编码分隔符
public static final String TREE_CODE_OFFICE_SEPARATE = ","; public static final String TREE_CODE_OFFICE_SEPARATE = ",";
// 部门名称分隔符
public static final String TREE_NAME_OFFICE_SEPARATE = "/"; public static final String TREE_NAME_OFFICE_SEPARATE = "/";
// 部门编码
@TableId @TableId
private String officeCode; private String officeCode;
// 地址
private String address; private String address;
// 企业编码
private String corpCode; private String corpCode;
// 企业名称
private String corpName; private String corpName;
// 创建人
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private String createBy; private String createBy;
// 创建时间
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private Date createDate; private Date createDate;
// 邮箱
private String email; private String email;
// 部门全称
private String fullName; private String fullName;
// 负责人
private String leader; private String leader;
// 部门名称
private String officeName; private String officeName;
// 部门类型
private String officeType; private String officeType;
// 父部门编码
private String parentCode; private String parentCode;
// 父部门编码列表
private String parentCodes; private String parentCodes;
// 电话
private String phone; private String phone;
// 备注
private String remarks; private String remarks;
// 部门状态
private String status; private String status;
// 是否为叶子节点
private Boolean treeLeaf; private Boolean treeLeaf;
// 树层次
private BigDecimal treeLevel; private BigDecimal treeLevel;
// 树名称
private String treeNames; private String treeNames;
// 树排序
private BigDecimal treeSort; private BigDecimal treeSort;
// 树排序字符串
private String treeSorts; private String treeSorts;
// 更新人
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private String updateBy; private String updateBy;
// 更新时间
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private Date updateDate; private Date updateDate;
// 视图编码
private String viewCode; private String viewCode;
// 邮政编码
private String zipCode; private String zipCode;
// grid tree // grid tree
// 获取部门编码
public String getId() { public String getId() {
return this.getOfficeCode(); return this.getOfficeCode();
} }
} }

20
tamguo-modules-core/src/main/java/com/tamguo/modules/sys/model/SysPostEntity.java
Unescape View File

@ -14,34 +14,52 @@ import com.baomidou.mybatisplus.enums.FieldFill;
import com.tamguo.modules.sys.model.enums.SysPostStatusEnum; import com.tamguo.modules.sys.model.enums.SysPostStatusEnum;
import lombok.Data; import lombok.Data;
/**
* SysPostEntity 类，用于表示系统岗位实体
*/
@Data @Data
@TableName(value = "sys_post") @TableName(value = "sys_post")
public class SysPostEntity extends Model<SysPostEntity> implements Serializable { public class SysPostEntity extends Model<SysPostEntity> implements Serializable {
private static final long serialVersionUID = 1L; private static final long serialVersionUID = 1L;
// 岗位编码
@TableId @TableId
private String postCode; private String postCode;
// 企业编码
private String corpCode; private String corpCode;
// 企业名称
private String corpName; private String corpName;
// 创建人
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private String createBy; private String createBy;
// 创建时间
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private Date createDate; private Date createDate;
// 岗位名称
private String postName; private String postName;
// 岗位排序
private BigDecimal postSort; private BigDecimal postSort;
// 岗位类型
private String postType; private String postType;
// 备注
private String remarks; private String remarks;
// 岗位状态枚举
@JSONField(serialzeFeatures = SerializerFeature.WriteEnumUsingToString) @JSONField(serialzeFeatures = SerializerFeature.WriteEnumUsingToString)
private SysPostStatusEnum status; private SysPostStatusEnum status;
// 更新人
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private String updateBy; private String updateBy;
// 更新时间
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private Date updateDate; private Date updateDate;
/**
* 重写 pkVal 方法，返回岗位编码作为主键值
* @return 岗位编码
*/
@Override @Override
protected Serializable pkVal() { protected Serializable pkVal() {
return getPostCode(); return getPostCode();
} }
} }

58
tamguo-modules-core/src/main/java/com/tamguo/modules/sys/model/SysUserEntity.java
Unescape View File

@ -17,87 +17,139 @@ import com.tamguo.modules.sys.model.enums.SysUserStatusEnum;
import com.tamguo.modules.sys.model.enums.SysUserTypeEnum; import com.tamguo.modules.sys.model.enums.SysUserTypeEnum;
import lombok.Data; import lombok.Data;
/**
* SysUserEntity 类，用于表示系统用户实体
*/
@Data @Data
@TableName(value = "sys_user") @TableName(value = "sys_user")
public class SysUserEntity extends Model<SysUserEntity> implements Serializable { public class SysUserEntity extends Model<SysUserEntity> implements Serializable {
private static final long serialVersionUID = 1L; private static final long serialVersionUID = 1L;
// 用户编码
@TableId @TableId
private String userCode; private String userCode;
// 部门编码
private String officeCode; private String officeCode;
// 部门名称
private String officeName; private String officeName;
// 公司编码
private String companyCode; private String companyCode;
// 公司名称
private String companyName; private String companyName;
// 头像
private String avatar; private String avatar;
// 企业编码
private String corpCode; private String corpCode;
// 企业名称
private String corpName; private String corpName;
// 创建人
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private String createBy; private String createBy;
// 创建时间
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private Date createDate; private Date createDate;
// 邮箱
private String email; private String email;
// 冻结原因
private String freezeCause; private String freezeCause;
// 冻结日期
private Date freezeDate; private Date freezeDate;
// 最后登录日期
private Date lastLoginDate; private Date lastLoginDate;
// 最后登录 IP
private String lastLoginIp; private String lastLoginIp;
// 登录账号
private String loginCode; private String loginCode;
// 用户管理类型枚举
@JSONField(serialzeFeatures = SerializerFeature.WriteEnumUsingToString) @JSONField(serialzeFeatures = SerializerFeature.WriteEnumUsingToString)
private SysUserMgrTypeEnum mgrType; private SysUserMgrTypeEnum mgrType;
// 手机号
private String mobile; private String mobile;
// 手机 IMEI 码
private String mobileImei; private String mobileImei;
// 密码
private String password; private String password;
// 电话
private String phone; private String phone;
// 密码问题更新日期
private Date pwdQuestUpdateDate; private Date pwdQuestUpdateDate;
// 密码问题
private String pwdQuestion; private String pwdQuestion;
// 第二个密码问题
@TableField(value = "pwd_question_2") @TableField(value = "pwd_question_2")
private String pwdQuestion2; private String pwdQuestion2;
// 第三个密码问题
@TableField(value = "pwd_question_3") @TableField(value = "pwd_question_3")
private String pwdQuestion3; private String pwdQuestion3;
// 密码问题答案
private String pwdQuestionAnswer; private String pwdQuestionAnswer;
// 第二个密码问题答案
@TableField(value = "pwd_question_answer_2") @TableField(value = "pwd_question_answer_2")
private String pwdQuestionAnswer2; private String pwdQuestionAnswer2;
// 第三个密码问题答案
@TableField(value = "pwd_question_answer_3") @TableField(value = "pwd_question_answer_3")
private String pwdQuestionAnswer3; private String pwdQuestionAnswer3;
// 密码安全级别
private BigDecimal pwdSecurityLevel; private BigDecimal pwdSecurityLevel;
// 密码更新日期
private Date pwdUpdateDate; private Date pwdUpdateDate;
// 密码更新记录
private String pwdUpdateRecord; private String pwdUpdateRecord;
// 推荐码
private String refCode; private String refCode;
// 推荐人名称
private String refName; private String refName;
// 备注
private String remarks; private String remarks;
// 性别
private String sex; private String sex;
// 个性签名
private String sign; private String sign;
// 用户状态枚举
@JSONField(serialzeFeatures = SerializerFeature.WriteEnumUsingToString) @JSONField(serialzeFeatures = SerializerFeature.WriteEnumUsingToString)
private SysUserStatusEnum status; private SysUserStatusEnum status;
// 更新人
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private String updateBy; private String updateBy;
// 更新时间
@TableField(fill = FieldFill.INSERT_UPDATE) @TableField(fill = FieldFill.INSERT_UPDATE)
private Date updateDate; private Date updateDate;
// 用户名
private String userName; private String userName;
// 员工姓名
private String empName; private String empName;
// 用户类型枚举
@JSONField(serialzeFeatures = SerializerFeature.WriteEnumUsingToString) @JSONField(serialzeFeatures = SerializerFeature.WriteEnumUsingToString)
private SysUserTypeEnum userType; private SysUserTypeEnum userType;
// 用户权重
private BigDecimal userWeight; private BigDecimal userWeight;
// 微信 OpenID
private String wxOpenid; private String wxOpenid;
// 英文名
private String userNameEn; private String userNameEn;
// 员工岗位列表（不存在数据库字段）
@TableField(exist = false) @TableField(exist = false)
private List<String> employeePosts; private List<String> employeePosts;
// 用户角色字符串（不存在数据库字段）
@TableField(exist = false) @TableField(exist = false)
private String userRoleString; private String userRoleString;
// 用户数据范围列表 JSON 字符串（不存在数据库字段）
@TableField(exist = false) @TableField(exist = false)
private String userDataScopeListJson; private String userDataScopeListJson;
/**
* 重写 pkVal 方法，返回用户编码作为主键值
* @return 用户编码
*/
@Override @Override
protected Serializable pkVal() { protected Serializable pkVal() {
return getUserCode(); return getUserCode();
} }
} }

190
tamguo-modules-core/src/main/java/com/tamguo/modules/sys/model/condition/SysUserCondition.java
Unescape View File

@ -1,128 +1,316 @@
package com.tamguo.modules.sys.model.condition; package com.tamguo.modules.sys.model.condition;
/**
* SysUserCondition 类，用于系统用户查询条件
*/
public class SysUserCondition { public class SysUserCondition {
// 当前页码
private Integer pageNo; private Integer pageNo;
// 每页显示数量
private Integer pageSize; private Integer pageSize;
// 登录账号
private String loginCode; private String loginCode;
// 用户名
private String userName; private String userName;
// 邮箱
private String email; private String email;
// 手机号
private String mobile; private String mobile;
// 电话号码
private String phone; private String phone;
// 推荐人名称
private String refName; private String refName;
// 部门名称
private String officeName; private String officeName;
// 部门编码
private String officeCode; private String officeCode;
// 公司编码
private String companyCode; private String companyCode;
// 公司名称
private String companyName; private String companyName;
// 岗位编码
private String postCode; private String postCode;
// 用户状态
private String status; private String status;
// 用户类型
private String userType; private String userType;
// 管理类型
private String mgrType; private String mgrType;
// 排序字段
private String orderBy; private String orderBy;
/**
* 获取当前页码
* @return 当前页码
*/
public Integer getPageNo() { public Integer getPageNo() {
return pageNo; return pageNo;
} }
/**
* 设置当前页码
* @param pageNo 当前页码
*/
public void setPageNo(Integer pageNo) { public void setPageNo(Integer pageNo) {
this.pageNo = pageNo; this.pageNo = pageNo;
} }
/**
* 获取每页显示数量
* @return 每页显示数量
*/
public Integer getPageSize() { public Integer getPageSize() {
return pageSize; return pageSize;
} }
/**
* 设置每页显示数量
* @param pageSize 每页显示数量
*/
public void setPageSize(Integer pageSize) { public void setPageSize(Integer pageSize) {
this.pageSize = pageSize; this.pageSize = pageSize;
} }
/**
* 获取登录账号
* @return 登录账号
*/
public String getLoginCode() { public String getLoginCode() {
return loginCode; return loginCode;
} }
/**
* 设置登录账号
* @param loginCode 登录账号
*/
public void setLoginCode(String loginCode) { public void setLoginCode(String loginCode) {
this.loginCode = loginCode; this.loginCode = loginCode;
} }
/**
* 获取用户名
* @return 用户名
*/
public String getUserName() { public String getUserName() {
return userName; return userName;
} }
/**
* 设置用户名
* @param userName 用户名
*/
public void setUserName(String userName) { public void setUserName(String userName) {
this.userName = userName; this.userName = userName;
} }
/**
* 获取邮箱
* @return 邮箱
*/
public String getEmail() { public String getEmail() {
return email; return email;
} }
/**
* 设置邮箱
* @param email 邮箱
*/
public void setEmail(String email) { public void setEmail(String email) {
this.email = email; this.email = email;
} }
/**
* 获取手机号
* @return 手机号
*/
public String getMobile() { public String getMobile() {
return mobile; return mobile;
} }
/**
* 设置手机号
* @param mobile 手机号
*/
public void setMobile(String mobile) { public void setMobile(String mobile) {
this.mobile = mobile; this.mobile = mobile;
} }
/**
* 获取电话号码
* @return 电话号码
*/
public String getPhone() { public String getPhone() {
return phone; return phone;
} }
/**
* 设置电话号码
* @param phone 电话号码
*/
public void setPhone(String phone) { public void setPhone(String phone) {
this.phone = phone; this.phone = phone;
} }
/**
* 获取推荐人名称
* @return 推荐人名称
*/
public String getRefName() { public String getRefName() {
return refName; return refName;
} }
/**
* 设置推荐人名称
* @param refName 推荐人名称
*/
public void setRefName(String refName) { public void setRefName(String refName) {
this.refName = refName; this.refName = refName;
} }
/**
* 获取部门名称
* @return 部门名称
*/
public String getOfficeName() { public String getOfficeName() {
return officeName; return officeName;
} }
/**
* 设置部门名称
* @param officeName 部门名称
*/
public void setOfficeName(String officeName) { public void setOfficeName(String officeName) {
this.officeName = officeName; this.officeName = officeName;
} }
/**
* 获取部门编码
* @return 部门编码
*/
public String getOfficeCode() { public String getOfficeCode() {
return officeCode; return officeCode;
} }
/**
* 设置部门编码
* @param officeCode 部门编码
*/
public void setOfficeCode(String officeCode) { public void setOfficeCode(String officeCode) {
this.officeCode = officeCode; this.officeCode = officeCode;
} }
/**
* 获取公司编码
* @return 公司编码
*/
public String getCompanyCode() { public String getCompanyCode() {
return companyCode; return companyCode;
} }
/**
* 设置公司编码
* @param companyCode 公司编码
*/
public void setCompanyCode(String companyCode) { public void setCompanyCode(String companyCode) {
this.companyCode = companyCode; this.companyCode = companyCode;
} }
/**
* 获取公司名称
* @return 公司名称
*/
public String getCompanyName() { public String getCompanyName() {
return companyName; return companyName;
} }
/**
* 设置公司名称
* @param companyName 公司名称
*/
public void setCompanyName(String companyName) { public void setCompanyName(String companyName) {
this.companyName = companyName; this.companyName = companyName;
} }
/**
* 获取岗位编码
* @return 岗位编码
*/
public String getPostCode() { public String getPostCode() {
return postCode; return postCode;
} }
/**
* 设置岗位编码
* @param postCode 岗位编码
*/
public void setPostCode(String postCode) { public void setPostCode(String postCode) {
this.postCode = postCode; this.postCode = postCode;
} }
/**
* 获取用户状态
* @return 用户状态
*/
public String getStatus() { public String getStatus() {
return status; return status;
} }
/**
* 设置用户状态
* @param status 用户状态
*/
public void setStatus(String status) { public void setStatus(String status) {
this.status = status; this.status = status;
} }
/**
* 获取用户类型
* @return 用户类型
*/
public String getUserType() { public String getUserType() {
return userType; return userType;
} }
/**
* 设置用户类型
* @param userType 用户类型
*/
public void setUserType(String userType) { public void setUserType(String userType) {
this.userType = userType; this.userType = userType;
} }
/**
* 获取排序字段
* @return 排序字段
*/
public String getOrderBy() { public String getOrderBy() {
return orderBy; return orderBy;
} }
/**
* 设置排序字段
* @param orderBy 排序字段
*/
public void setOrderBy(String orderBy) { public void setOrderBy(String orderBy) {
this.orderBy = orderBy; this.orderBy = orderBy;
} }
/**
* 获取管理类型
* @return 管理类型
*/
public String getMgrType() { public String getMgrType() {
return mgrType; return mgrType;
} }
/**
* 设置管理类型
* @param mgrType 管理类型
*/
public void setMgrType(String mgrType) { public void setMgrType(String mgrType) {
this.mgrType = mgrType; this.mgrType = mgrType;
} }
} }

71
tamguo-modules-core/src/main/java/com/tamguo/modules/tiku/model/ChapterEntity.java
Unescape View File

@ -2,45 +2,40 @@ package com.tamguo.modules.tiku.model;
import java.io.Serializable; import java.io.Serializable;
import com.alibaba.fastjson.annotation.JSONField; import com.alibaba.fastjson.annotation.JSONField; // 用于 JSON 序列化时的注解
import com.alibaba.fastjson.serializer.SerializerFeature; import com.alibaba.fastjson.serializer.SerializerFeature; // JSON 序列化特性
import com.baomidou.mybatisplus.annotations.TableField; import com.baomidou.mybatisplus.annotations.TableField; // 与数据库表字段相关的注解
import com.baomidou.mybatisplus.annotations.TableName; import com.baomidou.mybatisplus.annotations.TableName; // 表名注解
import com.tamguo.config.dao.SuperEntity; import com.tamguo.config.dao.SuperEntity; // 父类实体
import com.tamguo.modules.tiku.model.enums.ChapterStatusEnum; import com.tamguo.modules.tiku.model.enums.ChapterStatusEnum; // 章节状态枚举
import lombok.Data; import lombok.Data; // Lombok 的数据注解
import java.util.List;
/** /**
* The persistent class for the t_chapter database table. * t_chapter 数据库表的持久化类
*
*/ */
@TableName(value="t_chapter") @TableName(value = "t_chapter") // 指定表名为 t_chapter
@Data @Data // Lombok 的数据注解，自动生成 getter 和 setter 等方法
public class ChapterEntity extends SuperEntity<ChapterEntity> implements Serializable { public class ChapterEntity extends SuperEntity<ChapterEntity> implements Serializable { // 继承父类实体，实现序列化接口
private static final long serialVersionUID = 1L; private static final long serialVersionUID = 1L; // 序列化版本号
private String courseId; private String courseId; // 课程 ID
private String bookId; private String bookId; // 书籍 ID
private String name; private String name; // 章节名称
private String parentCode; private String parentCode; // 父章节代码
private String parentCodes; private String parentCodes; // 父章节代码列表
private Integer questionNum; private Integer questionNum; // 问题数量
private Integer pointNum; private Integer pointNum; // 知识点数量
private Integer orders; private Integer orders; // 排序序号
private Boolean treeLeaf; private Boolean treeLeaf; // 是否为叶子节点
private Integer treeLevel; private Integer treeLevel; // 树的层级
private String seoTitle; private String seoTitle; // SEO 标题
private String seoKeywords; private String seoKeywords; // SEO 关键字
private String seoDescription; private String seoDescription; // SEO 描述
@TableField(exist=false) @TableField(exist = false) // 表示该字段在数据库中不存在
private List<ChapterEntity> childChapterList; private List<ChapterEntity> childChapterList; // 子章节列表
@JSONField(serialzeFeatures= SerializerFeature.WriteEnumUsingToString) @JSONField(serialzeFeatures = SerializerFeature.WriteEnumUsingToString) // 指定 JSON 序列化枚举时的特性
private ChapterStatusEnum status; private ChapterStatusEnum status; // 章节状态枚举
} }

69
tamguo-modules-core/src/main/java/com/tamguo/modules/tiku/model/CourseEntity.java
Unescape View File

@ -1,43 +1,42 @@
package com.tamguo.modules.tiku.model; package com.tamguo.modules.tiku.model;
import java.util.Date; import java.util.Date; // 日期类
import com.alibaba.fastjson.annotation.JSONField;
import com.alibaba.fastjson.serializer.SerializerFeature;
import com.baomidou.mybatisplus.annotations.TableField;
import com.baomidou.mybatisplus.annotations.TableId;
import com.baomidou.mybatisplus.annotations.TableName;
import com.baomidou.mybatisplus.enums.FieldFill;
import com.tamguo.modules.tiku.model.enums.CourseStatusEnum;
import lombok.Data;
@Data import com.alibaba.fastjson.annotation.JSONField; // 用于 JSON 序列化时的注解
@TableName(value="t_course") import com.alibaba.fastjson.serializer.SerializerFeature; // JSON 序列化特性
public class CourseEntity { import com.baomidou.mybatisplus.annotations.TableField; // 与数据库表字段相关的注解
import com.baomidou.mybatisplus.annotations.TableId; // 表主键注解
@TableId import com.baomidou.mybatisplus.annotations.TableName; // 表名注解
private String id; import com.baomidou.mybatisplus.enums.FieldFill; // 字段填充策略枚举
private String subjectId; import com.tamguo.modules.tiku.model.enums.CourseStatusEnum; // 课程状态枚举
private String name; import lombok.Data; // Lombok 的数据注解
private Integer sort;
private Integer questionNum;
private Integer pointNum;
private String remarks;
private String icon;
private String seoTitle; @Data // Lombok 的数据注解，自动生成 getter 和 setter 等方法
private String seoKeywords; @TableName(value = "t_course") // 指定表名为 t_course
private String seoDescription; public class CourseEntity {
@TableId // 标识为主键
private String id; // 课程 ID
private String subjectId; // 科目 ID
private String name; // 课程名称
private Integer sort; // 排序号
private Integer questionNum; // 问题数量
private Integer pointNum; // 知识点数量
private String remarks; // 备注
private String icon; // 图标
@TableField(fill = FieldFill.INSERT_UPDATE) private String seoTitle; // SEO 标题
private String createBy; private String seoKeywords; // SEO 关键字
@TableField(fill = FieldFill.INSERT_UPDATE) private String seoDescription; // SEO 描述
private String updateBy;
@TableField(fill = FieldFill.INSERT_UPDATE)
private Date createDate;
@TableField(fill = FieldFill.INSERT_UPDATE)
private Date updateDate;
@JSONField(serialzeFeatures= SerializerFeature.WriteEnumUsingToString) @TableField(fill = FieldFill.INSERT_UPDATE) // 字段填充策略，在插入和更新时填充
private CourseStatusEnum status; private String createBy; // 创建人
@TableField(fill = FieldFill.INSERT_UPDATE) // 字段填充策略，在插入和更新时填充
private String updateBy; // 更新人
@TableField(fill = FieldFill.INSERT_UPDATE) // 字段填充策略，在插入和更新时填充
private Date createDate; // 创建日期
@TableField(fill = FieldFill.INSERT_UPDATE) // 字段填充策略，在插入和更新时填充
private Date updateDate; // 更新日期
@JSONField(serialzeFeatures = SerializerFeature.WriteEnumUsingToString) // 指定 JSON 序列化枚举时的特性
private CourseStatusEnum status; // 课程状态枚举
} }

69
tamguo-modules-core/src/main/java/com/tamguo/modules/tiku/model/condition/BookCondition.java
Unescape View File

@ -1,50 +1,117 @@
package com.tamguo.modules.tiku.model.condition; package com.tamguo.modules.tiku.model.condition;
/**
* BookCondition 类，用于书籍查询条件
*/
public class BookCondition { public class BookCondition {
// 当前页码
private Integer pageNo; private Integer pageNo;
// 每页显示数量
private Integer pageSize; private Integer pageSize;
// 书籍 ID
private String id; private String id;
// 出版社
private String publishingHouse; private String publishingHouse;
// 书名
private String name; private String name;
// 课程 ID
private String courseId; private String courseId;
/**
* 获取当前页码
* @return 当前页码
*/
public Integer getPageNo() { public Integer getPageNo() {
return pageNo; return pageNo;
} }
/**
* 设置当前页码
* @param pageNo 当前页码
*/
public void setPageNo(Integer pageNo) { public void setPageNo(Integer pageNo) {
this.pageNo = pageNo; this.pageNo = pageNo;
} }
/**
* 获取每页显示数量
* @return 每页显示数量
*/
public Integer getPageSize() { public Integer getPageSize() {
return pageSize; return pageSize;
} }
/**
* 设置每页显示数量
* @param pageSize 每页显示数量
*/
public void setPageSize(Integer pageSize) { public void setPageSize(Integer pageSize) {
this.pageSize = pageSize; this.pageSize = pageSize;
} }
/**
* 获取课程 ID
* @return 课程 ID
*/
public String getCourseId() { public String getCourseId() {
return courseId; return courseId;
} }
/**
* 设置课程 ID
* @param courseId 课程 ID
*/
public void setCourseId(String courseId) { public void setCourseId(String courseId) {
this.courseId = courseId; this.courseId = courseId;
} }
/**
* 获取出版社
* @return 出版社
*/
public String getPublishingHouse() { public String getPublishingHouse() {
return publishingHouse; return publishingHouse;
} }
/**
* 设置出版社
* @param publishingHouse 出版社
*/
public void setPublishingHouse(String publishingHouse) { public void setPublishingHouse(String publishingHouse) {
this.publishingHouse = publishingHouse; this.publishingHouse = publishingHouse;
} }
/**
* 获取书名
* @return 书名
*/
public String getName() { public String getName() {
return name; return name;
} }
/**
* 设置书名
* @param name 书名
*/
public void setName(String name) { public void setName(String name) {
this.name = name; this.name = name;
} }
/**
* 获取书籍 ID
* @return 书籍 ID
*/
public String getId() { public String getId() {
return id; return id;
} }
/**
* 设置书籍 ID
* @param id 书籍 ID
*/
public void setId(String id) { public void setId(String id) {
this.id = id; this.id = id;
} }
} }

58
tamguo-modules-core/src/main/java/com/tamguo/modules/tiku/model/condition/ChapterCondition.java
Unescape View File

@ -1,42 +1,98 @@
package com.tamguo.modules.tiku.model.condition; package com.tamguo.modules.tiku.model.condition;
/**
* ChapterCondition 类，用于章节查询条件
*/
public class ChapterCondition { public class ChapterCondition {
// 父章节编码
private String parentCode; private String parentCode;
// 章节 ID
private String id; private String id;
// 章节名称
private String name; private String name;
// 所属书籍 ID
private String bookId; private String bookId;
// 所属书籍名称
private String bookName; private String bookName;
/**
* 获取父章节编码
* @return 父章节编码
*/
public String getParentCode() { public String getParentCode() {
return parentCode; return parentCode;
} }
/**
* 设置父章节编码
* @param parentCode 父章节编码
*/
public void setParentCode(String parentCode) { public void setParentCode(String parentCode) {
this.parentCode = parentCode; this.parentCode = parentCode;
} }
/**
* 获取章节 ID
* @return 章节 ID
*/
public String getId() { public String getId() {
return id; return id;
} }
/**
* 设置章节 ID
* @param id 章节 ID
*/
public void setId(String id) { public void setId(String id) {
this.id = id; this.id = id;
} }
/**
* 获取章节名称
* @return 章节名称
*/
public String getName() { public String getName() {
return name; return name;
} }
/**
* 设置章节名称
* @param name 章节名称
*/
public void setName(String name) { public void setName(String name) {
this.name = name; this.name = name;
} }
/**
* 获取所属书籍 ID
* @return 所属书籍 ID
*/
public String getBookId() { public String getBookId() {
return bookId; return bookId;
} }
/**
* 设置所属书籍 ID
* @param bookId 所属书籍 ID
*/
public void setBookId(String bookId) { public void setBookId(String bookId) {
this.bookId = bookId; this.bookId = bookId;
} }
/**
* 获取所属书籍名称
* @return 所属书籍名称
*/
public String getBookName() { public String getBookName() {
return bookName; return bookName;
} }
/**
* 设置所属书籍名称
* @param bookName 所属书籍名称
*/
public void setBookName(String bookName) { public void setBookName(String bookName) {
this.bookName = bookName; this.bookName = bookName;
} }
} }

69
tamguo-modules-core/src/main/java/com/tamguo/modules/tiku/model/condition/CourseCondition.java
Unescape View File

@ -1,50 +1,117 @@
package com.tamguo.modules.tiku.model.condition; package com.tamguo.modules.tiku.model.condition;
/**
* CourseCondition 类，用于课程条件的封装
*/
public class CourseCondition { public class CourseCondition {
// 当前页码
private Integer pageNo; private Integer pageNo;
// 每页显示数量
private Integer pageSize; private Integer pageSize;
// 课程 ID
private String id; private String id;
// 课程名称
private String name; private String name;
// 课程状态
private String status; private String status;
// 学科 ID
private String subjectId; private String subjectId;
/**
* 获取当前页码
* @return 当前页码
*/
public Integer getPageNo() { public Integer getPageNo() {
return pageNo; return pageNo;
} }
/**
* 设置当前页码
* @param pageNo 当前页码
*/
public void setPageNo(Integer pageNo) { public void setPageNo(Integer pageNo) {
this.pageNo = pageNo; this.pageNo = pageNo;
} }
/**
* 获取每页显示数量
* @return 每页显示数量
*/
public Integer getPageSize() { public Integer getPageSize() {
return pageSize; return pageSize;
} }
/**
* 设置每页显示数量
* @param pageSize 每页显示数量
*/
public void setPageSize(Integer pageSize) { public void setPageSize(Integer pageSize) {
this.pageSize = pageSize; this.pageSize = pageSize;
} }
/**
* 获取课程名称
* @return 课程名称
*/
public String getName() { public String getName() {
return name; return name;
} }
/**
* 设置课程名称
* @param name 课程名称
*/
public void setName(String name) { public void setName(String name) {
this.name = name; this.name = name;
} }
/**
* 获取课程状态
* @return 课程状态
*/
public String getStatus() { public String getStatus() {
return status; return status;
} }
/**
* 设置课程状态
* @param status 课程状态
*/
public void setStatus(String status) { public void setStatus(String status) {
this.status = status; this.status = status;
} }
/**
* 获取学科 ID
* @return 学科 ID
*/
public String getSubjectId() { public String getSubjectId() {
return subjectId; return subjectId;
} }
/**
* 设置学科 ID
* @param subjectId 学科 ID
*/
public void setSubjectId(String subjectId) { public void setSubjectId(String subjectId) {
this.subjectId = subjectId; this.subjectId = subjectId;
} }
/**
* 获取课程 ID
* @return 课程 ID
*/
public String getId() { public String getId() {
return id; return id;
} }
/**
* 设置课程 ID
* @param id 课程 ID
*/
public void setId(String id) { public void setId(String id) {
this.id = id; this.id = id;
} }
} }

58
tamguo-modules-core/src/main/java/com/tamguo/modules/tiku/model/condition/SubjectCondition.java
Unescape View File

@ -1,43 +1,99 @@
package com.tamguo.modules.tiku.model.condition; package com.tamguo.modules.tiku.model.condition;
/**
* SubjectCondition 类，用于学科条件的封装
*/
public class SubjectCondition { public class SubjectCondition {
// 当前页码
private Integer pageNo; private Integer pageNo;
// 每页显示数量
private Integer pageSize; private Integer pageSize;
// 用户 ID
private String uid; private String uid;
// 学科名称
private String name; private String name;
// 学科状态
private String status; private String status;
/**
* 获取每页显示数量
* @return 每页显示数量
*/
public Integer getPageSize() { public Integer getPageSize() {
return pageSize; return pageSize;
} }
/**
* 设置每页显示数量
* @param pageSize 每页显示数量
*/
public void setPageSize(Integer pageSize) { public void setPageSize(Integer pageSize) {
this.pageSize = pageSize; this.pageSize = pageSize;
} }
/**
* 获取当前页码
* @return 当前页码
*/
public Integer getPageNo() { public Integer getPageNo() {
return pageNo; return pageNo;
} }
/**
* 设置当前页码
* @param pageNo 当前页码
*/
public void setPageNo(Integer pageNo) { public void setPageNo(Integer pageNo) {
this.pageNo = pageNo; this.pageNo = pageNo;
} }
/**
* 获取用户 ID
* @return 用户 ID
*/
public String getUid() { public String getUid() {
return uid; return uid;
} }
/**
* 设置用户 ID
* @param uid 用户 ID
*/
public void setUid(String uid) { public void setUid(String uid) {
this.uid = uid; this.uid = uid;
} }
/**
* 获取学科名称
* @return 学科名称
*/
public String getName() { public String getName() {
return name; return name;
} }
/**
* 设置学科名称
* @param name 学科名称
*/
public void setName(String name) { public void setName(String name) {
this.name = name; this.name = name;
} }
/**
* 获取学科状态
* @return 学科状态
*/
public String getStatus() { public String getStatus() {
return status; return status;
} }
/**
* 设置学科状态
* @param status 学科状态
*/
public void setStatus(String status) { public void setStatus(String status) {
this.status = status; this.status = status;
} }
} }

61
tamguo-modules-core/src/main/java/com/tamguo/modules/tiku/model/enums/QuestionTypeEnum.java
Unescape View File

@ -1,28 +1,66 @@
package com.tamguo.modules.tiku.model.enums; package com.tamguo.modules.tiku.model.enums;
import java.io.Serializable;
/** /**
* 试题类型、、题目类型(1.单选题；2.多选题; 3.解答题) * 试题类型枚举
* 题目类型：(1. 单选题；2. 多选题；3. 填空题；4. 判断题；5. 问答题)
* *
* @author tamguo * @author tamguo
*
*/ */
public enum QuestionTypeEnum { public enum QuestionTypeEnum {
/**
* 单选题
* @param value 值
* @param desc 描述
*/
DANXUANTI("1", "单选题"), DANXUANTI("1", "单选题"),
/**
* 多选题
* @param value 值
* @param desc 描述
*/
DUOXUANTI("2", "多选题"), DUOXUANTI("2", "多选题"),
/**
* 填空题
* @param value 值
* @param desc 描述
*/
TIANKONGTI("3", "填空题"), TIANKONGTI("3", "填空题"),
/**
* 判断题
* @param value 值
* @param desc 描述
*/
PANDUANTI("4", "判断题"), PANDUANTI("4", "判断题"),
/**
* 问答题
* @param value 值
* @param desc 描述
*/
WENDATI("5", "问答题"); WENDATI("5", "问答题");
private String value; private String value; // 枚举值
private String desc; private String desc; // 描述
/**
* 构造函数，初始化枚举值和描述
* @param value 值
* @param desc 描述
*/
QuestionTypeEnum(final String value, final String desc) { QuestionTypeEnum(final String value, final String desc) {
this.value = value; this.value = value;
this.desc = desc; this.desc = desc;
} }
/**
* 根据传入的 value 获取对应的枚举类型
* @param value 要查询的 value 值
* @return 对应的枚举类型，如果未找到则返回 WENDATI
*/
public static QuestionTypeEnum getQuestionType(String value) { public static QuestionTypeEnum getQuestionType(String value) {
if ("1".equals(value)) { if ("1".equals(value)) {
return DANXUANTI; return DANXUANTI;
@ -38,17 +76,28 @@ public enum QuestionTypeEnum {
return WENDATI; return WENDATI;
} }
/**
* 获取枚举值
* @return 枚举值
*/
public Serializable getValue() { public Serializable getValue() {
return this.value; return this.value;
} }
/**
* 获取描述
* @return 描述
*/
public String getDesc() { public String getDesc() {
return this.desc; return this.desc;
} }
/**
* 将枚举值转换为字符串
* @return 枚举值的字符串表示
*/
@Override @Override
public String toString() { public String toString() {
return this.value; return this.value;
} }
} }

221
tamguo-modules-core/src/main/java/com/tamguo/modules/tiku/service/impl/ChapterServiceImpl.java
Unescape View File

@ -1,45 +1,54 @@
package com.tamguo.modules.tiku.service.impl; package com.tamguo.modules.tiku.service.impl;
import java.util.ArrayList; import java.util.ArrayList; // 导入 ArrayList 类，用于存储章节列表
import java.util.List; import java.util.List; // 导入 List 接口，用于存储章节实体列表
import org.apache.commons.lang3.StringUtils; import org.apache.commons.lang3.StringUtils; // 导入StringUtils 类，用于字符串操作
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired; // 导入 Autowired 注解，用于依赖注入
import org.springframework.stereotype.Service; import org.springframework.stereotype.Service; // 导入 Service 注解，标识为服务层实现类
import org.springframework.transaction.annotation.Transactional; import org.springframework.transaction.annotation.Transactional; // 导入 Transactional 注解，用于事务管理
import com.alibaba.fastjson.JSONArray; import com.alibaba.fastjson.JSONArray; // 导入 JSONArray 类，用于处理 JSON 数组
import com.alibaba.fastjson.JSONObject; import com.alibaba.fastjson.JSONObject; // 导入 JSONObject 类，用于处理 JSON 对象
import com.baomidou.mybatisplus.mapper.Condition; import com.baomidou.mybatisplus.mapper.Condition; // 导入 Condition 类，用于构建查询条件
import com.baomidou.mybatisplus.plugins.Page; import com.baomidou.mybatisplus.plugins.Page; // 导入 Page 类，用于分页查询
import com.baomidou.mybatisplus.service.impl.ServiceImpl; import com.baomidou.mybatisplus.service.impl.ServiceImpl; // 导入 ServiceImpl 类，作为服务层实现类的父类
import com.tamguo.common.utils.SystemConstant; import com.tamguo.common.utils.SystemConstant; // 导入 SystemConstant 类，用于定义系统常量
import com.tamguo.modules.tiku.dao.KnowPointMapper; import com.tamguo.modules.tiku.dao.KnowPointMapper; // 导入 KnowPointMapper 接口，用于知识关键点的数据访问
import com.tamguo.modules.tiku.dao.ChapterMapper; import com.tamguo.modules.tiku.dao.ChapterMapper; // 导入 ChapterMapper 接口，用于章节的数据访问
import com.tamguo.modules.tiku.dao.CourseMapper; import com.tamguo.modules.tiku.dao.CourseMapper; // 导入 CourseMapper 接口，用于课程的数据访问
import com.tamguo.modules.tiku.model.KnowPointEntity; import com.tamguo.modules.tiku.model.KnowPointEntity; // 导入 KnowPointEntity 类，代表知识关键点实体
import com.tamguo.modules.tiku.model.ChapterEntity; import com.tamguo.modules.tiku.model.ChapterEntity; // 导入 ChapterEntity 类，代表章节实体
import com.tamguo.modules.tiku.model.condition.ChapterCondition; import com.tamguo.modules.tiku.model.condition.ChapterCondition; // 导入 ChapterCondition 类，代表章节查询条件
import com.tamguo.modules.tiku.model.enums.ChapterStatusEnum; import com.tamguo.modules.tiku.model.enums.ChapterStatusEnum; // 导入 ChapterStatusEnum 枚举，代表章节状态
import com.tamguo.modules.tiku.service.IChapterService; import com.tamguo.modules.tiku.service.IChapterService; // 导入 IChapterService 接口，定义章节服务的接口
@Service @Service // 标识为服务层实现类
public class ChapterServiceImpl extends ServiceImpl<ChapterMapper, ChapterEntity> implements IChapterService { public class ChapterServiceImpl extends ServiceImpl<ChapterMapper, ChapterEntity> implements IChapterService {
@Autowired @Autowired // 自动注入 ChapterMapper 实例
ChapterMapper chapterMapper; private ChapterMapper chapterMapper;
@Autowired
CourseMapper courseMapper; @Autowired // 自动注入 CourseMapper 实例
@Autowired private CourseMapper courseMapper;
KnowPointMapper bookMapper;
@Autowired // 自动注入 KnowPointMapper 实例
private KnowPointMapper bookMapper;
@Transactional(readOnly=false) /**
@SuppressWarnings("unchecked") * 查找章节树结构
*
* @param bookId 书籍 ID
* @return 章节树结构的根节点列表
*/
@Transactional(readOnly = false) // 开启事务，设置只读为 false
@SuppressWarnings("unchecked") // 抑制unchecked 警告
@Override @Override
public List<ChapterEntity> findChapterTree(String bookId) { public List<ChapterEntity> findChapterTree(String bookId) {
// 根据书籍 ID 查询章节列表
List<ChapterEntity> chapterList = baseMapper.selectList(Condition.create().eq("book_id", bookId)); List<ChapterEntity> chapterList = baseMapper.selectList(Condition.create().eq("book_id", bookId));
// 获取根chapter UID // 获取根章节 UID
String rootUid = StringUtils.EMPTY; String rootUid = StringUtils.EMPTY;
for (int i = 0; i < chapterList.size(); i++) { for (int i = 0; i < chapterList.size(); i++) {
ChapterEntity chapter = chapterList.get(i); ChapterEntity chapter = chapterList.get(i);
@ -47,6 +56,7 @@ public class ChapterServiceImpl extends ServiceImpl<ChapterMapper, ChapterEntity
rootUid = chapter.getId(); rootUid = chapter.getId();
} }
} }
// 获取第一层结构 // 获取第一层结构
List<ChapterEntity> entitys = new ArrayList<>(); List<ChapterEntity> entitys = new ArrayList<>();
for (int i = 0; i < chapterList.size(); i++) { for (int i = 0; i < chapterList.size(); i++) {
@ -55,8 +65,10 @@ public class ChapterServiceImpl extends ServiceImpl<ChapterMapper, ChapterEntity
entitys.add(chapter); entitys.add(chapter);
} }
} }
for (int i = 0; i < entitys.size(); i++) { for (int i = 0; i < entitys.size(); i++) {
ChapterEntity entity = entitys.get(i); ChapterEntity entity = entitys.get(i);
// 获取子章节列表
List<ChapterEntity> childs = new ArrayList<>(); List<ChapterEntity> childs = new ArrayList<>();
for (int k = 0; k < chapterList.size(); k++) { for (int k = 0; k < chapterList.size(); k++) {
ChapterEntity chapter = chapterList.get(k); ChapterEntity chapter = chapterList.get(k);
@ -66,10 +78,12 @@ public class ChapterServiceImpl extends ServiceImpl<ChapterMapper, ChapterEntity
} }
entity.setChildChapterList(childs); entity.setChildChapterList(childs);
} }
for (int i = 0; i < entitys.size(); i++) { for (int i = 0; i < entitys.size(); i++) {
List<ChapterEntity> childs = entitys.get(i).getChildChapterList(); List<ChapterEntity> childs = entitys.get(i).getChildChapterList();
for (int k = 0; k < childs.size(); k++) { for (int k = 0; k < childs.size(); k++) {
ChapterEntity child = childs.get(k); ChapterEntity child = childs.get(k);
// 获取子子章节列表
List<ChapterEntity> tmpChilds = new ArrayList<>(); List<ChapterEntity> tmpChilds = new ArrayList<>();
for (int n = 0; n < chapterList.size(); n++) { for (int n = 0; n < chapterList.size(); n++) {
ChapterEntity chapter = chapterList.get(n); ChapterEntity chapter = chapterList.get(n);
@ -83,83 +97,98 @@ public class ChapterServiceImpl extends ServiceImpl<ChapterMapper, ChapterEntity
return entitys; return entitys;
} }
@SuppressWarnings("unchecked") /**
* 根据条件查询章节数据
*
* @param condition 章节查询条件
* @return 符合条件的章节实体列表
*/
@SuppressWarnings("unchecked") // 抑制 unchecked 警告
@Override @Override
public List<ChapterEntity> listData(ChapterCondition condition) { public List<ChapterEntity> listData(ChapterCondition condition) {
Condition query = Condition.create(); Condition query = Condition.create(); // 创建查询条件对象
if (!StringUtils.isEmpty(condition.getParentCode())) { if (!StringUtils.isEmpty(condition.getParentCode())) {
query.eq("parent_code", condition.getParentCode()); query.eq("parent_code", condition.getParentCode()); // 添加父章节代码条件
} else { } else {
query.eq("tree_level", "0"); query.eq("tree_level", "0"); // 添加树级别为 0 的条件（即根章节）
} }
if (!StringUtils.isEmpty(condition.getId())) { if (!StringUtils.isEmpty(condition.getId())) {
query.eq("id", condition.getId()); query.eq("id", condition.getId()); // 添加章节 ID 条件
} }
if (!StringUtils.isEmpty(condition.getName())) { if (!StringUtils.isEmpty(condition.getName())) {
query.like("name", condition.getName()); query.like("name", condition.getName()); // 添加章节名称模糊匹配条件
} }
if (!StringUtils.isEmpty(condition.getBookId())) { if (!StringUtils.isEmpty(condition.getBookId())) {
query.andNew().eq("course_id", condition.getBookId()).or().eq("book_id", condition.getBookId()).or().eq("subject_id", condition.getBookId());; query.andNew().eq("course_id", condition.getBookId()).or().eq("book_id", condition.getBookId()).or().eq("subject_id", condition.getBookId()); // 添加课程 ID、书籍 ID 或科目 ID 条件
} }
return chapterMapper.selectList(query); return chapterMapper.selectList(query); // 执行查询并返回结果
}
@SuppressWarnings("unchecked")
@Override
public JSONArray treeData(String courseId, String excludeId) {
List<ChapterEntity> chapterList = null;
if(StringUtils.isEmpty(excludeId)) {
chapterList = chapterMapper.selectList(Condition.EMPTY);
} else {
chapterList = chapterMapper.selectList(Condition.create().notLike("parent_codes", excludeId).eq("id", excludeId));
}
return turnZTreeData(chapterList);
} }
/**
* 将章节数据转换为 ZTree 格式的 JSON 数组
*
* @param chapterList 章节实体列表
* @return ZTree 格式的 JSON 数组
*/
private JSONArray turnZTreeData(List<ChapterEntity> chapterList) { private JSONArray turnZTreeData(List<ChapterEntity> chapterList) {
if (chapterList!= null) { if (chapterList!= null) {
JSONArray nodes = new JSONArray(); JSONArray nodes = new JSONArray(); // 创建 JSON 数组对象
for (int i = 0; i < chapterList.size(); i++) { for (int i = 0; i < chapterList.size(); i++) {
JSONObject node = new JSONObject(); JSONObject node = new JSONObject(); // 创建 JSON 对象
ChapterEntity office = chapterList.get(i); ChapterEntity office = chapterList.get(i); // 获取章节实体
node.put("name", office.getName()); node.put("name", office.getName()); // 设置节点名称
node.put("id", office.getId()); node.put("id", office.getId()); // 设置节点 ID
node.put("pId", office.getParentCode()); node.put("pId", office.getParentCode()); // 设置父节点 ID
node.put("title", office.getName()); node.put("title", office.getName()); // 设置节点标题
nodes.add(node);
nodes.add(node); // 将节点添加到 JSON 数组中
} }
return nodes; return nodes; // 返回 JSON 数组
} }
return null; return null; // 如果章节列表为空，则返回 null
} }
@Transactional(readOnly=false) /**
* 保存章节信息
*
* @param chapter 章节实体
*/
@Transactional(readOnly = false) // 开启事务，设置只读为 false
@Override @Override
public void save(ChapterEntity chapter) { public void save(ChapterEntity chapter) {
// 更新父章节的叶子节点状态为 false
ChapterEntity parentChapter = chapterMapper.selectById(chapter.getParentCode()); ChapterEntity parentChapter = chapterMapper.selectById(chapter.getParentCode());
parentChapter.setTreeLeaf(false); parentChapter.setTreeLeaf(false);
chapterMapper.updateById(parentChapter); chapterMapper.updateById(parentChapter);
chapter.setStatus(ChapterStatusEnum.NORMAL); chapter.setStatus(ChapterStatusEnum.NORMAL); // 设置章节状态为正常
chapter.setTreeLeaf(true); chapter.setTreeLeaf(true); // 设置章节为叶子节点
chapter.setTreeLevel(parentChapter.getTreeLevel() + 1); chapter.setTreeLevel(parentChapter.getTreeLevel() + 1); // 设置章节树级别
chapter.setBookId(parentChapter.getBookId()); chapter.setBookId(parentChapter.getBookId()); // 设置章节所属书籍 ID
chapterMapper.insert(chapter); chapterMapper.insert(chapter); // 插入章节记录
// 更新章节的父章节代码列表
chapter.setParentCodes(parentChapter.getParentCodes() + chapter.getId() + ","); chapter.setParentCodes(parentChapter.getParentCodes() + chapter.getId() + ",");
chapterMapper.updateById(chapter); chapterMapper.updateById(chapter);
} }
@SuppressWarnings("unchecked") /**
@Transactional(readOnly=false) * 更新章节信息
*
* @param chapter 章节实体
*/
@SuppressWarnings("unchecked") // 抑制 unchecked 警告
@Transactional(readOnly = false) // 开启事务，设置只读为 false
@Override @Override
public void update(ChapterEntity chapter) { public void update(ChapterEntity chapter) {
ChapterEntity entity = chapterMapper.selectById(chapter.getId()); // 更新父章节的叶子节点状态为 false
ChapterEntity parentChapter = chapterMapper.selectById(chapter.getParentCode()); ChapterEntity parentChapter = chapterMapper.selectById(chapter.getParentCode());
parentChapter.setTreeLeaf(false); parentChapter.setTreeLeaf(false);
chapterMapper.updateById(parentChapter); chapterMapper.updateById(parentChapter);
// 更新章节信息
ChapterEntity entity = chapterMapper.selectById(chapter.getId());
entity.setName(chapter.getName()); entity.setName(chapter.getName());
entity.setParentCode(chapter.getParentCode()); entity.setParentCode(chapter.getParentCode());
entity.setParentCodes(parentChapter.getParentCodes() + entity.getId() + ","); entity.setParentCodes(parentChapter.getParentCodes() + entity.getId() + ",");
@ -168,7 +197,7 @@ public class ChapterServiceImpl extends ServiceImpl<ChapterMapper, ChapterEntity
entity.setOrders(chapter.getOrders()); entity.setOrders(chapter.getOrders());
entity.setTreeLevel(entity.getParentCodes().split(",").length - 1); entity.setTreeLevel(entity.getParentCodes().split(",").length - 1);
// 更新子集章节 // 更新子集章节的父章节代码列表和树级别
List<ChapterEntity> chapterList = chapterMapper.selectList(Condition.create().like("parent_codes", entity.getId())); List<ChapterEntity> chapterList = chapterMapper.selectList(Condition.create().like("parent_codes", entity.getId()));
for (int i = 0; i < chapterList.size(); i++) { for (int i = 0; i < chapterList.size(); i++) {
ChapterEntity child = chapterList.get(i); ChapterEntity child = chapterList.get(i);
@ -181,13 +210,20 @@ public class ChapterServiceImpl extends ServiceImpl<ChapterMapper, ChapterEntity
chapterMapper.updateById(entity); chapterMapper.updateById(entity);
} }
@Transactional(readOnly=false) /**
@SuppressWarnings("unchecked") * 删除章节信息
*
* @param id 章节 ID
*/
@Transactional(readOnly = false) // 开启事务，设置只读为 false
@SuppressWarnings("unchecked") // 抑制 unchecked 警告
@Override @Override
public void delete(String id) { public void delete(String id) {
// 更新章节状态为已删除
ChapterEntity chapter = chapterMapper.selectById(id); ChapterEntity chapter = chapterMapper.selectById(id);
chapter.setStatus(ChapterStatusEnum.DELETE); chapter.setStatus(ChapterStatusEnum.DELETE);
chapterMapper.updateById(chapter); chapterMapper.updateById(chapter);
// 删除子章节 // 删除子章节
List<ChapterEntity> childs = chapterMapper.selectList(Condition.create().like("parent_codes", id)); List<ChapterEntity> childs = chapterMapper.selectList(Condition.create().like("parent_codes", id));
for (int i = 0; i < childs.size(); i++) { for (int i = 0; i < childs.size(); i++) {
@ -197,24 +233,41 @@ public class ChapterServiceImpl extends ServiceImpl<ChapterMapper, ChapterEntity
} }
} }
@Transactional(readOnly=true) /**
@SuppressWarnings("unchecked") * 根据课程 ID 查询课程章节
*
* @param courseId 课程 ID
* @return 课程章节列表
*/
@Transactional(readOnly = true) // 开启事务，设置只读为 true
@SuppressWarnings("unchecked") // 抑制 unchecked 警告
@Override @Override
public List<ChapterEntity> findCourseChapter(String courseId) { public List<ChapterEntity> findCourseChapter(String courseId) {
// 根据课程 ID 查询知识关键点列表
List<KnowPointEntity> bookList = bookMapper.selectList(Condition.create().eq("course_id", courseId)); List<KnowPointEntity> bookList = bookMapper.selectList(Condition.create().eq("course_id", courseId));
if (bookList.size() == 0) { if (bookList.size() == 0) {
return null; return null; // 如果没有找到知识关键点，则返回 null
} }
Condition condition = Condition.create();
condition.eq("tree_level", 1); Condition condition = Condition.create(); // 创建查询条件对象
condition.eq("book_id", bookList.get(0).getId()); condition.eq("tree_level", 1); // 设置树级别为 1
condition.eq("book_id", bookList.get(0).getId()); // 设置书籍 ID
// 根据条件查询章节列表
List<ChapterEntity> list = chapterMapper.selectPage(new Page<>(1, 5), condition); List<ChapterEntity> list = chapterMapper.selectPage(new Page<>(1, 5), condition);
return list; return list; // 返回章节列表
} }
@Transactional(readOnly=true) /**
* 根据父章节代码和当前章节 ID 查询下一个章节
*
* @param parentCode 父章节代码
* @param id 当前章节 ID
* @return 下一个章节实体
*/
@Transactional(readOnly = true) // 开启事务，设置只读为 true
@Override @Override
public ChapterEntity selectNextChapter(String parentCode, String id) { public ChapterEntity selectNextChapter(String parentCode, String id) {
return chapterMapper.selectNextChapter(parentCode , id); return chapterMapper.selectNextChapter(parentCode, id); // 查询下一个章节
} }
} }

214
tamguo-modules-core/src/main/java/com/tamguo/modules/tiku/service/impl/CourseServiceImpl.java
Unescape View File

@ -1,125 +1,185 @@
package com.tamguo.modules.tiku.service.impl; package com.tamguo.modules.tiku.service.impl;
import java.util.Arrays; import java.util.Arrays; // 导入 Arrays 类，用于操作数组
import java.util.List; import java.util.List; // 导入 List 接口，用于存储科目和课程实体列表
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired; // 导入 Autowired 注解，用于依赖注入
import org.springframework.stereotype.Service; import org.springframework.stereotype.Service; // 导入 Service 注解，标识为服务层实现类
import org.springframework.transaction.annotation.Transactional; import org.springframework.transaction.annotation.Transactional; // 导入 Transactional 注解，用于事务管理
import org.springframework.util.StringUtils; import org.springframework.util.StringUtils; // 导入 StringUtils 类，用于字符串操作
import com.alibaba.fastjson.JSONArray; import com.alibaba.fastjson.JSONArray; // 导入 JSONArray 类，用于处理 JSON 数组
import com.alibaba.fastjson.JSONObject; import com.alibaba.fastjson.JSONObject; // 导入 JSONObject 类，用于处理 JSON 对象
import com.baomidou.mybatisplus.mapper.Condition; import com.baomidou.mybatisplus.mapper.Condition; // 导入 Condition 类，用于构建查询条件
import com.baomidou.mybatisplus.plugins.Page; import com.baomidou.mybatisplus.plugins.Page; // 导入 Page 类，用于分页查询
import com.baomidou.mybatisplus.service.impl.ServiceImpl; import com.baomidou.mybatisplus.service.impl.ServiceImpl; // 导入 ServiceImpl 类，作为服务层实现类的父类
import com.tamguo.modules.tiku.dao.CourseMapper; import com.tamguo.modules.tiku.dao.CourseMapper; // 导入 CourseMapper 接口，用于课程的数据访问
import com.tamguo.modules.tiku.dao.SubjectMapper; import com.tamguo.modules.tiku.dao.SubjectMapper; // 导入 SubjectMapper 接口，用于科目的数据访问
import com.tamguo.modules.tiku.model.CourseEntity; import com.tamguo.modules.tiku.model.CourseEntity; // 导入 CourseEntity 类，代表课程实体
import com.tamguo.modules.tiku.model.SubjectEntity; import com.tamguo.modules.tiku.model.SubjectEntity; // 导入 SubjectEntity 类，代表科目实体
import com.tamguo.modules.tiku.model.condition.CourseCondition; import com.tamguo.modules.tiku.model.condition.CourseCondition; // 导入 CourseCondition 类，代表课程查询条件
import com.tamguo.modules.tiku.model.enums.CourseStatusEnum; import com.tamguo.modules.tiku.model.enums.CourseStatusEnum; // 导入 CourseStatusEnum 枚举，代表课程状态
import com.tamguo.modules.tiku.model.enums.SubjectStatusEnum; import com.tamguo.modules.tiku.model.enums.SubjectStatusEnum; // 导入 SubjectStatusEnum 枚举，代表科目状态
import com.tamguo.modules.tiku.service.ICourseService; import com.tamguo.modules.tiku.service.ICourseService; // 导入 ICourseService 接口，定义课程服务的接口
@Service @Service // 标识为服务层实现类
public class CourseServiceImpl extends ServiceImpl<CourseMapper, CourseEntity> implements ICourseService { public class CourseServiceImpl extends ServiceImpl<CourseMapper, CourseEntity> implements ICourseService {
@Autowired @Autowired // 自动注入 CourseMapper 实例
public CourseMapper courseMapper; private CourseMapper courseMapper;
@Autowired
public SubjectMapper subjectMapper;
@SuppressWarnings("unchecked") @Autowired // 自动注入 SubjectMapper 实例
@Transactional(readOnly=true) private SubjectMapper subjectMapper;
/**
* 根据条件查询课程数据
*
* @param condition 课程查询条件
* @return 包含课程数据的分页对象
*/
@SuppressWarnings("unchecked") // 抑制unchecked 警告
@Transactional(readOnly = true) // 开启事务，设置只读为 true
@Override @Override
public Page<CourseEntity> listData(CourseCondition condition) { public Page<CourseEntity> listData(CourseCondition condition) {
Page<CourseEntity> page = new Page<>(condition.getPageNo() , condition.getPageSize()); Page<CourseEntity> page = new Page<>(condition.getPageNo(), condition.getPageSize()); // 创建分页对象
Condition query = Condition.create();
Condition query = Condition.create(); // 创建查询条件对象
if (!StringUtils.isEmpty(condition.getId())) { if (!StringUtils.isEmpty(condition.getId())) {
query.eq("id", condition.getId()); query.eq("id", condition.getId()); // 添加课程 ID 条件
} }
if (!StringUtils.isEmpty(condition.getName())) { if (!StringUtils.isEmpty(condition.getName())) {
query.like("name", condition.getName()); query.like("name", condition.getName()); // 添加课程名称模糊匹配条件
} }
if (!StringUtils.isEmpty(condition.getSubjectId())) { if (!StringUtils.isEmpty(condition.getSubjectId())) {
query.eq("subject_id", condition.getSubjectId()); query.eq("subject_id", condition.getSubjectId()); // 添加科目 ID 条件
} }
if (!StringUtils.isEmpty(condition.getStatus())) { if (!StringUtils.isEmpty(condition.getStatus())) {
query.eq("status", condition.getStatus()); query.eq("status", condition.getStatus()); // 添加课程状态条件
} }
query.orderAsc(Arrays.asList("sort")); query.orderAsc(Arrays.asList("sort")); // 根据排序字段升序排序
return page.setRecords(courseMapper.selectPage(page , query));
return page.setRecords(courseMapper.selectPage(page, query)); // 执行查询并设置分页结果
} }
@Transactional(readOnly=false) /**
* 保存课程信息
*
* @param course 课程实体
*/
@Transactional(readOnly = false) // 开启事务，设置只读为 false
@Override @Override
public void save(CourseEntity course) { public void save(CourseEntity course) {
course.setStatus(CourseStatusEnum.NORMAL); course.setStatus(CourseStatusEnum.NORMAL); // 设置课程状态为正常
courseMapper.insert(course); courseMapper.insert(course); // 插入课程记录
} }
@Transactional(readOnly=false) /**
* 更新课程信息
*
* @param course 课程实体
*/
@Transactional(readOnly = false) // 开启事务，设置只读为 false
@Override @Override
public void update(CourseEntity course) { public void update(CourseEntity course) {
CourseEntity entity = courseMapper.selectById(course.getId()); CourseEntity entity = courseMapper.selectById(course.getId()); // 获取要更新的课程实体
entity.setName(course.getName());
entity.setSubjectId(course.getSubjectId()); entity.setName(course.getName()); // 更新课程名称
entity.setSort(course.getSort()); entity.setSubjectId(course.getSubjectId()); // 更新科目 ID
entity.setRemarks(course.getRemarks()); entity.setSort(course.getSort()); // 更新排序号
courseMapper.updateById(entity); entity.setRemarks(course.getRemarks()); // 更新备注
courseMapper.updateById(entity); // 更新课程记录
} }
@Transactional(readOnly=false) /**
* 删除课程信息
*
* @param uid 课程 ID
*/
@Transactional(readOnly = false) // 开启事务，设置只读为 false
@Override @Override
public void delete(String uid) { public void delete(String uid) {
CourseEntity entity = courseMapper.selectById(uid); CourseEntity entity = courseMapper.selectById(uid); // 获取要删除的课程实体
entity.setStatus(CourseStatusEnum.DELETE);
courseMapper.updateById(entity); entity.setStatus(CourseStatusEnum.DELETE); // 设置课程状态为已删除
courseMapper.updateById(entity); // 更新课程记录
} }
@Transactional(readOnly=false) /**
* 启用课程
*
* @param uid 课程 ID
*/
@Transactional(readOnly = false) // 开启事务，设置只读为 false
@Override @Override
public void enable(String uid) { public void enable(String uid) {
CourseEntity entity = courseMapper.selectById(uid); CourseEntity entity = courseMapper.selectById(uid); // 获取要启用的课程实体
entity.setStatus(CourseStatusEnum.NORMAL);
courseMapper.updateById(entity); entity.setStatus(CourseStatusEnum.NORMAL); // 设置课程状态为正常
courseMapper.updateById(entity); // 更新课程记录
} }
@Transactional(readOnly=false) /**
* 禁用课程
*
* @param uid 课程 ID
*/
@Transactional(readOnly = false) // 开启事务，设置只读为 false
@Override @Override
public void disabled(String uid) { public void disabled(String uid) {
CourseEntity entity = courseMapper.selectById(uid); CourseEntity entity = courseMapper.selectById(uid); // 获取要禁用的课程实体
entity.setStatus(CourseStatusEnum.DISABLED);
courseMapper.updateById(entity); entity.setStatus(CourseStatusEnum.DISABLED); // 设置课程状态为禁用
courseMapper.updateById(entity); // 更新课程记录
} }
@SuppressWarnings("unchecked") /**
* 将科目和课程数据转换为 ZTree 格式的 JSON 数组
*
* @return ZTree 格式的 JSON 数组
*/
@SuppressWarnings("unchecked") // 抑制 unchecked 警告
@Transactional(readOnly = false) // 开启事务，设置只读为 false
@Override @Override
public JSONArray treeData() { public JSONArray treeData() {
List<SubjectEntity> subjectList = subjectMapper.selectList(Condition.create().eq("status", SubjectStatusEnum.NORMAL.getValue())); List<SubjectEntity> subjectList = subjectMapper.selectList(Condition.create().eq("status", SubjectStatusEnum.NORMAL.getValue())); // 查询正常状态的科目列表
List<CourseEntity> courseList = courseMapper.selectList(Condition.create().eq("status", CourseStatusEnum.NORMAL.getValue())); List<CourseEntity> courseList = courseMapper.selectList(Condition.create().eq("status", CourseStatusEnum.NORMAL.getValue())); // 查询正常状态的课程列表
return transform(subjectList, courseList);
return transform(subjectList, courseList); // 转换科目和课程数据为 JSON 数组
} }
/**
* 将科目和课程数据转换为 ZTree 格式的 JSON 数组
*
* @param subjectList 科目实体列表
* @param courseList 课程实体列表
* @return ZTree 格式的 JSON 数组
*/
private JSONArray transform(List<SubjectEntity> subjectList, List<CourseEntity> courseList) { private JSONArray transform(List<SubjectEntity> subjectList, List<CourseEntity> courseList) {
JSONArray entitys = new JSONArray(); JSONArray entitys = new JSONArray(); // 创建 JSON 数组对象
for (int i = 0; i < subjectList.size(); i++) { for (int i = 0; i < subjectList.size(); i++) {
JSONObject entity = new JSONObject(); JSONObject entity = new JSONObject(); // 创建 JSON 对象
entity.put("id", subjectList.get(i).getId());
entity.put("name", subjectList.get(i).getName()); SubjectEntity subject = subjectList.get(i); // 获取科目实体
entity.put("pId", "0"); entity.put("id", subject.getId()); // 设置科目 ID
entitys.add(entity); entity.put("name", subject.getName()); // 设置科目名称
entity.put("pId", "0"); // 设置父节点 ID 为 0
entitys.add(entity); // 将科目对象添加到 JSON 数组中
} }
for (int i = 0; i < courseList.size(); i++) { for (int i = 0; i < courseList.size(); i++) {
JSONObject entity = new JSONObject(); JSONObject entity = new JSONObject(); // 创建 JSON 对象
entity.put("id", courseList.get(i).getId());
entity.put("name", courseList.get(i).getName());
entity.put("pId", courseList.get(i).getSubjectId());
entitys.add(entity);
}
return entitys;
}
CourseEntity course = courseList.get(i); // 获取课程实体
entity.put("id", course.getId()); // 设置课程 ID
entity.put("name", course.getName()); // 设置课程名称
entity.put("pId", course.getSubjectId()); // 设置父节点 ID 为课程所属科目 ID
entitys.add(entity); // 将课程对象添加到 JSON 数组中
}
return entitys; // 返回转换后的 JSON 数组
}
} }

235
tamguo-modules-core/src/main/java/com/tamguo/modules/tiku/service/impl/KnowPointServiceImpl.java
Unescape View File

@ -1,129 +1,192 @@
package com.tamguo.modules.tiku.service.impl; package com.tamguo.modules.tiku.service.impl;
import java.util.List; import java.util.List; // 导入 List 接口，用于存储科目、课程和知识点实体列表
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired; // 导入 Autowired 注解，用于依赖注入
import org.springframework.stereotype.Service; import org.springframework.stereotype.Service; // 导入 Service 注解，标识为服务层实现类
import org.springframework.transaction.annotation.Transactional; import org.springframework.transaction.annotation.Transactional; // 导入 Transactional 注解，用于事务管理
import com.alibaba.fastjson.JSONArray; import com.alibaba.fastjson.JSONArray; // 导入 JSONArray 类，用于处理 JSON 数组
import com.alibaba.fastjson.JSONObject; import com.alibaba.fastjson.JSONObject; // 导入 JSONObject 类，用于处理 JSON 对象
import com.baomidou.mybatisplus.mapper.Condition; import com.baomidou.mybatisplus.mapper.Condition; // 导入 Condition 类，用于构建查询条件
import com.baomidou.mybatisplus.plugins.Page; import com.baomidou.mybatisplus.plugins.Page; // 导入 Page 类，用于分页查询
import com.baomidou.mybatisplus.service.impl.ServiceImpl; import com.baomidou.mybatisplus.service.impl.ServiceImpl; // 导入 ServiceImpl 类，作为服务层实现类的父类
import com.tamguo.modules.tiku.dao.KnowPointMapper; import com.tamguo.modules.tiku.dao.KnowPointMapper; // 导入 KnowPointMapper 接口，用于知识点的数据访问
import com.tamguo.modules.tiku.dao.CourseMapper; import com.tamguo.modules.tiku.dao.CourseMapper; // 导入 CourseMapper 接口，用于课程的数据访问
import com.tamguo.modules.tiku.dao.SubjectMapper; import com.tamguo.modules.tiku.dao.SubjectMapper; // 导入 SubjectMapper 接口，用于科目的数据访问
import com.tamguo.modules.tiku.model.KnowPointEntity; import com.tamguo.modules.tiku.model.KnowPointEntity; // 导入 KnowPointEntity 类，代表知识点实体
import com.tamguo.modules.tiku.model.CourseEntity; import com.tamguo.modules.tiku.model.CourseEntity; // 导入 CourseEntity 类，代表课程实体
import com.tamguo.modules.tiku.model.SubjectEntity; import com.tamguo.modules.tiku.model.SubjectEntity; // 导入 SubjectEntity 类，代表科目实体
import com.tamguo.modules.tiku.model.condition.BookCondition; import com.tamguo.modules.tiku.model.condition.BookCondition; // 导入 BookCondition 类，代表知识点查询条件
import com.tamguo.modules.tiku.model.enums.BookStatusEnum; import com.tamguo.modules.tiku.model.enums.BookStatusEnum; // 导入 BookStatusEnum 枚举，代表知识点状态
import com.tamguo.modules.tiku.model.enums.CourseStatusEnum; import com.tamguo.modules.tiku.model.enums.CourseStatusEnum; // 导入 CourseStatusEnum 枚举，代表课程状态
import com.tamguo.modules.tiku.model.enums.SubjectStatusEnum; import com.tamguo.modules.tiku.model.enums.SubjectStatusEnum; // 导入 SubjectStatusEnum 枚举，代表科目状态
import com.tamguo.modules.tiku.service.IKnowPointService; import com.tamguo.modules.tiku.service.IKnowPointService; // 导入 IKnowPointService 接口，定义知识点服务的接口
@Service @Service // 标识为服务层实现类
public class KnowPointServiceImpl extends ServiceImpl<KnowPointMapper, KnowPointEntity> implements IKnowPointService { public class KnowPointServiceImpl extends ServiceImpl<KnowPointMapper, KnowPointEntity> implements IKnowPointService {
@Autowired @Autowired // 自动注入 KnowPointMapper 实例
KnowPointMapper knowPointMapper; private KnowPointMapper knowPointMapper;
@Autowired
CourseMapper courseMapper;
@Autowired
SubjectMapper subjectMapper;
@Transactional(readOnly=false) @Autowired // 自动注入 CourseMapper 实例
private CourseMapper courseMapper;
@Autowired // 自动注入 SubjectMapper 实例
private SubjectMapper subjectMapper;
/**
* 根据条件查询知识点数据
*
* @param condition 知识点查询条件
* @return 包含知识点数据的分页对象
*/
@Transactional(readOnly = false) // 开启事务，设置只读为 false
@Override @Override
public Page<KnowPointEntity> listData(BookCondition condition) { public Page<KnowPointEntity> listData(BookCondition condition) {
Page<KnowPointEntity> page = new Page<>(condition.getPageNo() , condition.getPageSize()); Page<KnowPointEntity> page = new Page<>(condition.getPageNo(), condition.getPageSize()); // 创建分页对象
return page.setRecords(knowPointMapper.listData(page, condition)); return page.setRecords(knowPointMapper.listData(page, condition)); // 执行查询并设置分页结果
} }
@Transactional(readOnly=false) /**
* 保存知识点信息
*
* @param book 知识点实体
*/
@Transactional(readOnly = false) // 开启事务，设置只读为 false
@Override @Override
public void save(KnowPointEntity book) { public void save(KnowPointEntity book) {
CourseEntity course = courseMapper.selectById(book.getCourseId()); CourseEntity course = courseMapper.selectById(book.getCourseId()); // 获取课程实体
book.setStatus(BookStatusEnum.NORMAL); book.setStatus(BookStatusEnum.NORMAL); // 设置知识点状态为正常
book.setSubjectId(course.getSubjectId()); book.setSubjectId(course.getSubjectId()); // 设置知识点所属科目 ID
knowPointMapper.insert(book); knowPointMapper.insert(book); // 插入知识点记录
} }
@Transactional(readOnly=false) /**
* 更新知识点信息
*
* @param book 知识点实体
*/
@Transactional(readOnly = false) // 开启事务，设置只读为 false
@Override @Override
public void update(KnowPointEntity book) { public void update(KnowPointEntity book) {
CourseEntity course = courseMapper.selectById(book.getCourseId()); CourseEntity course = courseMapper.selectById(book.getCourseId()); // 获取课程实体
KnowPointEntity entity = knowPointMapper.selectById(book.getId()); KnowPointEntity entity = knowPointMapper.selectById(book.getId()); // 获取要更新的知识点实体
entity.setName(book.getName()); entity.setName(book.getName()); // 更新知识点名称
entity.setPointNum(book.getPointNum()); entity.setPointNum(book.getPointNum()); // 更新知识点数量
entity.setQuestionNum(book.getQuestionNum()); entity.setQuestionNum(book.getQuestionNum()); // 更新问题数量
entity.setRemarks(book.getRemarks()); entity.setRemarks(book.getRemarks()); // 更新备注
entity.setPublishingHouse(book.getPublishingHouse()); entity.setPublishingHouse(book.getPublishingHouse()); // 更新出版社
entity.setSort(book.getSort()); entity.setSort(book.getSort()); // 更新排序号
entity.setCourseId(course.getId()); entity.setCourseId(course.getId()); // 更新课程 ID
knowPointMapper.updateById(entity); knowPointMapper.updateById(entity); // 更新知识点记录
} }
@Transactional(readOnly=false) /**
* 删除知识点信息
*
* @param id 知识点 ID
*/
@Transactional(readOnly = false) // 开启事务，设置只读为 false
@Override @Override
public void delete(String id) { public void delete(String id) {
KnowPointEntity book = knowPointMapper.selectById(id); KnowPointEntity book = knowPointMapper.selectById(id); // 获取要删除的知识点实体
book.setStatus(BookStatusEnum.DELETE);
knowPointMapper.updateById(book); book.setStatus(BookStatusEnum.DELETE); // 设置知识点状态为已删除
knowPointMapper.updateById(book); // 更新知识点记录
} }
@Transactional(readOnly=false) /**
* 启用知识点
*
* @param id 知识点 ID
*/
@Transactional(readOnly = false) // 开启事务，设置只读为 false
@Override @Override
public void enable(String id) { public void enable(String id) {
KnowPointEntity book = knowPointMapper.selectById(id); KnowPointEntity book = knowPointMapper.selectById(id); // 获取要启用的知识点实体
book.setStatus(BookStatusEnum.NORMAL);
knowPointMapper.updateById(book); book.setStatus(BookStatusEnum.NORMAL); // 设置知识点状态为正常
knowPointMapper.updateById(book); // 更新知识点记录
} }
@Transactional(readOnly=false) /**
* 禁用知识点
*
* @param id 知识点 ID
*/
@Transactional(readOnly = false) // 开启事务，设置只读为 false
@Override @Override
public void disabled(String id) { public void disabled(String id) {
KnowPointEntity book = knowPointMapper.selectById(id); KnowPointEntity book = knowPointMapper.selectById(id); // 获取要禁用的知识点实体
book.setStatus(BookStatusEnum.DISABLED);
knowPointMapper.updateById(book); book.setStatus(BookStatusEnum.DISABLED); // 设置知识点状态为禁用
knowPointMapper.updateById(book); // 更新知识点记录
} }
@Transactional(readOnly=false) /**
@SuppressWarnings("unchecked") * 将科目、课程和知识点数据转换为 ZTree 格式的 JSON 数组
*
* @return ZTree 格式的 JSON 数组
*/
@Transactional(readOnly = false) // 开启事务，设置只读为 false
@SuppressWarnings("unchecked") // 抑制 unchecked 警告
@Override @Override
public JSONArray treeData() { public JSONArray treeData() {
List<SubjectEntity> subjectList = subjectMapper.selectList(Condition.create().eq("status", SubjectStatusEnum.NORMAL.getValue())); List<SubjectEntity> subjectList = subjectMapper.selectList(Condition.create().eq("status", SubjectStatusEnum.NORMAL.getValue())); // 查询正常状态的科目列表
List<CourseEntity> courseList = courseMapper.selectList(Condition.create().eq("status", CourseStatusEnum.NORMAL.getValue())); List<CourseEntity> courseList = courseMapper.selectList(Condition.create().eq("status", CourseStatusEnum.NORMAL.getValue())); // 查询正常状态的课程列表
List<KnowPointEntity> bookList = knowPointMapper.selectList(Condition.create().eq("status", BookStatusEnum.NORMAL.getValue())); List<KnowPointEntity> bookList = knowPointMapper.selectList(Condition.create().eq("status", BookStatusEnum.NORMAL.getValue())); // 查询正常状态的知识点列表
return transform(subjectList, courseList , bookList);
return transform(subjectList, courseList, bookList); // 转换科目、课程和知识点数据为 JSON 数组
} }
/**
* 将科目、课程和知识点数据转换为 ZTree 格式的 JSON 数组
*
* @param subjectList 科目实体列表
* @param courseList 课程实体列表
* @param bookList 知识点实体列表
* @return ZTree 格式的 JSON 数组
*/
private JSONArray transform(List<SubjectEntity> subjectList, List<CourseEntity> courseList, List<KnowPointEntity> bookList) { private JSONArray transform(List<SubjectEntity> subjectList, List<CourseEntity> courseList, List<KnowPointEntity> bookList) {
JSONArray entitys = new JSONArray(); JSONArray entitys = new JSONArray(); // 创建 JSON 数组对象
for (int i = 0; i < subjectList.size(); i++) { for (int i = 0; i < subjectList.size(); i++) {
JSONObject entity = new JSONObject(); JSONObject entity = new JSONObject(); // 创建 JSON 对象
entity.put("id", subjectList.get(i).getId());
entity.put("name", subjectList.get(i).getName()); SubjectEntity subject = subjectList.get(i); // 获取科目实体
entity.put("pId", "0"); entity.put("id", subject.getId()); // 设置科目 ID
entitys.add(entity); entity.put("name", subject.getName()); // 设置科目名称
entity.put("pId", "0"); // 设置父节点 ID 为 0
entitys.add(entity); // 将科目对象添加到 JSON 数组中
} }
for (int i = 0; i < courseList.size(); i++) { for (int i = 0; i < courseList.size(); i++) {
JSONObject entity = new JSONObject(); JSONObject entity = new JSONObject(); // 创建 JSON 对象
entity.put("id", courseList.get(i).getId());
entity.put("name", courseList.get(i).getName()); CourseEntity course = courseList.get(i); // 获取课程实体
entity.put("pId", courseList.get(i).getSubjectId()); entity.put("id", course.getId()); // 设置课程 ID
entitys.add(entity); entity.put("name", course.getName()); // 设置课程名称
entity.put("pId", course.getSubjectId()); // 设置父节点 ID 为课程所属科目 ID
entitys.add(entity); // 将课程对象添加到 JSON 数组中
} }
for (int i = 0; i < bookList.size(); i++) { for (int i = 0; i < bookList.size(); i++) {
JSONObject entity = new JSONObject(); JSONObject entity = new JSONObject(); // 创建 JSON 对象
entity.put("id", bookList.get(i).getId());
entity.put("name", bookList.get(i).getName()); KnowPointEntity book = bookList.get(i); // 获取知识点实体
entity.put("pId", bookList.get(i).getCourseId()); entity.put("id", book.getId()); // 设置知识点 ID
entitys.add(entity); entity.put("name", book.getName()); // 设置知识点名称
entity.put("pId", book.getCourseId()); // 设置父节点 ID 为知识点所属课程 ID
entitys.add(entity); // 将知识点对象添加到 JSON 数组中
} }
return entitys;
return entitys; // 返回转换后的 JSON 数组
} }
} }

43
tamguo-modules-core/src/main/java/com/tamguo/modules/tiku/service/impl/MenuServiceImpl.java
Unescape View File

@ -2,6 +2,7 @@ package com.tamguo.modules.tiku.service.impl;
import java.util.Arrays; import java.util.Arrays;
import java.util.List; import java.util.List;
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service; import org.springframework.stereotype.Service;
@ -13,14 +14,28 @@ import com.tamguo.modules.tiku.dao.MenuMapper;
import com.tamguo.modules.tiku.model.MenuEntity; import com.tamguo.modules.tiku.model.MenuEntity;
import com.tamguo.modules.tiku.service.IMenuService; import com.tamguo.modules.tiku.service.IMenuService;
/**
* MenuServiceImpl 类，实现 IMenuService 接口
*/
@Service @Service
public class MenuServiceImpl extends ServiceImpl<MenuMapper, MenuEntity> implements IMenuService { public class MenuServiceImpl extends ServiceImpl<MenuMapper, MenuEntity> implements IMenuService {
/**
* 自动注入的 MenuMapper
*/
@Autowired @Autowired
private MenuMapper menuMapper; private MenuMapper menuMapper;
/**
* 自动注入的缓存服务
*/
@Autowired @Autowired
private CacheService cacheService; private CacheService cacheService;
/**
* 获取菜单列表
* @return 菜单列表
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@Override @Override
public List<MenuEntity> findMenus() { public List<MenuEntity> findMenus() {
@ -36,6 +51,10 @@ public class MenuServiceImpl extends ServiceImpl<MenuMapper, MenuEntity> impleme
return menuList; return menuList;
} }
/**
* 获取所有菜单列表
* @return 所有菜单列表
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@Override @Override
public List<MenuEntity> findAllMenus() { public List<MenuEntity> findAllMenus() {
@ -51,6 +70,10 @@ public class MenuServiceImpl extends ServiceImpl<MenuMapper, MenuEntity> impleme
return allMenuList; return allMenuList;
} }
/**
* 获取左侧菜单列表
* @return 左侧菜单列表
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@Override @Override
public List<MenuEntity> findLeftMenus() { public List<MenuEntity> findLeftMenus() {
@ -66,7 +89,10 @@ public class MenuServiceImpl extends ServiceImpl<MenuMapper, MenuEntity> impleme
return leftMenuList; return leftMenuList;
} }
/**
* 获取章节菜单列表
* @return 章节菜单列表
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@Override @Override
public List<MenuEntity> findChapterMenus() { public List<MenuEntity> findChapterMenus() {
@ -82,7 +108,10 @@ public class MenuServiceImpl extends ServiceImpl<MenuMapper, MenuEntity> impleme
return chapterMenuList; return chapterMenuList;
} }
/**
* 获取页脚菜单列表
* @return 页脚菜单列表
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@Override @Override
public List<MenuEntity> findFooterMenus() { public List<MenuEntity> findFooterMenus() {
@ -98,15 +127,23 @@ public class MenuServiceImpl extends ServiceImpl<MenuMapper, MenuEntity> impleme
return footerMenuList; return footerMenuList;
} }
/**
* 获取菜单树
* @return 菜单树
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@Override @Override
public List<MenuEntity> getMenuTree() { public List<MenuEntity> getMenuTree() {
return menuMapper.selectList(Condition.EMPTY); return menuMapper.selectList(Condition.EMPTY);
} }
/**
* 根据 ID 查找菜单实体
* @param uid 菜单 ID
* @return 菜单实体
*/
@Override @Override
public MenuEntity findById(String uid) { public MenuEntity findById(String uid) {
return menuMapper.selectById(uid); return menuMapper.selectById(uid);
} }
} }

93
tamguo-modules-core/src/main/java/com/tamguo/modules/tiku/service/impl/PaperServiceImpl.java
Unescape View File

@ -27,24 +27,58 @@ import com.tamguo.modules.tiku.service.ICourseService;
import com.tamguo.modules.tiku.service.IPaperService; import com.tamguo.modules.tiku.service.IPaperService;
import com.tamguo.modules.tiku.service.ISubjectService; import com.tamguo.modules.tiku.service.ISubjectService;
/**
* PaperServiceImpl 类，实现 IPaperService 接口
*/
@Service @Service
public class PaperServiceImpl extends ServiceImpl<PaperMapper, PaperEntity> implements IPaperService { public class PaperServiceImpl extends ServiceImpl<PaperMapper, PaperEntity> implements IPaperService {
/**
* 自动注入的 ISubjectService
*/
@Autowired @Autowired
private ISubjectService iSubjectService; private ISubjectService iSubjectService;
/**
* 自动注入的 ICourseService
*/
@Autowired @Autowired
private ICourseService iCourseService; private ICourseService iCourseService;
/**
* 自动注入的 ISysAreaService
*/
@Autowired @Autowired
private ISysAreaService iSysAreaService; private ISysAreaService iSysAreaService;
/**
* 自动注入的 PaperMapper
*/
@Autowired @Autowired
private PaperMapper paperMapper; private PaperMapper paperMapper;
/**
* 自动注入的 CacheService
*/
@Autowired @Autowired
private CacheService cacheService; private CacheService cacheService;
/**
* 自动注入的 QuestionMapper
*/
@Autowired @Autowired
private QuestionMapper questionMapper; private QuestionMapper questionMapper;
/**
* 自动注入的 QuestionOptionsMapper
*/
@Autowired @Autowired
private QuestionOptionsMapper questionOptionsMapper; private QuestionOptionsMapper questionOptionsMapper;
/**
* 获取历史试卷列表
* @return 历史试卷列表
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@Override @Override
public List<PaperEntity> findHistoryPaper() { public List<PaperEntity> findHistoryPaper() {
@ -63,6 +97,10 @@ public class PaperServiceImpl extends ServiceImpl<PaperMapper, PaperEntity> impl
return paperList; return paperList;
} }
/**
* 获取模拟试卷列表
* @return 模拟试卷列表
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@Override @Override
public List<PaperEntity> findSimulationPaper() { public List<PaperEntity> findSimulationPaper() {
@ -81,6 +119,11 @@ public class PaperServiceImpl extends ServiceImpl<PaperMapper, PaperEntity> impl
return paperList; return paperList;
} }
/**
* 获取热门试卷列表
* @param areaId 地区 ID
* @return 热门试卷列表
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@Override @Override
public List<PaperEntity> findHotPaper(String areaId) { public List<PaperEntity> findHotPaper(String areaId) {
@ -99,6 +142,13 @@ public class PaperServiceImpl extends ServiceImpl<PaperMapper, PaperEntity> impl
return paperList; return paperList;
} }
/**
* 添加试卷问题信息
* @param paperId 试卷 ID
* @param title 标题
* @param name 名称
* @param type 类型
*/
@Transactional(readOnly = false) @Transactional(readOnly = false)
@Override @Override
public void addPaperQuestionInfo(String paperId, String title, String name, String type) { public void addPaperQuestionInfo(String paperId, String title, String name, String type) {
@ -117,6 +167,14 @@ public class PaperServiceImpl extends ServiceImpl<PaperMapper, PaperEntity> impl
paperMapper.updateById(paper); paperMapper.updateById(paper);
} }
/**
* 更新试卷问题信息
* @param paperId 试卷 ID
* @param title 标题
* @param name 名称
* @param type 类型
* @param uid 问题 ID
*/
@Transactional(readOnly = false) @Transactional(readOnly = false)
@Override @Override
public void updatePaperQuestionInfo(String paperId, String title, String name, String type, String uid) { public void updatePaperQuestionInfo(String paperId, String title, String name, String type, String uid) {
@ -135,9 +193,15 @@ public class PaperServiceImpl extends ServiceImpl<PaperMapper, PaperEntity> impl
paperMapper.updateById(paper); paperMapper.updateById(paper);
} }
/**
* 删除试卷
* @param currMemberId 当前用户 ID
* @param paperId 试卷 ID
* @return 删除结果
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@Override @Override
public Result deletePaper(String currMemberId , String paperId) { public Result deletePaper(String CurrMemberId, String paperId) {
PaperEntity paper = paperMapper.selectById(paperId); PaperEntity paper = paperMapper.selectById(paperId);
if (!currMemberId.equals(paper.getCreaterId())) { if (!currMemberId.equals(paper.getCreaterId())) {
return Result.result(501, null, "不能删除其他人的试卷！"); return Result.result(501, null, "不能删除其他人的试卷！");
@ -148,9 +212,16 @@ public class PaperServiceImpl extends ServiceImpl<PaperMapper, PaperEntity> impl
return Result.result(Result.SUCCESS_CODE, null, "删除成功！"); return Result.result(Result.SUCCESS_CODE, null, "删除成功！");
} }
/**
* 删除试卷问题信息
* @param CurrMemberId 当前用户 ID
* @param paperId 试卷 ID
* @param cuid 问题 ID
* @return 删除结果
*/
@Transactional(readOnly = false) @Transactional(readOnly = false)
@Override @Override
public Result deletePaperQuestionInfoBtn(String currMemberId , String paperId, String cuid) { public Result deletePaperQuestionInfoBtn(String CurrMemberId, String paperId, String cuid) {
PaperEntity paper = paperMapper.selectById(paperId); PaperEntity paper = paperMapper.selectById(paperId);
if (!paper.getCreaterId().equals(currMemberId)) { if (!paper.getCreaterId().equals(currMemberId)) {
return Result.failResult("试卷属于当前用户，不能修改！"); return Result.failResult("试卷属于当前用户，不能修改！");
@ -167,6 +238,10 @@ public class PaperServiceImpl extends ServiceImpl<PaperMapper, PaperEntity> impl
return Result.result(Result.SUCCESS_CODE, null, "删除子卷成功"); return Result.result(Result.SUCCESS_CODE, null, "删除子卷成功");
} }
/**
* 添加试卷
* @param paper 试卷实体
*/
@Transactional(readOnly = false) @Transactional(readOnly = false)
@Override @Override
public void addPaper(PaperEntity paper) { public void addPaper(PaperEntity paper) {
@ -181,8 +256,14 @@ public class PaperServiceImpl extends ServiceImpl<PaperMapper, PaperEntity> impl
paperMapper.insert(paper); paperMapper.insert(paper);
} }
/**
* 更新试卷
* @param paper 试卷实体
* @param currMemberId 当前用户 ID
* @return 更新结果
*/
@Override @Override
public Result updatePaper(PaperEntity paper ,String currMemberId) { public Result updatePaper(PaperEntity paper, String CurrMemberId) {
PaperEntity entity = paperMapper.selectById(paper.getId()); PaperEntity entity = paperMapper.selectById(paper.getId());
if (!entity.getCreaterId().equals(currMemberId)) { if (!entity.getCreaterId().equals(currMemberId)) {
return Result.failResult("试卷属于当前用户，不能修改！"); return Result.failResult("试卷属于当前用户，不能修改！");
@ -192,6 +273,11 @@ public class PaperServiceImpl extends ServiceImpl<PaperMapper, PaperEntity> impl
return Result.result(Result.SUCCESS_CODE, paper, "修改成功"); return Result.result(Result.SUCCESS_CODE, paper, "修改成功");
} }
/**
* 获取试卷问题列表
* @param paperId 试卷 ID
* @return 问题列表
*/
@Override @Override
public List<QuestionEntity> findQuestionList(String paperId) { public List<QuestionEntity> findQuestionList(String paperId) {
// 查询选项信息 // 查询选项信息
@ -202,5 +288,4 @@ public class PaperServiceImpl extends ServiceImpl<PaperMapper, PaperEntity> impl
}); });
return questionList; return questionList;
} }
} }

69
tamguo-modules-core/src/main/java/com/tamguo/modules/tiku/service/impl/QuestionServiceImpl.java
Unescape View File

@ -15,66 +15,135 @@ import com.tamguo.modules.tiku.model.PaperEntity;
import com.tamguo.modules.tiku.model.QuestionEntity; import com.tamguo.modules.tiku.model.QuestionEntity;
import com.tamguo.modules.tiku.service.IQuestionService; import com.tamguo.modules.tiku.service.IQuestionService;
// 标识这是一个Spring的服务层组件类，用于实现IQuestionService接口中定义的与题目（Question）相关的业务逻辑方法，
// 它继承自ServicePlus框架提供的ServiceImpl类，借助其提供的通用数据库操作能力，结合自身的业务逻辑实现对题目数据的添加、查询、更新和删除等操作，并且通过依赖注入获取相关的Mapper对象来与数据库进行交互。
@Service @Service
public class QuestionServiceImpl extends ServiceImpl<QuestionMapper, QuestionEntity> implements IQuestionService { public class QuestionServiceImpl extends ServiceImpl<QuestionMapper, QuestionEntity> implements IQuestionService {
// 自动注入PaperMapper，用于操作试卷（Paper）相关的数据，比如通过试卷ID查询试卷信息等操作，在题目相关业务逻辑中可能需要获取试卷的创建者等信息来进行权限判断等操作，依赖该Mapper与数据库的试卷表进行交互。
@Autowired @Autowired
private PaperMapper paperMapper; private PaperMapper paperMapper;
// 自动注入QuestionMapper，用于操作题目（Question）相关的数据，比如插入题目、根据条件查询题目、更新题目以及删除题目等数据库操作，是实现题目业务逻辑中与数据库进行交互的核心依赖对象，直接对应数据库中的题目表。
@Autowired @Autowired
private QuestionMapper questionMapper; private QuestionMapper questionMapper;
/**
* 添加题目业务逻辑方法
* 该方法用于向数据库中添加一道新的题目信息，在添加之前会先根据传入题目所属试卷的ID去查询试卷信息，判断当前登录用户是否为该试卷的创建者，
* 如果不是则返回无权操作的提示信息；若是，则设置题目中的课程ID（从对应的试卷信息中获取），然后将题目信息插入到数据库中，并返回添加成功的提示信息。
*
* @param question 要添加的题目实体对象，包含了题目相关的各种属性信息（如题目内容、所属试卷ID等），这些信息将被插入到数据库的题目表中，需要保证其属性值符合数据库表结构及业务要求。
* @param currMemberId 当前登录会员的ID，用于判断当前用户是否有权限添加该题目，通过与试卷创建者的ID进行比对来确定权限，只有试卷创建者才有添加对应试卷下题目的权限，确保数据的安全性和权限控制。
* @return 返回一个Result对象，该对象包含了操作的状态码、数据以及提示信息，用于告知调用者题目添加操作的结果，如果添加成功状态码为0，若无权操作则状态码为501，并携带相应的提示信息说明情况。
*/
@Override @Override
public Result addQuestion(QuestionEntity question, String currMemberId) { public Result addQuestion(QuestionEntity question, String currMemberId) {
// 根据题目实体对象中携带的试卷ID，通过PaperMapper从数据库中查询对应的试卷实体信息，用于后续判断当前用户对该试卷是否有操作权限（即是否为试卷创建者）。
PaperEntity paper = paperMapper.selectById(question.getPaperId().toString()); PaperEntity paper = paperMapper.selectById(question.getPaperId().toString());
// 判断当前登录会员的ID与查询到的试卷创建者的ID是否相等，如果不相等，表示当前用户无权操作该试卷下的题目，返回包含相应错误提示信息和状态码（501）的Result对象给调用者。
if (!currMemberId.equals(paper.getCreaterId())) { if (!currMemberId.equals(paper.getCreaterId())) {
return Result.result(501, null, "改试卷不属于您！"); return Result.result(501, null, "改试卷不属于您！");
} }
// 如果当前用户有权限添加题目，将从试卷实体对象中获取的课程ID设置到题目实体对象中，保证题目与试卷在课程维度上的关联关系正确，便于后续按课程等维度进行题目相关的查询、统计等业务操作。
question.setCourseId(paper.getCourseId()); question.setCourseId(paper.getCourseId());
// 通过QuestionMapper将题目实体对象插入到数据库的题目表中，完成题目添加的数据库操作，若插入成功，则数据库中会新增一条对应的题目记录。
questionMapper.insert(question); questionMapper.insert(question);
// 返回包含添加成功提示信息和状态码（0表示成功）的Result对象给调用者，告知题目添加操作已成功完成。
return Result.result(0, null, "添加成功！"); return Result.result(0, null, "添加成功！");
} }
/**
* 查询题目列表业务逻辑方法
* 根据传入的多个查询条件（如题目类型、题目ID、题目内容、所属试卷ID以及当前登录会员ID等）来查询符合条件的题目列表信息，
* 在查询之前会先根据试卷ID和当前登录会员ID判断用户是否有权限查询该试卷下的题目，如果无权则返回空的题目列表；若有权限，则根据其他条件构建查询条件对象，
* 通过MyBatis Plus的分页查询功能从数据库中获取相应的题目列表数据，并返回包含查询结果的分页对象。
*
* @param questionType 题目类型，用于筛选特定类型的题目，若为空字符串则表示不按题目类型进行筛选，根据业务需求传入相应的题目类型值，与数据库题目表中的题目类型字段进行匹配查询。
* @param id 题目ID，用于精确查找特定ID的题目，若为空则不按此ID进行筛选，方便根据已知的题目唯一标识来获取具体的题目信息，与数据库题目表中的题目ID字段进行匹配查询。
* @param content 题目内容，用于模糊查询包含指定内容的题目，若为空则不按此内容进行筛选，可用于根据部分题目内容关键字来查找相关题目，通过数据库的模糊查询（LIKE操作符）与题目表中的题目内容字段进行匹配查询。
* @param paperId 所属试卷ID，用于指定要查询题目所属的试卷，是判断权限以及确定查询范围的重要依据，通过该试卷ID结合当前登录会员ID来验证用户是否有权查询该试卷下的题目，同时也是构建查询条件与数据库题目表中所属试卷ID字段进行匹配查询的关键参数。
* @param currMemberId 当前登录会员的ID，用于进行权限判断，通过与试卷创建者的ID对比来确定当前用户是否有权限查询该试卷下的题目，只有试卷创建者才能查询对应试卷下的题目信息，确保数据的访问权限控制。
* @param p 分页对象，包含了分页相关的参数信息（如页码、每页记录数等），用于进行分页查询，在查询符合条件的题目列表时，会按照该分页对象的设置来获取相应分页的数据，方便在前端进行分页展示等操作。
* @return 返回一个包含题目列表数据的Page<QuestionEntity>分页对象，如果用户无权查询则返回的分页对象中记录列表为空（通过p.setRecords(null)设置），若有权查询则返回包含符合条件题目列表数据的分页对象，供前端进行分页展示等处理。
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@Override @Override
public Page<QuestionEntity> queryQuestionList(String questionType, String id, String content, String paperId, String currMemberId, public Page<QuestionEntity> queryQuestionList(String questionType, String id, String content, String paperId, String currMemberId,
Page<QuestionEntity> p) { Page<QuestionEntity> p) {
// 根据传入的试卷ID从数据库中查询对应的试卷实体信息，然后判断当前登录会员的ID与查询到的试卷创建者的ID是否相等，如果不相等，表示当前用户无权查询该试卷下的题目，直接返回传入的分页对象，并将其记录列表设置为空，表示无权获取题目数据。
if (!currMemberId.equals(paperMapper.selectById(paperId).getCreaterId())) { if (!currMemberId.equals(paperMapper.selectById(paperId).getCreaterId())) {
return p.setRecords(null); return p.setRecords(null);
} }
// 创建一个MyBatis Plus的查询条件对象，用于构建后续查询题目时的各种条件，通过该对象可以方便地添加等于、大于、小于、模糊匹配等各种条件来精确筛选题目数据，符合MyBatis Plus的条件查询规范。
Condition condition = new Condition(); Condition condition = new Condition();
// 判断题目类型是否不为空字符串，如果不为空，则添加一个等于（eq）条件到查询条件对象中，使得查询时只会获取指定题目类型的题目，与数据库题目表中的题目类型字段进行精确匹配查询。
if (!StringUtils.isEmpty(questionType)) { if (!StringUtils.isEmpty(questionType)) {
condition.eq("question_type", questionType); condition.eq("question_type", questionType);
} }
// 判断题目ID是否不为空字符串，如果不为空，则添加一个等于（eq）条件到查询条件对象中，使得查询时只会获取指定ID的题目，与数据库题目表中的题目ID字段进行精确匹配查询，用于精确查找特定题目。
if (!StringUtils.isEmpty(id)) { if (!StringUtils.isEmpty(id)) {
condition.eq("id", id); condition.eq("id", id);
} }
// 判断题目内容是否不为空字符串，如果不为空，则添加一个模糊匹配（like）条件到查询条件对象中，使得查询时会获取题目内容包含指定关键字的题目，通过数据库的模糊查询（LIKE操作符）与题目表中的题目内容字段进行匹配查询，用于根据部分内容查找相关题目。
if (!StringUtils.isEmpty(content)) { if (!StringUtils.isEmpty(content)) {
condition.like("content", content); condition.like("content", content);
} }
// 添加一个等于（eq）条件到查询条件对象中，指定要查询的题目所属的试卷ID，与数据库题目表中的所属试卷ID字段进行精确匹配查询，确保获取的题目都是属于指定试卷的。
condition.eq("paper_id", paperId); condition.eq("paper_id", paperId);
// 通过QuestionMapper结合分页对象和构建好的查询条件对象进行分页查询，从数据库中获取符合条件的题目列表数据，并将查询结果设置到传入的分页对象的记录列表中，最后返回该分页对象，供前端进行分页展示等操作。
return p.setRecords(questionMapper.selectPage(p, condition)); return p.setRecords(questionMapper.selectPage(p, condition));
} }
/**
* 更新题目业务逻辑方法
* 该方法用于更新数据库中已存在的题目信息，在更新之前会先根据传入题目所属试卷的ID去查询试卷信息，判断当前登录用户是否为该试卷的创建者，
* 如果不是则返回无权操作的提示信息；若是，则通过QuestionMapper根据题目ID更新相应的题目信息，并返回更新成功的提示信息。
* 该方法使用了事务控制，确保在更新题目数据的过程中，如果出现异常情况，数据库操作能够回滚，保证数据的一致性和完整性。
*
* @param question 要更新的题目实体对象，包含了更新后的题目相关属性信息（如更新后的题目内容、所属试卷ID等），这些信息将覆盖数据库中对应题目记录的原有属性值，需要保证其属性值符合数据库表结构及业务要求。
* @param currMemberId 当前登录会员的ID，用于判断当前用户是否有权限更新该题目，通过与试卷创建者的ID进行比对来确定权限，只有试卷创建者才有更新对应试卷下题目的权限，确保数据的安全性和权限控制。
* @return 返回一个Result对象，该对象包含了操作的状态码、数据以及提示信息，用于告知调用者题目更新操作的结果，如果更新成功状态码为0，若无权操作则状态码为501，并携带相应的提示信息说明情况。
*/
@Transactional(readOnly = false) @Transactional(readOnly = false)
@Override @Override
public Result updateQuestion(QuestionEntity question, String currMemberId) { public Result updateQuestion(QuestionEntity question, String currMemberId) {
// 根据题目实体对象中携带的试卷ID，通过PaperMapper从数据库中查询对应的试卷实体信息，用于后续判断当前用户对该试卷是否有操作权限（即是否为试卷创建者）。
PaperEntity paper = paperMapper.selectById(question.getPaperId().toString()); PaperEntity paper = paperMapper.selectById(question.getPaperId().toString());
// 判断当前登录会员的ID与查询到的试卷创建者的ID是否相等，如果不相等，表示当前用户无权操作该试卷下的题目，返回包含相应错误提示信息和状态码（501）的Result对象给调用者。
if (!currMemberId.equals(paper.getCreaterId())) { if (!currMemberId.equals(paper.getCreaterId())) {
return Result.result(501, null, "改试卷不属于您！"); return Result.result(501, null, "改试卷不属于您！");
} }
// 如果当前用户有权限更新题目，通过QuestionMapper根据题目实体对象的ID更新数据库中对应的题目记录，将传入的题目实体对象中的属性值覆盖原有记录中的相应属性值，完成题目信息的更新操作。
questionMapper.updateById(question); questionMapper.updateById(question);
// 返回包含更新成功提示信息和状态码（0表示成功）的Result对象给调用者，告知题目更新操作已成功完成。
return Result.result(0, null, "修改成功！"); return Result.result(0, null, "修改成功！");
} }
/**
* 删除题目业务逻辑方法
* 该方法用于从数据库中删除指定ID的题目信息，在删除之前会先根据传入题目ID获取题目所属试卷的信息，判断当前登录用户是否为该试卷的创建者，
* 如果不是则返回无权操作的提示信息；若是，则通过QuestionMapper根据题目ID删除对应的题目记录，并返回删除成功的提示信息。
* 该方法使用了事务控制，确保在删除题目数据的过程中，如果出现异常情况，数据库操作能够回滚，保证数据的一致性和完整性。
*
* @param uid 要删除题目的唯一标识ID，用于准确指定要从数据库中删除的题目记录，通过该ID可以在数据库题目表中定位到对应的题目记录并进行删除操作，确保删除操作的准确性。
* @param currMemberId 当前登录会员的ID，用于判断当前用户是否有权限删除该题目，通过与试卷创建者的ID进行比对来确定权限，只有试卷创建者才有删除对应试卷下题目的权限，确保数据的安全性和权限控制。
* @return 返回一个Result对象，该对象包含了操作的状态码、数据以及提示信息，用于告知调用者题目删除操作的结果，如果删除成功状态码为0，若无权操作则状态码为501，并携带相应的提示信息说明情况。
*/
@Transactional(readOnly = false) @Transactional(readOnly = false)
@Override @Override
public Result delete(String uid, String currMemberId) { public Result delete(String uid, String currMemberId) {
// 根据传入的题目ID，通过QuestionMapper从数据库中查询对应的题目实体信息，用于获取该题目所属试卷的ID，以便后续判断当前用户对该试卷是否有操作权限（即是否为试卷创建者）。
QuestionEntity question = questionMapper.selectById(uid); QuestionEntity question = questionMapper.selectById(uid);
// 根据题目所属试卷的ID，通过PaperMapper从数据库中查询对应的试卷实体信息，用于后续判断当前用户对该试卷是否有操作权限（即是否为试卷创建者）。
PaperEntity paper = paperMapper.selectById(question.getPaperId().toString()); PaperEntity paper = paperMapper.selectById(question.getPaperId().toString());
// 判断当前登录会员的ID与查询到的试卷创建者的ID是否相等，如果不相等，表示当前用户无权操作该试卷下的题目，返回包含相应错误提示信息和状态码（501）的Result对象给调用者。
if (!currMemberId.equals(paper.getCreaterId())) { if (!currMemberId.equals(paper.getCreaterId())) {
return Result.result(501, null, "改试卷不属于您！"); return Result.result(501, null, "改试卷不属于您！");
} }
// 如果当前用户有权限删除题目，通过QuestionMapper根据题目ID删除数据库中对应的题目记录，完成题目删除的数据库操作，从数据库表中移除该题目对应的行数据。
questionMapper.deleteById(uid); questionMapper.deleteById(uid);
// 返回包含删除成功提示信息和状态码（0表示成功）的Result对象给调用者，告知题目删除操作已成功完成。
return Result.result(0, null, "删除成功！"); return Result.result(0, null, "删除成功！");
} }

31
tamguo-modules-core/src/main/java/com/tamguo/modules/tiku/service/impl/SchoolService.java
Unescape View File

@ -19,16 +19,35 @@ import com.tamguo.modules.tiku.model.PaperEntity;
import com.tamguo.modules.tiku.model.SchoolEntity; import com.tamguo.modules.tiku.model.SchoolEntity;
import com.tamguo.modules.tiku.service.ISchoolService; import com.tamguo.modules.tiku.service.ISchoolService;
/**
* SchoolServiceImpl 类，实现 ISchoolService 接口
*/
@Service @Service
public class SchoolService extends ServiceImpl<SchoolMapper, SchoolEntity> implements ISchoolService { public class SchoolServiceImpl extends ServiceImpl<SchoolMapper, SchoolEntity> implements ISchoolService {
/**
* 自动注入的 SchoolMapper
*/
@Autowired @Autowired
private SchoolMapper schoolMapper; private SchoolMapper schoolMapper;
/**
* 自动注入的 PaperMapper
*/
@Autowired @Autowired
private PaperMapper paperMapper; private PaperMapper paperMapper;
/**
* 自动注入的 CacheService
*/
@Autowired @Autowired
private CacheService cacheService; private CacheService cacheService;
/**
* 获取精英学校试卷
* @param shcoolId 学校 ID
* @return 精英学校试卷列表
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@Override @Override
public List<SchoolEntity> findEliteSchoolPaper(String shcoolId) { public List<SchoolEntity> findEliteSchoolPaper(String shcoolId) {
@ -47,6 +66,10 @@ public class SchoolService extends ServiceImpl<SchoolMapper, SchoolEntity> imple
return schoolList; return schoolList;
} }
/**
* 获取精英学校
* @return 精英学校列表
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@Override @Override
public List<SchoolEntity> findEliteSchool() { public List<SchoolEntity> findEliteSchool() {
@ -59,11 +82,15 @@ public class SchoolService extends ServiceImpl<SchoolMapper, SchoolEntity> imple
return schoolList; return schoolList;
} }
/**
* 根据地区 ID 查询学校
* @param areaId 地区 ID
* @return 学校列表
*/
@Transactional(readOnly = true) @Transactional(readOnly = true)
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@Override @Override
public List<SchoolEntity> findSchoolByAreaId(String areaId) { public List<SchoolEntity> findSchoolByAreaId(String areaId) {
return schoolMapper.selectList(Condition.create().in("area_id", Arrays.asList(areaId.split(",")))); return schoolMapper.selectList(Condition.create().in("area_id", Arrays.asList(areaId.split(","))));
} }
} }

44
tamguo-modules-core/src/main/java/com/tamguo/modules/tiku/service/impl/SubjectServiceImpl.java
Unescape View File

@ -19,14 +19,29 @@ import com.tamguo.modules.tiku.model.condition.SubjectCondition;
import com.tamguo.modules.tiku.model.enums.SubjectStatusEnum; import com.tamguo.modules.tiku.model.enums.SubjectStatusEnum;
import com.tamguo.modules.tiku.service.ISubjectService; import com.tamguo.modules.tiku.service.ISubjectService;
/**
* SubjectServiceImpl 类，实现 ISubjectService 接口
*/
@Service @Service
public class SubjectServiceImpl extends ServiceImpl<SubjectMapper, SubjectEntity> implements ISubjectService { public class SubjectServiceImpl extends ServiceImpl<SubjectMapper, SubjectEntity> implements ISubjectService {
/**
* 自动注入的 SubjectMapper
*/
@Autowired @Autowired
private SubjectMapper subjectMapper; private SubjectMapper subjectMapper;
/**
* 自动注入的 CourseMapper
*/
@Autowired @Autowired
private CourseMapper courseMapper; private CourseMapper courseMapper;
/**
* 列表数据
* @param condition 条件
* @return 页面对象
*/
@Transactional(readOnly = false) @Transactional(readOnly = false)
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@Override @Override
@ -44,6 +59,10 @@ public class SubjectServiceImpl extends ServiceImpl<SubjectMapper, SubjectEntity
return page.setRecords(subjectMapper.selectPage(page, query)); return page.setRecords(subjectMapper.selectPage(page, query));
} }
/**
* 保存
* @param subject 实体
*/
@Transactional(readOnly = false) @Transactional(readOnly = false)
@Override @Override
public void save(SubjectEntity subject) { public void save(SubjectEntity subject) {
@ -51,6 +70,10 @@ public class SubjectServiceImpl extends ServiceImpl<SubjectMapper, SubjectEntity
subjectMapper.insert(subject); subjectMapper.insert(subject);
} }
/**
* 更新
* @param subject 实体
*/
@Transactional(readOnly = false) @Transactional(readOnly = false)
@Override @Override
public void update(SubjectEntity subject) { public void update(SubjectEntity subject) {
@ -64,6 +87,10 @@ public class SubjectServiceImpl extends ServiceImpl<SubjectMapper, SubjectEntity
subjectMapper.updateById(entity); subjectMapper.updateById(entity);
} }
/**
* 启用
* @param uid 编号
*/
@Transactional(readOnly = false) @Transactional(readOnly = false)
@Override @Override
public void enable(String uid) { public void enable(String uid) {
@ -72,6 +99,10 @@ public class SubjectServiceImpl extends ServiceImpl<SubjectMapper, SubjectEntity
subjectMapper.updateById(entity); subjectMapper.updateById(entity);
} }
/**
* 禁用
* @param uid 编号
*/
@Transactional(readOnly = false) @Transactional(readOnly = false)
@Override @Override
public void disabled(String uid) { public void disabled(String uid) {
@ -80,6 +111,10 @@ public class SubjectServiceImpl extends ServiceImpl<SubjectMapper, SubjectEntity
subjectMapper.updateById(entity); subjectMapper.updateById(entity);
} }
/**
* 删除
* @param uid 编号
*/
@Transactional(readOnly = false) @Transactional(readOnly = false)
@Override @Override
public void delete(String uid) { public void delete(String uid) {
@ -88,6 +123,10 @@ public class SubjectServiceImpl extends ServiceImpl<SubjectMapper, SubjectEntity
subjectMapper.updateById(entity); subjectMapper.updateById(entity);
} }
/**
* 获取课程级联树
* @return JSON 数组
*/
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@Override @Override
public JSONArray getCourseCascaderTree() { public JSONArray getCourseCascaderTree() {
@ -115,6 +154,10 @@ public class SubjectServiceImpl extends ServiceImpl<SubjectMapper, SubjectEntity
return courseTree; return courseTree;
} }
/**
* 获取主题树
* @return JSON 数组
*/
@Transactional(readOnly = true) @Transactional(readOnly = true)
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
@Override @Override
@ -130,5 +173,4 @@ public class SubjectServiceImpl extends ServiceImpl<SubjectMapper, SubjectEntity
} }
return courseTree; return courseTree;
} }
} }
Write Preview
Loading…
Cancel
Save