SpringBoot开发深入

作者: Coding小聪 | 来源:发表于2018-03-18 19:50 被阅读53次

    设置环境属性

    SpringBoot默认启动的端口是8080,如果要换成别的端口就需要设置端口属性覆盖默认值,我们需要通过在项目中的"src/main/resources"下创建application.properties文件(或者是application.yml文件)。

    YAML 的意思其实是:"Yet Another Markup Language"(仍是一种标记语言)。和properties文件简单区别,如properties文件中db.username=root,转换成yml的格式则为
    db:
    username: root
    具体格式请参考:YAML 语言教程

    如果要改变端口,则在applicaiton.xml文件中配置server.port即可

    server.port=80
    # 配置contextPath,访问路径变为: http://127.0.0.1/springboot/xxx
    server.context-path=/springboot
    

    如果是使用application.yml文件,配置如下

    server:
      port: 80
      context-path: /springboot
    

    读取资源文件

    实际开发中我们常需要读取资源文件,国际化也需要依赖资源文件。下面分步骤讲解一下在springboot中如何读取资源文件。

    1. 在src/main/resources目录下建立i18n文件夹;
    2. 在i18n目录中创建2个资源文件
      Messages.properties文件
    welcome.url=www.google.com
    welcome.msg=\u6b22\u8fce{0}\u5149\u4e34\uff01
    

    Pages.properties文件

    member.add.page=/pages/back/admin/member/member_add.jsp
    member.add.action=/pages/back/admin/member/member_add.action
    
    1. 在applicaion.yml文件中增加如下配置
    spring:
      messages:
        basename: i18n/Messages,i18n/Pages
    
    1. 创建读取配置信息的控制器类MessageController
    @RestController
    public class MessageController {
        @Resource
        private MessageSource messageSource; // 自动注入此资源对象
    
        @RequestMapping(value = "showMsg",method = RequestMethod.GET)
        public String showMessage(String user){
            System.out.println("request url:" + this.getMessage("member.add.action"));
            return this.getMessage("welcome.msg", user);
        }
    
        private String getMessage(String key,String... args) {
            return messageSource.getMessage(key,args, Locale.getDefault());
        }
    }
    

    配置Bean

    SpringBoot没有单独提供配置Bean的方式,它配置Bean的方式还是得依赖Spring提供的方式。Spring中提供了3中装配Bean的方式

    • 自动化装配bean;
    • 在Java类中进行配置;
    • 在xml文件中配置。

    自动化配置bean

    自动配置一般使用的最多,通过@Controller、@Service、@Component等注解完成Bean的配置,而通过@Resource、@Autowired注解完成依赖的注入。不过默认情况下自动配置不是开启的,在传统Spring项目中可以通过在Java配置类中增加@ComponentScan注解或者在xml配置文件中加入<context:component-scan base-package="cn.zgc"/>配置来打开组件扫描功能。在Springboot中,通过在启动类中加入@SpringBootApplication注解既能打开组件扫描功能,默认扫描路径为启动类所在的包路径。

    Java配置文件类配置bean

    package cn.zgc.springboot.advanced.config;
    
    import cn.zgc.springboot.advanced.service.impl.MessageJavaConfigServiceImpl;
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    
    @Configuration  // 此处为配置项
    public class ServiceConfig {
        @Bean(name="configService")     // 此处返回的是一个Spring的配置Bean,与xml的“<bean>”等价
        public MessageJavaConfigServiceImpl getMessageService() {
            return new MessageJavaConfigServiceImpl() ;
        }
    }
    

    XML文件配置bean

    一般情况下,是不推荐使用xml文件进行配置的,但是如果非要在Springboot项目中使用xml文件该如何办呢?可以在程序启动类上使用 @ImportResource注解引入xml 文件进行配置加载

    @SpringBootApplication // 启动SpringBoot程序,而后自带子包扫描
    @ImportResource(locations={"classpath:spring-common.xml"})
    public class StartSpringBootMain {
     public static void main(String[] args) throws Exception {
     SpringApplication.run(StartSpringBootMain.class, args);
     }
    }
    
    

    profile配置

    实际项目中一般会存在多个环境,例如:开发、测试、生产。每个环境都有自己不同的配置,我们可以借助spring的profile来方便的实现不同环境之间的切换。profile的配置针对项目中使用的是application.yml还是application.properties有所不同,下面讲解是基于application.yml的。

    1. 在application.yml文件中配置如下内容
    spring:
      profiles:
        active: product
    ---
    spring:
      messages:
        basename: i18n/Messages,i18n/Pages
      profiles: dev
    server:
      port: 8080
    ---
    spring:
      messages:
        basename: i18n/Messages,i18n/Pages
      profiles: test
    server:
      port: 9090
    ---
    spring:
      messages:
        basename: i18n/Messages,i18n/Pages
      profiles: product
    

    可以看到不同环境所启动的端口有所不同。

    1. 对工程进行打包,然后进行不同环境的切换。
      打包命令:clean package
      切换不同环境指令:java -jar microboot.jar --spring.profiles.active=test 如果直接运行java -jar xxx.jar则运行的是yml文件中配置的激活(active,示例中为product)的环境

    2. 打包的时候,页面和一些资源文件也需要一起打到jar包中,这时需要在pom文件中加入以下配置

    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.yml</include>
                <include>**/*.xml</include>
                <include>**/*.tld</include>
            </includes>
            <filtering>false</filtering>
        </resource>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
                <include>**/*.tld</include>
            </includes>
            <filtering>false</filtering>
        </resource>
        <resource>
            <directory>src/main/view</directory>
            <includes>
                <include>**/*.*</include>
            </includes>
            <filtering>false</filtering>
        </resource>
    </resources>
    

    页面模板渲染

    常见的页面模板渲染技术有:FreeMarker、Velocity、Thymeleaf,Spring官方推荐使用Thymeleaf。下面介绍一下如何在springboot中使用Thymeleaf。

    1. 在pom文件中导入thymeleaf的依赖
    <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
    </dependency>
    
    1. 创建controller类,通过Model向显示层传递参数
    @Controller
    public class ThymeleafController {
        @RequestMapping(value = "/thymeleaf", method = RequestMethod.GET)
        public String toThymeleaf(String username, Model model){
            model.addAttribute("username",username);
            model.addAttribute("password","123456789");
            // 此处返回的是一个路径, 该路径的后缀默认是*.html
            return "message/user";
        }
    }
    
    1. 创建页面文件,thymeleaf相关的页面文件保存的路径是有规定的:在CLASSPATH路径下(src/main/resources、src/main/view)必须建立有一个templates的目录,在这个目录里面保存有thymeleaf的页面,这些页面可以按照文件目录保存。
    <!DOCTYPE HTML>
    <html xmlns:th="http://www.thymeleaf.org">
    <head>
        <title>SpringBoot模版渲染</title>
        <meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
    </head>
    <body>
        <p th:text="'用户名:' + ${username}"/>
        <p th:text="'密码:' + ${password}"/>
    </body>
    </html>
    <!-- 注意该文件中所有的标签都要正常结束 -->
    
    1. 如果现在我们所定义的要访问的页面不是通过控制器跳转的怎么办?那么为了解决这样的问题,可以考虑在 thymeleaf 所在的父路径中“src/main/view”建立一个 static 的子目录,该目录保存的是所有静态页面。项目中的静态的资源都放入该目录下。 springboot页面资源路径

      如果要更改thymeleaf页面默认的后缀,可以在application.yml文件中加入如下配置(页面文件的后缀要和修改后的后缀保持一致)

    spring: 
     thymeleaf:
     suffix: .htm
    

    相关文章

      网友评论

        本文标题:SpringBoot开发深入

        本文链接:https://www.haomeiwen.com/subject/iyjeqftx.html