设置环境属性
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中如何读取资源文件。
- 在src/main/resources目录下建立i18n文件夹;
- 在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
- 在applicaion.yml文件中增加如下配置
spring:
messages:
basename: i18n/Messages,i18n/Pages
- 创建读取配置信息的控制器类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的。
- 在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
可以看到不同环境所启动的端口有所不同。
-
对工程进行打包,然后进行不同环境的切换。
打包命令:clean package
切换不同环境指令:java -jar microboot.jar --spring.profiles.active=test 如果直接运行java -jar xxx.jar则运行的是yml文件中配置的激活(active,示例中为product)的环境 -
打包的时候,页面和一些资源文件也需要一起打到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。
- 在pom文件中导入thymeleaf的依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
- 创建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";
}
}
- 创建页面文件,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>
<!-- 注意该文件中所有的标签都要正常结束 -->
-
如果现在我们所定义的要访问的页面不是通过控制器跳转的怎么办?那么为了解决这样的问题,可以考虑在 thymeleaf 所在的父路径中“src/main/view”建立一个 static 的子目录,该目录保存的是所有静态页面。项目中的静态的资源都放入该目录下。
springboot页面资源路径
如果要更改thymeleaf页面默认的后缀,可以在application.yml文件中加入如下配置(页面文件的后缀要和修改后的后缀保持一致)
spring:
thymeleaf:
suffix: .htm
网友评论