搭建完一個spring-boot的介面服務後，可以在前段通過ajax非同步請求後臺介面資料，一般ajax通過傳遞json物件給後臺介面，後臺接收資料轉化為Bean物件，處理邏輯完成後，將返回的資料轉為json回送給前臺呼叫者；

1.前臺ajax引數格式為：

var param1={
    id:1234,
    name:'名稱',
    path:'路徑',
    createdDate:'2017-01-05 12:45:32'
}

2.ajax 呼叫

$.get("http://***********/ajaxApi/getOfBean",param, function(result){
    console.info("result:"+JSON.stringify(result));
});
 

3.後臺接收引數的Bean實體類

public class Ajax implements Serializable{
    private Long id;
    private String name;
    private String path;
    private Date createdDate;
    
}

4.後臺spring-boot提供的介面：

@RestController
@RequestMapping(value="ajaxApi")
@Api(value = "/ajaxApi", description = "非同步介面測試API",tags={"/ajaxApi"})
public class AjaxController {
  private static final Logger logger = LoggerFactory.getLogger(AjaxController.class);
  /***
   * 非同步引數接收
   * @return
   */
    @RequestMapping(value = "/getOfBean")
    @ApiOperation("Bean實體引數")
    public Ajax getOfBean(Ajax ajax) throws Exception{
      logger.info("非同步引數接收：{}",ajax.toString());//列印接收的物件
      return ajax;
    }
 }
 

介面接收引數為AjaxBean實體類，結束後返回該實體類給前臺；啟動專案，觸發ajax請求，報錯：

【org.springframework.validation.BindException】

Failed to convert property value of type 'java.lang.String' to required type 'java.util.Date' for property 'createdDate';
 nested exception is org.springframework.core.convert.ConversionFailedException: 
Failed to convert from type [java.lang.String] to type [java.util.Date] for value '2017-01-05 12:45:32'; 
nested exception is java.lang.IllegalArgumentException
 

【報錯原因】：

 ajax使用json字串將日期字串傳送到後臺介面，後臺無法將字串轉為日期型別，缺少轉換器；

【解決方法】：

 增加日期型別轉換器，方式有四種：

第一種：在Bean實體欄位或引數上增加@DateTimeFormat註解

@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date createdDate;

第二種：在接收引數的的Controller中增加@InitBinder轉化方法

@InitBinder
protected void initBinder(WebDataBinder binder) {
   SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
   binder.registerCustomEditor(Date.class, new CustomDateEditor(dateFormat, true));
}

【*】此種方式只對當前controller起作用

第三種：配置全域性的日期轉換器

/**
 * 轉換解析器
 * @author wangqingguo 2017/9/25
 */
@Configuration
public class MappingConverterAdapter {
    /***
     * 日期引數接收轉換器，將json字串轉為日期型別
     * @return
     */
    @Bean
    public Converter<String, Date> DateConvert() {
        return new Converter<String, Date>() {
            @Override
            public Date convert(String source) {
                SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
                Date date = null;
                try {
                    date = sdf.parse((String) source);
                } catch (Exception e) {
                    e.printStackTrace();
                }
                return date;
            }
        };
    }
}

【*】此處定義的dateConvert用來轉換Date型別，如果是LocalDate、LocalDateTime型別，則將Date
型別換成相應的型別即可，注意java8的日期型別需要用Formatter格式化：

/**
 * 轉換解析器
 * @author wangqingguo 2017/9/25
 */
@Configuration
public class MappingConverterAdapter {
    /***
     * 日期引數接收轉換器，將json字串轉為日期型別
     * @return
     */
   @Bean
    public Converter<String, LocalDateTime> LocalDateTimeConvert() {
        return new Converter<String, LocalDateTime>() {
            @Override
            public LocalDateTime convert(String source) {

                DateTimeFormatter df = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
                LocalDateTime date = null;
                try {
                    date = LocalDateTime.parse((String) source,df);
                } catch (Exception e) {
                    e.printStackTrace();
                }
                return date;
            }
        };
    }
}

第四種：配置Formatter日期轉換器

/**
 * 日期轉換器
 * @author LiMeng 2017/11/7
 */
@Configuration
public class DateConfig {
    /***
     * Date日期型別轉換器
     * @return
     */
    @Bean
    public Formatter<Date> dateFormatter() {
        return new Formatter<Date>() {

            @Override
            public Date parse(String text, Locale locale) throws ParseException {
                SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
                Date date = null;
                try {
                    date = sdf.parse(text);
                } catch (Exception e) {
                    e.printStackTrace();
                }
                return date;
            }

            @Override
            public String print(Date object, Locale locale) {
                SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
                return sdf.format(object);
            }
        };
    }
}

【*】如果是LocalDate、LocalDateTime型別，則將Date型別換成相應的型別即可，
注意java8的日期型別需要用Formatter格式化：

/**
 * 日期轉換器
 * @author LiMeng 2017/11/7
 */
@Configuration
public class DateConfig {
    /***
     * Date日期型別轉換器
     * @return
     */
    @Bean
    public Formatter<Date> dateFormatter() {
        return new Formatter<Date>() {

            @Override
            public Date parse(String text, Locale locale) throws ParseException {
                SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
                Date date = null;
                try {
                    date = sdf.parse(text);
                } catch (Exception e) {
                    e.printStackTrace();
                }
                return date;
            }

            @Override
            public String print(Date object, Locale locale) {
                SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
                return sdf.format(object);
            }
        };
    }
    @Bean
    public Formatter<LocalDate> localDateFormatter() {
        return new Formatter<LocalDate>() {
            @Override
            public LocalDate parse(String text, Locale locale) throws ParseException {
                return LocalDate.parse(text, DateTimeFormatter.ISO_LOCAL_DATE);
            }

            @Override
            public String print(LocalDate object, Locale locale) {
                return DateTimeFormatter.ISO_LOCAL_DATE.format(object);
            }
        };
    }

    @Bean
    public Formatter<LocalDateTime> localDateTimeFormatter() {
        return new Formatter<LocalDateTime>() {
            @Override
            public String print(LocalDateTime localDateTime, Locale locale) {
                DateTimeFormatter formatter=DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
                return formatter.format(localDateTime);
            }

            @Override
            public LocalDateTime parse(String text, Locale locale) throws ParseException {
                DateTimeFormatter formatter=DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
                return LocalDateTime.parse(text, DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
            }
        };
    }
}

OK，啟動系統，可以正常訪問，但這時發現後臺返回前臺的資料為：
{"id":1234,"name":"名稱","path":"路徑","createdDate":1483545600000}

發現後臺可以正常接收日期型別，但返回後前臺接收的日期成了時間戳；理想情況下前臺接收到時間的格式化字串資料；
之所以出現這個問題，是因為專案沒有對返回的JSON進行處理解析；

【報錯原因】：
 java中的日期型別，在轉為JSON字串時沒有進行日期格式化；

【解決方法】：

解決方式有以下幾種

第一種：在Bean實體屬性增加 @JsonFormat註解

    @JsonFormat( pattern = "yyyy-MM-dd HH:mm:ss",timezone="GMT+8")
    private Date createdDate;
    @JsonFormat( pattern = "yyyy-MM-dd HH:mm:ss")
    private LocalDateTime createdTime;

【*】注：Date型別的使用註解 會出現事件相差8小時的情況，需要設定timezone屬性指定時區；LocalDateTime型別沒有發現此問題，所以沒有加此屬性；

另外LocalDateTime只加此註解，還是無法解析，需要增加jackson-datatype-jsr310jar包才管用

compile group: 'com.fasterxml.jackson.datatype', name: 'jackson-datatype-jsr310', version: '2.9.3'

第二種：增加MappingJackson2HttpMessageConverterAdapter 轉換器，對日期型別進行格式化轉換：

/**
 * JSON解析器
 * @author wangqingguo 2017/9/25
 */
@Configuration
public class MappingJackson2HttpMessageConverterAdapter {

    /***
     * 配置JSON解析器內容
     * @return
     */
    @Bean
    public MappingJackson2HttpMessageConverter mappingJackson2HttpMessageConverter() {
        MappingJackson2HttpMessageConverter a= new MappingJackson2HttpMessageConverter();
        /***
         * 頭格式
         */
        List<MediaType> supportedMediaTypes=new ArrayList<>();
        supportedMediaTypes.add(MediaType.APPLICATION_JSON_UTF8);
        supportedMediaTypes.add(MediaType.TEXT_HTML);
        supportedMediaTypes.add(MediaType.TEXT_PLAIN);
        a.setSupportedMediaTypes(supportedMediaTypes);

        /***
         * 日期格式化,解決返回的日期型別格式化
         */
        ObjectMapper objectMapper = a.getObjectMapper();
        DateFormat dateFormat=new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        objectMapper.setDateFormat(dateFormat);
        a.setObjectMapper(objectMapper);


        return a;
    }
}

【*】注：此種方式只對Date型別起作用，Java8的LocalDateTime型別不起作用，LocalDateTime型別還是需要用@JsonFormat註解的形式；

文章為本人測試後所寫，歡迎各位留言交流，如有不對請指正，歡迎大家留言