springboot跨域
技術標籤:springbootjava
Springboot跨域問題,是當前主流web開發人員都繞不開的難題。但我們首先要明確以下幾點
- 跨域只存在於瀏覽器端,不存在於安卓/ios/Node.js/python/ java等其它環境
- 跨域請求能發出去,服務端能收到請求並正常返回結果,只是結果被瀏覽器攔截了。
- 之所以會跨域,是因為受到了同源策略的限制,同源策略要求源相同才能正常進行通訊,即協議、域名、埠號都完全一致。
瀏覽器出於安全的考慮,使用 XMLHttpRequest物件發起 HTTP請求時必須遵守同源策略,否則就是跨域的HTTP請求,預設情況下是被禁止的。換句話說,瀏覽器安全的基石是同源策略。
同源策略限制了從同一個源載入的文件或指令碼如何與來自另一個源的資源進行互動。這是一個用於隔離潛在惡意檔案的重要安全機制。
先給出一個熟悉的報錯資訊,讓你找到家的感覺~
Access to XMLHttpRequest at ‘http://192.168.1.1:8080/app/easypoi/importExcelFile’ from origin ‘http://localhost:8080’ has been blocked by CORS policy: No ‘Access-Control-Allow-Origin’ header is present on the requested resource.
一、什麼是CORS?
CORS是一個W3C標準,全稱是”跨域資源共享”(Cross-origin resource sharing),允許瀏覽器向跨源伺服器,發出XMLHttpRequest請求,從而克服了AJAX只能同源使用的限制。
它通過伺服器增加一個特殊的Header[Access-Control-Allow-Origin]來告訴客戶端跨域的限制,如果瀏覽器支援CORS、並且判斷Origin通過的話,就會允許XMLHttpRequest發起跨域請求。
CORS Header
- Access-Control-Allow-Origin: http://www.xxx.com
- Access-Control-Max-Age:86400
- Access-Control-Allow-Methods:GET, POST, OPTIONS, PUT, DELETE
- Access-Control-Allow-Headers: content-type
- Access-Control-Allow-Credentials: true
含義解釋:
CORS Header屬性 | 解釋 |
---|---|
Access-Control-Allow-Origin | 允許http://www.xxx.com域(自行設定,這裡只做示例)發起跨域請求 |
Access-Control-Max-Age | 設定在86400秒不需要再發送預校驗請求 |
Access-Control-Allow-Methods | 設定允許跨域請求的方法 |
Access-Control-Allow-Headers | 允許跨域請求包含content-type |
Access-Control-Allow-Credentials | 設定允許Cookie |
二、SpringBoot跨域請求處理方式
方法一、SpringBoot的註解@CrossOrigin(也支援SpringMVC)
簡單粗暴的方式,Controller層在需要跨域的類或者方法上加上該註解即可
@RestController
@CrossOrigin
@RequestMapping("/situation")
public class SituationController extends PublicUtilController {
@Autowired
private SituationService situationService;
// log日誌資訊
private static Logger LOGGER = Logger.getLogger(SituationController.class);
}
但每個Controller都得加,太麻煩了,怎麼辦呢,加在Controller公共父類(PublicUtilController)中,所有Controller繼承即可。
@CrossOrigin
public class PublicUtilController {
/**
* 公共分頁引數整理介面
* @param currentPage
* @param pageSize
* @return
*/
public PageInfoUtil proccedPageInfo(String currentPage, String pageSize) {
/* 分頁 */
PageInfoUtil pageInfoUtil = new PageInfoUtil();
try {
/*
* 將字串轉換成整數,有風險, 字串為a,轉換不成整數
*/
pageInfoUtil.setCurrentPage(Integer.valueOf(currentPage));
pageInfoUtil.setPageSize(Integer.valueOf(pageSize));
} catch (NumberFormatException e) {
}
return pageInfoUtil;
}
}
當然,這裡雖然指SpringBoot,SpringMVC也是同樣的,但要求在Spring4.2及以上的版本。
另外,如果SpringMVC框架版本不方便修改,也可以通過修改tomcat的web.xml配置檔案來處理
SpringMVC使用@CrossOrigin使用場景要求
- jdk1.8+
- Spring4.2+
方法二、處理跨域請求的Configuration
增加一個配置類,CrossOriginConfig.java。繼承WebMvcConfigurerAdapter或者實現WebMvcConfigurer介面,其他都不用管,專案啟動時,會自動讀取配置。
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.CorsRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;
/**
* AJAX請求跨域
*/
@Configuration
public class CorsConfig extends WebMvcConfigurerAdapter {
static final String ORIGINS[] = new String[] { "GET", "POST", "PUT", "DELETE" };
@Override
public void addCorsMappings(CorsRegistry registry) {
registry.addMapping("/**").allowedOrigins("*").allowCredentials(true).allowedMethods(ORIGINS).maxAge(3600);
}
方法三、採用過濾器(filter)的方式
同方法二加配置類,增加一個CORSFilter 類,並實現Filter介面即可,其他都不用管,介面呼叫時,會過濾跨域的攔截。
@Component
public class CORSFilter implements Filter {
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {
HttpServletResponse res = (HttpServletResponse) response;
// 設定允許Cookie
res.addHeader("Access-Control-Allow-Credentials", "true");
// 允許http://www.xxx.com域(自行設定,這裡只做示例)發起跨域請求
res.addHeader("Access-Control-Allow-Origin", "*");
// 設定允許跨域請求的方法
res.addHeader("Access-Control-Allow-Methods", "GET, POST, DELETE, PUT");
// 允許跨域請求包含content-type
res.addHeader("Access-Control-Allow-Headers", "Content-Type,X-CAF-Authorization-Token,sessionToken,X-TOKEN");
if (((HttpServletRequest) request).getMethod().equals("OPTIONS")) {
response.getWriter().println("ok");
return;
}
chain.doFilter(request, response);
}
@Override
public void destroy() {
}
@Override
public void init(FilterConfig filterConfig) throws ServletException {
}
}
好了,關於Springboot比較常用的解決跨域問題方式都已經分享了,希望對老鐵有所幫助。