IDEA從零開始搭建SpringBoot工程
下面就給大家介紹一下IDEA從零開始搭建一個SpringBoot工程
(1)File->new,選擇maven,建立一個空專案,直接next.
(2)填寫工程名
(3)next到底,成果建立一個基於maven的空Java專案,其目錄結構差不多是這樣的:
(4)在pom檔案中引入SpringBoot相關依賴
<parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>1.5.1.RELEASE</version> </parent> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> </dependencies>
(5)新建一個controller 包,用於存放所有的controller,這裡跟官方的一樣,使用SampleController為第一個測試用例。程式碼如下:
package controller; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.EnableAutoConfiguration; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.ResponseBody; @Controller @EnableAutoConfiguration public class SampleController { @RequestMapping("/") @ResponseBody String home() { return "大家好,我是行業小白!"; } public static void main(String[] args) throws Exception { SpringApplication.run(SampleController.class, args); } }
注意到,這裡有一個main函式,再聯想到前面說的,SpringBoot應用一般是打包成可執行jar包來發布的,這個main函式就是整個專案的入口。而之所以能這麼做,是因為SpringBoot連Tomcat8作為一個外掛都整合進去了,所以就不必跟之前的SSM架構下一樣,還需要去在Tomcat下配置war包才能執行。直接點選執行該main函式,再瀏覽器連結欄,輸入地址http://localhost:8080/,就可以看到列印的字串”Hello World!”了。這就是官網提供的一個最基本的基於SpringBoot的Web應用,如此便捷。
當然,一個基本的Web應用,結構肯定不會這麼簡單。下面要說的是,如何在上面的基礎上,搭建一個具有MVC結構的完整的Web應用,其中資料庫採用的是Mysql,ORM採用的是Spring Data JPA,前端頁面採用js+html5。(當然還有其他的方式,例如ORM框架採用mybatis等,本文暫未涉及。)
(6)在resource目錄下新建一個application.properties檔案(或yml檔案),命名與位置為SpringBoot預設的配置檔案。在該檔案中,記錄著所有的模組配置內容。例如Tomcat的埠(預設8080)以及編碼方式等:
server.port=8080
server.tomcat.uri-encoding=utf-8
(7)引入本專案中所需要的相關依賴(MySQL連線驅動 以及Spring Data JPA,thymeleaf模板引擎)
<dependencies>
<!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.39</version>
</dependency>
<!-- https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-starter-thymeleaf -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
<version>1.4.0.RELEASE</version>
</dependency>
<!-- https://mvnrepository.com/artifact/org.springframework.data/spring-data-jpa -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
<version>1.5.1.RELEASE</version>
</dependency>
</dependencies>
(8)在application.properties中配置MySQL資料庫連線資訊
這裡的資料庫為本地資料庫test,使用者名稱和密碼改成自己的
#MySQL
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/test?characterEncoding=utf8
spring.datasource.username=****
spring.datasource.password=****
(9)在application.properties中配置Spring Data JPA
這一段的意思就是說,資料庫型別為MYSQL,日誌資訊列印具體執行的sql語句,表更新策略以及Java類到資料庫表字段的對映規則等,具體檢視網路資料。
#Spring Data JPA
spring.jpa.database=MYSQL
spring.jpa.show-sql=true
spring.jpa.hibernate.ddl-auto=update
# Naming strategy
spring.jpa.hibernate.naming-strategy = org.hibernate.cfg.ImprovedNamingStrategy
# stripped before adding them to the entity manager)
spring.jpa.properties.hibernate.dialect = org.hibernate.dialect.MySQL5Dialect
(10)編寫一個實體類User
@Table標籤,指定資料庫中對應的表名,id配置為主鍵,生成策略為自動生成
/**
* Model 使用者
*/
@Entity
@Table(name = "tbl_user")
public class User {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private long id;
private String name;
private String password;
}
(11)基於JPA,實現DAO層(即資料庫資料的增刪改查操作)
新建UserRepositoty.java介面檔案,原始碼如下:
/**
* User表操作介面
*/
@Repository
public interface UserRepositoty extends JpaRepository<User,Long>{
@Query("select t from User t where t.name = :name")
User findByUserName(@Param("name") String name);
}
需要解釋的是,Spring Data JPA提供了很多持久層介面,例如Repository,CrudRepositoty,PagingAndSortingRepository 以及JpaRepository 介面。其中Repository為基類,JpaRepository繼承自PagingAndSortingRepository介面,兩個泛型引數分別代表Java POJO類以及主鍵資料型別。我們建立自己的資料庫操作介面時,只需繼承上述JPA提供的某個介面,即可自動繼承相關資料操作方法,而不需要再次實現。例如CrudRepositoty提供了對增刪改查操作的實現,PagingAndSortingRepository提供了分頁查詢方法的實現。另外JPA提供了一套命名規則例如readBy**()等,這些方法也只需要使用者申明而由JPA自動實現了。如果這仍不能滿足業務需求,也可以自定義SQL查詢語句,例如上述程式碼所示,採用@Query標籤, 其中 :*語法為引用下面用@Param標識的變數,需要注意的是其中User不是表面而是Java POJO類名。具體使用參考JPA使用手冊。
(12)設計Service層業務程式碼
新建UserService類,其原始碼如下:
/**
* User業務邏輯
*/
@Service
public class UserService {
@Autowired
private UserRepositoty userRepositoty;
public User findUserByName(String name){
User user = null;
try{
user = userRepositoty.findByUserName(name);
}catch (Exception e){}
return user;
}
}
(13)設計Controller層
新建UserController.java,提供兩個介面,/user/index 返回頁面,/user/show返回資料。其原始碼如下:
/**
* User控制層
*/
@Controller
@RequestMapping(value = "/user")
public class UserController {
@Autowired
private UserService userService;
@RequestMapping(value = "/index")
public String index(){
return "user/index";
}
@RequestMapping(value = "/show")
@ResponseBody
public String show(@RequestParam(value = "name")String name){
User user = userService.findUserByName(name);
if(null != user)
return user.getId()+"/"+user.getName()+"/"+user.getPassword();
else return "null";
}
}
(14)在application.properties檔案中配置頁面引擎。這裡採用SpringMVC(SpringBoot還提供thymeleaf,freemaker等)。這裡需要配置其靜態資源(js、css檔案、圖片檔案等)路徑,以及html頁面檔案路徑,參考SpringMVC在Spring下的配置。
#檢視層控制
spring.mvc.view.prefix=classpath:/templates/
spring.mvc.view.suffix=.html
spring.mvc.static-path-pattern=/static/**
(15)在resource目錄下新建templates以及static目錄,分別用於存放html檔案以及(js、css檔案、圖片)檔案。在(13)中返回了一個“user/index”頁面,所以在templates下新建user目錄,在user目錄下新建index.html頁面,這裡就不寫什麼了,預設頁面,通過相對路徑引入js檔案,js檔案裡只做示意,彈出一個alert()。
user/index.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8"/>
<!--<script src="../static/scripts/jquery.min.js"></script>-->
<!--<script src="../static/scripts/test.js"></script>-->
<title>Title</title>
<script language="JavaScript">
function ready() {
alert("OK TEST");
}
</script>
</head>
<h1 onclick="ready()">我是你們的爸爸</h1>
<body>
</body>
</html>
static/scripts/test.js
$(document).ready(function (){
alert("OK TEST");
});
(16)配置JPA
新建一個configuration包,用於存放專案配置類。類似SSM架構下,spring需要配置Java POJO類包路徑以及DAO層介面路徑,以自動掃描相關注解,這裡同樣需要配置這兩項,不同的是Spring採取的是xml配置方式,這裡用Java程式碼+註解方式配置。新建一個JpaConfiguration.java類,其程式碼如下:
/**
* JPA 配置類
*/
@Order(Ordered.HIGHEST_PRECEDENCE)
@Configuration
@EnableTransactionManagement(proxyTargetClass = true)
@EnableJpaRepositories(basePackages = "com.song.repository")
@EntityScan(basePackages = "com.song.entity")
public class JpaConfiguration {
@Bean
PersistenceExceptionTranslationPostProcessor persistenceExceptionTranslationPostProcessor(){
return new PersistenceExceptionTranslationPostProcessor();
}
}
(17)配置專案啟動入口
到這一步就可以刪掉(5)中官方示例給出的SampleController.java了,由於我們的工程結構已經發生了改變,我們需要告訴SpringBoot框架去掃描哪些包從而載入對應類,所以這裡重新編寫main函式。新建一個Entry.java類,其程式碼如下(其中@SpringBootApplication是一個複合註解,就理解為自動配置吧):
/**
* Created by Song on 2017/2/15.
* 專案啟動入口,配置包根路徑
*/
@SpringBootApplication
@ComponentScan(basePackages = "com.song")
public class Entry {
public static void main(String[] args) throws Exception {
SpringApplication.run(Entry.class, args);
}
}
(18)執行main函式,訪問http://localhost:8080/user/index 會顯示測試頁面,並彈出alert(),訪問http://localhost:8080/user/show?name=**(資料表裡存在的資料)會顯示user資訊。最終的工程檔案結構如下:
完整專案工程:https://github.com/Sonlan/springboot-demo
SpringBoot的具體介紹可以參看其他網上介紹,這裡就不多說了,就這幾天的學習,個人理解,簡而言之:
(1)它是Spring的升級版,Spring容器能做到的事情,它都能做到,而且更簡便,從配置形式上來說,SpringBoot完全拋棄了繁瑣的XML檔案配置方式,而是替代性地用註解方式來實現,雖然本質來說,是差不多的(類似包掃描,註解掃描,類載入之類)。
(2)SpringBoot整合的外掛更多,從而使用很多服務,都只是引入一個依賴,幾個註解和Java類就可以用了,具體的參考相關手冊。
(3)在Web應用開發這一塊,之前的應用一般來說是打包成war包,再發布到相關伺服器容器下(例如Tomcat),雖然SpringBoot也可以這麼做,但在SpringBoot下更常見的形式是將SpringBoot應用打包成可執行jar包檔案。之所以這麼做,源於你可以直接將SpringBoot應用看成是一個Java Application,其Web應用可以沒有webapp目錄(更不用說web.xml了),它推薦使用html頁面,並將其作為靜態資源使用。
下面具體記錄一下,如何在IDEA下從零開始,一步步搭建SpringBoot Web應用,這裡採用的是maven作依賴管理,新手起步,有任何疑問,請參考SpringBoot官網。
需要說明的是SpringBoot依賴的JDK版本為1.8及以上。
- 2018最新免費Spring Boot+Spring Cloud視訊教程全套下載
百度雲盤:https://www.jianshu.com/p/b3392007b241