SpringBoot+Vue+ElementUI实现含国际化的先后端不分离的传统简易管理系统搭建（一）

时间  2020-12-03
标签 html 前端 vue java mysql jquery git github web spring 栏目 Spring 繁體版
原文   原文链接

本项目在GitHub上能够下载源代码，欢迎你们指点。谢谢
GitHub地址：点击进入
html

开发IED使用IntelliJ IDEA
目前仅仅在架构运用层解析框架如何使用，后续在此项目完结后会剖析所用到的全部架构的底层原理技术，额，比较倾向于，先学会简单使用，再剖析其底层原理的学习模式。


前端

文章目录

1 项目构建

新建一个maven项目，这里就很少说了，给你们看下我这边项目的结构：
在这里插入图片描述
config:主要存放配置文件资源，我这里目前比较简单，就一个application.properties，固然也能够是推荐的springboot推荐的application.yml
i18n:主要存放国际化语言文件，这里须要在application.properties中指定其文件路径和位置
即：



vue

# i18n
spring.messages.encoding=utf-8
spring.messages.basename=i18n/index

META-INF:目前可不须要，我这里是想要之后可能会写一些jsp文件，因此在这里也支持下，配置的jsp文件就会在这里文件夹中
在这里插入图片描述
views主要是前端代码了，好比html、js等等

java

咱们先来看后端
首先是pom.xml中jar包的引入：
springboot项目，必要的，必须继承其父项目

mysql

<!--支持全栈式Web开发，包括Tomcat和spring-webmvc-->
<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-web</artifactId>
</dependency>

<!-- spring boot 集成spring security-->
<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-security</artifactId>
</dependency>

<!--支持常规的测试依赖，包括JUnit、Hamcrest、Mockito以及spring-test模块-->
<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-test</artifactId>
	<scope>test</scope>
</dependency>

<!-- 支持JDBC数据库 -->
<!-- https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-starter-jdbc -->
<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-jdbc</artifactId>
	<version>2.0.4.RELEASE</version>
</dependency>


<!--mybatis-spring适配器-->
<dependency>
	<groupId>org.mybatis</groupId>
	<artifactId>mybatis-spring</artifactId>
	<version>1.3.0</version>
</dependency>

<!--mybatis-->
<dependency>
	<groupId>org.mybatis</groupId>
	<artifactId>mybatis</artifactId>
	<version>3.4.0</version>
</dependency>

<!--mysql链接数据库驱动-->
<dependency>
	<groupId>mysql</groupId>
	<artifactId>mysql-connector-java</artifactId>
	<version>8.0.11</version>
</dependency>

<!-- https://mvnrepository.com/artifact/commons-dbcp/commons-dbcp -->
<!-- dbcp常见主流数据库链接池工具 -->
<dependency>
	<groupId>commons-dbcp</groupId>
	<artifactId>commons-dbcp</artifactId>
	<version>1.4</version>
</dependency>

<!-- https://mvnrepository.com/artifact/commons-pool/commons-pool -->
<dependency>
	<groupId>commons-pool</groupId>
	<artifactId>commons-pool</artifactId>
	<version>1.6</version>
</dependency>

<!-- aop切面支持 -->
<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-aop</artifactId>
</dependency>

<!--支持Thymeleaf模板引擎，包括与Spring的集成-->
<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

<dependency>
	<groupId>net.sourceforge.nekohtml</groupId>
	<artifactId>nekohtml</artifactId>
	<version>1.9.22</version>
</dependency>

<!-- 标准Java库没法提供足够的方法来处理其核心类。Apache Commons Lang提供了这些额外的方法。-->
<dependency>
	<groupId>org.apache.commons</groupId>
	<artifactId>commons-lang3</artifactId>
	<version>3.7</version>
</dependency>

<!-- XML操做jar包-->
<dependency>
	<groupId>dom4j</groupId>
	<artifactId>dom4j</artifactId>
	<version>1.6.1</version>
</dependency>

后端使用mybatis操做数据库增、删、改、查，Thymeleaf模板引擎进行页面渲染，项目使用mysql作数据库支撑jquery

这里还须要解决，IDE工具编译java文件时，不编译.xml文件及其余资源文件（字体等等）的问题，须要设置：git

<resources>
    <!---解决字体问题-->
    <resource>
        <directory>src/main/resources</directory>
        <filtering>true</filtering>
        <excludes>
            <exclude>**/fonts/**</exclude>
            <exclude>**/**.ico</exclude>
        </excludes>
    </resource>
    <resource>
        <directory>src/main/resources</directory>
        <filtering>false</filtering>
        <includes>
            <include>**/fonts/**</include>
            <include>**/**.ico</include>
        </includes>
    </resource>
    <resource>
        <directory>src/main/java</directory>
        <includes>
            <include>**/*.xml</include>
        </includes>
    </resource>
</resources>

看下application.properties：github

# service port
server.port=8080
# close favicon
spring.mvc.favicon.enabled=false
# database
default.datasource.driverClassName=com.mysql.cj.jdbc.Driver
default.datasource.url=jdbc:mysql://localhost:3306/xttl?useUnicode=true&characterEncoding=utf-8&serverTimezone=GMT&useSSL=false
default.datasource.username=root
default.datasource.password=soft01
# thymeleaf
spring.thymeleaf.prefix=classpath:/views/
spring.thymeleaf.check-template-location=true
spring.thymeleaf.suffix=.html
spring.thymeleaf.encoding=UTF-8
spring.thymeleaf.content-type=text/html
spring.thymeleaf.mode=LEGACYHTML5
spring.thymeleaf.cache=false
# jsp
spring.mvc.view.prefix=/jsp/
spring.mvc.view.suffix=.jsp
# i18n
spring.messages.encoding=utf-8
spring.messages.basename=i18n/index

8.0版本的mysql默认链接数据库会使用useSSL，这里咱们须要禁掉，不然会出现Establishing SSL connection without server’s identity verification is not recommended的警告，同时咱们须要设置时区，即：serverTimezone，不然会出现Could not get JDBC Connection; nested exception is java.sql.SQLException: The server time zone value ‘XXX’ is unrecognized or represents more than one time zone. You must configure either the server or JDBC driver (via the serverTimezone configuration property) to use a more specifc time zone value if you want to utilize time zone support的错误信息。这里目前先随便设置个时区（serverTimezone=GMT，这表示格林威治中央区时区），后面来看，其实仍是有问题的，请看后续分解。这儿再也不详述。
thymeleaf模板引擎配置：因为前段使用VUE+ElementUI，使得会在html标签上存在一些很是规html规范的写法，会致使模板解析报错，因此这里引入了JAR包nekohtml解决这个问题，同时spring.thymeleaf.mode配置须要更改成LEGACYHTML5。SpringBoot默认模板放在resource下templates中的，能够看出咱们的项目结构并非这样子，因此这里须要指定模板路径spring.thymeleaf.prefix=classpath:/views/
web

2 SpringBoot整合SpringSecurity

继承org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter，重写configure方法，这里直接贴入楼主的整个类文件spring

package com.tllg.sysset.mvcconfig.security;

import com.tllg.sysset.mvcconfig.auth.MyAuthProvider;
import com.tllg.sysset.mvcconfig.user.MyUserDetailsService;
import com.tllg.sysset.mvcconfig.handler.MyFailHandler;
import com.tllg.sysset.mvcconfig.handler.MySuccessHandler;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.authentication.builders.AuthenticationManagerBuilder;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.builders.WebSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;

/**
 * @author lgli
 * 安全信息配置
 * 项目基本配置信息，主要包括登陆拦截，静态资源访问
 */
@Configuration
@EnableWebSecurity
public class WebSecurityConfig extends WebSecurityConfigurerAdapter {

    @Autowired
    private MyUserDetailsService myUserDetailsService;

    @Autowired
    private MyAuthProvider myAuthProvider;

    @Override
    public void configure(WebSecurity web){
        //定义登陆页面的静态资源（包括js）
        web.ignoring().antMatchers("/login/**",//登陆界面及其资源
                "/login.html",//登陆界面及其资源
                "/base/js/**",//主要js,jquery及其vue
                "/*.ico"//图标
        );
    }

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .formLogin()//定义须要用户登陆时，跳转到登陆页面
            .loginPage("/login.html")//定义登陆页面
            .usernameParameter("username").passwordParameter("password")//定义登陆界面传参
            .loginProcessingUrl("/login_to_sys")//登陆接口,该接口被SpringSecurity执行;
            .permitAll()//表示不须要拦截，所有经过
            .failureHandler(new MyFailHandler())//登陆失败处理handler
            .successHandler(new MySuccessHandler())//登陆成功处理handler
            .and().headers().frameOptions().sameOrigin()//保证同源iframe中可访问，不拦截
            .and().authorizeRequests().anyRequest().authenticated()
            .and().csrf().disable()
        ;
    }

    @Override
    protected void configure(AuthenticationManagerBuilder auth) throws Exception {
        auth.userDetailsService(myUserDetailsService);
        auth.authenticationProvider(myAuthProvider);
//        auth.eraseCredentials(true);
    }
}

web.ignoring().antMatchers过滤不须要拦截的一些资源文件，如登陆所用到的全部html及js文件。
configure(HttpSecurity http)方法主要是拦截设置，其代码主要含义，也有明确的注释，设置frameOptions().sameOrigin()主要是由于项目前端经过iframe嵌套访问后端请求，不然请求将访问异常。
此外，咱们须要实现org.springframework.security.core.userdetails.UserDetailsService的loadUserByUsername方法，进行自定义验证信息，也能够不实现，那样就直接默认不处理了。我这里实现了改方法，并组装了登陆成功验证后的一些资源信息，核心代码以下《所涉及到的其余相关代码，见GitHub》

if(UtilBase.STRING.isBlank(name)){
	throw new UsernameNotFoundException("请传入用户名");
}
logger.info("传入用户名为{}的试图登陆",name);
UserBaseInfo user = userMapper.selectUserByUserUniqueSign(name, "0");
if(user == null){
	throw new UsernameNotFoundException("无效用户");
}
UserBaseSys userBaseSys = new UserBaseSys(user);
//获取用户角色
userBaseSys.setUserResource((List<ResourceInfo>)dealWithCascade( userMapper.selectUserResourcesByUserUniqueSign(name, StaticEnum.ZERO.getValue()),ResourceInfo.class
));
//获取用户资源
userBaseSys.setUserRoles((List<RoleBaseInfo >)dealWithCascade( userMapper.selectUserRolesByUserUniqueSign(name),RoleBaseInfo.class ));
logger.info("获取到用户数据，返回userDetail");
return userBaseSys;

configure方法设定了登陆验证失败或者成功的处理handler，这里须要实现各自的接口
失败，须要实现org.springframework.security.web.authentication.AuthenticationFailureHandler的onAuthenticationFailure方法，这里就简单的返回登陆页面：

package com.tllg.sysset.mvcconfig.handler;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.security.core.AuthenticationException;
import org.springframework.security.web.authentication.AuthenticationFailureHandler;


import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.Date;

/**
 * @author lgli
 * 登陆失败处理handler
 *
 */
public class MyFailHandler implements AuthenticationFailureHandler {

    private Logger logger = LoggerFactory.getLogger(MyFailHandler.class);

    @Override
    public void onAuthenticationFailure(HttpServletRequest request, HttpServletResponse response,
                                        AuthenticationException e) throws IOException {
        logger.error("本次操做出现认证异常："+new Date());
        response.sendRedirect("/login.html?error="+e.getMessage());//返回登陆页面，从新登陆
    }
}

成功须要实现org.springframework.security.web.authentication.AuthenticationSuccessHandler的onAuthenticationSuccess方法，这里登陆成功直接进入系统首页

package com.tllg.sysset.mvcconfig.handler;

import org.springframework.security.core.Authentication;
import org.springframework.security.web.authentication.AuthenticationSuccessHandler;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

/**
 * @author lgli
 * 实现自定义的用户成功登录处理
 * 登陆成功处理handler
 *
 */
public class MySuccessHandler implements AuthenticationSuccessHandler {
    @Override
    public void onAuthenticationSuccess(HttpServletRequest request, HttpServletResponse response,
                                        Authentication authentication) throws IOException, ServletException {
        response.sendRedirect("home/entryHomeIndex");
    }
}

3.SpringBoot整合Mybatis

因为长时间没有仔细回顾Mybatis原理了，因此这里采用@Configuration方式，一步步回顾mybatis，这里也只作步骤层解析，不作底层原理解读。

package com.tllg.sysset.datasource;

import com.tllg.util.PropertyUtil;
import org.apache.ibatis.datasource.pooled.PooledDataSource;
import org.apache.ibatis.session.SqlSessionFactory;
import org.mybatis.spring.SqlSessionFactoryBean;
import org.mybatis.spring.SqlSessionTemplate;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.io.support.PathMatchingResourcePatternResolver;
import org.springframework.jdbc.datasource.DataSourceTransactionManager;
import org.springframework.transaction.PlatformTransactionManager;
import org.springframework.transaction.annotation.EnableTransactionManagement;
import org.springframework.transaction.annotation.TransactionManagementConfigurer;

import java.io.IOException;


/**
 * @author lgli
 * 初始化主数据源
 * 数据源链接池 --> 会话工厂sqlSessionFactoryBean --> 自动扫描对象关系映射 --> 事务管理
 */
@Configuration
@EnableTransactionManagement//支持事物
public class MainSource implements TransactionManagementConfigurer {

    private static final Logger log = LoggerFactory.getLogger(MainSource.class);

    @Autowired
    private PropertyUtil propertyUtil;

    private PooledDataSource datasource;

    private SqlSessionFactory sessionFactory;

    @Override
    public PlatformTransactionManager annotationDrivenTransactionManager() {
        initDataSource();
        return new DataSourceTransactionManager(datasource);
    }

    /**
     * 初始化数据源及其链接
     */
    @Bean(name="mainDatasource")
    public PooledDataSource initDataSource(){
        try {
            PooledDataSource datasource = new PooledDataSource();
            //设置链接驱动-数据库类型
            datasource.setDriver(propertyUtil.getValueByKey("default.datasource.driverClassName"));
            //设置URL
            datasource.setUrl(propertyUtil.getValueByKey("default.datasource.url"));
            //设置用户名
            datasource.setUsername(propertyUtil.getValueByKey("default.datasource.username"));
            //设置密码
            datasource.setPassword(propertyUtil.getValueByKey("default.datasource.password"));
            //链接池其余信息默认PooledDataSource中的属性
            this.datasource = datasource;
            return datasource;
        }catch (Exception e){
            log.error("初始化主数据源链接池失败，"+e,e);
            throw new RuntimeException("初始化主数据源链接池失败异常"+e);
        }
    }


    /**
     * 注册sqlSessionFactoryBean
     *
     */
    @Bean(name="mainSqlSessionFactory")
    public SqlSessionFactory registerSqlSessionFactory(){
        SqlSessionFactoryBean sqlSessionFactoryBean = new SqlSessionFactoryBean();
        sqlSessionFactoryBean.setDataSource(this.datasource);//设置数据源
        PathMatchingResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();
        try {
            //指定xml配置文件路径
            sqlSessionFactoryBean.setMapperLocations(resolver.getResources("classpath:com/tllg/**/mapper/xml/*.xml"));
            this.sessionFactory = sqlSessionFactoryBean.getObject();
            return this.sessionFactory;
        }catch (IOException ioe){
            log.error("主数据源配置Mapper映射文件不存在"+ioe,ioe);
            throw new RuntimeException("配置Mapper映射文件不存在"+ioe);
        }catch (Exception ex){
            log.error("主数据源注册sqlSessionFactoryBean异常"+ex,ex);
            throw new RuntimeException("主数据源注册sqlSessionFactoryBean异常"+ex);
        }
    }

    /**
     * 注册sqlSessionTemplate
     * @param factory SqlSessionFactory
     * @return
     */
    @Bean(name="mainSqlSessionTemplate")
    public SqlSessionTemplate setSqlSessionTemplate(SqlSessionFactory factory){
        return new SqlSessionTemplate(factory);
    }
}

-------------------------------------------------


package com.tllg.sysset.datasource;

import org.mybatis.spring.mapper.MapperScannerConfigurer;
import org.springframework.boot.autoconfigure.AutoConfigureAfter;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
@AutoConfigureAfter(MainSource.class)
public class MainMapper {
    /**
     * 注册Mapper映射文件信息
     */
    @Bean(name="mainMapperScannerConfigurer")
    public MapperScannerConfigurer registerMapperConfig(){
        MapperScannerConfigurer mapper = new MapperScannerConfigurer();
        //指定sqlSessionFactory
        mapper.setSqlSessionFactoryBeanName("mainSqlSessionFactory");
        //指定dao接口配置文件路径
        mapper.setBasePackage("com.tllg.**.mapper");
        return mapper;
    }
}

代码简单描述下：
mybatis主要行动轨迹是，链接数据库–>SqlSessionFactoryBuilder–>SqlSessionFactory–>SqlSession–>do Something -->return result
mybatis经过读取配置文件信息，获得数据库链接，由链接配置对象，获得当前数据库链接的会话工厂SqlSessionFactoryBuilder对象，由SqlSessionFactoryBuilder对象获得SqlSessionFactory实例，由SqlSessionFactory获得SqlSession实例，SqlSession能够执行咱们的sql了。全部对象实例，使用单例模式。固然通常来讲，必须使用的单例模式，不然建立多了，数据库链接会被占满了。
registerSqlSessionFactory（）方法主要是SqlSessionFactory的一些配置信息，好比数据源，及其sql文件。
setSqlSessionTemplate（）方法则是经过代理执行获取SqlSession实例，内部封装了其事物信息，不须要咱们手动去调用SqlSessionFactory获取SqlSession来执行sql了，即前面描述的后续过程交给SqlSessionTemplate处理了。



这里有2个@Configuration配置文件，其中前面一个主要是mybatis行动轨迹过程代码化，后面一个主要是设置映射关系文件，注意@AutoConfigureAfter注解，表示改配置文件须要先执行其余的配置文件，设置映射关系，咱们须要获得SqlSessionFactory，因此第二个配置文件执行在第一个配置文件以后。

4 Resolver整合

咱们须要重写org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter的addResourceHandlers方法，使其能够访问静态资源文件

package com.tllg.sysset.mvcconfig.resolver;


import org.springframework.stereotype.Component;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;

/**
 * @author lgli
 * 资源路径的配置信息
 * 指定访问资源路径
 */
@Component
public class SourceResolverConfig extends WebMvcConfigurerAdapter {

    /**
     * 添加目录配置
     * 默认配置/**
     * 能够屡次使用 addResourceLocations 添加目录
     * 优先级先添加的高于后添加的
     * @param registry registry
     */
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/**")
                .addResourceLocations("classpath:/views/");
        super.addResourceHandlers(registry);
    }
}

此时，基本后台配置就差很少了，项目也是能够跑起来了。
目前先到这儿了，下一节，将继续前端代码的引入。
天天温习一点点，学习才能进步
有喜欢的朋友能够关注下个人公众号，不按期更新一些学习分享经验。纯属我的所学总结，但愿你们能够指出不正确的地方，共同窗习成长。
在这里插入图片描述 代码之路之长，由于喜欢，因此坚持。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程