Spring的JavaConfig註解

傳統spring通常都是基於xml配置的,不事後來新增了許多JavaConfig的註解。特別是springboot,基本都是清一色的java config,不瞭解一下,還真是不適應。這裏備註一下。java

@RestController

spring4爲了更方便的支持restfull應用的開發,新增了RestController的註解,比Controller註解多的功能就是給底下的RequestMapping方法默認都加上ResponseBody註解,免得本身再去每一個去添加該註解。spring

@Configuration

這個標註該類是spring的配置類,自己自帶Component註解springboot

@ImportResource

對應的xml

<import resource="applicationContext-ehcache.xml"/>

存在的必要性

這個是兼容傳統xml配置的,畢竟JavaConfig還不是萬能的,好比JavaConfig不能很好地支持aop:advisor和tx:adviceIntroduce @EnableAspectJAutoProxy (equivalent to aop:aspectj-autoproxy)Introduce @Configuration-based equivalent to aop:config XML elementrestful

@ComponentScan

對應的xmlmybatis

<context:component-scan base-package="com.xixicat.app"/>

該配置自動包含了以下配置的功能:mvc

<context:annotation-config/>

就是向Spring容器註冊AutowiredAnnotationBeanPostProcessor(使用@Autowired必須註冊)、CommonAnnotationBeanPostProcessor(使用@Resource 、@PostConstruct、@PreDestroy等必須註冊)、PersistenceAnnotationBeanPostProcessor(使用@PersistenceContext必須註冊) 以及RequiredAnnotationBeanPostProcessor(使用@Required必須註冊)這4個BeanPostProcessor。
值得注意的是Spring3.1RC2版本以前是不容許註解Configuration的類在ComponentScan指定的包範圍內的,不然會報錯。app

@Bean

對應的xml以下:ide

<bean id="objectMapper" class="org.codehaus.jackson.map.ObjectMapper" />

@EnableWebMvc

對應的xml以下:post

<mvc:annotation-driven />

該配置自動註冊DefaultAnnotationHandlerMapping(來註冊handler method和request的mapping關係)與AnnotationMethodHandlerAdapter(在實際調用handler method前對其參數進行處理)兩個bean,以支持@Controller註解的使用。
主要的做用以下:測試

  • 可配置的ConversionService(方便進行自定義類型轉換)

  • 支持用@NumberFormat格式化數字類型字段

  • 支持用@DateTimeFormat格式化Date,Calendar以及Joda Time字段(若是classpath有Joda Time的話)

  • 支持@Valid的參數校驗(若是JSR-303相關provider有在classpath的話)

  • 支持@RequestBody/@ResponseBody註解的XML讀寫(若是JAXB在classpath的話)

  • 支持@RequestBody/@ResponseBody註解的JSON讀寫(若是Jackson在classpath的話)

@ContextConfiguration

主要在junit測試時指定java config

@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration({
    "classpath*:spring/*.xml",
    "classpath:applicationContext.xml",
    "classpath:applicationContext-rabbitmq.xml",
    "classpath:applicationContext-mail.xml",
    "classpath:applicationContext-medis.xml",
    "classpath:applicationContext-mybatis.xml"})
@TransactionConfiguration(transactionManager = "mybatisTransactionManager", defaultRollback = false)
public class AppBaseTest {
   //......
}

@ResponseStatus

主要是rest開發用,註解返回的http返回碼,具體值看org.springframework.http.HttpStatus枚舉。通常post方法返回HttpStatus.CREATED,DELETE和PUT方法返回HttpStatus.OK。還能夠配置異常處理,見@ExceptionHandler和@ControllerAdvice

@ExceptionHandler

主要用來處理指定的異常,返回返回指定的HTTP狀態碼,免得每一個controller的方法本身去try catch。通常能夠爲每一個應用定義一個異常基類,而後再定義業務異常,這樣這裏就能夠統一捕獲業務異常。

@ExceptionHandler(BizException.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    public @ResponseBody
    ReturnMessage bizExceptionHandler(Exception ex) {
        logger.error(ex.getMessage(),ex);
        return new ReturnMessage(HttpStatus.BAD_REQUEST.value(),ex.getMessage());
    }

不過值得注意的是這種方法僅限於controller的方法調用鏈產生的異常,若是在spring裏頭還使用了定時任務啥的,該註解是不會攔截到的。

@ControllerAdvice

配合@ExceptionHandler使用的,用來攔截controller的方法。

@ControllerAdvice
public class ErrorController {

    private static final Logger logger = LoggerFactory.getLogger(ErrorController.class);


    @ExceptionHandler(BizException.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    public @ResponseBody
    ReturnMessage bizExceptionHandler(Exception ex) {
        logger.error(ex.getMessage(),ex);
        return new ReturnMessage(HttpStatus.BAD_REQUEST.value(),ex.getMessage());
    }

    @ExceptionHandler(Exception.class)
    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
    public @ResponseBody
    ReturnMessage serverExceptionHandler(Exception ex) {
        logger.error(ex.getMessage(),ex);
        return new ReturnMessage(HttpStatus.INTERNAL_SERVER_ERROR.value(),ex.getMessage());
    }
}
相關文章
相關標籤/搜索