Spring Boot 其默認是集成web容器的,啟動方式由像普通Java程序一樣,main函數入口啟動。其內置Tomcat容器或Jetty容器,具體由配置來決定(默認Tomcat)。當然你也可以將項目打包成war包,放到獨立的web容器中(Tomcat、weblogic等等),當然在此之前你要對程序入口做簡單調整。
項目構建我們使用Maven或Gradle,這將使項目依賴、jar包管理、以及打包部署變的非常方便。
一、內嵌 Server 配置
Spring Boot將容器內置后,它通過配置文件的方式類修改相關server配置。
先看一下下面的圖,為關於server的配置列項:
其中常用的配置只有少數幾個,已經用紫色標記起來。紅框圈起來的部分,看名稱分類就可以明白其作用。
對server的幾個常用的配置做個簡單說明:
# 項目contextPath,一般在正式發布版本中,我們不配置
server.context-path=/myspringboot
# 錯誤頁,指定發生錯誤時,跳轉的URL。請查看BasicErrorController源碼便知
server.error.path=/error
# 服務端口
server.port=9090
# session最大超時時間(分鍾),默認為30
server.session-timeout=60
# 該服務綁定IP地址,啟動服務器時如本機不是該IP地址則拋出異常啟動失敗,只有特殊需求的情況下才配置
# server.address=192.168.16.11
Tomcat
Tomcat為Spring Boot的默認容器,下面是幾個常用配置:
# tomcat最大線程數,默認為200
server.tomcat.max-threads=800
# tomcat的URI編碼
server.tomcat.uri-encoding=UTF-8
# 存放Tomcat的日志、Dump等文件的臨時文件夾,默認為系統的tmp文件夾(如:C:\Users\Shanhy\AppData\Local\Temp)
server.tomcat.basedir=H:/springboot-tomcat-tmp
# 打開Tomcat的Access日志,並可以設置日志格式的方法:
#server.tomcat.access-log-enabled=true
#server.tomcat.access-log-pattern=
# accesslog目錄,默認在basedir/logs
#server.tomcat.accesslog.directory=
# 日志文件目錄
logging.path=H:/springboot-tomcat-tmp
# 日志文件名稱,默認為spring.log
logging.file=myapp.log
Jetty
如果你要選擇Jetty,也非常簡單,就是把pom中的tomcat依賴排除,並加入Jetty容器的依賴,如下:
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-jetty</artifactId>
</dependency>
<dependencies>
打包
打包方法:
CMD進入項目目錄,使用 mvn clean package 命令打包,以我的項目工程為例:
E:\spring-boot-sample>mvn clean package
可以追加參數 -Dmaven.test.skip=true 跳過測試。
打包后的文件存放於項目下的target目錄中,如:spring-boot-sample-0.0.1-SNAPSHOT.jar
如果pom配置的是war包,則為spring-boot-sample-0.0.1-SNAPSHOT.war
二、部署到JavaEE容器
- 修改啟動類,繼承 SpringBootServletInitializer 並重寫 configure 方法
public class SpringBootSampleApplication extends SpringBootServletInitializer{
private static final Logger logger = LoggerFactory.getLogger(SpringBootSampleApplication.class);
@Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
return builder.sources(this.getClass());
}
}
- 修改pom文件中jar 為 war
<!-- <packaging>jar</packaging> -->
<packaging>war</packaging>
- 修改pom,排除tomcat插件
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
</exclusion>
</exclusions>
</dependency>
- 打包部署到容器
使用命令 mvn clean package 打包后,同一般J2EE項目一樣部署到web容器。
三、使用Profile區分環境
spring boot 可以在 “配置文件”、“Java代碼類”、“日志配置” 中來配置profile區分不同環境執行不同的結果
1、配置文件
使用配置文件application.yml 和 application.properties 有所區別
以application.properties 為例,通過文件名來區分環境 application-{profile}.properties
application.properties
app.name=MyApp
server.port=8080
spring.profiles.active=dev
application-dev.properties
server.port=8081
application-stg.properties
server.port=8082
在啟動程序的時候通過添加 –spring.profiles.active={profile} 來指定具體使用的配置
例如我們執行 java -jar demo.jar –spring.profiles.active=dev 那么上面3個文件中的內容將被如何應用?
Spring Boot 會先加載默認的配置文件,然后使用具體指定的profile中的配置去覆蓋默認配置。
app.name 只存在於默認配置文件 application.properties 中,因為指定環境中不存在同樣的配置,所以該值不會被覆蓋
server.port 默認為8080,但是我們指定了環境后,將會被覆蓋。如果指定stg環境,server.port 則為 8082
spring.profiles.active 默認指定dev環境,如果我們在運行時指定 –spring.profiles.active=stg 那么將應用stg環境,最終 server.port 的值為8082
2、Java類中@Profile注解
下面2個不同的類實現了同一個接口,@Profile注解指定了具體環境
// 接口定義
public interface SendMessage {
// 發送短信方法定義
public void send();
}
// Dev 環境實現類
@Component
@Profile("dev")
public class DevSendMessage implements SendMessage {
@Override
public void send() {
System.out.println(">>>>>>>>Dev Send()<<<<<<<<");
}
}
// Stg環境實現類
@Component
@Profile("stg")
public class StgSendMessage implements SendMessage {
@Override
public void send() {
System.out.println(">>>>>>>>Stg Send()<<<<<<<<");
}
}
// 啟動類
@SpringBootApplication
public class ProfiledemoApplication {
@Value("${app.name}")
private String name;
@Autowired
private SendMessage sendMessage;
@PostConstruct
public void init(){
sendMessage.send();// 會根據profile指定的環境實例化對應的類
}
}
3、logback-spring.xml也支持有節點來支持區分
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<include resource="org/springframework/boot/logging/logback/base.xml" />
<logger name="org.springframework.web" level="INFO"/>
<springProfile name="default">
<logger name="org.springboot.sample" level="TRACE" />
</springProfile>
<springProfile name="dev">
<logger name="org.springboot.sample" level="DEBUG" />
</springProfile>
<springProfile name="staging">
<logger name="org.springboot.sample" level="INFO" />
</springProfile>
</configuration>
再說一遍文件名不要用logback.xml 請使用logback-spring.xml
四、指定外部的配置文件
有些系統,關於一些數據庫或其他第三方賬戶等信息,由於安全問題,其配置並不會提前配置在項目中暴露給開發人員。
對於這種情況,我們在運行程序的時候,可以通過參數指定一個外部配置文件。
以 demo.jar 為例,方法如下:
java -jar demo.jar --spring.config.location=/opt/config/application.properties
其中文件名隨便定義,無固定要求。
五、創建一個Linux 應用的sh腳本
下面幾個腳本僅供參考,請根據自己需要做調整
start.sh
#!/bin/sh
rm -f tpid
nohup java -jar myapp.jar --spring.config.location=application.yml > /dev/null 2>&1 &
echo $! > tpid
echo Start Success!
stop.sh
#!/bin/sh
APP_NAME=myapp
tpid=`ps -ef|grep $APP_NAME|grep -v grep|grep -v kill|awk '{print $2}'`
if [ ${tpid} ]; then
echo 'Stop Process...'
kill -15 $tpid
fi
sleep 5
tpid=`ps -ef|grep $APP_NAME|grep -v grep|grep -v kill|awk '{print $2}'`
if [ ${tpid} ]; then
echo 'Kill Process!'
kill -9 $tpid
else
echo 'Stop Success!'
fi
check.sh
#!/bin/sh
APP_NAME=myapp
tpid=`ps -ef|grep $APP_NAME|grep -v grep|grep -v kill|awk '{print $2}'`
if [ ${tpid} ]; then
echo 'App is running.'
else
echo 'App is NOT running.'
fi
kill.sh
#!/bin/sh
APP_NAME=myapp
tpid=`ps -ef|grep $APP_NAME|grep -v grep|grep -v kill|awk '{print $2}'`
if [ ${tpid} ]; then
echo 'Kill Process!'
kill -9 $tpid
fi
六、使用Linux服務的方式啟動、停止、重啟
1、首先在 pom.xml 中配置插件
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<executable>true</executable>
</configuration>
</plugin>
</plugins>
</build>
特別注意一下 <executable>true</executable>
2、然后正常使用 mvn clean package -Dmaven.test.skip=true
將工程打成jar包
3、上傳jar包到服務器,假設部署路徑為 /var/apps/myapp.jar
,使用命令做一個軟連接到 /etc/init.d
目錄,命令:
ln -s /var/apps/myapp.jar /etc/init.d/myapp
其中 /etc/init.d/myapp
最后的 myapp 可以是別的名字,這個就是服務名,我們后面使用 service [服務名] start
來啟動(下面有說明)。
4、給jar文件授予可執行權限,命令:
chmod +x myapp.jar
5、接下來,就可以使用我們熟悉的 service myapp start|stop|restart|status
來對應用進行啟停了。
執行命令后將得到形如 Started|Stopped [PID] 的結果反饋。
默認PID文件路徑:/var/run/appname/appname.pid
默認服務日志文件路徑:/var/log/appname.log(可以通過下面.conf 的方式修改LOG_FOLDER
)
6、使用自定義的.conf文件來變更默認配置,方法如下:
在jar包相同路徑下創建一個.conf文件,名稱應該與.jar的名稱相同,如myapp.conf(如果我們打包的文jar文件為 myapp-1.0.0.jar 那么這里的conf文件也應該是 myapp-1.0.0.conf),其內容配置可以如下:
JAVA_HOME=/usr/local/jdk
JAVA_OPTS=-Xmx1024M
LOG_FOLDER=/data/logs/myapp
注:LOG_FOLDER 對應的文件夾目錄要必須存在,如果目錄不存在,服務並不會自從創建目錄。
華麗麗的分割線
如果你是CentOS 7或紅帽7以上,你還可以用下面的方法處理,為什么要用這樣的方法(請自行研究),這里直接提供結果,哈哈
編輯服務文件 vim /usr/lib/systemd/system/myapp.service
[Unit]
Description=myapp
After=network.target
[Service]
WorkingDirectory=/var/apps/myapp
ExecStart=/usr/local/java/bin/java -Dsun.misc.URLClassPath.disableJarChecking=true -jar /var/apps/myapp.jar
ExecStop=kill $MAINPID
Restart=always
[Install]
WantedBy=multi-user.target
使用Linux 7 以后服務新的啟動方式,相關命令
啟動
systemctl start myapp 停止 systemctl stop myapp 重啟 systemctl restart myapp 查看日志 journalctl -u myapp 關於更多 systemctl 命令的使用方法,度娘有很多。
(結束)