詳解SpringBoot應用跨域訪問解決方案


一、什么是跨域訪問

說到跨域訪問,必須先解釋一個名詞:同源策略。所謂同源策略就是在瀏覽器端出於安全考量,向服務端發起請求必須滿足:協議相同、Host(ip)相同、端口相同的條件,否則訪問將被禁止,該訪問也就被稱為跨域訪問。
雖然跨域訪問被禁止之后,可以在一定程度上提高了應用的安全性,但也為開發帶來了一定的麻煩。比如:我們開發一個前后端分離的易用,頁面及js部署在一個主機的nginx服務中,后端接口部署在一個tomcat應用容器中,當前端向后端發起請求的時候一定是不符合同源策略的,也就無法訪問。那么我們如何解決這個問題?就是本文需要向大家說明的內容。

二、跨域訪問的解決方案有哪些?

2.1.第一類方案:前端解決方案

雖然瀏覽器對於不符合同源策略的訪問是禁止的,但是仍然存在例外的情況,如以下資源引用的標簽不受同源策略的限制:

  • html的script標簽
  • html的link標簽
  • html的img標簽
  • html的iframe標簽:對於使用jsp、freemarker開發的項目,這是實現跨域訪問最常見的方法,

除了基於HTML本身的特性實現跨域訪問,我們還可以使用jsonp、window的postMessage實現跨域訪問。這些都是前端實現跨域訪問的方式。

2.2.第二類方案:使用代理

實際上對跨域訪問的支持在服務端實現起來更加容易,最常用的方法就是通過代理的方式,如:

  • nginx或haproxy代理跨域
  • nodejs中間件代理跨域

其實實現代理跨域的邏輯非常簡單:就是在不同的資源服務:js資源、html資源、css資源、接口數據資源服務的前端搭建一個中間層,所有的瀏覽器及客戶端訪問都通過代理轉發。所以在瀏覽器、客戶端看來,它們訪問的都是同一個ip、同一個端口的資源,從而符合同源策略實現跨域訪問。

2.3 第三類方案:CORS

跨域資源共享(CORS):通過修改Http協議header的方式,實現跨域。說的簡單點就是,通過設置HTTP的響應頭信息,告知瀏覽器哪些情況在不符合同源策略的條件下也可以跨域訪問,瀏覽器通過解析Http協議中的Header執行具體判斷。具體的Header如下:

CROS跨域常用header

  • Access-Control-Allow-Origin: 允許哪些ip或域名可以跨域訪問
  • Access-Control-Max-Age: 表示在多少秒之內不需要重復校驗該請求的跨域訪問權限
  • Access-Control-Allow-Methods: 表示允許跨域請求的HTTP方法,如:GET,POST,PUT,DELETE
  • Access-Control-Allow-Headers: 表示訪問請求中允許攜帶哪些Header信息,如:AcceptAccept-LanguageContent-LanguageContent-Type

三、SpringBoot下實現CORS的四種方式

為大家介紹四種實現CORS的方法,兩種是全局配置,兩種是局部接口生效的配置。一般來說,SpringBoot項目采用其中一種方式實現CORS即可。

3.1.使用CorsFilter進行全局跨域配置

    @Configuration public class GlobalCorsConfig { @Bean public CorsFilter corsFilter() { CorsConfiguration config = new CorsConfiguration(); //開放哪些ip、端口、域名的訪問權限,星號表示開放所有域 config.addAllowedOrigin("*"); //是否允許發送Cookie信息 config.setAllowCredentials(true); //開放哪些Http方法,允許跨域訪問 config.addAllowedMethod("GET","POST", "PUT", "DELETE"); //允許HTTP請求中的攜帶哪些Header信息 config.addAllowedHeader("*"); //暴露哪些頭部信息(因為跨域訪問默認不能獲取全部頭部信息) config.addExposedHeader("*"); //添加映射路徑,“/**”表示對所有的路徑實行全局跨域訪問權限的設置 UrlBasedCorsConfigurationSource configSource = new UrlBasedCorsConfigurationSource(); configSource.registerCorsConfiguration("/**", config); return new CorsFilter(configSource); } }

3.2. 重寫WebMvcConfigurer的addCorsMappings方法(全局跨域配置)

    @Configuration public class GlobalCorsConfig { @Bean public WebMvcConfigurer corsConfigurer() { return new WebMvcConfigurer() { @Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping("/**") //添加映射路徑,“/**”表示對所有的路徑實行全局跨域訪問權限的設置 .allowedOrigins("*") //開放哪些ip、端口、域名的訪問權限 .allowCredentials(true) //是否允許發送Cookie信息 .allowedMethods("GET","POST", "PUT", "DELETE") //開放哪些Http方法,允許跨域訪問 .allowedHeaders("*") //允許HTTP請求中的攜帶哪些Header信息 .exposedHeaders("*"); //暴露哪些頭部信息(因為跨域訪問默認不能獲取全部頭部信息) } }; } }

3.3.使用CrossOrigin注解(局部跨域配置)

  • 將CrossOrigin注解加在Controller層的方法上,該方法定義的RequestMapping端點將支持跨域訪問
  • 將CrossOrigin注解加在Controller層的類定義處,整個類所有的方法對應的RequestMapping端點都將支持跨域訪問
    @RequestMapping("/cors") @ResponseBody @CrossOrigin(origins = "http://localhost:8080", maxAge = 3600) public String cors( ){ return "cors"; }

3.4 使用HttpServletResponse設置響應頭(局部跨域配置)

這種方式略顯麻煩,不建議在SpringBoot項目中使用。

    @RequestMapping("/cors") @ResponseBody public String cors(HttpServletResponse response){ //使用HttpServletResponse定義HTTP請求頭,最原始的方法也是最通用的方法 response.addHeader("Access-Control-Allow-Origin", "http://localhost:8080"); return "cors"; }

四、實現與測試

在SpringBoot項目外隨便定義一個HTML,並寫代碼觸發如下的ajax代碼。(觸發過程我就不寫了,定義一個按鈕加一個監聽函數即可)。以下是跨域AJAX請求驗證的核心代碼:

    $.ajax({
            url: 'http://localhost:8090/cors', type: "POST", xhrFields: { withCredentials: true //允許發送Cookie信息 }, success: function (data) { alert("跨域請求配置成功") }, error: function (data) { alert("跨域請求配置失敗") } })
  • 跨域請求配置成功表示:我們的跨域配置生效,ajax請求可以正確訪問服務端接口。
  • 跨域請求配置失敗表示:我們的跨域配置未生效,請參照檢查第三節檢查各項配置是否正確。

SpringBoot使用MyBatis-Generator詳解-copy

 

SpringBoot使用MyBatis-Generator詳解
MyBatis-Generator簡介
MyBatis-Generator使用
添加maven依賴
創建MBG配置文件
運行MBG,生成底層類
數據庫查詢

前幾天工作中接觸到MyBatis-Generator,發現其方便之處,MyBatis-Generator可以幫助我們實現數據庫繁復的增刪改查操作,當數據庫中表結構發生變化時,只需要重新生成一次即可,而不用每一條語句上去添加新增或者刪除字段,這樣可以大大的提高我們的開發效率,並且,不需要寫大量的重復性的工作,可以讓我們把精力更多的專注於業務邏輯。
​ MyBatis-Generator官網

MyBatis-Generator簡介
​ MyBatis Generator(MBG,縮寫名)是MyBatis的代碼生成器。 它將為所有版本的MyBatis以及版本2.2.0之后的iBATIS版本生成數據庫的底層實現代碼。 它可以根據數據庫中的表文件,生成可用於訪問數據表的Pojo類,dao類和*Mapper.xml的所有文件。MBG為大部分數據庫操作即相對簡單CRUD(增刪改查)提供支持,不過相對復雜的操作比如多表查詢還需自己動手完成sql。

​ MBG生成的SQL配置文包含一下操作的語句:

​ -[ ] insert

​ -[ ] update by primary key

​ -[ ] update by example (using a dynamic where clause)

​ -[ ] delete by primary key

​ -[ ] delete by example (using a dynamic where clause)

​ -[ ] select by primary key

​ -[ ] select by example (using a dynamic where clause)

​ -[ ] count by example

​ MBG默認生成所有的語句,我么同樣可以在配置文件中通過配置去除自己不需要的語句。

MyBatis-Generator使用
添加maven依賴
<!--數據庫連接依賴-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.12</version>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid-spring-boot-starter</artifactId>
<version>1.1.10</version>
</dependency>
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>1.1.1</version>
</dependency>
<!--MBG插件-->
<plugin>
<groupId>org.mybatis.generator</groupId>
<artifactId>mybatis-generator-maven-plugin</artifactId>
<version>1.3.6</version>
</plugin>

本文使用的SpringBoot版本是2.0.3.RELEASE。

創建MBG配置文件
​ MBG最重要的就是配置文件,可以參考以為大神的博客,我也從中受益很多,因為MBG配置文件可選參數實在是很多,本文只介紹些重要的參數的屬性,足夠正常開發使用,如有需要,還是需要看MBG的官方文檔的。

​ 在resources文件目錄下創建generatorConfig.xml文件,文件內容如下:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE generatorConfiguration
PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
"http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">

<generatorConfiguration>
<classPathEntry
location="D:\Office SoftWare\maven\repository\mysql\mysql-connector-java\8.0.12\mysql-connector-java-8.0.12.jar"/>

<context id="MysqlTables" targetRuntime="MyBatis3" defaultModelType="flat">

<property name="javaFileEncoding" value="UTF-8"/>

<commentGenerator>
<property name="suppressDate" value="false"/>
<property name="addRemarkComments" value="true"/>
<property name="suppressAllComments" value="false"/>
</commentGenerator>

<jdbcConnection driverClass="com.mysql.cj.jdbc.Driver"
connectionURL="jdbc:mysql://localhost:3306/testMBG?useUnicode=true&amp;characterEncoding=utf8&amp;useSSL=false"
userId="root"
password="123456">
<property name="nullCatalogMeansCurrent" value="true"/>
</jdbcConnection>

<javaTypeResolver>
<property name="forceBigDecimals" value="false"/>
</javaTypeResolver>

<javaModelGenerator targetPackage="com.doo.mybatis.domain.entity"
targetProject="src\main\java">
<property name="enableSubPackages" value="true"/>
<property name="trimStrings" value="true"/>
</javaModelGenerator>

<sqlMapGenerator targetPackage="mappers" targetProject="src\main\resources">
<property name="enableSubPackages" value="true"/>
</sqlMapGenerator>

<javaClientGenerator type="XMLMAPPER" targetPackage="com.doo.mybatis.dao"
targetProject="src\main\java">
<property name="enableSubPackages" value="true"/>
</javaClientGenerator>


<table schema="ins_personal_claim" tableName="claim_apply_record" enableCountByExample="true" domainObjectName="ClaimApplyRecord">
<columnOverride column="apply_for" javaType="com.jd.ins.personal.claim.domain.enums.ApplyForType" typeHandler="org.apache.ibatis.type.EnumTypeHandler"/>
<ignoreColumn column="create_time"/>
<ignoreColumn column="update_time"/>
</table>

<table schema="ins_personal_claim" tableName="claim_image_info" enableCountByExample="false" domainObjectName="ClaimImageInfo">
<columnOverride column="image_type" javaType="com.jd.ins.personal.claim.domain.enums.ImageType" typeHandler="org.apache.ibatis.type.EnumTypeHandler"/>
<ignoreColumn column="create_time"/>
<ignoreColumn column="update_time"/>
</table>

</context>
</generatorConfiguration>

​ 配置文件中的<classPathEntry>是配置驅動的一個簡單的方式,可以通過location制定路徑。

​ <context>元素用於指定生成一組對象的環境。例如指定要連接的數據庫,要生成對象的類型和要處理的數據庫中的表。其中的defaultModelType屬性很重要,這個屬性定義了MBG如何生成實體類,推薦使用flat模式,為每一張表只生成一個包含表所有字段的實體類。

​ <javaModelGenerator>指定生成實體類的生成路徑,trimStrings屬性會對查詢條件進行trim操作,默認值是false。

​ <sqlMapGenerator>指定生成xml文件的路徑。

​ <javaClientGenerator>指定生成dao接口。

​ <table>可以配置多個,用於指定生成數據庫中的那個表的底層類,可以指定生成的實體類的name,enableCountXXX屬性可以去除不需要的sql方法,其中columnOverride可以指定表中使用的枚舉類,ignoreColumn可以忽略表中的字段,columnOverride和ignoreColumn可以指定0個或多個。

運行MBG,生成底層類
​ 執行MBG的方式有很多,本文使用Maven的方式執行,也是較為簡單的方式。

點擊執行就可以自動生成代碼,會生成實體類,查詢使用的example文件,dao,xml文件,如下圖所示:

 

數據庫查詢
​ 生成了數據表操的所有底層類后,我們簡單的使用它來進行一次查詢操作,示例代碼如下:

@Test
public void queryByPrimaryKey() {
ClaimImageInfo imageInfo = imageInfoMapper.selectByPrimaryKey(112L);
log.info("查詢結果為:{}", imageInfo);
}

@Test
public void queryByExample(){
ClaimImageInfoExample example = new ClaimImageInfoExample();
example.createCriteria().andIdGreaterThan(112L);
example.setOrderByClause(" id limit " + 10);
List<ClaimImageInfo> imageInfoList = imageInfoMapper.selectByExample(example);
log.info("查詢結果為:{}", imageInfoList);
}

如果需要對查詢結果進行排序,可以使用setOrderByClause來添加排序語句,並且如果有分頁的需求,可以通過id或者其他的條件,和limit配合使用,達到分頁的效果。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM