Hoje, \u00e9 muito comum frameworks configur\u00e1veis atrav\u00e9s de annotations. O Spring tamb\u00e9m possui esse estilo de configura\u00e7\u00e3o que \u00e9 bastante pr\u00e1tico e traz produtividade ao desenvolvimento. Voc\u00ea poder\u00e1 inclusive misturar configura\u00e7\u00e3o via XML e Annotations e utilizar qual for mais adequada para cada situa\u00e7\u00e3o. Nesse tutorial mostraremos como a configura\u00e7\u00e3o pode ser feita atrav\u00e9s de annotations e ainda como pode ser feita a detec\u00e7\u00e3o autom\u00e1tica dos beans atrav\u00e9s do classpath scanning.<\/p>\n
<\/p>\n
<\/p>\n
Esse tutorial \u00e9 continua\u00e7\u00e3o do Hello World com Spring 3 para um projeto WEB<\/a>, se ainda n\u00e3o tem um projeto Spring configurado, \u00e9 recomend\u00e1vel ler o outro tutorial antes de prosseguir com esse. Algumas anota\u00e7\u00f5es utilizadas nesse cap\u00edtulo necessitam JEE 5 (como @PostConstruct).<\/p>\n Vamos come\u00e7ar configurando beans com Annotations, ao inv\u00e9s de usar a configura\u00e7\u00e3o de XML. Como \u00e9 poss\u00edvel utilizar as duas configura\u00e7\u00f5es simultaneamente, a configura\u00e7\u00e3o feita atrav\u00e9s de Annotations \u00e9 processada antes da configura\u00e7\u00e3o via XML. A configura\u00e7\u00e3o em XML pode ent\u00e3o sobrescrever a configura\u00e7\u00e3o feita com Annotations.<\/p>\n Para habilitar a configura\u00e7\u00e3o dos beans via annotations, basta adicionar uma tag context:annotation-config no seu arquivo applicationContext.xml (Note a inclus\u00e3o do namespace context<\/em>)<\/p>\n <?xml version="1.0" encoding="UTF-8"?> <context:annotation-config\/> Com essa tag, ser\u00e1 poss\u00edvel fazer a configura\u00e7\u00e3o dos beans por Annotations.<\/p>\n Vejamos as anota\u00e7\u00f5es (alguns dos exemplos mostrados foram retirados da documenta\u00e7\u00e3o do Spring):<\/p>\n A anota\u00e7\u00e3o @Required \u00e9 utilizada nos setters das propriedades do bean, veja o exemplo:<\/p>\n public class<\/strong> SimpleMovieLister { <\/p>\n private<\/strong> MovieFinder movieFinder; <\/p>\n @Required Essa anota\u00e7\u00e3o indica que essa propriedade deve ser populada na configura\u00e7\u00e3o. Caso n\u00e3o haja configura\u00e7\u00e3o para essa propriedade uma exce\u00e7\u00e3o ser\u00e1 lan\u00e7ada pelo container.<\/p>\n Como esperado, voc\u00ea pode utilizar a anota\u00e7\u00e3o @Autowired em m\u00e9todos setter. Se estiver utilizando um JAR para o JSR-330 (Inje\u00e7\u00e3o de dependencia) poder\u00e1 utilizar a anota\u00e7\u00e3o @Inject. O Spring detecta se o JAR est\u00e1 presente automaticamente. A anota\u00e7\u00e3o @Autowired faz a configura\u00e7\u00e3o da propriedade de forma autom\u00e1tica, buscando na f\u00e1brica do Spring algum bean que possa satisfazer a dependencia e ent\u00e3o realizando a configura\u00e7\u00e3o.<\/p>\n public class<\/strong> SimpleMovieLister { Propriedade anotadas com @Autowired devem ser obrigatoriamente preenchidas. Voc\u00ea pode alterar esse comportamento atrav\u00e9s do atributo required, como @Autowired(required=false). A anota\u00e7\u00e3o @Inject n\u00e3o tem a mesma defini\u00e7\u00e3o, sendo o preenchimento opicional. <\/p>\n Tamb\u00e9m \u00e9 poss\u00edvel utilizar essa anota\u00e7\u00e3o em m\u00e9todos com nomes aleat\u00f3rios e com v\u00e1rios argumentos:<\/p>\n public class<\/strong> MovieRecommender { Voc\u00ea pode usar o @Autowired em construtores e campos:<\/p>\n public class<\/strong> MovieRecommender { A anota\u00e7\u00e3o @Value \u00e9 utilizada quando temos propriedades que n\u00e3o s\u00e3o outros beans exemplo:<\/p>\n public class<\/strong> MovieCatalog { }<\/font><\/p>\n As anota\u00e7\u00f5es @PostContruct e @PreDestroy servem para anotar m\u00e9todos que devem ser chamados quando o container for iniciado e destruido respectivamente. \u00c9 necess\u00e1rio ter um JAR do JSR-250 para ter dispon\u00edveis essas anota\u00e7\u00f5es. Se n\u00e3o tiver esse JAR dispon\u00edvel uma alternativa \u00e9 utilizar os atributos init-method e destroy-method na defini\u00e7\u00e3o do bean no XML do Spring. Ou o bean implementar as interfaces InitializingBean e DisposeableBean.<\/p>\n Utilizando uma aplica\u00e7\u00e3o que j\u00e1 esteja configurada com o Spring, vamos criar dois beans e utilizar a inje\u00e7\u00e3o de depend\u00eancia atrav\u00e9s de annotations. Crie duas classes conforme o exemplo:<\/p>\n package<\/strong> org.javaframework.spring; <\/font><\/p>\n import<\/strong> javax.annotation.PostConstruct; <\/font><\/p>\n import<\/strong> org.springframework.beans.factory.annotation.Autowired; <\/p>\n public class<\/strong> MostraInformacoesSistema { <\/font><\/p>\n @Autowired<\/font><\/strong> @PostConstruct<\/font><\/strong> package<\/strong> org.javaframework.spring; <\/font><\/font><\/p>\n import<\/strong> org.springframework.beans.factory.annotation.Value; <\/p>\n public class<\/strong> Sistema { <\/font><\/font><\/p>\n @Value("Spring com annotations")<\/font><\/strong> @Value("1.0")<\/font><\/strong> public<\/strong> String getNome() { A classe Sistema servir\u00e1 para guardarmos algumas informa\u00e7\u00f5es que ser\u00e3o mostradas pela classe MostraInformacoesSistema. Foi utilizada a anota\u00e7\u00e3o @Autowired no atributo sistema da classe MostraInformacoesSistema, isso indica para o Spring fazer a configura\u00e7\u00e3o dessa propriedade automaticamente. A anota\u00e7\u00e3o @PostConstruct far\u00e1 com que o m\u00e9todo mostraInformacoes seja chamado assim que o bean esteja completamente configurado. <\/p>\n Agora vamos configurar o XML do Spring para ler essas anota\u00e7\u00f5es e fazer a configura\u00e7\u00e3o, configure seu arquivo applicationContext.cml conforme o exemplo:<\/p>\n <?xml version="1.0" encoding="UTF-8"?> <context:annotation-config\/> <\/p>\n <bean class="org.javaframework.spring.MostraInformacoesSistema"\/> <\/p>\n <bean class="org.javaframework.spring.Sistema\u201d\/> <\/p>\n <\/beans><\/p>\n Declaramos um bean da classe MostraInformacoesSistema e outro da classe Sistema. O Spring ir\u00e1 fazer a inje\u00e7\u00e3o do objeto Sistema no objeto MostraInformacoesSistema, gra\u00e7as a anota\u00e7\u00e3o @Autowired que utilizamos. <\/p>\n Ao testar a aplica\u00e7\u00e3o ser\u00e1 impresso no console: Sistema: Spring com annotations, vers\u00e3o: 1.0<\/em><\/p>\n Outras informa\u00e7\u00f5es sobre a configura\u00e7\u00e3o por anota\u00e7\u00f5es, assim como outras anota\u00e7\u00f5es dispon\u00edveis, podem ser vistas na documenta\u00e7\u00e3o do Spring, se\u00e7\u00e3o 3.9 Annotation-based container configuration<\/a>.<\/p>\n Fizemos a configura\u00e7\u00e3o do bean por annotations, mas ainda precisamos declarar o bean no XML. Isso porque a tag context:annotation-config apenas l\u00ea as anota\u00e7\u00f5es e faz a configura\u00e7\u00e3o, mas n\u00e3o implica em detectar as classes automaticamente. Para isso precisamos de outra tag, que ser\u00e1 mostrada a seguir.<\/p>\n Classpath scanning \u00e9 um recurso do Spring que l\u00ea o classpath da aplica\u00e7\u00e3o e busca classes que possam ser configuradas, isso evita que voc\u00ea tenha que declarar essas classes no XML. Essas classes s\u00e3o passadas por um filtro e ent\u00e3o uma defini\u00e7\u00e3o de um bean \u00e9 criada para elas. Geralemente esse filtro \u00e9 alguma anota\u00e7\u00e3o que marca que determinada classe deve ser utilizada como um componente. Essas anota\u00e7\u00f5es s\u00e3o: @Component, @Service, @Controller e @Repository (que foi introduzida no Spring 2.0). Voc\u00ea pode tamb\u00e9m criar suas pr\u00f3prias anota\u00e7\u00f5es e filtros para declarar os componentes.<\/p>\n A anota\u00e7\u00e3o @Component \u00e9 um tipo gen\u00e9rico para qualquer bean que deve ser gerenciado pelo Spring. @Repository, @Service e @Controller s\u00e3o especializa\u00e7\u00f5es de @Component e servem para as camadas de persistencia, servi\u00e7o e apresenta\u00e7\u00e3o respectivamente. Voc\u00ea pode utilizar @Component para qualquer classe da sua aplica\u00e7\u00e3o, mas utilizar uma anota\u00e7\u00e3o mais espec\u00edfica ajuda caso deseje criar um filtro, utilizar ferramentas, ou orienta\u00e7\u00e3o a aspectos. Funcionalmente todas as anota\u00e7\u00f5es servem para declarar beans, n\u00e3o existe diferen\u00e7a entre elas a n\u00e3o ser na quest\u00e3o de organiza\u00e7\u00e3o da apliaca\u00e7\u00e3o e utilidades citadas anteriormente.<\/p>\n Para detectar as classes e gerar beans precisamos de uma outra tag no applicationContext.xml<\/p>\n <?xml version="1.0" encoding="UTF-8"?> <context:component-scan base-package="org.javaframework"\/> <\/p>\n <\/beans><\/p>\n Essa tag ir\u00e1 indicar ao Spring para procurar as classes e fazer a configura\u00e7\u00e3o dos beans. O atributo base-package indica em qual pacote as classes devem ser lidas, podem ser especificados quantos pacotes desejar, separados por v\u00edrgula. <\/p>\n Com essa tag, podemos alterar o applicationContext.xml da aplica\u00e7\u00e3o exemplo que criamos, retirando as declara\u00e7\u00f5es dos beans. O arquivo applicationContext.xml fica da seguinte forma:<\/p>\n <?xml version="1.0" encoding="UTF-8"?> <context:annotation-config\/> <\/beans><\/p>\n As classes devem ter alguma anota\u00e7\u00e3o que indique que s\u00e3o componentes, utilizamos a anota\u00e7\u00e3o @Service<\/p>\n package<\/strong> org.javaframework.spring; <\/font><\/p>\n import<\/strong> javax.annotation.PostConstruct; <\/font><\/p>\n import<\/strong> org.springframework.beans.factory.annotation.Autowired; @Service @Autowired @PostConstruct package<\/strong> org.javaframework.spring; <\/font><\/p>\n import<\/strong> org.springframework.beans.factory.annotation.Value; @Service<\/font><\/strong> @Value("Spring com annotations") @Value("1.0") public<\/strong> String getNome() { Agora, basta criar as classes e utilizar as anota\u00e7\u00f5es para fazer a configura\u00e7\u00e3o, contando que as classes estejam no pacote definido em base-package elas ser\u00e3o detectadas e configuradas automaticamente, sem a necessidade de interven\u00e7\u00e3o no XML de configura\u00e7\u00e3o do Spring.<\/p>\n1. Configurando os beans com annotations<\/h3>\n
<beans xmlns="<\/font>http:\/\/www.springframework.org\/schema\/beans"<\/font><\/a>
xmlns:xsi="<\/font>http:\/\/www.w3.org\/2001\/XMLSchema-instance"<\/font><\/a>
xmlns:context="<\/u><\/font>http:\/\/www.springframework.org\/schema\/context"<\/u><\/font><\/a>
xsi:schemaLocation="<\/font>http:\/\/www.springframework.org\/schema\/beans<\/font><\/a>
<\/font>http:\/\/www.springframework.org\/schema\/beans\/spring-beans-3.0.xsd<\/font><\/a>
http:\/\/www.springframework.org\/schema\/context<\/u><\/font><\/a>
http:\/\/www.springframework.org\/schema\/context\/spring-context-3.0.xsd<\/u>"<\/font><\/a>> <\/p>\n
<\/font>
<\/beans><\/font><\/p>\n@Required<\/h5>\n
public void<\/strong> setMovieFinder(MovieFinder movieFinder) {
this<\/strong>.movieFinder = movieFinder;
}
\/\/ …
}<\/font><\/p>\n@Autowired e @Inject<\/h5>\n
private<\/strong> MovieFinder movieFinder;
@Autowired
public void<\/strong> setMovieFinder(MovieFinder movieFinder) {
this<\/strong>.movieFinder = movieFinder;
}
\/\/ …
}<\/font><\/p>\n
private<\/strong> MovieCatalog movieCatalog;
private<\/strong> CustomerPreferenceDao customerPreferenceDao;
@Autowired
public void<\/strong> prepare(MovieCatalog movieCatalog, CustomerPreferenceDao customerPreferenceDao) {
this<\/strong>.movieCatalog = movieCatalog;
this<\/strong>.customerPreferenceDao = customerPreferenceDao;
}
\/\/ …
}<\/font><\/font><\/p>\n
@Autowired
private<\/strong> MovieCatalog movieCatalog;
private<\/strong> CustomerPreferenceDao customerPreferenceDao;
@Autowired
public<\/strong> MovieRecommender(CustomerPreferenceDao customerPreferenceDao) {
this<\/strong>.customerPreferenceDao = customerPreferenceDao;
}
\/\/ …
}<\/font><\/font><\/p>\n@Value<\/h5>\n
@Value(\u201cComedy\u201d)
String name;<\/font><\/font><\/p>\n@PostConstruct e @PreDestroy<\/h5>\n
2. Contruindo uma aplica\u00e7\u00e3o utilizando Annotations<\/h3>\n
Sistema sistema; <\/p>\n
public void<\/strong> mostraInformacoes(){
System.out.println("Sistema: "+sistema.getNome()+
", vers\u00e3o: "+sistema.getVersao());
}
}<\/font><\/p>\n<\/p>\n
String nome; <\/p>\n
String versao; <\/p>\n
return<\/strong> nome;
}
public<\/strong> String getVersao() {
return<\/strong> versao;
}
public void<\/strong> setNome(String nome) {
this.nome = nome;
}
public void<\/strong> setVersao(String telefone) {
this.versao = telefone;
}
}<\/font><\/p>\n
<beans xmlns="http:\/\/www.springframework.org\/schema\/beans"<\/a>
xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance"<\/a>
xmlns:context="http:\/\/www.springframework.org\/schema\/context"<\/a>
xsi:schemaLocation="http:\/\/www.springframework.org\/schema\/beans<\/a>
http:\/\/www.springframework.org\/schema\/beans\/spring-beans-3.0.xsd<\/a>
http:\/\/www.springframework.org\/schema\/context<\/a>
http:\/\/www.springframework.org\/schema\/context\/spring-context-3.0.xsd"<\/a>> <\/p>\n3. Classpath scanning<\/h3>\n
<beans xmlns="http:\/\/www.springframework.org\/schema\/beans"<\/a>
xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance"<\/a>
xmlns:context="http:\/\/www.springframework.org\/schema\/context"<\/a>
xsi:schemaLocation="http:\/\/www.springframework.org\/schema\/beans<\/a>
http:\/\/www.springframework.org\/schema\/beans\/spring-beans-3.0.xsd<\/a>
http:\/\/www.springframework.org\/schema\/context<\/a>
http:\/\/www.springframework.org\/schema\/context\/spring-context-3.0.xsd"<\/a>> <\/p>\n
<beans xmlns="http:\/\/www.springframework.org\/schema\/beans"<\/a>
xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance"<\/a>
xmlns:context="http:\/\/www.springframework.org\/schema\/context"<\/a>
xsi:schemaLocation="http:\/\/www.springframework.org\/schema\/beans<\/a>
http:\/\/www.springframework.org\/schema\/beans\/spring-beans-3.0.xsd<\/a>
http:\/\/www.springframework.org\/schema\/context<\/a>
http:\/\/www.springframework.org\/schema\/context\/spring-context-3.0.xsd"<\/a>> <\/p>\n
<context:component-scan base-package="org.javaframework"\/> <\/p>\n
import<\/strong> org.springframework.stereotype.Service; <\/font><\/p>\n
<\/font>public class<\/strong> MostraInformacoesSistema { <\/font><\/font><\/p>\n
Sistema sistema; <\/p>\n
public void<\/strong> mostraInformacoes(){
System.out.println("Sistema: "+sistema.getNome()
<\/font>+", vers\u00e3o: "+sistema.getVersao());
}
}<\/font><\/p>\n
import<\/strong> org.springframework.stereotype.Service; <\/font><\/p>\n
public class<\/strong> Sistema { <\/font><\/font><\/p>\n
String nome; <\/p>\n
String versao; <\/p>\n
return nome;
}
public<\/strong> String getVersao() {
return versao;
}
public void<\/strong> setNome(String nome) {
this.nome = nome;
}
public void<\/strong> setVersao(String telefone) {
this.versao = telefone;
}
}<\/font><\/p>\n