Spring Boot(二)：Web 綜合開發

時間 2019-11-12

原文原文鏈接

上篇文章介紹了 Spring Boot 初級教程：Spring Boot(一)：入門篇，方便你們快速入門、瞭解實踐 Spring Boot 特性；本篇文章接着上篇內容繼續爲你們介紹 Spring Boot 的其它特性（有些未必是 Spring Boot 體系桟的功能，可是是 Spring 特別推薦的一些開源技術本文也會介紹），對了這裏只是一個大概的介紹，特別詳細的使用咱們會在其它的文章中來展開說明。css

Web 開發

Spring Boot Web 開發很是的簡單，其中包括經常使用的 json 輸出、filters、property、log 等html

json 接口開發

在之前使用 Spring 開發項目，須要提供 json 接口時須要作哪些配置呢前端

添加 jackjson 等相關 jar 包

配置 Spring Controller 掃描

對接的方法添加 @ResponseBody

就這樣咱們會常常因爲配置錯誤，致使406錯誤等等，Spring Boot 如何作呢，只須要類添加 @RestController 便可，默認類中的方法都會以 json 的格式返回vue

@RestController
public class HelloController {
    @RequestMapping("/getUser")
    public User getUser() {
        User user=new User();
        user.setUserName("小明");
        user.setPassWord("xxxx");
        return user;
    }
}

若是須要使用頁面開發只要使用@Controller註解便可，下面會結合模板來講明java

自定義 Filter

咱們經常在項目中會使用 filters 用於錄調用日誌、排除有 XSS 威脅的字符、執行權限驗證等等。Spring Boot 自動添加了 OrderedCharacterEncodingFilter 和 HiddenHttpMethodFilter，而且咱們能夠自定義 Filter。mysql

兩個步驟：jquery

實現 Filter 接口，實現 Filter 方法

添加@Configuration 註解，將自定義Filter加入過濾鏈

好吧，直接上代碼git

@Configuration
public class WebConfiguration {
    @Bean
    public RemoteIpFilter remoteIpFilter() {
        return new RemoteIpFilter();
    }
    
    @Bean
    public FilterRegistrationBean testFilterRegistration() {

        FilterRegistrationBean registration = new FilterRegistrationBean();
        registration.setFilter(new MyFilter());
        registration.addUrlPatterns("/*");
        registration.addInitParameter("paramName", "paramValue");
        registration.setName("MyFilter");
        registration.setOrder(1);
        return registration;
    }
    
    public class MyFilter implements Filter {
        @Override
        public void destroy() {
            // TODO Auto-generated method stub
        }

        @Override
        public void doFilter(ServletRequest srequest, ServletResponse sresponse, FilterChain filterChain)
                throws IOException, ServletException {
            // TODO Auto-generated method stub
            HttpServletRequest request = (HttpServletRequest) srequest;
            System.out.println("this is MyFilter,url :"+request.getRequestURI());
            filterChain.doFilter(srequest, sresponse);
        }

        @Override
        public void init(FilterConfig arg0) throws ServletException {
            // TODO Auto-generated method stub
        }
    }
}

自定義 Property

在 Web 開發的過程當中，我常常須要自定義一些配置文件，如何使用呢github

配置在 application.properties 中

com.neo.title=純潔的微笑
com.neo.description=分享生活和技術

自定義配置類web

@Component
public class NeoProperties {
    @Value("${com.neo.title}")
    private String title;
    @Value("${com.neo.description}")
    private String description;

    //省略getter settet方法

    }

log配置

配置輸出的地址和輸出級別

logging.path=/user/local/log
logging.level.com.favorites=DEBUG
logging.level.org.springframework.web=INFO
logging.level.org.hibernate=ERROR

path 爲本機的 log 地址，logging.level 後面能夠根據包路徑配置不一樣資源的 log 級別

數據庫操做

在這裏我重點講述 Mysql、spring data jpa 的使用，其中 Mysql 就不用說了你們很熟悉。Jpa 是利用 Hibernate 生成各類自動化的 sql，若是隻是簡單的增刪改查，基本上不用手寫了，Spring 內部已經幫你們封裝實現了。

下面簡單介紹一下如何在 Spring Boot 中使用

一、添加相 jar 包

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
 <dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
</dependency>

二、添加配置文件

spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

spring.jpa.properties.hibernate.hbm2ddl.auto=update
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL5InnoDBDialect
spring.jpa.show-sql= true

其實這個 hibernate.hbm2ddl.auto 參數的做用主要用於：自動建立|更新|驗證數據庫表結構,有四個值：

create：每次加載 hibernate 時都會刪除上一次的生成的表，而後根據你的 model 類再從新來生成新表，哪怕兩次沒有任何改變也要這樣執行，這就是致使數據庫表數據丟失的一個重要緣由。

create-drop ：每次加載 hibernate 時根據 model 類生成表，可是 sessionFactory 一關閉,表就自動刪除。

update：最經常使用的屬性，第一次加載 hibernate 時根據 model 類會自動創建起表的結構（前提是先創建好數據庫），之後加載 hibernate 時根據 model 類自動更新表結構，即便表結構改變了但表中的行仍然存在不會刪除之前的行。要注意的是當部署到服務器後，表結構是不會被立刻創建起來的，是要等應用第一次運行起來後纔會。

validate ：每次加載 hibernate 時，驗證建立數據庫表結構，只會和數據庫中的表進行比較，不會建立新表，可是會插入新值。

dialect 主要是指定生成表名的存儲引擎爲 InnoDBD
show-sql 是否打印出自動生成的 SQL，方便調試的時候查看

三、添加實體類和 Dao

@Entity
public class User implements Serializable {

    private static final long serialVersionUID = 1L;
    @Id
    @GeneratedValue
    private Long id;
    @Column(nullable = false, unique = true)
    private String userName;
    @Column(nullable = false)
    private String passWord;
    @Column(nullable = false, unique = true)
    private String email;
    @Column(nullable = true, unique = true)
    private String nickName;
    @Column(nullable = false)
    private String regTime;

    //省略getter settet方法、構造方法

}

dao 只要繼承 JpaRepository 類就能夠，幾乎能夠不用寫方法，還有一個特別有尿性的功能很是贊，就是能夠根據方法名來自動的生成 SQL，好比findByUserName 會自動生成一個以 userName 爲參數的查詢方法，好比 findAlll 自動會查詢表裏面的全部數據，好比自動分頁等等。。

Entity 中不映射成列的字段得加 @Transient 註解，不加註解也會映射成列

public interface UserRepository extends JpaRepository<User, Long> {
    User findByUserName(String userName);
    User findByUserNameOrEmail(String username, String email);
}

四、測試

@RunWith(SpringJUnit4ClassRunner.class)
@SpringApplicationConfiguration(Application.class)
public class UserRepositoryTests {

    @Autowired
    private UserRepository userRepository;

    @Test
    public void test() throws Exception {
        Date date = new Date();
        DateFormat dateFormat = DateFormat.getDateTimeInstance(DateFormat.LONG, DateFormat.LONG);        
        String formattedDate = dateFormat.format(date);
        
        userRepository.save(new User("aa1", "aa@126.com", "aa", "aa123456",formattedDate));
        userRepository.save(new User("bb2", "bb@126.com", "bb", "bb123456",formattedDate));
        userRepository.save(new User("cc3", "cc@126.com", "cc", "cc123456",formattedDate));

        Assert.assertEquals(9, userRepository.findAll().size());
        Assert.assertEquals("bb", userRepository.findByUserNameOrEmail("bb", "cc@126.com").getNickName());
        userRepository.delete(userRepository.findByUserName("aa1"));
    }

}

當讓 Spring Data Jpa 還有不少功能，好比封裝好的分頁，能夠本身定義 SQL，主從分離等等，這裏就不詳細講了

Thymeleaf 模板

Spring Boot 推薦使用 Thymeleaf 來代替 Jsp，Thymeleaf 模板究竟是什麼來頭呢，讓 Spring 大哥來推薦，下面咱們來聊聊

Thymeleaf 介紹

Thymeleaf 是一款用於渲染 XML/XHTML/HTML5 內容的模板引擎。相似 JSP，Velocity，FreeMaker 等，它也能夠輕易的與 Spring MVC 等 Web 框架進行集成做爲 Web 應用的模板引擎。與其它模板引擎相比，Thymeleaf 最大的特色是可以直接在瀏覽器中打開並正確顯示模板頁面，而不須要啓動整個 Web 應用。

好了，大家說了咱們已經習慣使用了什麼 Velocity,FreMaker，beetle之類的模版，那麼到底好在哪裏呢？

比一比吧

Thymeleaf 是不同凡響的，由於它使用了天然的模板技術。這意味着 Thymeleaf 的模板語法並不會破壞文檔的結構，模板依舊是有效的XML文檔。模板還能夠用做工做原型，Thymeleaf 會在運行期替換掉靜態值。Velocity 與 FreeMarke r則是連續的文本處理器。
下面的代碼示例分別使用 Velocity、FreeMarker 與 Thymeleaf 打印出一條消息：

Velocity: <p>$message</p>
FreeMarker: <p>${message}</p>
Thymeleaf: <p th:text="${message}">Hello World!</p>

注意，因爲 Thymeleaf 使用了 XML DOM 解析器，所以它並不適合於處理大規模的 XML 文件。

URL

URL 在 Web 應用模板中佔據着十分重要的地位，須要特別注意的是 Thymeleaf 對於 URL 的處理是經過語法 @{...} 來處理的。Thymeleaf 支持絕對路徑 URL：

<a th:href="@{http://www.thymeleaf.org}">Thymeleaf</a>

條件求值

<a th:href="@{/login}" th:unless=${session.user != null}>Login</a>

for循環

<tr th:each="prod : ${prods}">
      <td th:text="${prod.name}">Onions</td>
      <td th:text="${prod.price}">2.41</td>
      <td th:text="${prod.inStock}? #{true} : #{false}">yes</td>
</tr>

就列出這幾個吧

頁面即原型

在 Web 開發過程當中一個繞不開的話題就是前端工程師與後端工程師的協做，在傳統 Java Web 開發過程當中，前端工程師和後端工程師同樣，也須要安裝一套完整的開發環境，而後各種 Java IDE 中修改模板、靜態資源文件，啓動/重啓/從新加載應用服務器，刷新頁面查看最終效果。

但實際上前端工程師的職責更多應該關注於頁面自己而非後端，使用 JSP，Velocity 等傳統的 Java 模板引擎很難作到這一點，由於它們必須在應用服務器中渲染完成後才能在瀏覽器中看到結果，而 Thymeleaf 從根本上顛覆了這一過程，經過屬性進行模板渲染不會引入任何新的瀏覽器不能識別的標籤，例如 JSP 中的，不會在 Tag 內部寫表達式。整個頁面直接做爲 HTML 文件用瀏覽器打開，幾乎就能夠看到最終的效果，這大大解放了前端工程師的生產力，它們的最終交付物就是純的 HTML/CSS/JavaScript 文件。

Gradle 構建工具

Spring 項目建議使用 Maven/Gradle 進行構建項目，相比 Maven 來說 Gradle 更簡潔，並且 Gradle 更適合大型複雜項目的構建。Gradle 吸取了 Maven 和 Ant 的特色而來，不過目前 Maven 仍然是 Java 界的主流，你們能夠先了解了解。

一個使用 Gradle 配置的項目

buildscript {
    repositories {
        maven { url "http://repo.spring.io/libs-snapshot" }
        mavenLocal()
    }
    dependencies {
        classpath("org.springframework.boot:spring-boot-gradle-plugin:1.3.6.RELEASE")
    }
}

apply plugin: 'java'  //添加 Java 插件, 代表這是一個 Java 項目
apply plugin: 'spring-boot' //添加 Spring-boot支持
apply plugin: 'war'  //添加 War 插件, 能夠導出 War 包
apply plugin: 'eclipse' //添加 Eclipse 插件, 添加 Eclipse IDE 支持, Intellij Idea 爲 "idea"

war {
    baseName = 'favorites'
    version =  '0.1.0'
}

sourceCompatibility = 1.7  //最低兼容版本 JDK1.7
targetCompatibility = 1.7  //目標兼容版本 JDK1.7

repositories {     //  Maven 倉庫
    mavenLocal()        //使用本地倉庫
    mavenCentral()      //使用中央倉庫
    maven { url "http://repo.spring.io/libs-snapshot" } //使用遠程倉庫
}
 
dependencies {   // 各類 依賴的jar包
    compile("org.springframework.boot:spring-boot-starter-web:1.3.6.RELEASE")
    compile("org.springframework.boot:spring-boot-starter-thymeleaf:1.3.6.RELEASE")
    compile("org.springframework.boot:spring-boot-starter-data-jpa:1.3.6.RELEASE")
    compile group: 'mysql', name: 'mysql-connector-java', version: '5.1.6'
    compile group: 'org.apache.commons', name: 'commons-lang3', version: '3.4'
    compile("org.springframework.boot:spring-boot-devtools:1.3.6.RELEASE")
    compile("org.springframework.boot:spring-boot-starter-test:1.3.6.RELEASE")
    compile 'org.webjars.bower:bootstrap:3.3.6'
    compile 'org.webjars.bower:jquery:2.2.4'
    compile("org.webjars:vue:1.0.24")
    compile 'org.webjars.bower:vue-resource:0.7.0'

}

bootRun {
    addResources = true
}

WebJars

WebJars 是一個很神奇的東西，可讓你們以 Jar 包的形式來使用前端的各類框架、組件。

什麼是 WebJars

WebJars 是將客戶端（瀏覽器）資源（JavaScript，Css等）打成 Jar 包文件，以對資源進行統一依賴管理。WebJars 的 Jar 包部署在 Maven 中央倉庫上。

爲何使用

咱們在開發 Java web 項目的時候會使用像 Maven，Gradle 等構建工具以實現對 Jar 包版本依賴管理，以及項目的自動化管理，可是對於 JavaScript，Css 等前端資源包，咱們只能採用拷貝到 webapp 下的方式，這樣作就沒法對這些資源進行依賴管理。那麼 WebJars 就提供給咱們這些前端資源的 Jar 包形勢，咱們就能夠進行依賴管理。

如何使用

一、 WebJars主官網查找對於的組件，好比 Vuejs

<dependency>
    <groupId>org.webjars</groupId>
    <artifactId>vue</artifactId>
    <version>2.5.16</version>
</dependency>

二、頁面引入

<link th:href="@{/webjars/bootstrap/3.3.6/dist/css/bootstrap.css}" rel="stylesheet"></link>

就能夠正常使用了！

示例代碼-github

示例代碼-碼雲

文章內容已經升級到 Spring Boot 2.x

參考：

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。