jeeplus多商户商城，分销商城

#ZSCAT
springcloud 多商户商城 下载 https://gitee.com/catshen/zscat_sw

pc+h5 +小程序 +app uniapp集成 分销商城 积分商城
不用写xml配置！独特的日志记录方式！包含用户角色，权限等模块的后台管理系统！整合springmvc + mybatis-plus + beetl！

鸣谢

1.SpringBlade
2.beetl
3.mybatis-plus

##功能简介

1. 用户管理
2. 角色管理
3. 菜单管理
4. 部门管理
5. 日志管理
6. 监控管理
7. 字典管理
8. 通知管理
9. 代码生成

##使用说明

1. 导入sql/guns.sql文件到数据库
2. 以maven方式导入项目，并修改数据库文件（src/main/resources/dev/jdbc.properties）为本机数据库配置
3. 启动项目,管理员账号admin/密码111111

##所用框架
###前端

1. bootstrap
2. jquery
3. bootstrap-table
4. layer
5. ztree
6. webuploader

###后端

1. springmvc
2. mybatis
3. mybatis-plus
4. spring
5. beetl
6. hibernate-validator
7. ehcache

##项目特点

1. 零springxml配置，完全采用javabean方式配置spring，新思路，配置简洁，不易出错。详情请见com.stylefeng.guns.project.config包中具体类。
2. 完善的日志记录体系，可记录登录日志，业务操作日志，异常日志到数据库，通过@BussinessLog注解和LogObjectHolder.me().set()方法，业务操作日志可具体记录哪个用户，执行了哪些业务，修改了哪些数据，并且日志记录为异步执行，详情请见@BussinessLog注解和LogObjectHolder,LogManager,LogAop类。
3. 利用beetl模板引擎对前台页面进行封装和拆分，使臃肿的html代码变得简洁，更加易维护。
4. 对常用js插件进行二次封装，使js代码变得简洁，更加易维护，具体请见webapp/static/js/common文件夹内js代码。
5. 利用ehcache框架对经常调用的查询进行缓存，提升运行速度，具体请见ConstantFactory类中@Cacheable标记的方法。
6. controller层采用map + warpper方式的返回结果，返回给前端更为灵活的数据，具体参见com.stylefeng.guns.modular.system.warpper包中具体类。
7. 防止XSS攻击,通过XssFilter类对所有的输入的非法字符串进行过滤以及替换。
8. 简单可用的代码生成体系，通过SimpleTemplateEngine可生成带有主页跳转和增删改查的通用控制器、html页面以及相关的js。
9. 控制器层统一的异常拦截机制,利用@ControllerAdvice统一对异常拦截,具体见com.stylefeng.guns.core.aop.GlobalExceptionHandler类。

##零spring xml配置示例
以下配置示例仅列出部分spring配置，详情请见com.stylefeng.guns.project.config包中具体的配置类
###根配置

@Configuration
@ComponentScan(basePackages = {"com.stylefeng"}, excludeFilters = {
        @Filter(type = FilterType.ANNOTATION, value = EnableWebMvc.class)// 这个是为了不让扫描到springmvc的控制器
})
@EnableAspectJAutoProxy
@Import(value = {DataSourceConfig.class, ShiroConfig.class, DruidMonitorConfig.class, EhcacheConfig.class})
public class RootSpringConfig {

}

###数据源配置

@Configuration
@EnableTransactionManagement
@PropertySource("classpath:jdbc.properties")
public class DataSourceConfig implements EnvironmentAware {

    private Environment em;

    /**
     * spring和MyBatis整合
     */
    @Bean
    public MybatisSqlSessionFactoryBean sqlSessionFactory(DataSource dataSource, GlobalConfiguration globalConfig) {
        MybatisSqlSessionFactoryBean sqlSessionFactory = new MybatisSqlSessionFactoryBean();
        sqlSessionFactory.setDataSource(dataSource);
        sqlSessionFactory.setConfigLocation(new ClassPathResource("mybatis-config.xml"));
        Resource[] classPathResources = ResKit.getClassPathResources("classpath*:com/stylefeng/guns/**/mapping/*.xml");
        sqlSessionFactory.setMapperLocations(classPathResources);

        //以下为mybatis-plus配置
        PaginationInterceptor paginationInterceptor = new PaginationInterceptor();
        paginationInterceptor.setDialectType("mysql");
        sqlSessionFactory.setPlugins(new Interceptor[]{paginationInterceptor});
        sqlSessionFactory.setGlobalConfig(globalConfig);
        return sqlSessionFactory;
    }
}

###零web.xml配置

public class WebAppInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {

    // spring应用上下文
    @Override
    protected Class[] getRootConfigClasses() {
        return new Class[]{RootSpringConfig.class};
    }

    // springmvc 上下文
    @Override
    protected Class[] getServletConfigClasses() {
        return new Class[]{SpringMvcConfig.class};
    }

    // 将DispatcherServlet映射到"/"
    @Override
    protected String[] getServletMappings() {
        return new String[]{"/"};
    }
}

###springmvc配置

@Configuration
@EnableWebMvc
@ComponentScan(basePackages = {"com.stylefeng.guns.**.controller", "com.stylefeng.guns.common.controller"})
@EnableAspectJAutoProxy
@Import({ControllerAopConfig.class})
public class SpringMvcConfig extends WebMvcConfigurerAdapter {

    // beetl的视图解析器
    @Bean
    public BeetlSpringViewResolver beetlViewResolver() {
        BeetlSpringViewResolver beetlSpringViewResolver = new BeetlSpringViewResolver();
        beetlSpringViewResolver.setConfig(beetlConfiguration());
        beetlSpringViewResolver.setContentType("text/html;charset=UTF-8");
        beetlSpringViewResolver.setOrder(0);
        return beetlSpringViewResolver;
    }   
    
    // 配置静态资源的处理,对静态资源的请求转发到servlet容器中默认的servlet上(对静态资源的请求不做处理)
    @Override
    public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
        configurer.enable();
    }
}

##业务日志记录原理
日志记录采用aop(LogAop类)方式对所有包含@BussinessLog注解的方法进行aop切入，会记录下当前用户执行了哪些操作（即@BussinessLog value属性的内容），如果涉及到数据修改，会取当前http请求的所有requestParameters与LogObjectHolder类中缓存的Object对象的所有字段作比较（所以在编辑之前的获取详情接口中需要缓存被修改对象之前的字段信息），日志内容会异步存入数据库中（通过ScheduledThreadPoolExecutor类）。

##beetl对前台页面的拆分与包装
例如，把主页拆分成三部分，每个部分单独一个页面，更加便于维护

    @include("/common/_tab.html"){}



    @include("/common/_right.html"){}



    @include("/common/_theme.html"){}

以及对重复的html进行包装，使前端页面更加专注于业务实现，例如,把所有页面引用包进行提取

	

		${layoutContent}
	
	

开发页面时，只需编写如下代码即可

@layout("/common/_container.html"){

    

        

            

                
部门管理
            
            

               //自定义内容
            
        
    


@}

以上beetl的用法请参考beetl说明文档。

##对js常用代码的封装
在webapp/static/js/common目录中，有对常用js代码的封装，例如Feng.js,其中Feng.info(),Feng.success(),Feng.error()三个方法，分别封装了普通提示，成功提示，错误提示的代码，简化了layer提示层插件的使用。

##极简的图片上传方法
guns对web-upload进行二次封装,让图片的上传功能呢只用2行代码即可实现,如下

var avatarUp = new $WebUpload("avatar");
avatarUp.init();

具体实现请参考static/js/common/web-upload-object.js

##controller层，map+warpper返回方式介绍
map+warpper方式即为把controller层的返回结果使用BeanKit工具类把原有bean转化为Map的的形式(或者原有bean直接是map的形式)，再用单独写的一个包装类再包装一次这个map，使里面的参数更加具体，更加有含义，下面举一个例子，例如，在返回给前台一个性别时，数据库查出来1是男2是女，假如直接返回给前台，那么前台显示的时候还需要增加一次判断，并且前后端分离开发时又增加了一次交流和文档的成本，但是采用warpper包装的形式，可以直接把返回结果包装一下，例如动态增加一个字段sexName直接返回给前台性别的中文名称即可。

##效果图
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-mqGqPaZl-1578551245281)(https://git.oschina.net/uploads/images/2017/0511/160059_b7a5d4d5_551203.jpeg “在这里输入图片标题”)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-0JWZjFcV-1578551245282)(https://git.oschina.net/uploads/images/2017/0516/000735_b83c5c46_551203.png “在这里输入图片标题”)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-cjT97O22-1578551245282)(https://git.oschina.net/uploads/images/2017/0511/160110_5e4f6d40_551203.jpeg “在这里输入图片标题”)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-sduncxF2-1578551245283)(https://git.oschina.net/uploads/images/2017/0511/160117_94443161_551203.jpeg “在这里输入图片标题”)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-PIE7rxjk-1578551245283)(https://git.oschina.net/uploads/images/2017/0511/160123_d0e287a5_551203.jpeg “在这里输入图片标题”)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-yKxlBN1P-1578551245283)(https://git.oschina.net/uploads/images/2017/0511/160129_beb6b25c_551203.jpeg “在这里输入图片标题”)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-ILvx3MYo-1578551245284)(https://git.oschina.net/uploads/images/2017/0511/160134_2212be4d_551203.jpeg “在这里输入图片标题”)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-EkZG7HB3-1578551245284)(https://git.oschina.net/uploads/images/2017/0511/160139_ef118391_551203.jpeg “在这里输入图片标题”)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-VhLle2j6-1578551245285)(https://git.oschina.net/uploads/images/2017/0511/160144_be4e3c3c_551203.jpeg “在这里输入图片标题”)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-HGoNiJax-1578551245285)(https://git.oschina.net/uploads/images/2017/0511/160154_1e2bf378_551203.jpeg “在这里输入图片标题”)]

前台展示
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-IiFW0hHc-1578551245285)(https://git.oschina.net/uploads/images/2017/0607/093638_0f95fd60_791098.png “在这里输入图片标题”)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-KDw2Tkyh-1578551245286)(https://git.oschina.net/uploads/images/2017/0607/093646_68bcb1fe_791098.png “在这里输入图片标题”)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-rvLl9OtQ-1578551245286)(https://git.oschina.net/uploads/images/2017/0607/093655_80475b9b_791098.png “在这里输入图片标题”)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-tIWEoo56-1578551245287)(https://git.oschina.net/uploads/images/2017/0607/093702_d176f4c2_791098.png “在这里输入图片标题”)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-9xGxws2A-1578551245287)(https://git.oschina.net/uploads/images/2017/0607/093710_66f3995e_791098.png “在这里输入图片标题”)]

已完成的功能 后台权限管理 用户 角色 菜单
商城 前台页面 后台管理
此项目主要是学习redis使用，生产不建议这样用 ，应该结合数据库一起使用
此项目的后台权限管理采用ssm 通用mapper 做成，商城管理去掉了mybatis 全部采用redis做存储和增删该查

如 商品数据结构

1. • /**

2. •  * 用户基本信息
     

3. •  * zscat:goods:{id}:{pcid}:{ptid}
     

4. •  * hash
     

5. •  * {
     

6. •  *     id: '100144', //ID
     

7. •  *     title: '1', //标题
     

8. •  *     tag: '0', //标签
     

9. •  *     img: '1', //图片
     

10. •  *     remark: '1,2', //内容
      

11. •  *     summry: '0', //摘书
      

12. •  * }
      

13. •  */
      

14. • public static final String GOODS = "zscat:goods:%s:%s:%s";
      

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-jN4n4qfh-1578551245287)(https://git.oschina.net/uploads/images/2017/0419/142316_c92a57a7_134431.png “在这里输入图片标题”)]

文章数据的redis 增删改查
public class ArticleRedis {

static RedisUtils RedisUtils = new RedisUtils(1);

/**
 * 文章列表
 * 
 * @param count
 * @return
 * @throws Exception
 */
public static List
 toArticle(int count) throws Exception {
	Set set = RedisUtils.keys(String.format(
			RandomChatRedisKey.Article, "*"));
	Iterator it = set.iterator();
	List
 l = new ArrayList<>();
	int j = 0;
	while (it.hasNext() && j < count) {
		j++;
		String key = it.next();
		Map map = RedisUtils.hgetall(key);
		l.add((Article) BeanUtil.transMap2Bean(map, Article.class));
	}

	return l;
}

/**
 * 保存或者修改文章
 * 
 * @param count
 * @return
 * @throws Exception
 */
public static void saveArticleRedisDB(Article profile) {
	String key = String.format(RandomChatRedisKey.Article, profile.getId());
	Map map = BeanUtil.transBean2Map(profile, true);
	Map tempMap = new HashMap<>();
	for (Map.Entry entry : map.entrySet()) {
		tempMap.put(entry.getKey(), entry.getValue().toString());
	}
	RedisUtils.hmset(key, tempMap);
}

/**
 * 删除文章
 * 
 * @param count
 * @return
 * @throws Exception
 */
public static Long deleteArticleRedisDB(Article profile) {
	String key = String.format(RandomChatRedisKey.Article, profile.getId());
	return RedisUtils.del(key);
}

/**
 * 获取文章文章
 * 
 * @param count
 * @return
 * @throws Exception
 */
public static Article getArticleRedisDB(Long id) {
	String key = String.format(RandomChatRedisKey.Article, id, "*");
	Map map = RedisUtils.hgetall(key);
	return BeanUtil.transMap2Bean(map, Article.class);
}

}

创建数据库，启动redis
然后用tomcat启动项目 访问http://localhost:8081/zsRedis
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-bpIjrbQy-1578551245288)(https://git.oschina.net/uploads/images/2017/0419/142759_b91b3b0c_134431.png “在这里输入图片标题”)]