import org.springframework.core.io.ClassPathResource;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpStatus;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;

import java.net.URLEncoder;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

@GetMapping("/testResponseEntity1")
public ResponseEntity<byte[]> testResponseEntity1() throws Exception {

    // 讀取本地的文件
    String filePath = "/temp/A110120119/測(cè)試文件.text";
    ClassPathResource readFile = new ClassPathResource(filePath);

    // 設(shè)置響應(yīng)頭,把文件名稱(chēng)放入響應(yīng)頭中,確保文件可下載
    HttpHeaders headers = new HttpHeaders();
    headers.set("Content-Disposition", "attachment;filename=" + URLEncoder.encode(readFile.getFilename(), "UTF-8"));
    // 設(shè)置內(nèi)容類(lèi)型為「application/octet-stream」二進(jìn)制流
    headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);

    // 獲取File對(duì)象
    File file = readFile.getFile();
    Path path = Paths.get(file.toURI());
    // 獲取File對(duì)象的字節(jié)碼文件
    byte[] bytes = Files.readAllBytes(path);

    /*
     * 表示返回一個(gè)字節(jié)碼類(lèi)型的響應(yīng)
     * 同時(shí)設(shè)置了響應(yīng)頭和狀態(tài)碼
     * */
    if (ObjectUtils.isEmpty(readFile.getFilename())) {
        // ??????簡(jiǎn)寫(xiě)形式
        return ResponseEntity.ok().headers(headers).body(bytes);
    }

    // ??????非簡(jiǎn)寫(xiě)形式
    return new ResponseEntity<>(bytes, headers, HttpStatus.OK);
}

@GetMapping("/testResponseEntity2")
public ResponseEntity<List<String>> testResponseEntity2() {

    List<String> list = Arrays.asList("1", "2");
    return ResponseEntity.ok(list);
}

@GetMapping("/testResponseEntity2")
@ResponseBody
public List<String> testResponseEntity2() {

    List<String> list = Arrays.asList("1", "2");
    return list;
}

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;

@GetMapping("/testResponseEntity3")
public ResponseEntity<Void> testResponseEntity3(String param) {

    // ?http狀態(tài)碼 204 （無(wú)內(nèi)容） 服務(wù)器成功處理了請(qǐng)求，但沒(méi)有返回任何內(nèi)容。
    if (ObjectUtils.isEmpty(param)) {
    	// ?簡(jiǎn)寫(xiě)方式
        return ResponseEntity.noContent().build();
    }
	
	// ?非簡(jiǎn)寫(xiě)方式
    return new ResponseEntity<>(HttpStatus.NO_CONTENT);
}

@GetMapping("/testResponseEntity4")
public ResponseEntity<Void> testResponseEntity4() {
	
	// 向數(shù)據(jù)庫(kù)中插入數(shù)據(jù)
	// ......
	
    // ?http狀態(tài)碼 201 （已創(chuàng)建） 請(qǐng)求成功并且服務(wù)器創(chuàng)建了新的資源。
    return ResponseEntity.status(HttpStatus.CREATED).build();
}

@GetMapping("/testResponseEntity5")
public ResponseEntity<String> testResponseEntity5(String param) {
	
	// 如果參數(shù)不存在就返回默認(rèn)的圖片url，并返回狀態(tài)碼201
    if (!ObjectUtils.isEmpty(param)) {
        return new ResponseEntity<>("默認(rèn)的圖片URL", HttpStatus.CREATED);
    }
	
	// 向數(shù)據(jù)庫(kù)中插入圖片，并返回能訪(fǎng)問(wèn)圖片地址的url
	// ......
	// ?用于插入數(shù)據(jù)成功之后返回?cái)?shù)據(jù)給前臺(tái)

    // ?201 狀態(tài)碼,并返回圖片的url
    return ResponseEntity.status(HttpStatus.CREATED).body("圖片的url");
}

@GetMapping("/testResponseEntity6")
public ResponseEntity<Map<String, Object>> testResponseEntity6(String param) {
	
	// 用來(lái)存放校驗(yàn)信息的Map
    Map<String, Object> map = new HashMap<>();
	
	// 進(jìn)行參數(shù)校驗(yàn)
    if (param == null) {
    	// 參數(shù)為null，直接返回錯(cuò)誤碼400
        return ResponseEntity.status(HttpStatus.BAD_REQUEST).build();
    } else if ("".equals(param.trim())){
    	// 參數(shù)為空字符串，返回錯(cuò)誤碼400的同時(shí)，還返回錯(cuò)誤信息
        map.put("errorMsg","參數(shù)為空");
        return ResponseEntity.badRequest().body(map);
    }

    // 200 狀態(tài)碼，并指定請(qǐng)求成功的響應(yīng)體
    map.put("successMsg", "參數(shù)通過(guò)校驗(yàn)");
	
    return ResponseEntity.status(HttpStatus.OK).body(map);
    
    // 這種寫(xiě)法更加簡(jiǎn)單，本質(zhì)上和上面是一種寫(xiě)法
    // return ResponseEntity.ok(map);
}

$.ajax({
    url: `請(qǐng)求URL`,
    type: '請(qǐng)求方式',
    // data: JSON.stringify(param),
    // 向服務(wù)器發(fā)送的數(shù)據(jù)類(lèi)型
    // contentType: 'application/json;charset=utf-8',
    // dataType: 'json',
    success: function (data, status, xhr) {

        // 請(qǐng)求成功的響應(yīng)體
        console.log(data);

        // 請(qǐng)求成功的狀態(tài)文字描述(success,nocontent等)
        console.log(status);

        // 請(qǐng)求成功的狀態(tài)碼(200,201,204等)
        const {
            status: stateCode
        } = xhr;
        console.log(stateCode);
    },
    error(xhr, status, error) {

        const {
            // 請(qǐng)求異常時(shí)的json格式響應(yīng)體
            responseJSON,
            // 請(qǐng)求異常時(shí)的文本響應(yīng)內(nèi)容
            responseText,
            // 請(qǐng)求異常時(shí)的狀態(tài)碼
            status: stateCode
        } = xhr;
        console.log(responseJSON);
        console.log(responseText);
        console.log(stateCode);

        // 請(qǐng)求成功的狀態(tài)文字描述(error等)
        console.log(status);
    }
});