Guns基于SpringBoot,致力于做更简洁的后台管理系统,完美整合springmvc + shiro + 分页插件PageHelper + 通用Mapper + beetl!Guns项目代码简洁,注释丰富,上手容易,同时Guns包含许多基础模块(用户管理,角色管理,部门管理,字典管理等10个模块),可以直接作为一个后台管理系统的脚手架.

说明

如果您有幸能看到，请认阅读以下内容；

1、本项目临摹自abel533的Guns，他的项目 fork 自 stylefeng 的 Guns！开源的世界真好，可以学到很多知识。
2、版权归原作者所有，自己只是学习使用。跟着大佬的思路，希望自己也能变成大佬。gogogo》。。
3、目前只是一个后台模块，希望自己技能增强到一定时，可以把stylefeng 的 [Guns]融合进来。
4、很多总结的文档都来自abel533的GiHub的README.md.为了方便自己复习就拿来主义了。
5、note里面是自己的学习过程，菜鸟写的，不是大佬写的。内容都是大佬的。

目录

修改说明

本项目对 Guns 的改动为：

1、将 mybatis-plus 改成了通用 Mapper.
2、增加分页插件 PageHelper.
3、去掉com.stylefeng.guns.modular.system.dao包中的所有DAO，将方法放到对应的Mapper接口中.
4、将 Mapper.xml 移动到 resources 中关于两者的对比，可以通过 commit 信息查看。

功能简介

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

1、首先我们来看包结构，老样子，我们先从core包开始，然后common，在config。等等，还是先从启动类开始吧。

项目包结构说明

├─main
│  │
│  ├─java
│  │   │
│  │   ├─com.guo.guns----------------项目主代码(原来的包：com.stylefeng.guns)
│  │   │          │
│  │   │          ├─common----------------项目公用的部分(业务中经常调用的类,例如常量,异常,实体,注解,分页类,节点类)
│  │   │          │
│  │   │          ├─config----------------项目配置代码(例如mybtais-plus配置,ehcache配置等)
│  │   │          │
│  │   │          ├─core----------------项目运行的核心依靠(例如aop日志记录,拦截器,监听器,guns模板引擎,shiro权限检查等)
│  │   │          │
│  │   │          ├─modular----------------项目业务代码
│  │   │          │
│  │   │          ├─GunsApplication类----------------以main方法启动springboot的类
│  │   │          │
│  │   │          └─GunsServletInitializer类----------------用servlet容器启动springboot的核心类
│  │   │
│  │   └─generator----------------mybatis-plus Entity生成器
│  │
│  ├─resources----------------项目资源文件
│  │     │
│  │     ├─gunsTemplate----------------guns代码生成模板
│  │     │
│  │     ├─application.yml----------------springboot项目配置
│  │     │
│  │     └─ehcache.xml----------------ehcache缓存配置
│  │
│  └─webapp----------------web页面和静态资源存放的目录
│

注:SpringBoot项目默认不支持将静态资源和模板(web页面)放到webapp目录,但是个人感觉resources目录只放项目的配置更加简洁,所以就将web页面继续放到webapp目录了.

1、先来看启动类：

/**
 * SpringBoot方式启动类
 */
@SpringBootApplication
public class GunsApplication extends WebMvcConfigurerAdapter {

    protected final static Logger logger = LoggerFactory.getLogger(GunsApplication.class);

    public static void main(String[] args) {
        SpringApplication.run(GunsApplication.class,args);
        logger.info("GunsApplication is success!");
    }
}

需要注意两个点：@SpringBootApplication注解和WebMvcConfigurerAdapter

(1)、1.2版本应该是@Configuretion注解，这个注解表明这个类会处理Spring的常规bean。来自《精通Spring MVC》

(2)、@ComponentScana 它会告诉Spring去哪里查找SPring组件(服务，控制器)，大白话就是bean那。一般我们在控制层的类上会加上@Controller注解，不知道大家有木有配置过XML，难受啊。

(3)、@EnableAutoConfiguration ：看名字，AutoConfiguration啊，这就是Spring魔力所在，省去很多XXML了，在这里是基于JavaConfig配置的。

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(
    excludeFilters = {@Filter(
    type = FilterType.CUSTOM,
    classes = {TypeExcludeFilter.class}
), @Filter(
    type = FilterType.CUSTOM,
    classes = {AutoConfigurationExcludeFilter.class}
)}
)
public @interface SpringBootApplication {
    Class<?>[] scanBasePackageClasses() default {};
}
-------------------------------------------------------
@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Configuration
public @interface SpringBootConfiguration {
}

2、接下来，我们再看下为毛要继承WebMvcConfigrerApapter类。

看见Config没，这个也是配置类，它声明了视图解析器、地域解析器、以及静态资源的位置，(想起来没，就是前置，后置) 。

先看一段源码 ————源码是个好东西



----------------------InternalResourceViewResolver熟悉吗？-----------------------
@Bean
@ConditionalOnMissingBean
public InternalResourceViewResolver defaultViewResolver() {
    InternalResourceViewResolver resolver = new InternalResourceViewResolver();
    resolver.setPrefix(this.mvcProperties.getView().getPrefix());
    resolver.setSuffix(this.mvcProperties.getView().getSuffix());
    return resolver;
}
---------------------------也是视图解析器，只是返回的是bean-------------------------
@Bean
@ConditionalOnBean({View.class})
@ConditionalOnMissingBean
public BeanNameViewResolver beanNameViewResolver() {
    BeanNameViewResolver resolver = new BeanNameViewResolver();
    resolver.setOrder(2147483637);
    return resolver;
}
-------------------------------地域解析器--------------------------------------------
@Bean
@ConditionalOnMissingBean
@ConditionalOnProperty(
    prefix = "spring.mvc",
    name = {"locale"}
)
public LocaleResolver localeResolver() {
    if(this.mvcProperties.getLocaleResolver() == org.springframework.boot.autoconfigure.web.WebMvcProperties.LocaleResolver.FIXED) {
        return new FixedLocaleResolver(this.mvcProperties.getLocale());
    } else {
        AcceptHeaderLocaleResolver localeResolver = new AcceptHeaderLocaleResolver();
        localeResolver.setDefaultLocale(this.mvcProperties.getLocale());
        return localeResolver;
    }
}

说了这么多，我们先来看看SpringMVC启动流程，知其所以然的同时也要知其然。

一般来说，初始化步骤如下：

1、初始化SpringMVC的DispatcherServlet
2、配置转码过滤器(UTF-8,乱码锅就在设置，还有一个就是在发送信息前，setCharacterEncoding()。),保证能正确转码，为啥啊，因为浏览器发送的是ISO-8859？。
3、配置视图解析器，就上面说的那个，返回视图的时候方便定位。
4、配置静态资源的位置，
5、还有就是配置multipart解析器，主要是为了能上传文件，part单词什么意思？多个-部分
6、还需要写错误页面，统一异常处理。

然而，然而有了SpringBoot，统统可以省略，激动吗？兴奋吗？我是蛮激动的，尤其第一次运行SpringBoot项目。

上面已经帮我们位置了视图解析器，接下来我们看下DispatcherServlet和multipart

@AutoConfigureOrder(-2147483648)
@Configuration
@ConditionalOnWebApplication
@ConditionalOnClass({DispatcherServlet.class})     //只有对应的类在classpath中有存在时才会注入
@AutoConfigureAfter({EmbeddedServletContainerAutoConfiguration.class})
public class DispatcherServletAutoConfiguration {
    public static final String DEFAULT_DISPATCHER_SERVLET_BEAN_NAME = "dispatcherServlet";    //熟悉吗？DeFAULT，默认的那。
    public static final String DEFAULT_DISPATCHER_SERVLET_REGISTRATION_BEAN_NAME = "dispatcherServletRegistration";

    public DispatcherServletAutoConfiguration() {
    }
-------------------------------MultipartResolver-------------------------------
    @Bean
    @ConditionalOnBean({MultipartResolver.class})
    @ConditionalOnMissingBean(
        name = {"multipartResolver"}
    )
    public MultipartResolver multipartResolver(MultipartResolver resolver) {
        return resolver;
    }
}

还有还有，错误配置、转码配置、tomcat配置Jetty等等。具体的在这个配置类中EmbeddedServletContainerAutoConfiguration,只看ContainerAutofig。我们还是正式进入项目吧。

/**
 * Guns Web程序启动类
 */
public class GunsServletInitializer extends SpringBootServletInitializer {

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        return builder.sources(GunsApplication.class);
    }
}

我们点击源码看看SpringBootServletInitializer。其实看名字就可看出是Servlet初始化，熟悉设这个ApplicationContext单词吗？应用上下文。很重要的，还有一个叫做BeanFactory，主要有个getBean方法，一般用前者。不懂的可以去看看我临摹别人的简单版Spring框架点这里

public abstract class SpringBootServletInitializer implements WebApplicationInitializer {

    protected WebApplicationContext createRootApplicationContext(ServletContext servletContext) {}


    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        return builder;
    }
}

今晚就先到这里吧，明早gogogo