JBoss Enterprise Application Platform 6.2 Guia de Migração

Transcrição

JBoss Enterprise Application
Platform 6.2
Guia de Migração
Para uso com o JBoss Enterprise Application Platform 6
Sande Gilda
Misty Stanley-Jones
Darrin Mison
Tom Wells
David Ryan
JBoss Enterprise Application Platform 6.2 Guia de Migração
Para uso com o JBoss Enterprise Application Platform 6
Sande Gilda
Darrin Miso n
David Ryan
Misty Stanley-Jo nes
[email protected] m
To m Wells
[email protected] m
Nota Legal
Co pyright © 20 14 Red Hat, Inc..
This do cument is licensed by Red Hat under the Creative Co mmo ns Attributio n-ShareAlike 3.0
Unpo rted License. If yo u distribute this do cument, o r a mo dified versio n o f it, yo u must pro vide
attributio n to Red Hat, Inc. and pro vide a link to the o riginal. If the do cument is mo dified, all Red
Hat trademarks must be remo ved.
Red Hat, as the licenso r o f this do cument, waives the right to enfo rce, and agrees no t to assert,
Sectio n 4 d o f CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shado wman lo go , JBo ss, MetaMatrix, Fedo ra, the Infinity
Lo go , and RHCE are trademarks o f Red Hat, Inc., registered in the United States and o ther
co untries.
Linux ® is the registered trademark o f Linus To rvalds in the United States and o ther co untries.
Java ® is a registered trademark o f Oracle and/o r its affiliates.
XFS ® is a trademark o f Silico n Graphics Internatio nal Co rp. o r its subsidiaries in the United
States and/o r o ther co untries.
MySQL ® is a registered trademark o f MySQL AB in the United States, the Euro pean Unio n and
o ther co untries.
No de.js ® is an o fficial trademark o f Jo yent. Red Hat So ftware Co llectio ns is no t fo rmally
related to o r endo rsed by the o fficial Jo yent No de.js o pen so urce o r co mmercial pro ject.
The OpenStack ® Wo rd Mark and OpenStack Lo go are either registered trademarks/service
marks o r trademarks/service marks o f the OpenStack Fo undatio n, in the United States and o ther
co untries and are used with the OpenStack Fo undatio n's permissio n. We are no t affiliated with,
endo rsed o r spo nso red by the OpenStack Fo undatio n, o r the OpenStack co mmunity.
All o ther trademarks are the pro perty o f their respective o wners.
Resumo
Este livro é um guia para migração de seu aplicativo a partir de versõ es anterio res do Red Hat
JBo ss Enterprise Applicatio n Platfo rm.
Índice
Índice
.Prefácio
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4. . . . . . . . . .
⁠1. Co nvenç õ es d e Do c umento s
4
⁠1.1. Co nvenç õ es Tip o g ráfic as
4
⁠1.2. Co nvenç õ es d e Pull-Q uo te
5
⁠1.3. No tas e Avis o s
6
⁠2 . O b tend o Ajud a e Fo rnec end o Co mentário s
6
⁠2 .1. Vo c ê p rec is a d e ajud a?
7
⁠2 .2. Nó s p rec is amo s d o s eu Co mentário !
7
. .apít
⁠C
. . . ulo
...1
. .. .Int
. . rodução
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8. . . . . . . . . .
⁠1.1. Red Hat JBo s s Enterp ris e Ap p lic atio n Platfo rm 6 (JBo s s EAP 6 )
8
⁠1.2. G uia d a Mig raç ão
8
. .apít
⁠C
. . . ulo
...2
. .. .Preparação
. . . . . . . . . .para
. . . . a. .Migração
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9. . . . . . . . . .
⁠2 .1. Prep araç ão p ara a Mig raç ão
⁠2 .2. Revis ão d as no vid ad es no JBo s s EAP 6
⁠2 .3. Revis ão d a Lis ta d e Rec urs o s Sub s tituíd o s e não Sup o rtad o s
9
9
11
. .apít
⁠C
. . . ulo
. . . 3.
. . Migre
. . . . . .seu
. . . Aplicat
. . . . . . .ivo
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. 2. . . . . . . . . .
⁠3 .1. Alteraç õ es Req uerid as p ara a maio ria d o s Ap lic ativo s
12
⁠3 .1.1. Revis ão d as Alteraç õ es Req uerid as p ara a Maio ria d o s Ap lic ativo s
12
⁠3 .1.2. Alteraç õ es d o Carreg amento d e Clas s e
12
⁠3 .1.2.1. Atualiz aç ão d o Ap lic ativo d evid o às Alteraç õ es d o Carreg amento d a Clas s e
12
⁠3 .1.2.2. Co mp reend end o as Dep end ênc ias d o Mó d ulo
12
⁠3 .1.2.3. Atualiz aç ão d as Dep end ênc ias d o Ap lic ativo d evid o às Alteraç õ es d o Carreg amento d a
Clas s e
13
⁠3 .1.3. Alteraç õ es d o Arq uivo d e Co nfig uraç ão
14
⁠3 .1.3.1. Criaç ão o u Mo d ific aç ão d o s Arq uivo s q ue c o ntro lam o Co ntro le d e Carreg amento d a
Clas s e no JBo s s EAP 6
14
⁠3 .1.3.2. jb o s s -d ep lo yment-s truc ture.xml
18
⁠3 .1.3.3. Rec urs o s d e Pac o te p ara o No vo Sis tema d e Carreg amento d e Clas s e Mo d ular
18
⁠3 .1.3.4. Alteraç ão d a Lo c aliz aç ão d as Pro p ried ad es Res o urc eBund le
18
⁠3 .1.3.5. Criaç ão d e um Mó d ulo Pers o naliz ad o
19
⁠3 .1.4. Alteraç õ es d o Reg is tro em Lo g
20
⁠3 .1.4.1. Mo d ific aç ão d as Dep end ênc ias d e Reg is tro em Lo g
21
⁠3 .1.4.2. Atualiz aç ão d o Có d ig o d o Ap lic ativo p ara Framewo rks d e Reg is tro d e Lo g d e
Terc eiro s
21
⁠3 .1.4.3. Mo d ific aç ão d o Có d ig o p ara Us o d o No vo Framewo rk d e Reg is tro d e Lo g d o JBo s s
22
⁠3 .1.5. Alteraç õ es d o Emp ac o tamento d o Ap lic ativo
22
⁠3 .1.5.1. Mo d ific aç ão d o Emp ac o tamento d o s EARS e WARs
22
⁠3 .1.6 . Alteraç õ es d a Co nfig uraç ão d o Ad ap tad o r d e Rec urs o e Fo nte d e Dad o s
23
⁠3 .1.6 .1. Atualiz aç ão d o Ap lic ativo d evid o às Alteraç õ es d a Co nfig uraç ão
23
⁠3 .1.6 .2. Atualiz aç ão d a Co nfig uraç ão d a Fo nte d e Dad o s
24
⁠3 .1.6 .3. Ins talaç ão e Co nfig uraç ão d o JDBC Driver
25
⁠3 .1.6 .4. Co nfig uraç ão d a Fo nte d e Dad o s p ara o Hib ernate o u JPA
29
⁠3 .1.6 .5. Atualiz aç ão d a Co nfig uraç ão d o Ad ap tad o r d e Rec urs o
30
⁠3 .1.7. Alteraç õ es d e Seg uranç a
31
⁠3 .1.7.1. Co nfig uraç ão d as Alteraç õ es d e Seg uranç a d o Ap lic ativo
31
⁠3 .1.8 . Alteraç õ es JNDI
32
⁠3 .1.8 .1. Atualiz aç ão d o s No mes JNDI Names p ac e d o Ap lic ativo
32
⁠3 .1.8 .2. No mes d o EJB JNDI Po rtátil
33
⁠3 .1.8 .3. Revis ão d as Reg ras JNDI Names p ac e
33
1
JBoss Ent erprise Applicat ion Plat form 6 .2 G uia de Migração
⁠3 .1.8 .3. Revis ão d as Reg ras JNDI Names p ac e
33
⁠3 .1.8 .4. Mo d ific aç ão d o Ap lic ativo p ara Seg uir as No vas Reg ras d o JNDI Names p ac e (Es p aç o
d o No me JNDI)
34
⁠3 .1.8 .5. Amo s tra d o JNDI Names p ac es no s Lanç amento s Anterio res e c o mo s ão es p ec ific ad o s
no JBo s s EAP 6
35
⁠3 .2. As Alteraç õ es Dep end em no s Co mp o nentes e na s ua Arq uitetura d o Ap lic ativo
36
⁠3 .2.1. Revis ão d as Alteraç õ es Dep end entes em s eus Co mp o nentes e Arq uitetura d o Ap lic ativo
⁠3 .2.2. Alteraç õ es JPA e Hib ernate
37 36
⁠3 .2.2.1. Atualiz aç ão d o s Ap lic ativo s q ue us am Hib ernate e/o u JPA
37
⁠3 .2.2.2. Co nfig uraç ão d as Alteraç õ es p ara Ap lic ativo s q ue us am o Hib ernate e o JPA
37
⁠3 .2.2.3. Pro p ried ad es d a Unid ad e d e Pers is tênc ia
39
⁠3 .2.2.4. Atualiz aç ão d e s eu Ap lic ativo Hib ernate 3 p ara us o d o Hib ernate 4
41
⁠3 .2.2.5. Mantenha o Co mp o rtamento Exis tente d o Valo r G erad o Auto matic amente d a Id entid ad e
Hib ernate
41
⁠3 .2.2.6 . Mig raç ão d e s eu Ap lic ativo Hib ernate 3.3.x p ara o Hib ernate 4.x
42
⁠3 .2.2.7. Mig raç ão d e s eu Ap lic ativo Hib ernate 3.5.x p ara o Hib ernate 4.x
43
⁠3 .2.2.8 . Mo d ific aç ão d as Pro p ried ad es d e Pers is tênc ia p ara o Seam Mig rad o
44
⁠3 .2.2.9 . Atualiz aç ão d e s eu Ap lic ativo p ara fic ar d e ac o rd o c o m a Es p ec ific aç ão JPA 2.0
45
⁠3 .2.2.10 . Sub s tituiç ão d o Cac he d e Seg und o Nível JPA/Hib ernate c o m o Infinis p an
45
⁠3 .2.2.11. Pro p ried ad es d o Cac he Hib ernate
⁠3 .2.2.12. Mig raç ão p ara o Valid ad o r Hib ernate 4
⁠3 .2.3. Alteraç õ es d o JSF
⁠3 .2.3.1. Hab ilitaç ão d e Ap lic ativo s p ara Us o d e Vers õ es Antig as d o JSF
⁠3 .2.4. Alteraç õ es d o s Serviç o s d a Web
49
49
50
⁠ .2.4.1. Alteraç õ es d o s Serviç o s d a Web
3
⁠3 .2.5. Alteraç õ es JAX-RS e RESTEas y
50
52
⁠ .2.5.1. Co nfig uraç ão d as Alteraç õ es JAX-RS e RESTEas y
3
⁠3 .2.6 . Alteraç õ es d o Realm d e Seg uranç a LDAP
52
54
⁠3 .2.6 .1. Co nfig uraç ão d as Alteraç õ es LDAP Sec urity Realm
⁠3 .2.7. Alteraç õ es d o Ho rnetQ
54
55
⁠3 .2.7.1. Ho rnetQ e NFS
⁠3 .2.7.2. Co nfig uraç ão d o JMS Brid g e p ara Mig raç ão d e JMS Mes s ag es Exis tentes ao JBo s s
EAP 6
56
⁠3 .2.7.3. Mig raç ão d e s eu Ap lic ativo p ara us o d o Ho rnetQ c o mo um Pro ved o r JMS
⁠3 .2.7.4. Co nfig uraç ão d e Mens ag ens c o m Ho rnetQ
60
61
55
⁠3 .2.8 . Alteraç õ es d e Clus tering
⁠3 .2.8 .1. Realiz e Alteraç õ es ao s eu Ap lic ativo p ara o Clus tering
62
62
⁠ .2.8 .2. Imp lantaç ão d e um HA Sing leto n
3
⁠3 .2.9 . Alteraç õ es d o Des envo lvimento d o es tilo d e Serviç o
⁠3 .2.9 .1. Atualiz aç ão d o s Ap lic ativo s q ue us am as Imp lantaç õ es d e es tilo d e Serviç o
66
74
74
⁠3 .2.10 . Alteraç õ es d a Invo c aç ão Remo ta
⁠3 .2.10 .1. Mig raç ão d o s Ap lic ativo s Imp lantad o s d o JBo s s EAP 5 q ue realiz a Invo c aç õ es
Remo tas ao JBo s s EAP 6
⁠3 .2.10 .2. Invo c aç ão d o Bean d e Ses s ão Remo ta us and o o JNDI
75
⁠3 .2.11. Alteraç õ es EJB 2.x
⁠3 .2.11.1. Atualiz aç ão d o s Ap lic ativo s q ue us am o EJB 2.x
⁠3 .2.12. Alteraç õ es d o JBo s s AO P
80
80
81
⁠ .2.12.1. Atualiz aç ão d o s Ap lic ativo s q ue us am o JBo s s AO P
3
⁠3 .2.13. Ap lic ativo s Seam 2.2 d e Mig raç ão
81
81
⁠3 .2.13.1. Mig raç ão d o s Arq uivo s Seam 2.2 p ara o JBo s s EAP 6
⁠3 .2.13.2. Pro b lemas d e Mig raç ão d o Seam 2.2 Arc hive
2
47
47
75
77
81
85
⁠3 .2.14. Ap lic ativo s Sp ring d e Mig raç ão
⁠3 .2.14.1. Ap lic ativo s Sp ring d e Mig raç ão
88
88
⁠3 .2.15. O utras Alteraç õ es q ue Afetam a Mig raç ão
⁠3 .2.15.1. O utras alteraç õ es q ue p o d em afetar s ua Mig raç ão
88
88
Índice
⁠3 .2.15.1. O utras alteraç õ es q ue p o d em afetar s ua Mig raç ão
⁠3 .2.15.2. Alteraç ão d o No me Maven Plug -in
88
89
⁠3 .2.15.3. Mo d ific aç ão d o s Ap lic ativo s d o Cliente
89
. .apít
⁠C
. . . ulo
...4
. .. .Ferrament
. . . . . . . . as
. . .e. Dicas
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9. 0. . . . . . . . . .
⁠4 .1. Rec urs o s p ara As s is ti-lo c o m a Mig raç ão
⁠4 .1.1. Rec urs o s q ue p o d em o rientá-lo em s ua Mig raç ão
90
90
⁠4 .1.2. Familiariz e-s e c o m as Ferramentas q ue p o d em o rientá-lo na Mig raç ão
⁠4 .1.3. Us o d o Tattle p ara enc o ntrar Dep end ênc ias d o Ap lic ativo
90
90
⁠4 .1.4. Do wnlo ad e Ins talaç ão d o Tattletale
⁠4 .1.5. Criaç ão e Revis ão d o Relató rio Tattletale
⁠4 .1.6 . Us o d a Ferramenta Iro nJac amar p ara Mig raç ão d a Fo nte d e Dad o s e Co nfig uraç õ es d o
Ad ap tad o r d e Rec urs o
⁠4 .1.7. Do wnlo ad e Ins talaç ão d a Ferramenta d e Mig raç ão Iro nJac amar
91
92
92
93
⁠4 .1.8 . Us o d a Ferramenta d e Mig raç ão Iro nJac amar p ara c o nverter um Arq uivo d e Co nfig uraç ão
d a Fo nte d e Dad o s
94
⁠4 .1.9 . Us o d a Ferramenta Iro nJac amar p ara Co nverter um Arq uivo d e Co nfig uraç ão d o Ad ap tad o r
d e Rec urs o
96
⁠4 .2. Pro b lemas d a Mig raç ão d e Dep uraç ão
10 1
⁠4 .2.1. Dep uraç ão e So luç ão d o s Pro b lemas d e Mig raç ão
⁠4 .2.2. Dep uraç ão e So luç ão d o Clas s No tFo und Exc ep tio ns e No Clas s DefFo und Erro rs
⁠4 .2.3. Bus q ue a Dep end ênc ia d e Mó d ulo d o JBo s s
10 1
10 1
10 1
⁠4 .2.4. Bus c a d o JAR na Ins talaç ão Anterio r
⁠4 .2.5. Dep uraç ão e Res o luç ão d o s Clas s Cas tExc ep tio ns
10 2
10 3
⁠4 .2.6 . Dep uraç ão e So luç ão d o Dup lic ateServic eExc ep tio ns
⁠4 .2.7. Dep uraç ão e Res o luç ão d o s Erro s d a Pág ina d e Dep uraç ão d o JBo s s Seam
10 4
10 4
⁠4 .3. Revis e a Mig raç ão d o s Ap lic ativo s d a Amo s tra
⁠4 .3.1. Revis e a Mig raç ão d o s Ap lic ativo s d e Amo s tra
10 6
10 7
⁠4 .3.2. Mig raç ão d a Amo s tra Seam 2.2 JPA p ara o JBo s s EAP 6
10 7
⁠4 .3.3. Mig raç ão d a Amo s tra d o Seam 2.2 JPA p ara o JBo s s EAP 6
10 9
⁠4 .3.4. Mig raç ão d o Seam 2.2 Bo o king Arc hive ao JBo s s EAP 6 : Ins truç õ es d e Etap a-p o r-Etap a
112
⁠4 .3.5. Co ns truç ão e Dep uraç ão d a Vers ão d o JBo s s EAP 5.1 d o Ap lic ativo Seam 2.2
Bo o king
113
⁠4 .3.6 . Dep uraç ão e res o luç ão d o erro s e exc eç õ es d o Seam 2.2 Bo o king Arc hive Dep lo yment
114
⁠4 .3.7. Dep uraç ão e Res o luç ão d e erro s e exc eç õ es d o Seam 2.2 Bo o king Arc hive Runtime
123
⁠4 .3.8 . Revis ão d o Sumário d as Alteraç õ es feitas q uand o Mig rand o o Ap lic ativo Seam 2.2
Bo o king
127
. . . . órico
Hist
. . . . . de
. . .Revisão
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. 30
...........
3
Prefácio
1. Convenções de Document os
Este manual usa diversas convenções para destacar certas palavras e frases e chamar a atenção
para informações específicas.
1.1. Convenções T ipográficas
São usadas quatro convenções tipográficas para realçar palavras e frases específicas. Estas
convenções, e circunstâncias a que se aplicam, são as seguintes:
Neg ri to Espaço Úni co (Mono-spaced Bold)
Usada para realçar entradas do sistema, incluindo comandos de shell, nomes de arquivos e
caminhos. São também usadas para realçar teclas Maiúsculas/Minúsculas e as combinações de
teclas. Por exemplo:
Para ver o conteúdo do arquivo my_next_bestsel l i ng _no vel em sua pasta de
trabalho atual, insira o comando cat my_next_bestsel l i ng _no vel na janela
de solicitação e pressione Enter para executar o comando.
O comando acima inclui um nome de arquivo, um comando de shell e uma tecla, todos
apresentados em Negrito Espaço Único (Mono-spaced Bold) e todos distintos, graças ao conteúdo.
As combinações de tecla podem ser diferenciadas de uma tecla individual pelo sinal positivo que
conecta cada parte da combinação da tecla. Por exemplo:
Pressione Enter para executar o comando.
Pressione C trl +Al t+F2 para trocar ao terminal virtual.
A primeira sentença, destaca uma tecla específica a ser pressionada. A segunda destaca duas
combinações de teclas: um conjunto de três teclas pressionadas simultaneamente.
Caso o código fonte seja discutido, serão apresentados como acima, os nomes de classe, métodos,
funções, nomes de variantes e valores retornados mencionados em um parágrafo, em Neg ri to d e
Espaço Úni co (Mo no -spaced Bo l d ). Por exemplo:
Classes baseadas em arquivo, incluem fi l esystem para sistemas de arquivo,
fi l e para arquivos, e d i r para diretórios. Cada classe possui seu conjunto próprio
de permissões associadas.
N eg rit o Pro p o rcio n al
Esta representa as palavras e frases encontradas no sistema, incluindo os nomes de aplicativos,
texto de caixa de diálogo, botões rotulados, caixa de seleção e rótulos de botão de opção, títulos de
menus e submenus. Por exemplo:
Escolha Sist ema → Pref erên cias → Mo u se da barra do menu principal para
lançar Mo u se Pref eren ces. Na aba Bo tõ es selecione o Bo tão d a esq uerd a
d o mo use selecione a caixa e cliquem emFecharpara mudar o botão inicial do
mouse da esquerda para a direita (tornando o mouse adequado para o uso na mão
esquerda).
Selecione Ap p licat io n s → Accesso ries → C h aract er Map a partir da barra de
menu principal, com o objetivo de inserir um caractere especial ao arquivo g ed it . Em
4
Prefácio
seguida, selecione Search → Fin d … a partir da barra do menu C h aract er Map ,
digite o nome do caractere no campo Search e clique em Next. O caractere
pesquisado aparecerá destacado no C haracter T abl e. Clique duas vezes no
caractere destacado para posicioná-lo no campo T ext to co py e clique no botão
C o py. Retorne ao seu documento e selecione Ed it → Past e a partir da barra do
menu g ed it .
O texto acima inclui nomes de aplicativos, nomes de menu e itens de todo o sistema, nomes de menu
específicos do aplicativo, e botões e textos encontrados na Interface Gráfica GUI, todos
apresentados em Negrito Proporcional (Proportional Bold) e todos diferenciados de acordo com o
contexto.
Itálico em Negrito de Espaço Único (Mono-spaced Bold Italic) ou Itálico em
Negrito Proporcional (Proportional Bold Italic)
Sendo o Negrito Espaço Único (Mono-spaced Bold) ou Negrito Proporcional (Proportional Bold), os
itálicos extras indicam textos substituíveis ou variáveis. O Itálico denota o texto que você não inseriu
literalmente ou textos exibidos que mudam dependendo das circunstâncias. Por exemplo:
Para conectar-se à uma máquina remota usando o ssh, digite ssh nome do
usuário@ domain.name na janela de comandos. Por exemplo, considere que a
máquina remota seja exampl e. co m e seu nome de usuário nesta máquina seja
john, digite ssh jo hn@ exampl e. co m.
O comando mo unt -o remo unt file-system remonta o sistema de arquivo
nomeado. Por exemplo, para remontar o sistema de arquivo /ho me, o comando é
mo unt -o remo unt /ho me.
Para ver a versão de um pacote instalado, use o comando rpm -q package. Ele
retornará um resultado como este: package-version-release.
Perceba as palavras em negrito e itálico acima - username, domain.name, file-system, package,
version e release. Cada palavra é um espaço reservado, tanto para o texto que você insere quando
emitindo um comando ou para textos exibidos pelo sistema.
Além de uso padrão para apresentar o título de um trabalho, os itálicos denotam a primeira vez que
um termo novo e importante é usado. Por exemplo:
O Publican é um sistema de publicação do DocBook.
1.2. Convenções de Pull-Quot e
Resultado de terminal e listagem de código fonte são definidos visualmente com base no contexto.
O resultado enviado à um terminal é configurado em R o mano d e Espaço Úni co (Mo no spaced R o man) e apresentado assim:
books
books_tests
Desktop
Desktop1
documentation drafts mss
downloads
images notes
photos
scripts
stuff
svgs
svn
As listas de código fonte também são configuradas em R o mano d e Espaço Úni co (Mo no spaced R o man), porém são apresentadas e realçadas como a seguir:
static int kvm_vm_ioctl_deassign_device(struct kvm *kvm,

struct kvm_assigned_pci_dev *assigned_dev)

{

int r = 0;
5

struct kvm_assigned_dev_kernel *match;

mutex_lock(& kvm->lock);

match = kvm_find_assigned_dev(& kvm->arch.assigned_dev_head,
assigned_dev->assigned_dev_id);
if (!match) {
printk(KERN_INFO "%s: device hasn't been assigned

before, "

"so cannot be deassigned\n", __func__);
r = -EINVAL;
goto out;

}

kvm_deassign_device(kvm, match);

kvm_free_assigned_device(kvm, match);
o ut:

mutex_unlock(& kvm->lock);
return r;

}
1.3. Not as e Avisos
E por fim, usamos três estilos visuais para chamar a atenção para informações que possam passar
despercebidas.
Nota
Uma nota é uma dica ou símbolo, ou ainda uma opção alternativa para a tarefa em questão.
Se você ignorar uma nota, provavelmente não resultará em más consequências, porém
poderá deixar passar uma dica importante que tornará sua vida mais fácil.
Importante
Caixas importantes detalham coisas que são geralmente fáceis de passarem despercebidas:
mudanças de configuração que somente se aplicam à sessão atual, ou serviços que
precisam ser reiniciados antes que uma atualização seja efetuada. Se você ignorar estas
caixas importantes, não perderá dados, porém isto poderá causar irritação e frustração.
Atenção
Um Aviso não deve ser ignorado. Se você ignorar avisos, muito provavelmente perderá
dados.
2. Obt endo Ajuda e Fornecendo Coment ários
6
Prefácio
2.1. Você precisa de ajuda?
Se encontrar dificuldades com o procedimento descrito nesta documentação, você pode encontrar
ajuda visitando o Portal do Cliente da Red Hat em http://access.redhat.com. Você poderá realizar o
seguinte através do portal do cliente:
realize buscas ou navegue através da base de conhecimento dos artigos de suporte técnico
sobre os produtos da Red Hat.
insira o caso de suporte nos Serviços de Suporte Global da Red Hat (GSS).
acesso a outra documentação da Red Hat.
A Red Hat acomoda um grande número de listas de correio eletrônico para discussão de software e
tecnologias da Red Hat. Você pode encontrar uma lista contendo as listas públicas disponíveis em
https://www.redhat.com/mailman/listinfo. Clique no nome de qualquer lista para subscrever àquela
lista ou acessar o histórico das listas.
2.2. Nós precisamos do seu Coment ário!
Se você encontrar erro ortográfico neste manual, ou se você tem uma sugestão para melhoramento
deste manual, nós gostaríamos muito de ouvir sua opinião! Por favor submita um relatório em
Bugzilla:http://bugzilla.redhat.com/ contra o produto JB o ss En t erp rise Ap p licat io n Plat f o rm..
Ao submeter um relatório de erro, certifique-se de mencionar a identificação do
manual:Migration_Guide.
Se você tiver uma sugestão para o melhoramento deste documento, por favor tente ser o mais
específico possível em sua descrição. Caso você tenha encontrado um erro, por favor inclua o
número da seção e alguns detalhes a respeito do texto para a nossa melhor identificação.
7
Capítulo 1. Introdução
1.1. Red Hat JBoss Ent erprise Applicat ion Plat form 6 (JBoss EAP 6)
O JBoss Enterprise Application Plataform 6 (JBoss EAP 6) é uma plataforma de middleware potente,
segura e rápida construída sobre os padrões de código aberto e compatível com a especificação do
Java Enterprise Edition 6. Ela integra o JBoss Aplication Server 7 com cluster de alta
disponibilidade, mensagem potente, cache distribuído e outras tecnologias para criação de uma
plataforma estável e escalável.
A nova estrutura modular permite que serviços sejam habilitados apenas quando requeridos,
aumentando significantemente a velocidade de iniciação. O Management Console e a Interface da
Linha de Comando removem a necessidade de editar os arquivos de configuração XML
manualmente, adicionando a habilidade de script e tarefas automáticas. Além disso, ela inclui os
frameworks de desenvolvimento que podem ser usados para a segurança do desenvolvimento e
aplicativos Java EE escalável rapidamente.
Reportar um erro
1.2. Guia da Migração
O JBoss EAP 6 é rápido, leve e uma implementação poderosa da especificação da Edição Java
Enterprise 6. A arquitetura é construída no Contêiner de Serviço Modular e habilita os serviços por
demanda quando o seu aplicativo os requer. D evido à nova arquitetura, os aplicativos executando
no JBoss EAP 5 podem necessitar de modificações para executarem no JBoss EAP 6.
O propósito deste guia é documentar as alterações que são requeridas a executarem com êxito e
implantar os aplicativos do JBoss EAP 6. Isto fornece informação de como resolver a implantação e
os problemas do período de execução e como prevenir alterações no aplicativo. Esta é a primeira
abordagem em direção à nova plataforma. Uma vez que o aplicativo for implantado e executado
com êxito, os planos podem ser feitos para atualização dos componentes individuais para uso das
novas funções e recursos do JBoss EAP 6.
Reportar um erro
8
⁠Capít ulo 2 . Preparação para a Migração
Capítulo 2. Preparação para a Migração
2.1. Preparação para a Migração
Uma vez que o servidor do aplicativo é estruturado de forma diferente da primeira versão, é possível
realizar algumas pesquisas e planejamento antes de tentar migrar o seu aplicativo.
1. R evisão d as n o vid ad es n o JB o ss EAP 6
D iversas modificações foram realizadas neste lançamento que podem impactar na
implantação dos aplicativos do EAP 5. Isto inclui modificações à estrutura do diretório do
arquivo, configuração da implantação, carregamento da classe e pesquisas JND I. Consulte
a Seção 2.2, “ Revisão das novidades no JBoss EAP 6” para maiores detalhes.
2. R evisão d a d o cu men t ação d a In icializ ação
Certifique-se de revisar o capítulo nomeado Iniciação dos Aplicativos de Desenvolvimento no
Guia de Desenvolvimento do JBoss EAP 6 no
https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/. Isto
contém informações importantes sobre o seguinte:
Java EE 6
O novo sistema de carregamento de classe modular
Alterações da estrutura do arquivo
Como efetuar o download e instalar o JBoss EAP 6
Como baixar e instalar o JBoss D eveloper Studio
Como configurar o Maven para o seu ambiente de desenvolvimento
Como baixar e executar os aplicativo de amostra de iniciação rápida que lançam o
produto.
3. An álise e En t en d imen t o d e seu Ap licat ivo
Cada aplicativo é único e você deve entender por completo os componentes e a arquitetura
do aplicativo existente antes de tentar a migração.
Importante
Antes de realizar quaisquer modificações ao seu aplicativo, certifique-se de criar uma cópia
como backup.
Reportar um erro
2.2. Revisão das novidades no JBoss EAP 6
In t ro d u ção
Segue abaixo uma lista das diferenças visíveis no JBoss EAP 6 a partir do lançamento anterior.
9
Mó d u lo b asead o n o carreg amen t o d a classe
No JBoss EAP 5, a arquitetura de carregamento de classe era hierárquico. No JBoss EAP
6, o carregamento de classe é baseado nos JBoss Modules. Isto oferece um isolamento do
aplicativo verdadeiro, oculta as classes de implementação do servidor e apenas carrega
as classes que seu aplicativo necessita. O carregamento de classe é para melhor
desempenho. Os aplicativos gravados para o JBoss EAP 5 devem ser modificados para
especificar as dependências e em alguns casos, arquivos de re-empacotamento. Para
maiores informações, refira-se ao Carregamento de Classe e Módulos no Guia de
Desenvolvimento do JBoss EAP 6 no
https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/.
D o main Man ag emen t
No JBoss EAP 6, o servidor pode ser executado como um servidor autônomo ou num
managed domain. Num managed domain, você pode configurar todos os grupos dos
servidores de uma só vez, mantendo as configurações sincronizadas por toda a rede de
servidores. Enquanto isto não deve impactar os aplicativos construídos, isto pode
simplificar o gerenciamento de implantações para servidores múltiplos. Refira-se ao
Managed Domains no Guia de Configuração e Administração do JBoss EAP 6 no
Nota
O modo domain não é suportado nos seguintes produtos do JBoss Enterprise:
Plataforma do Portal do JBoss 6
C o n f ig u ração d a Imp lan t ação
Servid o res Au t ô n o mo s e Man ag ed D o main s
O JBoss EAP 5 usava um perfil baseado na configuração de implantação. Esses
perfis estavam localizados no diretório EAP_HOME/server/. Os aplicativos
sempre continham arquivos de configuração múltiplos para segurança, banco
de dados, adaptador de recurso e outras configurações. No JBoss EAP 6, a
configuração da implantação é feita usando um arquivo. Esse arquivo é usado
para configurar todos os serviços e subsistemas usados para a implantação. Um
servidor autônomo é configurado usando o arquivo
EAP_HOME/stand al o ne/co nfi g urati o n/stand al o ne. xml . Para os
servidores executando no managed domain, o servidor é configurado usando o
arquivo EAP_HOME/d o mai n/co nfi g urati o n/d o mai n. xml . A informação
contida nos arquivos de configuração do JBoss EAP 5 deve ser integrada ao
novo arquivo de configuração única.
O rd en ação d as imp lan t açõ es
O JBoss EAP 6 usa uma rápida inicialização para a implantação, resultando
num desempenho aprimorado e eficiência. Na maioria das vezes, o servidor do
aplicativo está apto a determinar as dependências automaticamente com
antecedência e escolher a estratégia de implantação mais eficiente. No entanto,
os aplicativos do JBoss EAP 5, que consistem em módulos múltiplos implantados
como EARs que usam pesquisas JND I de legacia ao invés de injeção CD I ou
entradas de referência de recurso, podem requerer alterações de configuração.
Est ru t u ra d e D iret ó rio e Scrip t s
10
⁠Capít ulo 2 . Preparação para a Migração
Conforme mencionado anteriormente, o JBoss EAP 6 não usa mais uma configuração de
implantação baseado no perfil, portanto não existe diretório EAP_HOME/server/. Os
arquivos de configuração para os servidores autônomos estão localizados agora no
diretório EAP_HOME/stand al o ne/co nfi g urati o n/ e as implantações estão
localizadas no diretório EAP_HOME/stand al o ne/d epl o yments/. Para os servidores
sendo executados no managed domain, os arquivos de configuração podem ser
encontrados no diretório EAP_HOME/d o mai n/co nfi g urati o n/ e as implantações
podem ser encontradas no diretório EAP_HOME/d o mai n/d epl o yments/.
No JBoss EAP 5, o script do Linux EAP_HOME/bi n/run. sh ou o script do Windows
EAP_HOME/bi n/run. bat era usado para iniciar o servidor. No JBoss EAP 6, o script de
iniciação do servidor depende de como você executa o seu servidor. O script do Linux
EAP_HOME/bi n/stand al o ne. sh ou script do Windows
EAP_HOME/bi n/stand al o ne. bat é usado para iniciar o servidor autônomo. O script do
Linux EAP_HOME/bi n/d o mai n. sh ou o script do Windows
EAP_HOME/bi n/d o mai n. bat é usado para iniciar um managed domain.
Pesq u isas JN D I
O JBoss EAP 6 usa agora JND I namespaces portáveis padronizados. Os aplicativos
gravados no JBoss EAP 5 que usam as pesquisas JND I, devem ser alterados para seguir
a nova convenção de JND I namespace gerenciado. Para maiores informações sobre a
sintaxe de nomeação JND I, consulte a Seção 3.1.8.2, “ Nomes do EJB JND I Portátil ” .
Refira-se aos Recursos Novos e Recursos Alterados no JBoss EAP 6 no Guia de Desenvolvimento do
JBoss EAP 6 no
https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/ para maiores
informações.
Reportar um erro
2.3. Revisão da List a de Recursos Subst it uídos e não Suport ados
Antes de você migrar seu aplicativo, você deve certificar-se que alguns recursos que estavam
disponíveis nos lançamentos anteriores do JBoss EAP podem ter sido substituídos ou não mais
suportados. Refira-se à sessão de Recursos não suportados das Notas de Lançamento para o JBoss
EAP 6 localizado no Portal do Cliente no
https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/, para uma
lista compreensiva deste assunto.
Reportar um erro
11
Capítulo 3. Migre seu Aplicativo
3.1. Alt erações Requeridas para a maioria dos Aplicat ivos
3.1.1. Revisão das Alt erações Requeridas para a Maioria dos Aplicat ivos
As alterações do carregamento da classe e configuração no JBoss EAP 6 irão impactar em quase
todos os aplicativos. O JBoss EAP 6 usa também uma nova sintaxe de nomeação JND I portátil
default. Essas alterações irão impactar na maioria dos aplicativos, por isso sugerimos
primeiramente a revisão da seguinte informação antes de você migrar seu aplicativo.
1. Seção 3.1.2.1, “ Atualização do Aplicativo devido às Alterações do Carregamento da Classe”
2. Seção 3.1.6.1, “ Atualização do Aplicativo devido às Alterações da Configuração”
3. Seção 3.1.8.1, “ Atualização dos Nomes JND I Namespace do Aplicativo”
Reportar um erro
3.1.2. Alt erações do Carregament o de Classe
3.1 .2 .1 . At ualização do Aplicat ivo de vido às Alt e raçõ e s do Carre gam e nt o da Classe
O carregamento da classe modular é uma mudança significativa no JBoss EAP 6 e irá impactar em
quase todos os aplicativos. Revise a seguinte informação primeiramente quando você migrar o seu
aplicativo.
1. Primeiro, busque pelo empacotamento de seu aplicativo e suas dependências. Consulte a
Seção 3.1.2.3, “ Atualização das D ependências do Aplicativo devido às Alterações do
Carregamento da Classe” para maiores informações.
2. Caso o seu aplicativo não efetuar a conexão, você precisará especificar as dependências de
módulo corretas. Consulte a Seção 3.1.4.1, “ Modificação das D ependências de Registro em
Log” para maiores informações
3. D evido às alterações de carregamento de classe modular, você talvez precise alterar a
estrutura do empacotamento de seu EAR ou WAR. Consulte a Seção 3.1.5.1, “ Modificação do
Empacotamento dos EARS e WARs” para maiores informações.
Reportar um erro
3.1 .2 .2 . Co m pre e nde ndo as De pe ndê ncias do Mó dulo
Su mário
Um módulo é apenas apto a acessar suas próprias classes e as classes de qualquer módulo que
possui uma dependência explícita ou implícita.
Pro ced imen t o 3.1. C o mp reen d en d o as D ep en d ên cias d o Mó d u lo
1. C o mp reen d en d o as d ep en d ên cias imp lícit as
Os implantadores com o servidor implicitamente automatizado, adicionam algumas das
12
⁠Capít ulo 3. Migre seu Aplicat ivo
dependências do módulo comumente usadas, como por exemplo javax. api e sun. jd k.
Isto faz as classes visíveis à implantação no período de execução e libera o desenvolvedor
da tarefa de adicionar explicitamente as dependências. Para maiores detalhes de como e
quando essas dependências implícitas são adicionadas, refira-se às Dependências de Módulo
Implícitas no capítulo nomeado Carregamento de Classe e Módulos do Guia de Desenvolvimento
do JBoss EAP 6 no
2. C o mp reen d en d o as d ep en d ên cias exp lícit as
Para outras classes, os módulos devem ser especificados explicitamente ou as
dependências ausentes resultam em erros de implantação ou do período de execução. Caso
falte uma dependência, você verá traços C l assNo tFo und Excepti o ns ou
No C l assD efFo und Erro rs no log do servidor. Caso mais de um módulo efetuar o
carregamento ao mesmo JAR ou um módulo efetuar o carregamento numa classe que
estende a classe com carregamento por um módulo diferente, você verá traços
C l assC astExcepti o ns no log do servidor. Para especificar as dependências, modifique o
MANIFEST . MF ou crie um jbo ss-d epl o yment-structure. xml do arquivo do descritor
de implantação específico do JBoss. Para maiores informações sobre as dependências do
módulo, refira-se à Visão Geral de Carregamento de Classe e Módulo no capítulo chamado
Carregamento de Classe e Módulo no Guia de Desenvolvimento do JBoss EAP 6 no
Reportar um erro
3.1 .2 .3. At ualização das De pe ndê ncias do Aplicat ivo de vido às Alt e raçõ e s do
Carre gam e nt o da Classe
Su mário
O carregamento de classe no JBoss EAP 6 é consideravelmente diferente do que as versões
anteriores do JBoss EAP. O carregamento de classe é agora baseado no projeto de Módulos do
JBoss. Ao invés de um único carregador, o carregador de classe hierárquico que carrega todos os
JARS num caminho de classe plano, cada biblioteca torna-se um módulo que apenas conecta os
módulos extras dos quais ela depende. As implantações no JBoss EAP 6 são módulos e não
precisam ter acesso às classes que são definidas nos JARs de um servidor de aplicativo a não ser
que uma dependência explícita seja definida nessa classe. Algumas das dependências do módulo
definidas pelo servidor do aplicativo são configuradas automaticamente. Por exemplo: caso você
esteja implantando um aplicativo Java EE, uma dependência no Java EE API é adicionada
automaticamente ou implicitamente. Para uma lista de dependências adicionadas automaticamente
pelo servidor, refira-se às Dependências de Módulo Implícitas no capítulo nomeado Carregamento de
Classe e Módulos no Guia de Desenvolvimento para o JBoss Enterprise Application Plataform 6 no
T aref as
Quando você migrar seu aplicativo ao JBoss EAP 6, você pode precisar executar uma ou mais das
seguintes tarefas devido às alterações do carregamento de classe modular:
Seção 3.1.2.2, “ Compreendendo as D ependências do Módulo”
Seção 4.1.3, “ Uso do Tattle para encontrar D ependências do Aplicativo”
Seção 3.1.3.1, “ Criação ou Modificação dos Arquivos que controlam o Controle de Carregamento
da Classe no JBoss EAP 6”
Seção 3.1.3.3, “ Recursos de Pacote para o Novo Sistema de Carregamento de Classe Modular”
13
Reportar um erro
3.1.3. Alt erações do Arquivo de Configuração
3.1 .3.1 . Criação o u Mo dificação do s Arquivo s que co nt ro lam o Co nt ro le de
Carre gam e nt o da Classe no JBo ss EAP 6
Su mário
D evido à alteração no JBoss EAP 6 para uso do carregamento da classe modular, você talvez
precise criar ou modificar um ou mais arquivos para adicionar dependências ou para prevenir
dependências automáticas de serem carregadas. Para maiores informações sobre o carregamento
de classe e a procedência do carregamento de classe, refira-se ao capítulo nomeado Carregamento
de Classe e Módulos no Guia de Desenvolvimento para o JBoss EAP 6 no
Os seguintes arquivos são usados para controlar o carregamento da classe no JBoss EAP 6.
jb o ss- web .xml
Caso tenha definido um elemento <cl ass-l o ad i ng > no arquivo jbo ss-web. xml , você
precisará removê-lo. O comportamento que isto causou no JBoss EAP 5 é agora o
comportamento do carregamento da classe default no JBoss EAP 6, portanto não é mais
necessário. Caso você não remova mais esse elemento, você verá um ParseError e
XMLStreamException no seu log do servidor.
Segue abaixo uma amostra do elemento <cl ass-l o ad i ng > no arquivo jbo ssweb. xml que encontra-se comentado.
< !DOCTYPE jboss-web PUBLIC

"-//JBoss//DTD Web Application 4.2//EN"

"http://www.jboss.org/j2ee/dtd/jboss-web_4_2.dtd">
< jboss-web>
< !-
<class-loading java2ClassLoadingCompliance="false">

<loader-repository>

seam.jboss.org:loader=MyApplication

<loader-repositoryconfig>java2ParentDelegation=false</loader-repository-config>

</loader-repository>

</class-loading>
-->
</jboss-web>
MAN IFEST .MF
Ed it ad o man u almen t e
D ependendo de quais componentes ou módulos o seu aplicativo usa, você
precisa adicionar uma ou mais dependências a este arquivo. Você pode
adicioná-las tanto como D epend enci es ou como entradas C l ass-P ath.
Segue abaixo uma amostra MANIFEST . MF editada por um desenvolvedor:
14
M anifest-Version: 1.0
D ependencies: org.jboss.logmanager
C lass-Path: OrderManagerEJB.jar
Caso você modifique esse arquivo, certifique-se de incluir um caractere com linha
nova no final do arquivo.
U san d o o Maven
Caso você use o Maven, você precisa modificar o seu arquivo po m. xml para
gerar as dependências para o arquivo MANIFEST . MF. Caso seu aplicativo usar
o EJB 3.0, você pode possuir uma seção no arquivo po m. xml parecida com o
seguinte:
< plugin>

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-ejb-plugin</artifactId>

</configuration>
< /plugin>
Caso o código EJB 3.0 usar o o rg . apache. co mmo ns. l o g , você precisará
daquela dependência no arquivo MANIFEST . MF. Com o objetivo de gerar aquela
dependência, adicione o elemento <pl ug i n> ao arquivo po m. xml , conforme
abaixo:
< plugin>

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-ejb-plugin</artifactId>

<manifestFile>src/main/resources/METAINF/MANIFEST.MF</manifestFile>

</archive>

</configuration>
< /plugin>
Na amostra acima, o arquivo src/mai n/reso urces/MET A-INF/MANIFEST . MF
precisa apenas conter a entrada da dependência:
D ependencies: org.apache.commons.logging
O Maven gerará o arquivo MANIFEST . MF completo:
M anifest-Version: 1.0
D ependencies: org.apache.commons.logging
15
jb o ss- d ep lo ymen t - st ru ct u re.xml
Esse arquivo é um descritor de implantação específico do JBoss que pode ser usado para
controlar o carregamento da classe de forma granulada. Assim como o MANIFEST . MF,
esse arquivo pode ser usado para adicionar dependência. Isto pode também prevenir que
dependências automáticas sejam adicionadas, definir módulos adicionais, alterar o
comportamento de carregamento da classe isolado da implantação EAR e adicionar raízes
de recurso adicional ao módulo.
Segue abaixo uma amostra do arquivo jbo ss-d epl o yment-structure. xml que
adiciona uma dependência para o módulo JSF 1.2 e previne o carregamento automático
do módulo JSF 2.0.
< jboss-deployment-structure xmlns="urn:jboss:deploymentstructure:1.0">
<deployment>

</dependencies>
</deployment>
<sub-deployment name="jboss-seam-booking.war">

</exclusions>

</dependencies>
</sub-deployment>
< /jboss-deployment-structure>
Consulte a Seção 3.1.3.2, “ jboss-deployment-structure.xml” para informações adicionais
sobre este arquivo.
ap p licat io n .xml
Nas versões anteriores do JBoss EAP, você controlou a ordem das implantações com um
EAR usando o arquivo jbo ss-app. xml . Isto não é mais a mesma situação. O Java EE6
spec fornece o elemento no appl i cati o n. xml que permite
o controle da ordem pela qual os módulos do Java EE com um EAR são implantados.
Na maioria das vezes, você não precisa especificar a ordem da implantação. Caso o seu
aplicativo use injeções de dependência e referências de recurso para referenciar
componentes em módulos externos, o elemento não é
requerido na maioria das vezes, uma vez que o servidor do aplicativo está apto a
determinar implicitamente a maneira correta e ideal de ordenar os componentes.
Vamos assumir que você possui um aplicativo que contém um myBeans. jar e um
myApp. war com um myApp. ear. Um servlet no myApp. war@ EJB injeta um bean do
myBeans. jar. Neste caso, o servidor do aplicativo possui um conhecimento apropriado
para certificar-se de que o componente EJB está disponível antes do servlet ser iniciado e
você não precisará usar o elemento .
16
No entanto, caso o servlet usar referências remotas de estilo de pesquisa JND I de legacia
como o seguinte para acesso ao bean, você poderá especificar a ordem do módulo.
i nit() {
Context ctx = new InitialContext();
ctx.lookup("TheBeanInMyBeansModule");

}
Neste caso, o servidor não está apto a determinar que o componente EJB está no
myBeans. jar e você precisa reforçar que os componentes no myBeans. jar são
inicializados e ativados antes dos componentes no myApp. war. Para isto, você configura
o elemento para true e especifica a ordem dos módulos
myBeans. jar e myApp. war no arquivo appl i cati o n. xml .
Segue abaixo uma amostra que usa o elemento para
controlar a ordem de implantação. O myBeans. jar é implantado antes do arquivo
myApp. war.
< application xmlns="http://java.sun.com/xml/ns/javaee"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
version="6"

xsi:schemaLocation="http://java.sun.com/xml/ns/javaee

http://java.sun.com/xml/ns/javaee/application_6.xsd">

<application-name>myApp</application-name>

<initialize-in-order>true</initialize-in-order>

<ejb>myBeans.jar</ejb>

</module>

<web>

<web-uri>myApp.war</web-uri>

<context-root>myApp</context-root>

</web>

</module>
< /application>
O esquema para o arquivo appl i cati o n. xml pode ser encontrado no
http://java.sun.com/xml/ns/javaee/application_6.xsd.
Nota
Você deve estar ciente que a configuração do elemento 
para true reduz a velocidade da implantação. É preferível definir as dependências
de maneira apropriada usando injeções de dependência ou referências de recurso,
uma vez que isto permite o contêiner maior flexibilidade na implantações ideais.
jb o ss- ejb 3.xml
O descritor da implantação jbo ss-ejb3. xml substitui o descritor da implantação
jbo ss. xml para substituição e adição à recursos fornecidos pelo Java Enterprise Edition
(EE - Edição do Java Enterprise) definidos no descritor da implantação ejb-jar. xml . O
17
novo arquivo é incompatível com o jbo ss. xml e o jbo ss. xml é agora ignorado nas
implantações.
lo g in - co n f ig .xml
O arquivo l o g i n-co nfi g . xml não é mais usado para a configuração de segurança. A
segurança é agora configurada no elemento <securi ty-d o mai n> no arquivo de
configuração do servidor. Para um servidor autônomo, este é o arquivo
stand al o ne/co nfi g urati o n/stand al o ne. xml . Caso você esteja executando o seu
servidor num managed domain, esse é o arquivo
d o mai n/co nfi g urati o n/d o mai n. xml .
Reportar um erro
3.1 .3.2 . jbo ss-de plo ym e nt -st ruct ure .xm l
O jbo ss-d epl o yment-structure. xml é um novo descritor de implantação opcional para o
JBoss EAP 6. Este descritor de implantação fornece controle sobre o carregamento da classe na
implantação.
O esquema para este descritor de implantação é o EAP_HOME/d o cs/schema/jbo ssd epl o yment-structure-1_2. xsd
Reportar um erro
3.1 .3.3. Re curso s de Paco t e para o No vo Sist e m a de Carre gam e nt o de Classe
Mo dular
Su mário
Nas versões anteriores do JBoss EAP, todos os recursos dentro do diretório WEB-INF/ foram
adicionados ao caminho de classe WAR. No JBoss EAP 6, os artefatos do aplicativo da web são
apenas carregados a partir dos diretórios WEB-INF/cl asses e WEB-INF/l i b. A falha dos
artefatos do aplicativo do pacote nas localizações especificadas pode resultar no
C l assNo tFo und Excepti o n, No C l assD efErro r, ou outros erros do período de execução.
Para resolver esses erros de carregamento da classe, você deverá modificar a estrutura de seu
arquivo do aplicativo ou definir um módulo personalizado.
Mo d if icação d o Emp aco t amen t o d e R ecu rso
Para disponibilizar os recursos apenas para o aplicativo, você deve empacotar os
arquivos de propriedades, JARs e outros artefatos com WAR, movendo-os ao diretório
WEB-INF/cl asses/ ou WEB-INF/l i b/. Essa abordagem está descrita com maiores
detalhes na: Seção 3.1.3.4, “ Alteração da Localização das Propriedades ResourceBundle”
C riação d e u m Mó d u lo Perso n aliz ad o
Caso você deseje disponibilizar recursos personalizados a todos os aplicativos
executando no servidor do JBoss EAP 6, você deve criar um modelo personalizado. Esta
abordagem está descrita em maiores detalhes na: Seção 3.1.3.5, “ Criação de um Módulo
Personalizado”
Reportar um erro
3.1 .3.4 . Alt e ração da Lo calização das Pro prie dade s Re so urce Bundle
18
Su mário
Nas versões anteriores do JBoss EAP, o diretório EAP_HOME/server/SERVER_NAME/co nf/ estava
no classpath e disponível ao aplicativo. Para disponibilizar as propriedades ao caminho da classe
do aplicativo no JBoss EAP 6, você deve empacotá-las com seu aplicativo.
Pro ced imen t o 3.2.
1. Caso esteja implantando um arquivo WAR, você deve empacotar essas propriedades na
pasta WEB-INF/cl asses/ do WAR.
2. Caso deseje disponibilizar essas propriedades a todos os componentes num EAR, você
deve empacotá-las à raiz do JAR na pasta l i b/ do EAR.
Reportar um erro
3.1 .3.5 . Criação de um Mó dulo Pe rso nalizado
O seguinte procedimento descreve como criar um módulo personalizado com o objetivo de criar
arquivos de propriedades e outros recursos disponíveis a todos os aplicativos sendo executados
no servidor do JBoss EAP.
Pro ced imen t o 3.3. C riação d e u m Mó d u lo Perso n aliz ad o
1. Crie e preencha a estrutura do diretório mo d ul e/.
a. Crie uma estrutura de diretório sob o diretório EAP_HOME/mo d ul e para conter os
arquivos e JARs. Por exemplo:
$ cd EAP_HOME/mo d ul es/ $ mkd i r -p myo rg -co nf/mai n/pro perti es
b. Mova os arquivos de propriedades ao diretório EAP_HOME/mo d ul es/myo rg co nf/mai n/pro perti es/ criado na etapa anterior.
c. Crie um arquivo mo d ul e. xml no diretório EAP_HOME/mo d ul es/myo rg co nf/mai n/ contendo o seguinte XML:
< module xmlns="urn:jboss:module:1.1" name="myorg-conf">

<resource-root path="properties"/>

</resources>
< /module>
2. Modifique o subsistema ee no arquivo de configuração do servidor. Você pode usar o JBoss
CLI ou pode editar manualmente o arquivo.
A. Siga as seguintes etapas para modificar o arquivo de configuração do servidor usando
o JBoss CLI.
a. Inicie o servidor e conecte-se ao Management CLI.
A. Insira a seguinte linha de comando para o Linux:
19
$ EAP_HOME/bin/jboss-cli.sh --connect
B. Insira a seguinte linha de comando para o Windows:
C:\>EAP_HOME\bin\jboss-cli.bat --connect
Você deverá observar a seguinte resposta:
Conectado ao controlador autônomo no localhost:9999
b. Para criar o elemento myo rg -co nf<global-modules> no subsistema ee, digite o
seguinte na linha de comando:
/subsystem=ee:write-attribute(name=global-modules, value=
[{"name"=>"myorg-conf","slot"=>"main"}])
Você deverá ver o seguinte resultado:
{"outcome" => "success"}
B. Siga essas etapas caso prefira editar manualmente o arquivo da configuração do
servidor.
a. Interrompa o servidor e abra o arquivo de configuração do servidor num editor de
texto. Caso você esteja executando um servidor autônomo, este é o arquivo
EAP_HOME/stand al o ne/co nfi g urati o n/stand al o ne. xml ou caso esteja
executando um managed domain, o arquivo é o
EAP_HOME/d o mai n/co nfi g urati o n/d o mai n. xml .
b. Encontre o subsistema ee e adicione o módulo global para myo rg -co nf. Segue
abaixo uma amostra do elemento do subsistema ee modificado para inclusão do
elemento myo rg -co nf:
< subsystem xmlns="urn:jboss:domain:ee:1.0" >

<global-modules>

</global-modules>
< /subsystem>
3. Assumindo que você copiou um arquivo nomeado my. pro perti es à localização de
módulo correta, você poderá agora carregar os arquivos de propriedades usando o código
similar ao seguinte:
T hread.currentThread().getContextClassLoader().getResource("my.prop
erties");
Reportar um erro
3.1.4 . Alt erações do Regist ro em Log
3.1 .4 .1 . Mo dificação das De pe ndê ncias de Re gist ro e m Lo g
20
3.1 .4 .1 . Mo dificação das De pe ndê ncias de Re gist ro e m Lo g
Su mário
O JBoss LogManager suporta front ends para todos os frameworks de registro em log, de forma que
você pode manter seu código de registro de log atual ou mover à nova infraestrutura de registro de
log do JBoss. Independente de sua decisão, devido às alterações de carregamento de classe
modular, você precisará provavelmente modificar seu aplicativo para adicionar as dependências
requeridas.
Pro ced imen t o 3.4 . At u aliz ação d o có d ig o d e reg ist ro d e lo g d o ap licat ivo
1. Seção 3.1.4.2, “ Atualização do Código do Aplicativo para Frameworks de Registro de Log de
Terceiros”
2. Seção 3.1.4.3, “ Modificação do Código para Uso do Novo Framework de Registro de Log do
JBoss”
Reportar um erro
3.1 .4 .2 . At ualização do Có digo do Aplicat ivo para Fram e wo rks de Re gist ro de Lo g
de T e rce iro s
Su mário
No JBoss EAP 6, as dependências de registro em log para frameworks de terceiros comuns como o
Apache Commons Logging, Apache log4j, SLF4J e Java Logging são adicionados por default. No
entanto, caso você esteja usando o log4j e você não deseja usar o subsistema de registro em log
para configurar seus manuseadores (anexadores), você precisa excluir o módulo do log4j do JBoss
EAP 6.
Pro ced imen t o 3.5. C o n f ig u ração d o JB o ss EAP 6 p ara u so d e u m arq u ivo
lo g 4 j.p ro p ert ies o u lo g 4 j.xml
1. Criação de um jbo ss-d epl o yment-structure. xml com o seguinte conteúdo:
< jboss-deployment-structure>

</exclusions>

</deployment>
2. Posicione o arquivo jbo ss-d epl o yment-structure. xml tanto no diretório MET A-INF/
ou diretório WEB-INF/, caso esteja implantando um WAR ou no diretório MET A-INF/, caso
você esteja implantando um EAR.
3. Adicione o arquivo l o g 4 j. pro perti es ou l o g 4 j. xml no diretório l i b/ de seu EAR ou
no diretório WEB-INF/cl asses/ de sua implantação WAR.
4. Implante seu aplicativo.
21
Nota
Caso você deseje usar o arquivo de configuração log4j, você não estará mais apto à alterar a
configuração do registro de log log4j no período de execução.
Reportar um erro
3.1 .4 .3. Mo dificação do Có digo para Uso do No vo Fram e wo rk de Re gist ro de Lo g do
JBo ss
Su mário
Para usar o novo framework, altere suas importações e código conforme abaixo:
Pro ced imen t o 3.6 . Mo d if iq u e o C ó d ig o e D ep en d ên cias p ara U so d o JB o ss lo g g in g
Framewo rk
1. Alt eração d e su as imp o rt açõ es e có d ig o d e reg ist ro em lo g
Segue abaixo uma amostra do código que usa o novo framework do JBoss Logging:
i mport org.jboss.logging.Level;
i mport org.jboss.logging.Logger;
p rivate static final Logger logger =
Logger.getLogger(MyClass.class.toString());
i f(logger.isTraceEnabled()) {

logger.tracef("Starting...", subsystem);

}
2. Ad ição d e d ep en d ên cia d e reg ist ro em lo g
O JAR contendo as classes do JBoss Logging está localizado no módulo nomeado
o rg . jbo ss. l o g g i ng . O seu arquivo MANIFEST -MF deve parecer com o seguinte:
Manifest-Version: 1.0
Dependencies: org.jboss.logging
Por favor consulte a Seção 3.1.2.3, “ Atualização das D ependências do Aplicativo devido às
Alterações do Carregamento da Classe” e a Seção 4.2.1, “ D epuração e Solução dos
Problemas de Migração” para maiores informações sobre como encontrar a dependência do
módulo.
Reportar um erro
3.1.5. Alt erações do Empacot ament o do Aplicat ivo
3.1 .5 .1 . Mo dificação do Em paco t am e nt o do s EARS e WARs
Su mário
22
Quando você migrar seu aplicativo, é possível que você tenha que alterar a estrutura de
empacotamento de seu EAR ou WAR devido à alteração do carregamento da classe modular. As
dependências de módulo contém o carregamento em ordem específica:
1. D ependências do sistema
2. D ependências do Usuário
3. Recursos Locais
4. D ependências inter-implantadas
Pro ced imen t o 3.7. Mo d if icação d o emp aco t amen t o d o arq u ivo
1. Emp aco t amen t o d o WAR
O WAR é um módulo único e todas as classes no WAR são carregadas com o mesmo
carregador de classe. Isto significa que as classes empacotadas no diretório WEBINF/l i b/ são tratadas da mesma forma que as classes no diretório WEB-INF/cl asses.
2. Emp aco t amen t o d e u m EAR
Um EAR consiste de módulos múltiplos. O diretório EAR /l i b/ é um módulo único e cada
WAR ou sub-implantação EJB jar no EAR é um módulo separado. As classes não possuem
acesso às classes em outros módulos com o EAR, a não ser que as dependências tenham
sido definidas. As sub-implantações sempre possuem uma dependência automática no
módulo pai que as fornecem acesso às classes no diretório EAR /l i b/. No entanto, as subimplantações nem sempre possuem uma dependência automática para permitir que se
acessassem entre si. Este comportamento é controlado pela configuração do elemento
<ear-subd epl o yments-i so l ated > na configuração do subsistema ee, conforme
abaixo:
< subsystem xmlns="urn:jboss:domain:ee:1.0" >
<ear-subdeployments-isolated>false</ear-subdeployments-isolated>
< /subsystem>
Por default, isto é configurado para falso, permitindo que as sub-implantações vejam as
classes pertencentes às demais sub-implantações com o EAR.
Para maiores informações sobre o carregamento da classe, refira-se ao capítulo
Carregamento de Classe e Módulos no Guia de Desenvolvimento para o JBoss EAP 6 no
Reportar um erro
3.1.6. Alt erações da Configuração do Adapt ador de Recurso e Font e de
Dados
3.1 .6 .1 . At ualização do Aplicat ivo de vido às Alt e raçõ e s da Co nfiguração
No JBoss EAP 5, os serviços e subsistemas foram configurados em diversos arquivos diferentes. No
JBoss EAP 6, a configuração é agora realizada basicamente em um arquivo. Caso o seu aplicativo
usar qualquer um dos recursos ou serviços, as alterações da configuração podem ser necessárias.
23
1. Caso o seu aplicativo usar uma fonte de dados, consulte a Seção 3.1.6.2, “ Atualização da
Configuração da Fonte de D ados” .
2. Caso o seu aplicativo usar JPA e empacotar o Hibernate JARs, consulte as opções de
migração na Seção 3.1.6.4, “ Configuração da Fonte de D ados para o Hibernate ou JPA” .
3. Caso o seu aplicativo usar um adaptador de recurso, consulte a Seção 3.1.6.5, “ Atualização
da Configuração do Adaptador de Recurso” .
4. Revise abaixo as informações de como configurar as alterações para segurança básica na
Seção 3.1.7.1, “ Configuração das Alterações de Segurança do Aplicativo” .
Reportar um erro
3.1 .6 .2 . At ualização da Co nfiguração da Fo nt e de Dado s
Su mário
Nas versões anteriores do JBoss EAP, a configuração da fonte de dados JCA foi definida num
arquivo com sufixo *-d s. xml . Esse arquivo foi implantado no diretório d epl o y/ do servidor ou
empacotado com o aplicativo. O driver JD BC foi copiado ao diretório server/l i b/ ou empacotado
no diretório WEB-INF/l i b/ do aplicativo. Enquanto esse método de configuração de fonte de
dados não é suportado para o desenvolvimento, ele não é recomendado para produção uma vez
que ele não é suportado pelas ferramentas de gerenciamento e administrativa do JBoss.
No JBoss EAP 6, a fonte de dados é configurada no arquivo de configuração do servidor. Caso a
instância do JBoss EAP estiver sendo executada num managed domain, a fonte de dados é
configurada no arquivo d o mai n/co nfi g urati o n/d o mai n. xml . Caso a instância do JBoss EAP
estiver sendo executada como servidor autônomo, a fonte de dados é configurada no
stand al o ne/co nfi g urati o n/stand al o ne. xml fi l e. As fontes de dados configuradas
dessa maneira podem ser gerenciadas e controladas usando as interfaces de gerenciamento do
JBoss, incluindo o Web Management Console (Management Console da Web) e a interface da linha
de comando (CLI). Essas ferramentas facilitam o gerenciamento de implantações e configuram
servidores múltiplos sendo executados no managed domain.
A seguinte seção descreve como modificar sua configuração de fonte de dados, de forma que ela
pode ser gerenciada e suportada pelas ferramentas de gerenciamento disponíveis.
Mig ração p ara u ma C o n f ig u ração d e Fo n t e d e D ad o s G eren ciável p ara o JB o ss EAP 6
Um driver compatível com JD BC 4.0 pode ser instalado como implantação ou como módulo core.
Um driver que é compatível com o JD BC 4.0 contém um arquivo MET AINF/servi ces/java. sq l . D ri ver que especifica o nome da classe do driver. Um driver que não
é compatível com o JD BC 4.0 requer etapas adicionais. Para maiores detalhes de como fazer um
driver compatível com o JD BC 4.0 e como atualizar sua configuração de fonte de dados atual para
uma que é gerenciável pelo Management Console da Web e CLI, consulte a Seção 3.1.6.3,
“ Instalação e Configuração do JD BC D river” .
Caso seu aplicativo usar Hibernate ou JPA, ele poderá requerer alterações adicionais. Consulte a
Seção 3.1.6.4, “ Configuração da Fonte de D ados para o Hibernate ou JPA” para maiores
informações.
U se a Ferramen t a d e Mig ração Iro n Jacamar p ara C o n vert er o s D ad o s d e C o n f ig u ração
Você pode usar a ferramenta IronJacamar para migrar a fonte de dados e as configurações do
adaptador do recurso. Esta ferramenta converte os arquivos de configuração do estilo *-d s. xml
no formato esperado pelo JBoss EAP 6. Consute: Seção 4.1.6, “ Uso da Ferramenta IronJacamar
24
para Migração da Fonte de D ados e Configurações do Adaptador de Recurso” para maiores
informações.
Reportar um erro
3.1 .6 .3. Inst alação e Co nfiguração do JDBC Drive r
Su mário
O JD BC driver pode ser instalado no contêiner em uma das duas seguintes maneiras:
como implantação
como módulo core
Os aspectos positivos e negativos de cada abordagem estão descritos abaixo.
No JBoss EAP 6, a fonte de dados é configurada no arquivo de configuração do servidor. Caso a
instância do JBoss EAP 6 estiver sendo executada num managed domain, a fonte de dados é
configurada no arquivo d o mai n/co nfi g urati o n/d o mai n. xml . Caso a instância do JBoss EAP
6 estiver sendo executada como um servidor autônomo, a fonte de dados é configurada no arquivo
stand al o ne/co nfi g urati o n/stand al o ne. xml . A informação da referência do esquema, que
é a mesma em ambos os modos, pode ser encontrada no diretório d o c/ de instalação do JBoss
EAP 6. Para propósitos desta discussão, assuma que o servidor está sendo executado como
servidor autônomo e a fonte de dados está configurada no arquivo stand al o ne. xml .
Pro ced imen t o 3.8. In st alação e C o n f ig u ração d o JD B C D river
1. In st alação d o JB B C D river
a. In st ale o JD B C D river co mo u ma imp lan t ação
Esta é a maneira recomendada para instalar o driver. Quando o JD BC driver for
instalado como uma implantação, ele é implantado como um JAR regular. Caso a
instância do JBoss EAP 6 estiver sendo executada como um servidor autônomo,
copie o JD BC 4.0 compatível ao JAR no diretório
EAP_HOME/stand al o ne/d epl o yments/. Caso o servidor estiver sendo executado
num managed domain, copie o JAR ao diretório
EAP_HOME/d o mai n/d epl o yments/.
Segue abaixo uma amostra de um MySQL JD BC driver instalado como implantação
ao servidor autônomo:
$cp mysql-connector-java-5.1.15.jar
EAP_HOME/stand al o ne/d epl o yments/
Qualquer driver compatível com o JD BC 4.0 é automaticamente reconhecido e
instalado no sistema pelo nome e versão. Um JAR compatível com o JD BC 4.0
contém um texto com arquivo nomeado MET A-INF/servi ces/java. sq l . D ri ver
que especifica o(s) nome(s) da classe do driver. Caso o driver não for compatível
com o JD BC 4.0, ele pode ser implantável em uma das seguintes maneiras:
Crie e adicione o arquivo java. sq l . D ri ver ao JAR sob o caminho MET AINF/servi ces/. Esse arquivo deve conter o nome de classe do driver, por
exemplo:
25
co m. mysq l . jd bc. D ri ver
Crie um arquivo java. sq l . D ri ver no diretório de implantação. Para uma
instância do JBoss EAP 6 sendo executada como servidor autônomo, o arquivo
deve ser posicionado aqui: EAP_HOME/stand al o ne/d epl o yments/MET AINF/servi ces/java. sq l . D ri ver. Caso o servidor estiver num managed
domain, o arquivo deve ser posicionado aqui:
EAP_HOME/d o mai n/d epl o yments/MET AINF/servi ces/java. sq l . D ri ver.
Os aspectos positivos desta abordagem são:
Este é o método mais simples uma vez que não há necessidade de definir um
módulo.
Quando o servidor estiver executando num managed domain, as implantações
que usam esta abordagem são propagadas automaticamente a todos os
servidores no domain. Isto significa que o administrador não precisa distribuir o
driver JAR manualmente.
Os aspectos negativos desta abordagem são:
Caso o JD BC driver consistir de mais de um JAR, por exemplo: o driver JAR mais
um JAR com licença independente ou JAR de localização, você não pode instalar
o driver como uma implantação. Você deve instalar o JD BC driver como um
módulo core.
Caso o driver não for compatível com o JD BC 4.0, um arquivo deve ser criado
contendo o(s) nome(s) da classe do driver e deve ser importado num JAR ou
sobreposto no diretório d epl o yments/.
b. In st ale o JD B C D river co mo mó d u lo co re
Para instalar um JD BC driver como um módulo core, você deve criar uma estrutura
do caminho do arquivo sob o diretório EAP_HOME/mo d ul es/. Esta estrutura contém
o JD BC driver JAR, qualquer licença do fornecedor adicional ou JARs de localização
e um arquivo mo d ul e. xml para definir o módulo.
A. In st ale o MySQ L JD B C D river co mo mó d u lo co re
i. Crie uma estrutura de diretório EAP_HOME/mo d ul es/co m/mysq l /mai n/
ii. No subdiretório mai n/, crie um arquivo mo d ul e. xml contendo a
seguinte definição do módulo para o MySQL JD BC driver:
< ?xml version="1.0" encoding="UTF-8"?>
< module xmlns="urn:jboss:module:1.0"
name="com.mysql">
< resources>

<resource-root path="mysql-connector-java5.1.15.jar"/>
< /resources>
< dependencies>

<module name="javax.api"/>
26
< /dependencies>
< /module>
O nome do módulo, " com.mysql" , coincide com a estrutura do diretório
para esse módulo. O elemento <d epend enci es> é usado para
especificar as dependências do módulo em outros módulos. Neste caso,
como é o caso em todas as fontes de dados JD BC, isto é dependente do
Java JD BC APIs que é definido em outro módulo nomeado javax. api .
Este módulo está localizado sob o diretório
mo d ul es/system/l ayers/base/javax/api /mai n/.
Nota
Certifique-se de que você NÃO possui espaço no início do arquivo
mo d ul e. xml ou você obterá um erro " New missing/unsatisfied
dependencies" para este driver.
iii. Copie o MySQL JD BC driver JAR ao diretório
EAP_HOME/mo d ul es/co m/mysq l /mai n/:
$ cp mysql-connector-java-5.1.15.jar
EAP_HOME/mo d ul es/co m/mysq l /mai n/
B. In st ale o IB M D B 2 JD B C d river e licen ça JAR co mo u m mó d u lo co re
Esta amostra é fornecida para apenas demonstrar como implantar drivers que
requerem JARs além do JD BC D river JAR.
i. Crie a estrutura do diretório
EAP_HOME/mo d ul es/co m/i bm/d b2/mai n/.
ii. No subdiretório mai n/ crie um arquivo mo d ul e. xml contendo a
seguinte definição do módulo para o IBM D B2 JD BC driver e licença:
< module xmlns="urn:jboss:module:1.1"
name="com.ibm.db2">
<resources>

<resource-root path="db2jcc.jar"/>

<resource-root path="db2jcc_license_cisuz.jar"/>
</resources>
<dependencies>

<module name="javax.transaction.api"/>
</dependencies>
< /module>
27
Nota
Certifique-se de que você NÃO possui espaço no início do arquivo
mo d ul e. xml ou você obterá um erro " New missing/unsatisfied
dependencies" para este driver.
iii. Copie o JD BC driver e a licença JAR ao diretório
EAP_HOME/mo d ul es/co m/i bm/d b2/mai n/.
$ cp db2jcc.jar EAP_HOME/mo d ul es/co m/i bm/d b2/mai n/
$ cp db2jcc_license_cisuz.jar
EAP_HOME/mo d ul es/co m/i bm/d b2/mai n/
Os aspectos positivos desta abordagem são:
Esta é a única abordagem que funciona quando o JD BC driver consiste de mais
de um JAR.
Com esta abordagem, os drivers que não são compatíveis com o JD BC 4.0 podem
ser instalados sem modificar o driver JAR ou criando uma sobreposição de
arquivo.
Os aspectos negativos desta abordagem são:
É mais difícil configurar um módulo.
O módulo deve ser manualmente copiado para cada servidor executando num
managed domain.
2. C o n f ig u ração d a f o n t e d e d ad o s
a. Ad ição d o d river d o b an co d e d ad o s
Adicione o elemento <d ri ver> ao elemento <d ri vers> de mesmo arquivo. Isto
contém algumas das informações que foram definidas anteriormente no arquivo *d s. xml .
Primeiro determine se o driver JAR é compatível com o JD BC 4.0. Um JAR que é
compatível com o JD BC 4.0 contém um arquivo MET AINF/servi ces/java. sq l . D ri ver que especifica o nome de classe do driver. O
servidor usa este arquivo para encontrar o nome da(s) classe(s) de driver no JAR.
Um driver que é compatível com o JD BC 4.0 não requer um elemento <d ri vercl ass>, uma vez que ele já está especificado no JAR. Esta é uma amostra do
elemento do driver para um JD BC 4.0 compatível com o driver MySQL:
< driver name="mysql-connector-java-5.1.15.jar"
module="com.mysql"/>
Um driver que não seja compatível com o JD BC 4.0 requer um atributo <d ri vercl ass> para identificar a classe do driver desde que não haja um arquivo MET AINF/servi ces/java. sq l . D ri ver que especifique o nome da classe do driver.
Segue abaixo uma amostra do elemento driver para o driver não compatível com o
JD BC 4.0:
28
< driver name="mysql-connector-java-5.1.15.jar"
module="com.mysql"><driverclass>com.mysql.jdbc.Driver</driver-class></driver>
b. C riação d a f o n t e d e d ad o s
Crie um elemento <d ataso urce> na seção <d ataso urces> do arquivo
stand al o ne. xml . Este arquivo contém bastante informações da fonte de dados
anteriormente definida no arquivo *-d s. xml .
Importante
Você deve interromper o servidor antes de editar o arquivo de configuração do
servidor para que sua alteração seja persistida na iniciação do servidor.
Segue abaixo uma amostra de um elemento de fonte de dados MySQL no arquivo
stand al o ne. xml :
< datasource jndi-name="java:/YourDatasourceName" poolname="YourDatasourceName">
<connectionurl>jdbc:mysql://localhost:3306/YourApplicationURL</connectio
n-url>
<driver>mysql-connector-java-5.1.15.jar</driver>
<transactionisolation>TRANSACTION_READ_COMMITTED</transaction-isolation>
<pool>

<min-pool-size>100</min-pool-size>

<max-pool-size>200</max-pool-size>
</pool>
<security>

<user-name>USERID</user-name>

<password>PASSWORD</password>
</security>
<statement>

<prepared-statement-cache-size>100</prepared-statementcache-size>

<share-prepared-statements/>
</statement>
< /datasource>
Reportar um erro
3.1 .6 .4 . Co nfiguração da Fo nt e de Dado s para o Hibe rnat e o u JPA
Caso o seu aplicativo usar o JPA e empacotar atualmente JBoss JARs, você deverá usar o
Hibernate que está incluso com o JBoss EAP 6. Para uso dessa versão do Hibernate, você deve
remover o pacote antigo do Hibernate de seu aplicativo.
29
Pro ced imen t o 3.9 . R emo ção d o p aco t e H ib ern at e
1. Remova o Hibernate JARs de suas pastas da biblioteca do aplicativo.
2. Remova ou comente o elemento <hi bernate. transacti o n. manag er_l o o kup_cl ass>
em seu arquivo persi stence. xml uma vez que este elemento não é necessário.
Reportar um erro
3.1 .6 .5 . At ualização da Co nfiguração do Adapt ado r de Re curso
Su mário
Nas versões anteriores do servidor do aplicativo, a configuração do adaptador do recurso era
definido num arquivo com um sufixo *-d s. xml . No JBoss EAP 6, o adaptador de recurso é
configurado no arquivo de configuração do servidor. Caso você esteja executando num managed
domain, o arquivo de configuração é o arquivo
EAP_HOME/d o mai n/co nfi g urati o n/d o mai n. xml . Caso você esteja executando como um
servidor autônomo, configure o adaptador de recurso no arquivo
EAP_HOME/stand al o ne/co nfi g urati o n/stand al o ne. xml . A informação da referência do
esquema, que é a mesma para ambos os módulos, pode ser encontrada no Resource adapter
descriptors.
Importante
Você deve interromper o servidor antes de editar o arquivo de configuração do servidor para
que sua alteração seja persistida na iniciação do servidor.
D ef in ição d o ad ap t ad o r d e recu rso
A informação do descritor do adaptador de recurso está definida no elemento do seguinte
subsistema no arquivo de configuração do servidor:
< subsystem xmlns="urn:jboss:domain:resource-adapters:1.1"/>
Você usará algumas das informações definidas anteriormente no arquivo *-d s. xml do adaptador
de recurso.
Segue abaixo uma amostra do elemento do adaptador de recurso no arquivo de configuração do
servidor:
< resource-adapters>
<resource-adapter>

<archive>multiple-full.rar</archive>

<config-property name="Name">ResourceAdapterValue</config-property>

<transaction-support>NoTransaction</transaction-support>

<connection-definitions>

<connection-definition

classname="org.jboss.jca.test.deployers.spec.rars.multiple.MultipleManagedConn
ectionFactory1"

enabled="true" jndi-name="java:/eis/MultipleConnectionFactory1"

pool-name="MultipleConnectionFactory1">
30

<config-property
name="Name">MultipleConnectionFactory1Value</config-property>

</connection-definition>

classname="org.jboss.jca.test.deployers.spec.rars.multiple.MultipleManagedConn
ectionFactory2"

enabled="true" jndi-name="java:/eis/MultipleConnectionFactory2"

pool-name="MultipleConnectionFactory2">

<config-property
name="Name">MultipleConnectionFactory2Value</config-property>

</connection-definitions>

<admin-objects>

<admin-object

classname="org.jboss.jca.test.deployers.spec.rars.multiple.MultipleAdminObject
1Impl"

jndi-name="java:/eis/MultipleAdminObject1">

<config-property name="Name">MultipleAdminObject1Value</configproperty>

</admin-object>

<admin-object classname="org.jboss.jca.test.deployers.spec.rars.multiple.MultipleAdminObject
2Impl"

jndi-name="java:/eis/MultipleAdminObject2">

<config-property name="Name">MultipleAdminObject2Value</configproperty>

</admin-object>

</admin-objects>
</resource-adapter>
< /resource-adapters>
Reportar um erro
3.1.7. Alt erações de Segurança
3.1 .7 .1 . Co nfiguração das Alt e raçõ e s de Se gurança do Aplicat ivo
C o n f ig u re a seg u ran ça p ara a au t en t icação b ásica
Nas versões anteriores do JBoss EAP, os arquivos de propriedades posicionados no diretório
EAP_HOME/server/SERVER_NAME/co nf/ estavam no classpath e poderiam ser facilmente
encontrados pelo UsersR o l esLo g i nMo d ul e. No JBoss EAP 6, a estrutura do diretório foi
alterada. Os arquivos da propriedade devem ser empacotados com aplicativo para disponibilizá-los
no classpath.
Importante
Você deve interromper o servidor antes de editar o arquivo de configuração do servidor para
que sua alteração seja persistida na iniciação do servidor.
31
Para configurar a segurança para uma autenticação básica, adicione um novo security domain sob
o securi ty-d o mai ns para o stand al o ne/co nfi g urati o n/stand al o ne. xml ou o arquivo
de configuração do servidor d o mai n/co nfi g urati o n/d o mai n. xml :
< security-domain name="example">

<login-module code="UsersRoles" flag="required">

<module-option name="usersProperties"

value="${jboss.server.config.dir}/exampleusers.properties"/>

<module-option name="rolesProperties"

value="${jboss.server.config.dir}/exampleroles.properties"/>

</login-module>

</authentication>
< /security-domain>
Caso a instância do JBoss EAP 6 estiver sendo executada como um servidor autônomo, o
${jbo ss. server. co nfi g . d i r} refere-se ao diretório
EAP_HOME/stand al o ne/co nfi g urati o n/. Caso a instância estiver executando num managed
domain, o ${jbo ss. server. co nfi g . d i r} refere-se ao diretório
EAP_HOME/d o mai n/co nfi g urati o n/.
Mo d if icação d o s n o mes d o secu rit y d o main
Os security domains não usam mais o prefixo java: /jaas/ em seus nomes no JBoss EAP 6.
Você deve remover esse prefixo das configurações do security domain para os aplicativos da
Web no jbo ss-web. xml .
Você deve remover esse prefixo das configurações do security domain para os aplicativos
Enterprise no jbo ss-web. xml . Esse arquivo foi substituído pelo jbo ss. xml no JBoss EAP 6.
Reportar um erro
3.1.8. Alt erações JNDI
3.1 .8 .1 . At ualização do s No m e s JNDI Nam e space do Aplicat ivo
Su mário
O EJB 3.1 introduzido a um JND I namespace glogal padronizado e uma série de namespaces
relacionados que mapeiam várious escopos do aplicativo Java EE. Os nomes do EJB Portátil é
apenas limitado a três deles: java: g l o bal , java: mo d ul e e java: app. Os aplicativos com os
EJBs que usam o JND I devem ser alterados para seguirem a nova convenção padronizada do JND I
namespace.
Pro ced imen t o 3.10. Mo d if icação d as p esq u isas JN D I
1. Leia mais a respeito deste assunto na Seção 3.1.8.2, “ Nomes do EJB JND I Portátil ”
2. Seção 3.1.8.3, “ Revisão das Regras JND I Namespace”
3. Seção 3.1.8.4, “ Modificação do Aplicativo para Seguir as Novas Regras do JND I Namespace
(Espaço do Nome JND I)”
32
Amo st ra d e Map eamen t o s JN D I
As amostras de espaços de nome JND I dos lançamentos anteriores e como eles são especificados
no JBoss EAP podem ser encontradas na: Seção 3.1.8.5, “ Amostra do JND I Namespaces nos
Lançamentos Anteriores e como são especificados no JBoss EAP 6”
Reportar um erro
3.1 .8 .2 . No m e s do EJB JNDI Po rt át il
Su mário
A especificação do Java EE 6 define quatro namespaces lógicos, cada um com o seu próprio
escopo. No entanto, os nomes do EJB portátil apenas obtém o limite de três deles. A seguinte tabela
detalha quando e como usar cada namespace.
T ab ela 3.1. N amesp aces JN D I Po rt áveis
JN D I N amesp ace
D escrição
java:global
Os nomes neste namespace são compartilhados em todos os
aplicativos implantados numa instância do servidor do
aplicativo. Use nomes neste namespace para encontrar os
arquivos EJBs externos ao mesmo servidor.
Segue abaixo uma amostra do java:global namespace:
java: g l o bal /jbo ss-seam-bo o ki ng /jbo ss-seambo o ki ng -jar/Ho tel Bo o ki ng Acti o n
java:module
Os nomes neste namespace são compartilhados por todos os
componentes num módulo, por exemplo: todos os enterprise
beans num módulo EJB único ou todos os componentes num
módulo da web.
Segue abaixo uma amostra do java:module namespace:
java: mo d ul e/Ho tel Bo o ki ng Acti o n! o rg . jbo ss. seam. e
xampl e. bo o ki ng . Ho tel Bo o ki ng
java:app
Os nomes neste namespace são compartilhados por todos os
componentes num aplicativo único. Por exemplo, um WAR e um
arquivo EJB jar no mesmo arquivo EAR teria acesso recursos no
java:app namespace.
Segue abaixo uma amostra do java:app namespace:
java: app/jbo ss-seam-bo o ki ng jar/Ho tel Bo o ki ng Acti o n
Você pode encontrar maiores informações sobre os contextos de nomeação JND I na seção
EE.5.2.2, " Application Component Environment Namespaces" no " JSR 316: JavaTM Platform,
Enterprise Edition (Java EE) Specification, v6" . Você pode baixar a especificação a partir do
http://jcp.org/en/jsr/detail?id=316
Reportar um erro
3.1 .8 .3. Re visão das Re gras JNDI Nam e space
Su mário
33
O JBoss EAP 6 aprimorou os nomes do JND I namespace, não apenas para fornecer regras
consistentes e premeditadas para cada nome limitado no servidor do aplicativo, mas também para
prevenir problemas futuros de compatibilidade. Isto significa que você poderá ter problemas com os
namespaces atuais no seu aplicativo, caso eles não seguirem as novas regras.
O s n amesp aces d evem seg u ir as seg u in t es reg ras:
1. Os nomes relativos não qualificados como o D efaul tD S ou jd bc/D efaul tD S devem ser
relativamente qualificados para o java: co mp/env, java: mo d ul e/env ou
java: jbo ss/env, dependendo do contexto.
2. Os nomes abso l ute não qualificados como /jd bc/D efaul tD S devem ser relativamente
qualificados a um nome java: jbo ss/ro o t.
3. Os nomes abso l ute qualificados como o java: /jd bc/D efaul tD S devem ser
qualificados da mesma forma que os nomes abso l ute não qualificados acima.
4. O espaço do nome java: jbo ss especial é compartilhado por toda a instância do servidor
AS.
5. Qualquer nome rel ati ve com o prefixo java: deve estar em um dos cinco espaços do
nome: co mp, mo d ul e, app, g l o bal ou jbo ss proprietário. Qualquer nome começando
com java: xxx onde xxx não combina com nenhum dos cinco acima e resultaria num erro
de nome inválido.
Reportar um erro
3.1 .8 .4 . Mo dificação do Aplicat ivo para Se guir as No vas Re gras do JNDI Nam e space
(Espaço do No m e JNDI)
Segue abaixo uma amostra da pesquisa JND I no JBoss EAP 5.1. Este código é normalmente
encontrado num método de inicialização.
p rivate ProductManager productManager;
t ry {

context = new InitialContext();

productManager = (ProductManager)
context.lookup("OrderManagerApp/ProductManagerBean/local");
} catch(Exception lookupError) {

throw new ServletException("Unable to find the ProductManager
bean", lookupError);

}
Note que o nome de pesquisa é O rd erManag erApp/P ro d uctManag erBean/l o cal .
Segue abaixo uma amostra de como a mesma pesquisa seria codificada no JBoss EAP 6
usando o CD I.
@ EJB(lookup="java:app/OrderManagerEJB/ProductManagerBean!services.ejb.
ProductManager")
34
Os valores de pesquisa são definidos como variáveis do associado e usam o novo nome
java: app JND I namespace
java: app/O rd erManag erEJB/P ro d uctManag erBean! servi ces. ejb. P ro d uctManag er.
Caso você prefira não usar o CD I, você pode continuar a criar um novo InitialContext conforme
acima e modificar a pesquisa para uso do novo nome JND I namespace.
t ry {

context = new InitialContext();

productManager = (ProductManager)
context.lookup("java:app/OrderManagerEJB/ProductManagerBean!services.e
jb.ProductManager");
} catch(Exception lookupError) {

throw new ServletException("Unable to find the ProductManager
bean", lookupError);

}
Reportar um erro
3.1 .8 .5 . Am o st ra do JNDI Nam e space s no s Lançam e nt o s Ant e rio re s e co m o são
e spe cificado s no JBo ss EAP 6
T ab ela 3.2.
N amesp ace n o JB o ss EAP
5.x
N amesp ace n o JB o ss EAP 6
C o men t ário s ad icio n ais
OrderManagerApp/ProductMan java:module/ProductManagerB O Java EE 6 binding default.
agerBean/local
ean!services.ejb.ProductManag Possui escopo para o módulo
er
atual e apenas acessível com o
mesmo módulo.
OrderManagerApp/ProductMan java:app/OrderManagerEJB/Pr O Java EE 6 binding default.
agerBean/local
oductManagerBean!services.ej Possui escopo para o
b.ProductManager
aplicativo atual e apenas
acessível com o mesmo
aplicativo.
OrderManagerApp/ProductMan java:global/OrderManagerApp/ O binding default do Java EE
agerBean/local
OrderManagerEJB/ProductMan 6. Possui escopo para o
agerBean!services.ejb.Product servidor do aplicativo e
Manager
acessível globalmente.
java:comp/UserTransaction
O namespace possui escopo
ao componente atual. Não é
acessível para threads que
não estão no Java EE 6, por
exemplo: os threads criados
diretamente pelo seu
aplicativo.
java:jboss/UserTransaction
Acessível globalmente. Use isto
caso o
não esteja disponível.
java:/TransactionManager
java:jboss/TransactionManage
r
35
N amesp ace n o JB o ss EAP
5.x
N amesp ace n o JB o ss EAP 6
java:/TransactionSynchronizat
ionRegistry
java:jboss/TransactionSynchro
nizationRegistry
C o men t ário s ad icio n ais
Reportar um erro
3.2. As Alt erações Dependem nos Component es e na sua Arquit et ura
do Aplicat ivo
3.2.1. Revisão das Alt erações Dependent es em seus Component es e
Arquit et ura do Aplicat ivo
Caso o seu aplicativo use qualquer uma das seguintes tecnologias ou componentes, você pode
precisar realizar as modificações ao seu aplicativo quando você migrar ao JBoss EAP 6.
H ib ern at e e JPA
Caso o seu aplicativo usar o Hibernate ou JPA, o seu aplicativo pode precisar de algumas
modificações. Consulte a Seção 3.2.2.1, “ Atualização dos Aplicativos que usam Hibernate
e/ou JPA” para maiores informações.
R EST
Caso seu aplicativo usar JAX-RS, você deve estar ciente de que o JBoss EAP 6 configura
automaticamente o RESTEasy, de forma de que você não precisa mais configurá-lo
automaticamente. Consulte a Seção 3.2.5.1, “ Configuração das Alterações JAX-RS e
RESTEasy” para maiores informações.
LD AP
O realm de segurança LD AP é configurado de forma diferente no JBoss EAP 6. Caso o seu
aplicativo usar o LD AP, refira-se ao seguinte tópico para maiores informações na
Seção 3.2.6.1, “ Configuração das Alterações LD AP Security Realm” .
Messag in g
O JBoss Messaging não está mais incluído no JBoss EAP 6. Caso o seu aplicativo usar o
JBoss Messaging como provedor messaging, você precisará substituir o código do JBoss
Messag como o HornetQ. A seguinte Seção 3.2.7.3, “ Migração de seu Aplicativo para uso
do HornetQ como um Provedor JMS” descreve o que você precisa realizar.
C lu st erin g
A maneira que você habilita o clustering foi alterada no JBoss EAP 6. Consulte a
Seção 3.2.8.1, “ Realize Alterações ao seu Aplicativo para o Clustering” para maiores
detalhes.
Imp lan t ação d e est ilo d e serviço
Embora o JBoss EAP 6 não usa mais os descritores de estilo de serviço, o contêiner
suporta essas implantações de estilo de serviço sem alterações onde possível. Consulte a
Seção 3.2.9.1, “ Atualização dos Aplicativos que usam as Implantações de estilo de
Serviço” para maiores informações.
In vo cação remo t a
36
Caso o seu aplicativo realizar invocações remota, você pode continuar usando o JND I
para pesquisar um proxy para o seu bean e invocar aquele proxy retornado. Consulte a
Seção 3.2.10.1, “ Migração dos Aplicativos Implantados do JBoss EAP 5 que realiza
Invocações Remotas ao JBoss EAP 6” para maiores informações sobre as alterações dos
namespaces e a sintaxe requerida.
Seam 2.2
Caso o seu aplicativo usar o Seam 2.2, refira-se à seguinte Seção 3.2.13.1, “ Migração dos
Arquivos Seam 2.2 para o JBoss EAP 6” para melhor entendimento das alterações
necessárias que você precisa realizar.
Sp rin g
Consulte a Seção 3.2.14.1, “ Aplicativos Spring de Migração” caso seu aplicativo usar o
Spring.
O u t ras alt eraçõ es q u e p o d em af et ar su a mig ração
Para alterações adicionais do JBoss EAP 6 que podem impactar o seu aplicativo, consulte
a Seção 3.2.15.1, “ Outras alterações que podem afetar sua Migração” .
Reportar um erro
3.2.2. Alt erações JPA e Hibernat e
3.2 .2 .1 . At ualização do s Aplicat ivo s que usam Hibe rnat e e /o u JPA
Su mário
Caso seu aplicativo usar Hibernate ou JPA, leia as seguintes seções e realize quaisquer alterações
necessárias para migrar ao JBoss EAP 6.
1. Seção 3.2.2.2, “ Configuração das Alterações para Aplicativos que usam o Hibernate e o
JPA”
2. Seção 3.2.2.4, “ Atualização de seu Aplicativo Hibernate 3 para uso do Hibernate 4”
3. Seção 3.2.2.9, “ Atualização de seu Aplicativo para ficar de acordo com a Especificação JPA
2.0”
4. Seção 3.2.2.10, “ Substituição do Cache de Segundo Nível JPA/Hibernate com o Infinispan”
5. Seção 3.2.2.12, “ Migração para o Validador Hibernate 4”
Reportar um erro
3.2 .2 .2 . Co nfiguração das Alt e raçõ e s para Aplicat ivo s que usam o Hibe rnat e e o
JPA
Su mário
37
Caso o seu aplicativo contenha um arquivo persi stence. xml ou código usando anotações
@ P ersi stenceC o ntext ou @ P ersi stenceUni t, o JBoss EAP 6 detecta isto durante a
implantação e assume que o aplicativo usa o JPA. Ele adiciona o Hibernate 4 mais algumas outras
dependências ao seu classpath do aplicativo.
Caso o seu aplicativo estiver usando as bibliotecas do Hibernate 3, na maioria das vezes você
estará apto à alterar ao uso do Hibernate 4 e executar com sucesso. No entanto, caso você ver
C l assNo tFo und Excepti o ns quando implantando seu aplicativo, você pode tentar resolvê-las
usando uma das abordagens seguintes.
Importante
Os aplicativos que usam o Hibernate diretamente com o Seam 2.2 podem usar a versão do
Hibernate 3 empacotados dentro do aplicativo. O Hibernate 4, que é fornecido através do
módulo org.hibernate do JBoss EAP 6, não é suportado pelo Seam 2.2. Esta amostra possui
por intenção ajudá-lo executar o seu aplicativo no JBoss EAP 6 como primeira etapa. Por
favor certifique-se de que o empacotamento do Hibernate 3 com o aplicativo Seam 2.2 não é
uma configuração suportada.
Pro ced imen t o 3.12. C o n f ig u ração d o Ap licat ivo
1. C o p ie o H ib ern at e 3 JAR s req u erid o p ara su a b ib lio t eca d o ap licat ivo .
Você pode estar apto a resolver o problema copiando o Hibernate 3 JARs específico que
contém classes ausentes no diretório l i b/ do aplicativo ou adicionando-as ao classpath
usando algum outro método. Em alguns casos, isto pode resultar no
C l assC astExcepti o ns ou outros problemas de carregamento de classe devido ao uso
misturado das versões Hibernate. Caso isto aconteça, você precisará usar a próxima
abordagem.
2. In st ru ção d o servid o r p ara u so ap en as d as b ib lio t ecas H Ib ern at e 3.
O JBoss EAP 6 permite você empacotar os jars do provedor de persistência Hibernate 3.5
(ou superior) com o aplicativo. Para direcionar o servidor para uso apenas das bibliotecas
Hibernate 3 e excluir as bibliotecas do Hibernate 4, você precisa configurar o
jbo ss. as. jpa. pro vi d erMo d ul e para hi bernate3-bund l ed no persi stence. xml ,
conforme abaixo:
< persistence xmlns="http://java.sun.com/xml/ns/persistence"
version="1.0">

<persistence-unit name="plannerdatasource_pu">

<description>Hibernate 3 Persistence Unit.</description>

<jta-data-source>java:jboss/datasources/PlannerDS</jtadata-source>

</properties>

</persistence-unit>
< /persistence>
38
O implantador do Java Persistence API (JPA - API de Persistência Java) detectará a
presença de um provedor de persistência no aplicativo e uso das bibliotecas do Hibernate 3.
Consulte a Seção 3.2.2.3, “ Propriedades da Unidade de Persistência” para maiores
informações sobre as propriedades de persistência JPA.
3. D esat ivação d o cach e d e seg u n d o n ível
O cache de segundo nível para o Hibernate 3 não exibe o mesmo comportamento com o
JBoss EAP 6 assim como fazia nas versões anteriores. Caso você esteja usando o cache de
segundo nível com o seu aplicativo, você deve desativá-lo até atualizá-lo para o Hibernate 4.
Para desativar o cache de segundo nível, configure o
<hi bernate. cache. use_seco nd _l evel _cache> para fal se no arquivo
persi stence. xml .
Reportar um erro
3.2 .2 .3. Pro prie dade s da Unidade de Pe rsist ê ncia
Pro p ried ad es d a C o n f ig u ração H ib ern at e 4 .x
O JBoss EAP 6 configura automaticamente as seguintes propriedades da configuração Hibernate
4.x:
T ab ela 3.3. Pro p ried ad es d a U n id ad e d e Persist ên cia H ib ern at e
N o me d a
Pro p ried ad e
Valo r D ef au lt
Pro p ó sit o
hi bernate. i d .
new_g enerato r
_mappi ng s
verdadeiro
Esta configuração é relevante caso você use
@ G enerated Val ue(AUT O ) para gerar valores de chave
de indexe único. Os novos aplicativos devem manter o
valor default true. Os aplicativos existentes que usavam
o Hibernate 3.3.x talvez tenham que alterar isto para
fal se com o objetivo de continuar usando o objeto de
sequência ou tabela baseada no gerador e manter a
compatibilidade reversa. O aplicativo pode substituir esse
valor no arquivo persi stence. xml .
Maiores informações sobre este comportamento são
fornecidas abaixo.
hi bernate. tra
nsacti o n. jta.
pl atfo rm
hi bernate. ejb
. reso urce_sca
nner
Instância da
Interface
o rg . hi bernate
. servi ce. jta.
pl atfo rm. spi .
JtaP l atfo rm
Instância da
Interface
o rg . hi bernate
. ejb. packag i n
g . Scanner
Essa classe passa o gerenciador de transação, a
transação do usuário e o registro de sincronização da
transação no Hibernate.
Essa classe sabe como usar o indexe de anotação do
JBoss EAP 6 para fornecer uma implantação mais rápida.
39
N o me d a
Pro p ried ad e
hi bernate. tra
nsacti o n. mana
g er_l o o kup_cl
ass
hi bernate. ses
si o n_facto ry_
name
hi bernate. ses
si o n_facto ry_
name_i s_jnd i
hi bernate. ejb
. enti tymanag e
r_facto ry_nam
e
Valo r D ef au lt
Pro p ó sit o
Essa propriedade é removida caso encontrada no
persistence.xml uma vez que isto pode entrar em conflito
com o hi bernate. transacti o n. jta. pl atfo rm
QUALIFIED_PERSI Isto é configurado para o nome do aplicativo + o nome da
STENCE_UNIT_N unidade da persistência. O aplicativo pode especificar um
AME
valor diferente, mas ele deve ser único por todas as
implantações do aplicativo na instância do JBoss EAP 6.
falso
Isto é configurado apenas se o aplicativo não tiver
especificado um valor para o
hi bernate. sessi o n_facto ry_name.
QUALIFIED_PERSI Isto é configurado para o nome do aplicativo + o nome da
STENCE_UNIT_N unidade da persistência. O aplicativo pode especificar um
AME
valor diferente, mas ele deve ser único por todas as
implantações do aplicativo na instância do JBoss EAP 6.
No Hibernate 4.x, caso o new_g enerato r_mappi ng s esteja configurado para true:
O @ G enerated Val ue(AUT O ) mapeia para
o rg . hi bernate. i d . enhanced . Seq uenceStyl eG enerato r.
O @ G enerated Val ue(T ABLE) mapeia para
o rg . hi bernate. i d . enhanced . T abl eG enerato r.
O @ G enerated Val ue(SEQ UENC E) mapeia para
o rg . hi bernate. i d . enhanced . Seq uenceStyl eG enerato r.
No Hibernate 4.x, caso o new_g enerato r_mappi ng s esteja configurado para fal se:
O @ G enerated Val ue(AUT O ) mapeia para o Hibernate " native" .
O @ G enerated Val ue(T ABLE) mapeia para o
o rg . hi bernate. i d . Mul ti pl eHi Lo P erT abl eG enerato r.
O @ G enerated Val ue(SEQ UENC E) mapeia para o Hibernate " seqhilo" .
Consulte o http://www.hibernate.org/docs e veja o Hibernate 4.1 D eveloper Guide para maiores
informações sobre essa propriedade.
Pro p ried ad es d e Persist ên cia JPA
As seguintes propriedades JPA são suportadas na definição de unidade de persistência no arquivo
persi stence. xml :
T ab ela 3.4 . Pro p ried ad es d a U n id ad e d e Persist ên cia JPA
N o me d a
Pro p ried ad e
40
Valo r D ef au lt
Pro p ó sit o
N o me d a
Pro p ried ad e
Valo r D ef au lt
Pro p ó sit o
jbo ss. as. jpa.
pro vi d erMo d ul
e
o rg . hi bernate
O nome do fornecedor de persistência.
O valor deve ser hi bernate3-bund l ed caso os
Hibernate 3 JARs estiverem no arquivo do aplicativo.
Caso o fornecedor de persistência for empacotado com o
aplicativo, este valor deve ser appl i cati o n.
jbo ss. as. jpa.
ad apterMo d ul e
o rg . jbo ss. as.
jpa. hi bernate
:4
O nome das classes de integração que ajuda o JBoss
EAP 6 a funcionar com o fornecedor de persistência.
Os valores válidos e corretos são:
o rg . jbo ss. as. jpa. hi bernate: 4 : Este é para as
classes de integração do Hibernate 4
o rg . jbo ss. as. jpa. hi bernate: 3: Este é para as
classes de integração Hibernate 3
Reportar um erro
3.2 .2 .4 . At ualização de se u Aplicat ivo Hibe rnat e 3 para uso do Hibe rnat e 4
Su mário
Quando você atualizar seu aplicativo para uso do Hibernate 4, algumas atualizações são gerais e
válidas independente da versão Hibernate sendo usada no momento pelo aplicativo. Para as
demais atualizações, você deve determinar qual versão o aplicativo está usando.
Pro ced imen t o 3.13. At u aliz ação d o ap licat ivo p ara u so d o H ib ern at e 4
1. O comportamento default gerador da sequência de auto-incremento foi alterado no JBoss
EAP 6. Consulte a Seção 3.2.2.5, “ Mantenha o Comportamento Existente do Valor Gerado
Automaticamente da Identidade Hibernate” para maiores informações.
2. D etermine a versão do Hibernate sendo utilizado pelo aplicativo e escolha o procedimento
de atualização correto abaixo.
A. Seção 3.2.2.6, “ Migração de seu Aplicativo Hibernate 3.3.x para o Hibernate 4.x ”
B. Seção 3.2.2.7, “ Migração de seu Aplicativo Hibernate 3.5.x para o Hibernate 4.x”
3. Consulte a Seção 3.2.2.8, “ Modificação das Propriedades de Persistência para o Seam
Migrado” caso deseje executar seu aplicativo num ambiente com cluster.
Reportar um erro
3.2 .2 .5 . Mant e nha o Co m po rt am e nt o Exist e nt e do Valo r Ge rado Aut o m at icam e nt e
da Ide nt idade Hibe rnat e
O Hibernate 3.5 introduziu uma propriedade core nomeada
hi bernate. i d . new_g enerato r_mappi ng s que direciona como as colunas de sequência e
identidade são geradas usando o @ G enerated Val ue. No JBoss EAP 6, o valor default para esta
propriedade é configurado como o seguinte:
41
Quando você implanta um aplicativo native Hibernate, o valor default é fal se.
Quando você implanta um aplicativo JPA, o valor default é true.
In st ru çõ es p ara N o vo s Ap licat ivo s
Os novos aplicativos que usam a anotação @ G enerated Val ue devem determinar o valor para a
propriedade hi bernate. i d . new_g enerato r_mappi ng s para true. Esta é a configuração
preferida uma vez que ela é mais portátil entre bancos de dados diferentes. Na maioria das vezes ela
é mais eficiente e, na maioria dos casos, ela endereça compatibilidade com a especificação JPA 2.
Para novos aplicativos JPA, o JBoss EAP 6 padroniza a propriedade
hi bernate. i d . new_g enerato r_mappi ng s para true e isto não deve ser alterado.
Para novos aplicativos native Hibernate , o JBoss EAP 6 aplica o default na propriedade
hi bernate. i d . new_g enerato r_mappi ng s para fal se. Você deve configurar essa
propriedade para true.
In st ru çõ es p ara o JB o ss EAP 5
Os aplicativos existentes que usam a anotação @ G enerated Val ue devem certificar-se de que o
mesmo gerador é usado para criar valores de chave primária para novas entidades quando o
aplicativo é migrado ao JBoss EAP 6.
Para aplicativos JPA existentes, ao JBoss EAP 6 aplica o default na propriedade
hi bernate. i d . new_g enerato r_mappi ng s para true. Você deve configurar esta
propriedade para fal se no arquivo persi stence. xml .
Para aplicativos native Hibernate, o JBoss EAP 6 aplica o default no
hi bernate. i d . new_g enerato r_mappi ng s para fal se e isto não deve ser alterado.
Consulte a Seção 3.2.2.3, “ Propriedades da Unidade de Persistência” para maiores informações
sobre essas configurações de propriedade.
Reportar um erro
3.2 .2 .6 . Migração de se u Aplicat ivo Hibe rnat e 3.3.x para o Hibe rnat e 4 .x
Pro ced imen t o 3.14 .
1. Map eie o s t ip o s d e text H ib ern at e p ara JD BC LO NG VAR C HAR
Nas versões anteriores do Hibernate 3.5, o tipo de text era mapeado para JD BC C LO B. Um
novo tipo de Hibernate, materi al i zed _cl o b, foi adicionado ao Hibernate 4 para mapear
as propriedades Java Stri ng para JD BC C LO B. Caso o seu aplicativo possuir
propriedades configuradas como type= "text" que possuem por intenção serem mapeadas
para JD BC C LO B, você deve fazer o seguinte:
a. Caso o seu aplicativo usar arquivos de mapeamento hbm, altere a propriedade para
type= "materi al i zed _cl o b".
b. Caso seu aplicativo usar anotações, você deve substituir @ T ype(type = "text")
por @ Lo b.
2. R evise o có d ig o p ara en co n t rar alt eraçõ es em t ip o s d e valo res ret o rn ad o s
42
As projeções de critério agregado numérico retornam agora o mesmo tipo de valor de seus
counterparts HQL. Como resultado, os tipos de retorno das projeções seguintes no
o rg . hi bernate. cri teri o n foram alteradas.
a. D evido às alterações no C o untP ro jecti o n, P ro jecti o ns. ro wC o unt(),
P ro jecti o ns. co unt(pro pertyName) e
P ro jecti o ns. co untD i sti nct(pro pertyName), as projeções co unt e co unt
d i sti nct retornam agora um valor Lo ng .
b. D evido às alterações no P ro jecti o ns. sum(pro pertyName), as projeções sum
retornam agora um tipo de valor que depende do tipo de propriedade.
Nota
Falha ao modificar o seu código do aplicativo num
java. l ang . C l assC astExcepti o n.
i. Para propriedades mapeadas com tipos de número primitivo, Número, Longo
ou Curto, o valor Longo é retornado;
ii. Para propriedades mapeadas como tipos de ponto flutuante primitivo, D uplo
ou Flutuante, o valor D uplo é retornado.
Reportar um erro
3.2 .2 .7 . Migração de se u Aplicat ivo Hibe rnat e 3.5 .x para o Hibe rnat e 4 .x
1. Mescle o An n o t at io n C o n f ig u rat io n n a C o n f ig u ração
Embora o Anno tati o nC o nfi g urati o n tenha sido substituído, ele não deve afetar a sua
migração.
Caso você esteja usando um arquivo hbm. xml , você deve estar ciente que o JBoss EAP 6
usa o o rg . hi bernate. cfg . EJB3Nami ng Strateg y no Anno tati o nC o nfi g urati o n ao
invés do o rg . hi bernate. cfg . D efaul tNami ng Strateg y que foi usado em versões
anteriores. Isto pode resultar em incompatibilidade de nomeação. Caso você baseie-se na
estratégia de nomeação para o default do nome de uma tabela associada (muitos-paramuitos e coleções de elementos), você poderá ver esse problema. Para resolver isto, você
pode solicitar ao Hibernate a usar o o rg . hi bernate. cfg . D efaul tNami ng Strateg y de
legacia chamando o C o nfi g urati o n#setNami ng Strateg y e passando-o ao
o rg . hi bernate. cfg . D efaul tNami ng Strateg y#INST ANC E.
2. Mo d if iq u e o s n amesp aces p ara est arem d e aco rd o co m o s n o vo s arq u ivo s
H ib ern at e D T D .
T ab ela 3.5.
D T D N amesp ace an t erio r
N o vo D T D N amesp ace
http://hibernate.sourceforge.net/hibernateconfiguration-3.0.dtd
http://hibernate.sourceforge.net/hibernatemapping-3.0.dtd
http://www.hibernate.org/dtd/hibernateconfiguration-3.0.dtd
http://www.hibernate.org/dtd/hibernatemapping-3.0.dtd
43
3. Mo d if iq u e as variáveis d o amb ien t e
a. Caso você esteja usando o Oracle e usando as propriedades materi al i zed _cl o b
ou materi al i zed _bl o b, a variável de ambiente global
hi bernate. jd bc. use_streams_fo r_bi nary deve ser configurada para
verdadeiro.
b. Caso você esteja usando o PostgreSQL e usando as propriedades C LO B ou BLO B, o
hi bernate. jd bc. use_streams_fo r_bi nary da variável do ambiente global
deve ser configurado para falso.
Reportar um erro
3.2 .2 .8 . Mo dificação das Pro prie dade s de Pe rsist ê ncia para o Se am Migrado
Caso você migrar o aplicativo gerenciado pelo contêiner JPA, as propriedades que influenciam a
serialização dos contextos de persistência estendidos são automaticamente passadas ao sistema.
No entanto, devido às alterações no Hibernate, você pode executar em problemas de serialização
caso você executar seu Seam migrado ou aplicativo Hibernate num ambiente com cluster. Você
poderá observar mensagens de erro similares à seguinte:
javax.ejb.EJBTransactionRolledbackException: JBAS010361: Failed to
deserialize
....
Caused by: java.io.InvalidObjectException: could not resolve session
factory during session deserialization
[uuid=8aa29e74373ce3a301373ce3a44b0000, name=null]
Para solucionar esses erros, você pode modificar as propriedades no arquivo de configuração. Na
maioria das vezes, este é o arquivo persi stence. xml . Para aplicativos native Hibernate API, este
é o arquivo hi bernate. cfg . xml .
Pro ced imen t o 3.16 . C o n f ig u ração d as p ro p ried ad es a serem execu t ad as n u m amb ien t e
co m clu st er
1. D etermine o valor hi bernate. sessi o n_facto ry_name a um nome único. Este nome deve
ser único por todas as implantações de aplicativo na instância do JBoss EAP 6. Por
exemplo:
< property name="hibernate.session_factory_name" value="jboss-seambooking.ear_session_factory"/>
2. D etermine p valor hi bernate. ejb. enti tymanag er_facto ry_name a um nome único.
Este nome deve ser único para todas as implantações do aplicativo na instância do JBoss
EAP 6.
< property name="hibernate.ejb.entitymanager_factory_name"
value="seam-booking.ear_PersistenceUnitName"/>
Para maiores informações sobre as configurações do Hibernate JPA Persistence Unit Property,
consulte a Seção 3.2.2.3, “ Propriedades da Unidade de Persistência” .
44
Reportar um erro
3.2 .2 .9 . At ualização de se u Aplicat ivo para ficar de aco rdo co m a Espe cificação JPA
2 .0
Su mário
A especificação JPA 2.0 requer que um contexto de persistência não seja propagado fora da
transação JTA. Caso o seu aplicativo use apenas contextos de persistência de transação com
escopo, o comportamento é o mesmo que no JBoss EAP 6 assim como era nas versões anteriores
do servidor do aplicativo e nenhuma alteração é requerida. No entanto, caso o seu aplicativo use
um extended persistence context (XPC - contexto de persistência estendida) para permitir o
enfileiramento ou as modificações de dados em lote, você poderá precisar alterar no seu aplicativo.
C o mp o rt amen t o d e p ro p ag ação d e co n t ext o d e p ersist ên cia
Caso o seu aplicativo possua um bean de sessão stateful, Bean1, que use um contexto de
persistência estendido e chame um bean de sessão stateless, Bean2, que usa um contexto de
persistência de transação com escopo, você pode esperar que o seguinte comportamento ocorra:
Caso o Bean1 iniciar uma transação JTA e realizar a invocação do método Bean2 com a
transação JTA ativa, o comportamento no JBoss EAP 6 é o mesmo que dos lançamentos
anteriores e nenhuma alteração será necessária.
Caso o Bean1 não inciar uma transação JTA e realizar a invocação do método Bean2, o
JBoss EAP 6 não propaga o contexto de persistência estendida ao Bean2. Esse
comportamento é diferente ao dos lançamentos anteriores que propagavam o contexto de
persistência estendido ao Bean2. Caso o seu aplicativo esperar que o contexto de persistência
estendido seja propagado ao bean com o gerenciador de entidade transacional, você precisa
alterar o seu aplicativo para realizar a invocação com uma transação JTA ativa.
Reportar um erro
3.2 .2 .1 0 . Subst it uição do Cache de Se gundo Níve l JPA/Hibe rnat e co m o Infinispan
Su mário
O JBoss Cache foi substituído pelo Infinispan para o cache de segundo nível (2LC) Hibernate. Isso
requer uma alteração ao arquivo persi stence. xml . A sintaxe é um pouco diferente, dependendo
de você usar o JPA ou o cache de segundo nível Hibernate. Essas amostras assumem que você está
usando o Hibernate.
Esta é uma amostra de como as propriedades do segundo nível do cache eram especificadas no
arquivo persi stence. xml no JBoss EAP 5.x.
< property name="hibernate.cache.region.factory_class"

value="org.hibernate.cache.jbc2.JndiMultiplexedJBossCacheRegionFactory"/>
< property name="hibernate.cache.region.jbc2.cachefactory"
value="java:CacheManager"/>
< property name="hibernate.cache.use_second_level_cache" value="true"/>
< property name="hibernate.cache.region.jbc2.cfg.entity" value="mvccentity"/>
< property name="hibernate.cache.region_prefix" value="services"/>
45
As seguintes etapas usarão esta amostra para configurar o Infinispan no JBoss EAP 6.
Pro ced imen t o 3.17. Mo d if icação d o arq u ivo persi stence. xml p ara u so In f in isp an
1. C o n f ig u ração In f in isp an p ara o ap licat ivo JPA n o JB o ss EAP 6
Esta é a forma de como você especifica as propriedades para arquivo de mesma
configuração para o aplicativo JPA usando o Infinispan no JBoss EAP 6:
< property name="hibernate.cache.use_second_level_cache"
value="true"/>
Além disso, você precisa especificar um shared -cache-mo d e com um valor de
ENABLE_SELEC T IVE ou ALL conforme abaixo:
A. O ENABLE_SELEC T IVE é o default e valor recomendado. Isto significa que as entidades
não possuem cache a não que você marque-as como com cache.
< shared-cache-mode>ENABLE_SELECTIVE</shared-cache-mode>
B. ALL significa que as entidades sempre possuem cache mesmo que você as marque sem
cache.
< shared-cache-mode>ALL</shared-cache-mode>
2. C o n f ig u re o In f in isp an p ara o ap licat ivo H ib ern at e n at ive n o JB o ss EAP 6
Isto é como você pode especificar a mesma configuração para o aplicativo Hibernate native
usando o Infinispan com o JBoss EAP 6:
< property name="hibernate.cache.region.factory_class"

value="org.jboss.as.jpa.hibernate4.infinispan.InfinispanRegionFacto
ry"/>
< property name="hibernate.cache.infinispan.cachemanager"

value="java:jboss/infinispan/container/hibernate"/>
< property name="hibernate.transaction.manager_lookup_class"

value="org.hibernate.transaction.JBossTransactionManagerLookup"/>
< property name="hibernate.cache.use_second_level_cache"
value="true"/>
Você deve adicionar o seguinte ao arquivo MANIFEST . MF:
46
Dependencies: org.infinispan, org.hibernate
Para maiores informações sobre as propriedades do cache Hibernate, consulte: Seção 3.2.2.11,
“ Propriedades do Cache Hibernate” .
Reportar um erro
3.2 .2 .1 1 . Pro prie dade s do Cache Hibe rnat e
T ab ela 3.6 . Pro p ried ad es
N o me d a Pro p ried ad e
D escrição
O nome da classe de um C acheP ro vi d er
personalizado.
hi bernate. cache. use_mi ni mal _puts
Booliano. Otimiza a operação do cache de
segundo nível para minimizar as gravações, ao
custo de leituras mais frequentes. Essa
configuração é mais útil para caches com
cluster, sendo que o Hibernate3 é habilitado por
default para as implantações do cache com
cluster.
hi bernate. cache. use_q uery_cache
Booliano. Habilita o cache da consulta. As
consultas individuais continuam sendo
configuradas com o cache.
hi bernate. cache. use_seco nd _l evel _ca Booliano. Usado para desativar completamente
che
o cache de segundo nível, que é habilitado por
default para classes que especificam um
mapeamento <cache>.
hi bernate. cache. q uery_cache_facto ry
O nome da classe da interface Q ueryC ache
default. O valor default é um
Stand ard Q ueryC ache interno.
hi bernate. cache. reg i o n_prefi x
O prefixo para uso dos nomes de região do
cache de segundo nível.
hi bernate. cache. use_structured _entri Booliano. Força o Hibernate a aplicar o store
es
nos dados no cache de segundo nível num
formato mais fácil para o usuário.
hi bernate. cache. d efaul t_cache_co ncur Configuração usada para gerar o nome do
rency_strateg y
o rg . hi bernate. anno tati o ns. C acheC o nc
urrencyStrateg y default de uso quando tanto
o @ C acheabl e ou @ C ache forem usados. O
@ C ache(strateg y= ". . ") é usado para
substituir este default.
hi bernate. cache. pro vi d er_cl ass
Reportar um erro
3.2 .2 .1 2 . Migração para o Validado r Hibe rnat e 4
Su mário
O Validador Hibernate 4.x é uma nova base de código que implementa o JSR 303 - Bean Validation.
O processo de migração do Validator 3.x para 4.x é bastante simples, mas existem algumas
alterações que você deve realizar quando migrando seu aplicativo.
47
Pro ced imen t o 3.18. Vo cê p o d e p recisar execu t ar u ma o u mais d essas t aref as
1. Acesso ao Valid at o rFact o ry d ef au lt
O JBoss EAP 6 bind (associa) o ValidatorFactory default ao contexto JND I sob o nome
java: co mp/Val i d ato rFacto ry.
2. C o mp reen d en d o o ciclo d e vid a d a valid ação t rig g er
Quando usado em combinação com o Hibernate Core 4, o ciclo de vida baseado na
validação é automaticamente habilitado pelo Hibernate Core.
a. A validação ocorre nas operações INSER T , UP D AT E e D ELET E de entidade.
b. Você pode configurar os grupos a serem validados pelo tipo de evento usando as
seguintes propriedades:
javax. persi stence. val i d ati o n. g ro up. pre-persi st,
javax. persi stence. val i d ati o n. g ro up. pre-upd ate, and
javax. persi stence. val i d ati o n. g ro up. pre-remo ve.
Os valores dessas propriedades são de vírgula separada, nomes de classe
inteiramente qualificada dos grupos a serem validados.
Os grupos de validação são um novo recurso da especificação da Validação Bean.
Caso você não deseje aproveitar as vantagens desse novo recurso, não existem
alterações requeridas na migração para o Hibernate Validator 4.
c. Caso você desativar o ciclo de vida baseado na validação pela configuração da
propriedade javax. persi stence. val i d ati o n. mo d e para no ne. Outros valores
válidos para esta propriedade são auto (o default), cal l back e d d l .
3. C o n f ig u ração d e seu ap licat ivo p ara u so d a valid ação
a. Caso você deseje manualmente controlar a validação, você pode criar um Validador
em algumas das seguintes maneiras:
Crie uma instância Val i d ato r a partir do Val i d ato rFacto ry usando o
método g etVal i d ato r().
Injete as Instâncias do Validador em seu EJB. O bean CD I ou qualquer outro
recurso injetável do Java EE.
b. Você pode usar o Val i d ato rC o ntext retornado pelo
Val i d ato rFacto ry. usi ng C o ntext() para personalizar sua instância do
Validador. Você pode configurar um Messag eInterpo l ato r,
T raverabl eR eso l ver e C o nstrai ntVal i d ato rFacto ry personalizado usando
o API. Essas interfaces são específicas na especificação do Bean Validation e são
novas ao Hibernate Validator 4.
4. Mo d if icação d o có d ig o p ara u so d e n o vas rest riçõ es d o B ean Valid at io n
As novas restrições de validação de nível Bean solicitam alterações de código quando
migrando ao Hibernate Validator 4.
48
a. Você deve usar as restrições nos seguintes pacotes para atualização ao Validador
Hibernate 4:
javax. val i d ati o n. co nstrai nts
o rg . hi bernate. val i d ato r. co nstrai nts
b. Todas as restrições que existiam no Hibernate Validator 3 continuam disponíveis no
Hibernate Validator 4. Para usá-las, você precisa importar a classe especificada e em
alguns casos alterar o nome ou tipo de parâmetro de restrição.
5. U so d e rest rição p erso n aliz ad a
No Hibernate Validator 3, é necessária uma restrição personalizada para implantar a
interface o rg . hi bernate. val i d ato r. Val i d ato r. No Hibernate Validator 4, você
precisa implantar a interface javax. val i d ati o n. C o nstrai ntVal i d ato r. Essa
interface contém os mesmos métodos i ni ti al i ze() e i sVal i d () da interface anterior,
no entanto, o método de assinatura foi alterado. Além disso, a alteração D D L não é mais
suportada no Hibernate Validator 4.
Reportar um erro
3.2.3. Alt erações do JSF
3.2 .3.1 . Habilit ação de Aplicat ivo s para Uso de Ve rsõ e s Ant igas do JSF
Su mário
Caso seu aplicativo usar uma versão antiga do JSF, você não precisará atualizar para o JSF 2.0.
Ao invés disso, você pode criar um arquivo jbo ss-d epl o yment-structure. xml para solicitar
que o JBoss EAP 6 use o JSF 1.2 ao invés do JSF 2.0 com a sua implantação de aplicativo. Este
descritor de implantação específico do JBoss é usado para controlar o carregador de classe e é
posicionado no diretório MET A-INF/ ou WEB-INF/do seu WAR, ou no diretório MET A-INF/ do seu
EAR.
Segue abaixo uma amostra de um arquivo jbo ss-d epl o yment-structure. xml que adiciona a
dependência para o módulo JSF 1.2 e exclui ou previne o carregamento automático do módulo JSF
2.0.
< jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.0">

</dependencies>

</deployment>

</exclusions>

49

</dependencies>
</sub-deployment>
/jboss-deployment-structure>
<

Reportar um erro
3.2.4 . Alt erações dos Serviços da Web
3.2 .4 .1 . Alt e raçõ e s do s Se rviço s da We b
O JBoss EAP 6 inclui suporte para a implantação dos pontos de extremidades do Serviço da Web
JAX-WS. Este suporte é fornecido pelo JBossWS. Para maiores informações sobre os Serviços da
Web, refira-se ao capítulo Serviços JAX-WS Web no Guia de Desenvolvimento para o JBoss EAP 6 no
O JBossWS 4 inclui as seguintes alterações que podem impactar sua migração.
Alt eraçõ es d o Pro jet o JB o ssWS API
Os componentes SPI e Comuns foram refabricados no JBossWS 4. A seguinte tabela lista
o API e as alterações de empacotamento que podem afetar a sua migração do aplicativo.
T ab ela 3.7. T aman h o d as Pro p ried ad es d o Man u sead o r d o Lo g
JAR an t ig o
Paco t e an t ig o
JBossWS
SPI
JBossWS
SPI
JBossWS
SPI
JBossWS
SPI
JBossWS
SPI
JBossWS
SPI
JBossWS
SPI
JBossWS
Common
JBossWS
Common
JBossWS
Common
JBossWS
Common
JBossWS
Native
org.jboss.wsf.spi.annotatio
n.*
org.jboss.wsf.spi.binding.*
N o vo JAR
JBossWS
API
JBossWS
API
org.jboss.wsf.spi.managem JBossWS
ent.recording.*
API
org.jboss.wsf.spi.tools.*
JBossWS
API
org.jboss.wsf.spi.tools.ant.* JBossWS
API
org.jboss.wsf.spi.tools.cmd. JBossWS
*
API
org.jboss.wsf.spi.util.Servic JBossWS
eLoader
API
org.jboss.wsf.common.*
JBossWS
API
org.jboss.wsf.common.hand JBossWS
ler.*
API
org.jboss.wsf.common.addr JBossWS
essing.*
API
org.jboss.wsf.common.D OM JBossWS
Utils
API
org.jboss.ws.annotation.En JBossWS
dpointConfig
API
@ Web C o n t ext An n o t at io n
No JBossWS 3.4.x, esta anotação foi empacotada como
50
N o vo p aco t e
org.jboss.ws.api.annotation
.*
org.jboss.ws.api.binding.*
org.jboss.ws.api.monitoring
.*
org.jboss.ws.api.tools.*
org.jboss.ws.tools.ant.*
org.jboss.ws.tools.cmd.*
org.jboss.ws.api.util.Service
Loader
org.jboss.ws.common.*
org.jboss.ws.api.handler.*
org.jboss.ws.api.addressin
g.*
org.jboss.ws.api.util.D OMUt
ils
org.jboss.ws.api.annotation
.EndpointConfig
o rg . jbo ss. wsf. spi . anno tati o n. WebC o ntext no projeto JBossWS SPI. No
JBossWS 4.0, esta anotação foi movida ao
o rg . jbo ss. ws. api . anno tati o n. WebC o ntext no projeto do JBossWS API. Caso o
seu aplicativo incluir uma dependência, você deve substituir as importações e
dependências no código de fonte do aplicativos e compilá-lo em referência ao novo
JBossWS API JAR.
Existe também uma mudança num atributo que não é compatível com versões anteriores. O
atributo Stri ng [] vi rtual Ho sts foi alterado para Stri ng vi rtual Ho sts. No JBoss
EAP 6, você pode especificar apenas um host virtual por implantação. Caso diversos
serviços da web usarem a anotação @ WebC o ntext, o valor do virtualHost deve ser
idêntico a todos os pontos de extremidade definidos no arquivo de implantação.
C o n f ig u ração d o Po n t o d e Ext remid ad e
O JBossWS 4.0 fornece integração da pilha dos JBoss Web Services com a maioria dos
módulos do projeto Apache CXF. A camada de integração permite o uso de webservices
APIs padrões, incluindo o JAX-WS. Isto permite também o uso dos recursos avançados do
Apache CX na parte superior do contêiner do JBoss EAP 6 sem requerer montagem ou
configuração complexa.
O subsistema webservi ce na configuração domain do JBoss EAP 6 inclui configurações
do ponto de extremidade pré-definidos. Você pode definir também suas próprias
configurações do ponto de extremidade adicional. A anotação
@ o rg . jbo ss. ws. api . anno tati o n. End po i ntC o nfi g é usada para referenciar uma
configuração do ponto de extremidade gerado.
Refira-se ao capítulo Serviços JAX-WS Web no Guia de D esenvolvimento para o JBoss EAP
6 no https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/
para maiores informações sobre este respeito.
jb o ss- web services.xml D ep lo ymen t D escrip t o r
O JBossWS 4.0 introduz um novo descritor de implantação para configurar os serviços da
web. O arquivo jbo ss-webservi ces. xml fornece informação adicional para a
implantação gerada e substitui parcialmente o arquivo jbo ss. xml obsoleto.
Para as implantações do EJB webservice, o local esperado para o arquivo do descritor
jbo ss-webservi ces. xml está no diretório MET A-INF/. Para os pontos de extremidade
do POJO e EJB webservice empacotados no arquivo WAR, o local esperado do arquivo
jbo ss-webservi ces. xml está no diretório WEB-INF/.
Segue abaixo uma amostra do arquivo do descritor jbo ss-webservi ces. xml e uma
tabela descrevendo os elementos.
< webservices>

<context-root>foo<context-root>

<config-name>Standard WSSecurity Endpoint</config-name>

<config-file>META-INF/custom.xml</config-file>

<value>prop.value</value>

</property>

<port-component>

<ejb-name>TestService</ejb-name>

<port-component-name>TestServicePort</port-componentname>
51

<port-component-uri>/*</port-component-uri>
<auth-method>BASIC</auth-method>

<transport-guarantee>NONE</transport-guarantee>

<secure-wsdl-access>true</secure-wsdl-access>

</port-component>

<webservice-description>

<webservice-description-name>TestService</webservicedescription-name>

<wsdl-publish-location>file:///bar/foo.wsdl</wsdl-publishlocation>

</webservice-description>
< /webservices>

T ab ela 3.8. jb o ss- web service.xml File Elemen t D escrip t io n
N o me d o Elemen t o
D escrição
context-root
Usado para personalizar a raiz do contexto da
implantação dos webservices.
Usado para associar uma implantação do ponto de
extremidade com uma configuração do ponto de
extremidade gerado. As configurações do ponto de
extremidade são especificadas no arquivo de
configuração referenciados ou num subsistema
webservi ces da configuração do domain.
Usado para configurar os pares do valor do nome de
propriedade simples para configurar o comportamento da
pilha webservice.
Usado para personalizar o URI de destinação do ponto de
extremidade ou para configurar as propriedades
relacionadas com a segurança.
Usado para personalizar ou substituir o local publicado
do webservice WSD L.
config-name
config-file
propriedade
port-component
webservice-description
Reportar um erro
3.2.5. Alt erações JAX-RS e REST Easy
3.2 .5 .1 . Co nfiguração das Alt e raçõ e s JAX-RS e REST Easy
O JBoss EAP 6 automaticamente configura o RESTEasy, de forma que você não precisa configurálo. Portanto, você deve remover toda configuração RESTEasy existente de seu arquivo web. xml e
substituí-la por uma das três opções abaixo:
1. Sub-classifique o javax. ws. rs. co re. Appl i cati o n e use a anotação
@ Appl i cati o nP ath.
Esta é a opção mais fácil e não requer qualquer configuração xml. Apenas sub-classifique o
javax. ws. rs. co re. Appl i cati o n em seu aplicativo e anote-o com o caminho que
deseja para disponibilizar as classes JAX-RS. Por exemplo:
52
@ ApplicationPath("/mypath")
p ublic class MyApplication extends Application {

}
Na amostra acima, os seus recursos JAX-RS estão disponíveis no caminho
/MY_WEB_APP_CONTEXT/mypath/.
Nota
Perceba que o caminho deve ser especificado como /mypath e não /mypath/*. Não
deve ter nenhum asterísco ou barra.
2. Sub-classifique javax. ws. rs. co re. Appl i cati o n e use o arquivo web. xml para
configurar o mapeamento JAX-RS.
Caso você não deseje usar a anotação @ Appl i cati o nP ath, você terá que sub-classificar
da mesma forma o javax. ws. rs. co re. Appl i cati o n. Você então irá configurar o
mapeamento JAX-RS no arquivo web. xml . Por exemplo:
p ublic class MyApplication extends Application {

}
< servlet-mapping>

<servlet-name>com.acme.MyApplication</servlet-name>

<url-pattern>/hello/*</url-pattern>
< /servlet-mapping>
Na amostra acima, os seus recursos JAX-RS estão disponíveis no
/MY_WEB_APP_CONTEXT/hel l o do caminho.
Nota
Você pode usar também esta abordagem para substituir um caminho de aplicativo
que foi configurado usando a anotação @ Appl i cati o nP ath.
3. Modificação do arquivo web. xml .
Caso você deseje sub-classificar o Appl i cati o n, você pode configurar o mapeamento
JAX-RS no arquivo web. xml , conforme abaixo:
< servlet-mapping>

<servlet-name>javax.ws.rs.core.Application</servlet-name>

<url-pattern>/hello/*</url-pattern>
< /servlet-mapping>
Na amostra acima, os seus recursos JAX-RS estão disponíveis no
/MY_WEB_APP_CONTEXT/hel l o do caminho.
53
Nota
Caso você escolha esta opção, você precisará apenas adicionar o mapeamento.
Você não precisa adicionar o servlet correspondente. O servidor é responsável pela
adição do servlet correspondente automaticamente.
Reportar um erro
3.2.6. Alt erações do Realm de Segurança LDAP
3.2 .6 .1 . Co nfiguração das Alt e raçõ e s LDAP Se curit y Re alm
No JBoss EAP 5, o LD AP security realm foi configurado num elemento <appl i cati o n-po l i cy>
no arquivo l o g i n-co nfi g . xml . No JBoss EAP 6, o LD AP security realm é configurado no
elemento <securi ty-d o mai n> no arquivo do servidor do aplicativo. Para um servidor autônomo,
este é o arquivo stand al o ne/co nfi g urati o n/stand al o ne. xml . Caso você esteja executando
o seu servidor num managed domain, este é o arquivo d o mai n/co nfi g urati o n/d o mai n. xml .
Segue abaixo a configuração realm de segurança LD AP no arquivo l o g i n-co nfi g . xml do
JBoss EAP 5:
< application-policy name="mcp_ldap_domain">
<authentication>

<login-module code="org.jboss.security.auth.spi.LdapExtLoginModule"
flag="required">

<module-option
name="java.naming.factory.initial">com.sun.jndi.ldap.LdapCtxFactory</mod
ule-option>

<module-option
name="java.naming.security.authentication">simple</module-option>

....

</login-module>
</authentication>
< /application-policy>
Segue abaixo uma amostra da configuração LD AP no arquivo de configuração do servidor no
JBoss EAP 6:
< subsystem xmlns="urn:jboss:domain:security:1.0">
<security-domains>

<security-domain name="mcp_ldap_domain" cache-type="default">

<login-module code="org.jboss.security.auth.spi.LdapLoginModule"
flag="required">

<module-option name="java.naming.factory.initial"
value="com.sun.jndi.ldap.LdapCtxFactory"/>

<module-option name="java.naming.security.authentication"
value="simple"/>

...

</login-module>
54

</authentication>
</security-domain>
</security-domains>
< /subsystem>

Nota
A pesquisa XML alterada no JBoss EAP 6. No JBoss EAP 5, você especificou as opções do
módulo como conteúdo do elemento, como por exemplo:
< module-option
name="java.naming.factory.initial">com.sun.jndi.ldap.LdapCtxFactory
</module-option>
Agora, as opções de módulo devem ser especificadas como atributos de elemento com
" value=" conforme abaixo:
< module-option name="java.naming.factory.initial"
value="com.sun.jndi.ldap.LdapCtxFactory"/>
Reportar um erro
3.2.7. Alt erações do Hornet Q
3.2 .7 .1 . Ho rne t Q e NFS
Na maioria das vezes, o NFS não é um método apropriado de storing de dados JMS para uso com o
HornetQ, quando usando o NIO como um tipo de diário devido à maneira de sincronização que o
mecanismo de bloqueio funciona. No entanto, o NFS pode ser usado em determinadas
circunstâncias, apenas nos servidores do Red Hat Enterprise Linux. Isto é devido à implantação
NFS usada pelo Red Hat Enterprise Linux.
A implantação NFS do Red Hat Enterprise Linux suportar ambos I/O diretos (arquivos de abertura
com o conjunto de aviso O_D IRECT) e kernel baseado no I/O assíncrono. É possível o uso do NFS
com ambos recursos presentes e é possível usar o NFS como opção de storage compartilhado, sob
as seguintes regras:
O cache do cliente NFS do Red Hat Enterprise Linux deve ser desabilitado.
Importante
O log do servidor deve ser checado após o JBoss EAP 6 for iniciado para certificar-se de que
a biblioteca native seja carregada com sucesso e que o tipo de diário ASYNCIO está sendo
usado. Caso a biblioteca native falhar no carregamento, o HornetQ falhará no tipo de diário
NIO e isto será mencionado no log do servidor.
55
Importante
A biblioteca native que implementa o I/O assíncrono requer que o l i bai o seja instalado no
sistema do Red Hat Enterprise Linux onde o JBoss EAP 6 está sendo executado.
Reportar um erro
3.2 .7 .2 . Co nfiguração do JMS Bridge para Migração de JMS Me ssage s Exist e nt e s ao
JBo ss EAP 6
O JBoss EAP 6 substitui o JBoss Messaging pelo HornetQ como implantação JMS default. A
maneira mais fácil de migrar as mensagens JMS a partir de um ambiente a um outro ambiente é usar
um JMS bridge. A função do JMS bridge é consumir mensagens a partir de uma destinação JMS de
fonte e enviá-las à destinação JMS. Você pode configurar e implantar o JMS bridge ao servidor
JBoss EAO 5.x ou para o JBoss EAP 6.1 ou servidor mais recente. Os seguintes procedimentos
descrevem como realizar isto.
Pro ced imen t o 3.19 . C o n f ig u re o JMS B rid g e imp lan t ad o a Servid o r JB o ss EAP 5.x
Para evitar conflitos em classes entre lançamentos, você deve usar o seguinte procedimento para
configurar o JMS bridge no JBoss EAP 5.x. Os nomes do diretório SAR e bridge são arbritários e
podem ser alterados, caso você desejar.
1. Crie um subdiretório no diretório de implantação do JBoss EAP 5 para conter o SAR, por
exemplo: EAP5_HOME/server/PROFILE_NAME/d epl o y/myBri d g e. sar
2. Crie um subdiretório nomeado MET A-INF no
EAP5_HOME/server/PROFILE_NAME/d epl o y/myBri d g e. sar/.
3. Crie um arquivo jbo ss-servi ce. xml que contém informação similar ao seguinte no
diretório EAP5_HOME/server/PROFILE_NAME/d epl o y/myBri d g e. sar/MET A-INF/.
< server>

<loader-repository>

com.example:archive=unique-archive-name

<loader-repositoryconfig>java2ParentDelegation=false</loader-repository-config>

</loader-repository>

<attribute
name="ProviderName">EnterpriseApplicationPlatform6JMSProvider</attr
ibute>

<attribute
name="ProviderAdapterClass">org.jboss.jms.jndi.JNDIProviderAdapter<
/attribute>

<attribute
name="FactoryRef">jms/RemoteConnectionFactory</attribute>

<attribute
name="QueueFactoryRef">jms/RemoteConnectionFactory</attribute>
56

<attribute
name="TopicFactoryRef">jms/RemoteConnectionFactory</attribute>

java.naming.factory.initial=org.jboss.naming.remote.client.InitialC
ontextFactory

java.naming.provider.url=remote://EnterpriseApplicationPlatform6hos
t:4447

java.naming.security.principal=jbossuser

java.naming.security.credentials=jbosspass

</attribute>

</mbean>

<depends optional-attributename="SourceProviderLoader">jboss.messaging:service=JMSProviderLoad
er,name=JMSProvider</depends>

<depends optional-attributename="TargetProviderLoader">jboss.messaging:service=JMSProviderLoad
er,name=EnterpriseApplicationPlatform6JMSProvider</depends>

<attribute
name="SourceDestinationLookup">/queue/A</attribute>

<attribute
name="TargetDestinationLookup">jms/queue/test</attribute>

<attribute name="AddMessageIDInHeader">false</attribute>

<attribute name="TargetUsername">jbossuser</attribute>

<attribute name="TargetPassword">jbosspass</attribute>

</mbean>
< /server>

Nota
O <l o ad -repo si to ry> está presente para garantir que o SAR já foi um classloader
isolado. Além disso, perceba que ambos bridge " target" e bridge look-up incluem
credenciais de segurança para o usuário " jbossuser" com senha " jbosspass" . Isto é
devido ao JBoss EAP 6 possuir segurança por default. O usuário nomeado
" jbossuser" com senha " jbosspass" foi criado no Appl i cati o nR eal m com a função
g uest usando o script EAP_HOME/bi n/ad d _user. sh.
4. Copie os seguintes JARs a partir do diretório
EAP_HOME/mo d ul es/system/l ayers/base/ no diretório
EAP5_HOME/server/PROFILE_NAME/d epl o y/myBri d g e. sar/. Substitua cada
VERSION_NUMBER pelo número de versão em sua distribuição do JBoss EAP 6.
57
o rg /ho rnetq /mai n/ho rnetq -co re-VERSION_NUMBER. jar
o rg /ho rnetq /mai n/ho rnetq -jms-VERSION_NUMBER. jar
o rg /jbo ss/ejb-cl i ent/mai n/jbo ss-ejb-cl i ent-VERSION_NUMBER. jar
o rg /jbo ss/l o g g i ng /mai n/jbo ss-l o g g i ng -VERSION_NUMBER. jar
o rg /jbo ss/l o g manag er/mai n/jbo ss-l o g manag er-VERSION_NUMBER. jar
o rg /jbo ss/marshal l i ng /mai n/jbo ss-marshal l i ng -VERSION_NUMBER. jar
o rg /jbo ss/marshal l i ng /ri ver/mai n/jbo ss-marshal l i ng ri ver-VERSION_NUMBER. jar
o rg /jbo ss/remo te-nami ng /mai n/jbo ss-remo tenami ng -VERSION_NUMBER. jar
o rg /jbo ss/remo ti ng 3/mai n/jbo ss-remo ti ng -VERSION_NUMBER. jar
o rg /jbo ss/sasl /mai n/jbo ss-sasl -VERSION_NUMBER. jar
o rg /jbo ss/netty/mai n/netty-VERSION_NUMBER. jar
o rg /jbo ss/remo ti ng 3/remo te-jmx/mai n/remo ti ng -jmx-VERSION_NUMBER. jar
o rg /jbo ss/xni o /mai n/xni o -api -VERSION_NUMBER. jar
o rg /jbo ss/xni o /ni o /mai n. xni o -ni o -VERSION_NUMBER. jar
Nota
Não copie simplesmente o EAP_HOME/bi n/cl i ent/jbo ss-cl i ent. jar uma vez
que as classes javax API classes entrarão em conflito com aquelas do JBoss EAP 5.x.
Pro ced imen t o 3.20. C o n f ig u re o JMS B rid g e imp lan t ad o a Servid o r JB o ss EAP 6 .x
No JBoss EAP 6.1 e mais recente, o JMS bridge pode ser usado para ser a ponte de mensagens de
qualquer servidor compatível com o JMS 1.1. Sendo que a fonte e o destino dos recursos JMS são
observados usando o JND I, as classe de pesquisa JND I do provedor de mensagem da fonte, ou
agente de mensagem, deve ser empacotado num JBoss Module. O seguinte procedimento usa o
agente de mensagem 'MyCustomMQ' fictício como uma amostra.
1. Criação do módulo do JBoss para o provedor de mensagem.
a. Crie uma estrutura de diretório sob o EAP_HOME/mo d ul es/system/l ayers/base/
para o novo módulo. Osubdiretório mai n/ conterá o cliente JARs e o arquivo
mo d ul e. xml . Segue abaixo uma amostra da estrutura do diretório criada para o
provedor de mensagem MyCustomMQ:
EAP_HOME/mo d ul es/system/l ayers/base/o rg /mycusto mmq /mai n/
b. No subdiretório mai n/, crie um arquivo mo d ul e. xml contendo a definição do
módulo para o provedor de mensagem. Segue abaixo uma amostra do
mo d ul e. xml criado para o provedor de mensagem MyCustomMQ.
58
< module xmlns="urn:jboss:module:1.1" name="org.mycustommq">

</properties>

<resource-root path="mycustommq-1.2.3.jar" />

<resource-root path="mylogapi-0.0.1.jar" />

</resources>

<dependencies>
<!-- Add the dependencies required by JMS Bridge code

-->

</dependencies>
< /module>
c. Copie os JARs do provedor de mensagem requeridos pela pesquisa JND I dos
recursos de fonte ao subdiretório mai n/. A estrutura do diretório para o módulo
MyCustomMQ deve parecer-se agora com o seguinte:
modules/
`-- system
`-- layers
`-- base
`-- org
`-- mycustommq
`-- main
|-- mycustommq-1.2.3.jar
|-- mylogapi-0.0.1.jar
|-- module.xml
2. Configure o JMS bridge no subsistema messag i ng do servidor do JBoss EAP 6.
a. Antes de começar, interrompa o servidor e realize o backup dos arquivos de
configuração do servidor atual. Caso você esteja executando o servidor autônomo,
este é o arquivo EAP_HOME/stand al o ne/co nfi g urati o n/stand al o ne-ful l ha. xml . Caso você esteja executando o managed domain, realize o backup em
ambos os arquivos EAP_HOME/d o mai n/co nfi g urati o n/d o mai n. xml e
EAP_HOME/d o mai n/co nfi g urati o n/ho st. xml .
b. Adicione o elemento <jms-bri d g e> ao subsistema messag i ng no arquivo de
configuração do servidor. Os elementos <so urce> e <targ et> fornecem os nomes
dos recursos JMS usados para as pesquisas JND I. Caso os credenciais <user> e
<passwo rd > forem especificados, eles serão passados como argumentos quando a
conexão for criada.
59
Segue abaixo uma amostra do elemento <jms-bri d g e> configurado para o
provedor de mensagem MyCustomMQ:
< subsystem xmlns="urn:jboss:domain:messaging:1.3">

...

<jms-bridge name="myBridge" module="org.mycustommq">

<connection-factory name="ConnectionFactory"/>

</context>

</source>

<connection-factory name="java:/ConnectionFactory"/>

</target>

<quality-of-service>DUPLICATES_OK</quality-of-service>

<failure-retry-interval>500</failure-retry-interval>

<max-retries>1</max-retries>

<max-batch-size>500</max-batch-size>

<max-batch-time>500</max-batch-time>

<add-messageID-in-header>true</add-messageID-in-header>

</jms-bridge>
< /subsystem>
Na amostra acima, as propriedades JND I são definidas no elemento <co ntext>
para o <so urce>. Caso o elemento <co ntext> for omitido, assim como na amostra
<targ et> acima, os recursos JMS são pesquisados na instância local.
Reportar um erro
3.2 .7 .3. Migração de se u Aplicat ivo para uso do Ho rne t Q co m o um Pro ve do r JMS
O JBoss Messaging não está mais incluído no JBoss EAP 6. Caso o seu aplicativo use o JBoss
Messaging como um fornecedor messaging, você precisará substituir o código do JBoss Messaging
com o HornetQ.
Pro ced imen t o 3.21. An t es d e co meçar
1. Encerre o cliente e o servidor
2. Realize uma cópia do backup de quaisquer dados do JBoss Messaging. Os dados da
mensagem são stored num banco de dados com tabelas pré-fixadas com o JBM_.
Pro ced imen t o 3.22. Alt ere seu p ro ved o r p ara o H o rn et Q
1. T ran sf ira co n f ig u raçõ es
60
A transferência das configurações do JBoss Messaging à configuração do JBoss EAP 6. As
seguintes configurações podem ser encontradas nos descritores de implantação
localizados no servidor do JBoss Messaging:
Configuração do Serviço de Criações da Conexões
Esta configuração descreve as criações da conexão JMS implantada com o servidor do
JBoss Messaging. O JBoss Messaging configura as criações da conexão num arquivo
nomeado co nnecti o n-facto ri es-servi ce. xml , que está localizado no diretório de
implantação do servidor do aplicativo.
Configuração de D estinação
Esta configuração descreve as filas JMS e tópicos implantados com o servidor do JBoss
Messaging. Por default, o JBoss Messaging configura as destinações num arquivo
nomeado d esti nati o ns-servi ce. xml que está localizado no diretório de
implantação no servidor do aplicativo.
Configuração do Serviço Bridge de Mensagem
Esta configuração inclui os serviços de ponte implantados com o servidor do JBoss
Messaging. Nenhum dos bridges é implantado por default, de forma que o nome do
arquivo da implantação varia, dependendo de sua instalação.
2. Mo d if icação d e seu có d ig o d e arq u ivo
Caso o código do aplicativo usar o JMS default, nenhuma alteração do código será
solicitada. No entanto, caso o aplicativo seja conectado a um cluster, você deverá revisar
com cuidado a documentação HornetQ das semânticas de clustering. O clustering está fora
do escopo da especificação JMS e o HornetQ e o JBoss Messaging tomaram abordagens
diferentes em suas respectivas implementações de funcionalidade de clustering.
Caso o aplicativo usar recursos específicos do JBoss Messaging, você deverá modificar o
código para uso dos recursos equivalentes disponíveis no HornetQ.
Para maiores informações sobre a configuração do messaging com o HornetQ, consulte:
Seção 3.2.7.4, “ Configuração de Mensagens com HornetQ” .
3. Mig ração d e men sag en s exist en t es
Mova quaisquer mensagens do banco de dados do JBoss Messaging ao diário HornetQ
usando a ponte JMS. As instruções para configuração do bridge JMS podem ser
encontrados na: Seção 3.2.7.2, “ Configuração do JMS Bridge para Migração de JMS
Messages Existentes ao JBoss EAP 6” .
Reportar um erro
3.2 .7 .4 . Co nfiguração de Me nsage ns co m Ho rne t Q
O método recomendado de configuração de mensagem no JBoss EAP 6 é tanto o Management
Console ou Management CLI. Você pode fazer com que estas alterações sejam persistentes com
qualquer uma dessas ferramentas sem a necessidade de editar manualmente os arquivos de
configuração stand al o ne. xml ou d o mai n. xml . Isto é útil, no entanto recomendamos
familiarizar-se com os componentes de mensagem dos arquivos de configuração default, sendo que
as amostras da documentação usando as ferramentas de gerenciamento fornecem snippets do
arquivo de configuração para referência.
Reportar um erro
61
3.2.8. Alt erações de Clust ering
3.2 .8 .1 . Re alize Alt e raçõ e s ao se u Aplicat ivo para o Clust e ring
1. In icie o JB o ss EAP 6 co m o clu st erin g h ab ilit ad o
Para habilitar o clustering no JBoss EAP 5.x, você precisava iniciar suas instâncias do
servidor usando o perfil al l ou alguma derivação do mesmo, como por exemplo:
$ EAP5_HOME/bi n/run. sh -c al l
No JBoss EAP 6, o método para a habilitação do clustering depende dos servidores serem
autônomos ou serem executados num managed domain.
a. H ab ilit ação d o clu st er p ara servid o res execu t an d o n u m man ag ed d o main
Para habilitar o clustering para servidores iniciados usando o domain controller,
atualize o seu d o mai n. xml e determine um grupo de servidor para uso do seu perfil
ha e grupo binding de soquete ha-so ckets. Por exemplo:
< server-groups>
<server-group name="main-server-group" profile="ha">

</jvm>

<socket-binding-group ref="ha-sockets"/>
</server-group>
< /server-group>
b. H ab ilit ação d o clu st er p ara servid o res au t ô n o mo s
Para habilitar o clustering para os servidores autônomos, inicie o servidor usando o
arquivo de configuração apropriado conforme o seguinte: $
EAP_HOME/bi n/stand al o ne. sh --server-co nfi g = stand al o ne-ha. xml D jbo ss. no d e. name= UNIQUE_NODE_NAME
2. Esp ecif icação d o en d ereço b in d
No JBoss EAP 5.x, você indicaria normalmente o endereço bind, usado para o clustering,
usando o argumento da linha de comando -b conforme o seguinte: $
EAP_HOME/bi n/run. sh -c al l -b 19 2. 16 8. 0 . 2
No JBoss EAP 6, os endereços bind são claramente definidos pelos socket bindings
relevantes com os arquivos da configuração do JBoss EAP 6. Para os servidores iniciados
usando o domain controller, os endereços bind são especificados com o arquivo
d o mai n/co nfi g urati o n/ho st. xml . Para os servidores autônomos, os endereços bind
são especificados com o arquivo stand al o ne-ha. xml :
< interfaces>
<interface name="management">

<inet-address value="192.168.0.2"/>

</interface>
62

< socket-binding-groups>
<socket-binding-group name="ha-sockets" defaultinterface="public">

</socket-binding-group>
< /socket-binding-groups>
A interface publ i c é especificada na amostra acima como interface default para todos os
sockets com o grupo socket binding ha-so ckets.
3. C o n f ig u re o jvmR o ute p ara su p o rt ar o mo d _jk e mo d _p ro xy
No JBoss EAP 5, o servidor da web jvmR o ute foi configurado usando a propriedade no
arquivo server. xml . No JBoss EAP 6, o atributo jvmR o ute é configurado no subsistema
da web do arquivo de combinação do servidor usando o atributo i nstance-i d conforme o
seguinte:
< subsystem xmlns="urn:jboss:domain:web:1.1" default-virtualserver="default-host" native="false" instance-id="
{JVM_ROUTE_SERVER}">
O {JVM_ROUTE_SERVER} acima deve ser substituído pela ID do servidor jvmRoute.
O i nstance-i d pode ser determinado usando o Management Console.
4. Esp ecif icação d o en d ereço mu lt icast e p o rt a
No JBoss EAP 5.x, você pode especificar o endereço multicast e a porta usada para a
comunicação infra-cluster usando os argumentos da linha de comando -u e -m,
respectivamente, como por exemplo: $ EAP_HOME/bi n/run. sh -c al l -u
228. 11. 11. 11 -m 4 56 88
No JBoss EAP 6, o endereço e porta multicast usados para a comunicação do cluster são
definidos pelo socket-binding referenciado pela pilha do protocolo JGroups relevante,
conforme abaixo:
< subsystem xmlns="urn:jboss:domain:jgroups:1.0" default-stack="udp">

</stack>
< /subsystem>
< socket-binding-groups>

<socket-binding-group name="ha-sockets" defaultinterface="public">
63

<socket-binding name="jgroups-udp" port="55200" multicastaddress="228.11.11.11" multicast-port="45688"/>

</socket-binding-group>
< /socket-binding-groups>

Caso você preferir especificar o endereço multicast e a porta na linha de comando, você
pode definir o endereço multicast e as portas como propriedades de sistema e usá-las na
linha de comando quando você iniciar o servidor. A seguinte amostra, jbo ss. mcast. ad d r
é o nome da variável para o endereço multicast e o jbo ss. mcast. po rt é o nome da
variável para a porta.
< socket-binding name="jgroups-udp" port="55200"
multicast-address="${jboss.mcast.addr:230.0.0.4}" multicastport="${jboss.mcast.port:45688}"/>
Você pode iniciar o seu servidor usando os argumentos da linha de comando: $
EAP_HOME/bi n/d o mai n. sh -D jbo ss. mcast. ad d r= 228. 11. 11. 11 D jbo ss. mcast. po rt= 4 56 88
5. U so d a p ilh a d e p ro t o co lo alt ern at ivo
No JBoss EAP 5.x, você pode manipular a pilha de protocolo default para todos os serviços
de clustering usando a propriedade de sistema jbo ss. d efaul t. jg ro ups. stack. $
EAP_HOME/bi n/run. sh -c al l -D jbo ss. d efaul t. jg ro ups. stack= tcp
No JBoss EAP 6, a pilha do protocolo default é definida pelo subsistema JGroups com o
d o mai n. xml ou stand al o ne-ha. xml :
< subsystem xmlns="urn:jboss:domain:jgroups:1.0" default-stack="udp">

</stack>
< /subsystem>
6. Su b st it u ição d a R ep licação B u d d y
O JBoss EAP 5.x usou o JBoss Cache Buddy Replication para suprimir a replicação dos
dados para todas as instâncias num cluster. É solicitado que você passe o argumento D jbo ss. cl uster. bud d yR epl na linha de comando quando você inicia o servidor do
JBoss.
No JBoss EAP 6, a Replicação Buddy foi substituída pelo cache distribuído bastante
superior do Infinispan ou modo D IST. A distribuição é um modo do clustering potente que
permite o Infinispan a escalar de forma linear à medida que mais servidores são
adicionados ao cluster. Segue abaixo uma amostra de como configurar o servidor para uso
do modo de cache D IST.
a. Abra a linha de comando e inicie o servidor com tanto o Perfil Completo ou HA. Por
exemplo:
64
EAP_HOME/bin/standalone.sh -c standalone-ha.xml
b. Abra outra linha de comando e conecte-se ao Management CLI.
$ EAP_HOME/bin/jboss-cli.sh --connect
C:\>EAP_HOME\bin\jboss-cli.bat --connect
Você deve ver a seguinte resposta:
Conectado ao controlador autônomo no localhost:9999
c. Imprima os seguintes comandos:
/subsystem=infinispan/cache-container=web/:writeattribute(name=default-cache,value=dist)
/subsystem=infinispan/cache-container=web/distributedcache=dist/:write-attribute(name=owners,value=3)
:reload
Você deverá ver a seguinte resposta após cada comando:
"outcome" => "success"
Esses comandos criam a seguinte configuração no subsistema i nfi ni span do
arquivo stand al o ne-ha. xml :
< cache-container name="web" aliases="standard-session-cache"
default-cache="dist"
module="org.jboss.as.clustering.web.infinispan">

<replicated-cache name="repl" mode="ASYNC"
batching="true">

<file-store/>

</replicated-cache>

<replicated-cache name="sso" mode="SYNC"
batching="true"/>

<distributed-cache name="dist" owners="3" l1-lifespan="0"
mode="ASYNC" batching="true">

<file-store/>

</distributed-cache>
< /cache-container>
Refira-se ao capítulo Clustering nos Aplicativos da Web no Guia de Desenvolvimento do
JBoss EAP 6 localizado no Portal do Cliente
https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/
para maiores informações sobre este respeito.
65
Reportar um erro
3.2 .8 .2 . Im plant ação de um HA Single t o n
Su mário
No JBoss EAP 5, os arquivos HA singleton eram implantados no diretório d epl o y-hasi ng l eto n/
separados de outras implantações. Isto era realizado para prevenir a implantação automática e
garantir que o serviço HASingletonD eployer controlava a implantação do arquivo e arquivos
implantados apenas no nó mestre do cluster. Não havia recurso da implantação instantânea (hot
deployment), de forma que a implantação solicitava a reinicialização do servidor. Além disso, caso
o nó mestre falhasse solicitando outro nó a assumir posição do nó mestre, o serviço singleton tinha
que passar por todo o processo de implantação com o objetivo de fornecer o serviço.
No JBoss EAP 6 isto foi alterado. O serviço de destino é instalado em cada nó no cluster, mas é
apenas iniciado em um nó a cada período gerado, quando usando um SingletonService. Este
procedimento simplifica as solicitações de implantação e reduz o período solicitado de relocação
do serviço mestre singleton entre os nós.
Pro ced imen t o 3.24 . Imp lan t ação d o Serviço H A Sin g let o n
1. G rave o ap licat ivo d o serviço H A sin g let o n .
Segue abaixo uma amostra simples de um Serviço que está encapsulado com o decorador
SingletonService a ser implantado como um serviço singleton.
a. C rie u m serviço sin g let o n .
A seguinte listagem é uma amostra do serviço singleton:
p ackage com.mycompany.hasingleton.service.ejb;
i mport java.util.concurrent.atomic.AtomicBoolean;
i mport java.util.logging.Logger;
i mport
i mport
i mport
i mport
i mport
i mport
i mport
i mport
org.jboss.as.server.ServerEnvironment;
org.jboss.msc.inject.Injector;
org.jboss.msc.service.Service;
org.jboss.msc.service.ServiceName;
org.jboss.msc.service.StartContext;
org.jboss.msc.service.StartException;
org.jboss.msc.service.StopContext;
org.jboss.msc.value.InjectedValue;
/ **
* @ author <a href="mailto:wfink@ redhat.com">Wolf-Dieter
Fink</a>
*/
p ublic class EnvironmentService implements Service<String> {

private static final Logger LOGGER =
Logger.getLogger(EnvironmentService.class.getCanonicalName())
;

public static final ServiceName SINGLETON_SERVICE_NAME =
ServiceName.JBOSS.append("quickstart", "ha", "singleton");

/**
66

* A flag whether the service is started.
*/

private final AtomicBoolean started = new
AtomicBoolean(false);

private String nodeName;

private final InjectedValue<ServerEnvironment> env = new
InjectedValue<ServerEnvironment>();

public Injector<ServerEnvironment> getEnvInjector() {
return this.env;
}

/**
* @ return the name of the server node

*/

public String getValue() throws IllegalStateException,
IllegalArgumentException {

if (!started.get()) {

throw new IllegalStateException("The service '" +
this.getClass().getName() + "' is not ready!");

}

return this.nodeName;

}

public void start(StartContext arg0) throws
StartException {

if (!started.compareAndSet(false, true)) {

throw new StartException("The service is still
started!");

}

LOGGER.info("Start service '" +
this.getClass().getName() + "'");

this.nodeName = this.env.getValue().getNodeName();

}

public void stop(StopContext arg0) {
if (!started.compareAndSet(true, false)) {

LOGGER.warning("The service '" +
this.getClass().getName() + "' is not active!");

} else {

LOGGER.info("Stop service '" +
this.getClass().getName() + "'");

}

b. C rie u m sin g let o n EJB p ara in iciar o serviço co mo u m Sin g let o n Serviço n a
in iciação d o servid o r.
A seguinte listagem é uma amostra de um singleton EJB que inicia um Singleton na
iniciação do servidor:
67
i mport java.util.Collection;
i mport java.util.EnumSet;
i mport
i mport
i mport
i mport
javax.annotation.PostConstruct;
javax.annotation.PreDestroy;
javax.ejb.Singleton;
javax.ejb.Startup;
i mport
i mport
i mport
i mport
i mport
i mport
i mport
i mport
i mport
i mport
org.jboss.as.clustering.singleton.SingletonService;
org.jboss.as.server.CurrentServiceContainer;
org.jboss.as.server.ServerEnvironment;
org.jboss.as.server.ServerEnvironmentService;
org.jboss.msc.service.AbstractServiceListener;
org.jboss.msc.service.ServiceController;
org.jboss.msc.service.ServiceController.Transition;
org.jboss.msc.service.ServiceListener;
org.slf4j.Logger;
org.slf4j.LoggerFactory;
/ **
* A Singleton EJB to create the SingletonService during
startup.
*
Fink</a>
*/
@ Singleton
@ Startup
p ublic class StartupSingleton {
LoggerFactory.getLogger(StartupSingleton.class);

/**

* Create the Service and wait until it is started.

* Will log a message if the service will not start in
10sec.

*/
@ PostConstruct
protected void startup() {

LOGGER.info("StartupSingleton will be initialized!");

EnvironmentService service = new EnvironmentService();
SingletonService<String> singleton = new
SingletonService<String>(service,
EnvironmentService.SINGLETON_SERVICE_NAME);

// if there is a node where the Singleton should deployed
the election policy might set,

// otherwise the JGroups coordinator will start it

//singleton.setElectionPolicy(new
PreferredSingletonElectionPolicy(new
NamePreference("node2/cluster"), new
SimpleSingletonElectionPolicy()));

ServiceController<String> controller =

68
singleton.build(CurrentServiceContainer.getServiceContainer()
)

.addDependency(ServerEnvironmentService.SERVICE_NAME,
ServerEnvironment.class, service.getEnvInjector())

.install();

controller.setMode(ServiceController.Mode.ACTIVE);
try {

wait(controller,
EnumSet.of(ServiceController.State.DOWN,
ServiceController.State.STARTING),
ServiceController.State.UP);

LOGGER.info("StartupSingleton has started the
Service");

} catch (IllegalStateException e) {

LOGGER.warn("Singleton Service {} not started, are you
sure to start in a cluster (HA)
environment?",EnvironmentService.SINGLETON_SERVICE_NAME);

}
}

/**

* Remove the service during undeploy or shutdown

*/
@ PreDestroy
protected void destroy() {

LOGGER.info("StartupSingleton will be removed!");

ServiceController<?> controller =
CurrentServiceContainer.getServiceContainer().getRequiredServ
ice(EnvironmentService.SINGLETON_SERVICE_NAME);

controller.setMode(ServiceController.Mode.REMOVE);

try {

wait(controller, EnumSet.of(ServiceController.State.UP,
ServiceController.State.STOPPING,
ServiceController.State.DOWN),
ServiceController.State.REMOVED);

} catch (IllegalStateException e) {

LOGGER.warn("Singleton Service {} has not be stopped
correctly!",EnvironmentService.SINGLETON_SERVICE_NAME);

}
}

private static <T> void wait(ServiceController<T>
controller, Collection<ServiceController.State>
expectedStates, ServiceController.State targetState) {

if (controller.getState() != targetState) {

ServiceListener<T> listener = new
NotifyingServiceListener<T>();

controller.addListener(listener);

try {

synchronized (controller) {

int maxRetry = 2;

while
(expectedStates.contains(controller.getState()) & & maxRetry >
0) {

LOGGER.info("Service controller state is {},
69
waiting for transition to {}", new Object[]
{controller.getState(), targetState});

controller.wait(5000);

maxRetry--;

}

} catch (InterruptedException e) {

LOGGER.warn("Wait on startup is interrupted!");

Thread.currentThread().interrupt();

}

controller.removeListener(listener);

ServiceController.State state = controller.getState();

LOGGER.info("Service controller state is now
{}",state);

if (state != targetState) {

throw new IllegalStateException(String.format("Failed
to wait for state to transition to %s. Current state is %s",
targetState, state), controller.getStartException());

}

}
}

private static class NotifyingServiceListener<T> extends
AbstractServiceListener<T> {

@ Override

public void transition(ServiceController<? extends T>
controller, Transition transition) {

synchronized (controller) {

controller.notify();

}

}
}

}
c. C rie u m B ean d e Sessão St at eless p ara acesso ao serviço a p art ir d e u m
clien t e.
Segue abaixo uma amostra de um bean de sessão stateless que acessa o serviço de
um cliente:
i mport javax.ejb.Stateless;
i mport
i mport
i mport
i mport
org.jboss.as.server.CurrentServiceContainer;
org.jboss.msc.service.ServiceController;
org.slf4j.Logger;
org.slf4j.LoggerFactory;
/ **
* A simple SLSB to access the internal SingletonService.
*
Fink</a>
70
*/
@ Stateless
p ublic class ServiceAccessBean implements ServiceAccess {

LoggerFactory.getLogger(ServiceAccessBean.class);

public String getNodeNameOfService() {
LOGGER.info("getNodeNameOfService() is called()");

ServiceController<?> service =
CurrentServiceContainer.getServiceContainer().getService(

EnvironmentService.SINGLETON_SERVICE_NAME);

LOGGER.debug("SERVICE {}", service);

if (service != null) {

return (String) service.getValue();

} else {

throw new IllegalStateException("Service '" +
EnvironmentService.SINGLETON_SERVICE_NAME + "' not found!");

}

d. C rie u ma in t erf ace d e ló g ica co mercial p ara o Sin g let o n Service.
A seguinte amostra é uma interface lógica comercial para o SingletonService:
i mport javax.ejb.Remote;
/ **
* Business interface to access the SingletonService via this
EJB
*
Fink</a>
*/
@ Remote
p ublic interface ServiceAccess {

public abstract String getNodeNameOfService();

}
2. In icie cad a in st ân cia d o JB o ss EAP 6 co m o clu st erin g h ab ilit ad o .
O método de habilitação com cluster depende se os servidores forem autônomos ou
executando num managed domain.
a. H ab ilit e o clu st erin g p ara servid o res execu t an d o n u m man ag ed d o main .
Você pode habilitar o clustering usando o Management CLI ou você pode editar
manualmente o arquivo de configuração.
71
A. H ab ilit e o clu st erin g u san d o o Man ag emen t C LI.
i. In icie o seu d o main co n t ro ller.
ii. Ab ra a jan ela d e co man d o p ara o seu sist ema o p eracio n al.
iii. C o n ect e ao Man ag emen t C LI p assan d o o en d ereço IP d o d o main
co n t ro ller o u n o me D N S.
Nesta amostra, assuma que o endereço IP do domain controller é
19 2. 16 8. 0 . 14 .
$ EAP_HOME/bin/jboss-cli.sh --connect -controller=192.168.0.14
C:\>EAP_HOME\bin\jboss-cli.bat --connect -controller=192.168.0.14
Você deverá observar a seguinte resposta:
Conectado ao domain controller no 192.168.0.14
iv. Ad icio n e o g ru p o d e servid o r mai n-server.
[domain@ 192.168.0.14:9999 /] /server-group=mainserver-group:add(profile="ha",socket-bindinggroup="ha-sockets")
{
"outcome" => "success",
"result" => undefined,
"server-groups" => undefined
}
v. C rie u m servid o r n o mead o server-o ne e ad icio n e- o ao g ru p o d o
servid o r mai n-server.
[domain@ 192.168.0.14:9999 /]
/host=station14Host2/server-config=serverone:add(group=main-server-group,auto-start=false)
{
"result" => undefined
}
vi. C o n f ig u re o JVM p ara o g ru p o d o servid o r mai n-server.
[domain@ 192.168.0.14:9999 /] /server-group=mainserver-group/jvm=default:add(heap-size=64m,max-heapsize=512m)
72
{
"result" => undefined,
"server-groups" => undefined
}
vii. C rie u m servid o r n o mead o server-two , co lo q u e- o n u m g ru p o d e
servid o r sep arad o e co n f ig u re a p o rt a d e d eslo camen t o p ara 100.
[domain@ 192.168.0.14:9999 /]
/host=station14Host2/server-config=servertwo:add(group=distinct2,socket-binding-portoffset=100)
{
"result" => undefined
}
B. H ab ilit e o clu st erin g ed it an d o man u almen t e o s arq u ivo s d e
co n f ig u ração d o servid o r.
i. In t erro mp a o servid o r d o JB o ss EAP 6 .
Importante
Você deve interromper o servidor antes de editar o arquivo de
configuração do servidor para que sua alteração seja persistida na
iniciação do servidor.
ii. Ab ra o arq u ivo d e co n f ig u ração d o mai n. xml p ara ed ição
D etermine um grupo de servidor para uso do seu perfil ha e grupo socket
binding ha-so ckets conforme abaixo:
< server-groups>
<server-group name="main-server-group"
profile="ha">

</jvm>

<socket-binding-group ref="ha-sockets"/>
</server-group>
< /server-groups>
iii. Ab ra o arq u ivo d e co n f ig u ração ho st. xml p ara ed ição
Modifique o arquivo conforme o seguinte:
< servers>
73

<socket-bindings port-offset="100"/>
</server>
< servers>
iv. In icie o servid o r.
A. D igite EAP_HOME/bi n/d o mai n. sh para o Linux
B. D igite EAP_HOME\bi n\d o mai n. bat para o Microsoft Windows
b. H ab ilit ação d o clu st er p ara servid o res au t ô n o mo s
Para habilitar o cluster para servidores autônomos, inicie o servidor usando o nome
do nó e o arquivo da configuração stand al o ne-ha. xml conforme abaixo:
A. D igite EAP_HOME/bi n/stand al o ne. sh --server-co nfi g = stand al o neha. xml -D jbo ss. no d e. name= UNIQUE_NODE_NAME para o Linux
B. D igite EAP_HOME\bi n\stand al o ne. bat --server-co nfi g = stand al o neha. xml -D jbo ss. no d e. name= UNIQUE_NODE_NAME para o Microsoft
Windows
Nota
Configure o arquivo stand al o ne-ha. xml para cada instância do servidor efetuar o
bind numa interface separada, com o objetivo de evitar conflitos quando executando
múltiplos servidores numa máquina. Alternativamente, você pode iniciar as instâncias
do servidor subsequentes com uma porta de deslocamento usando o argumento
conforme a seguinte linha de comando: -D jbo ss. so cket. bi nd i ng . po rto ffset= 10 0 .
3. Imp lan t ação d o ap licat ivo ao s servid o res
Caso você use o Maven para implantar seu aplicativo, use o seguinte comando Maven para
implantar o servidor executando nas portas default:
mvn cl ean i nstal l jbo ss-as: d epl o y
Para implantar os servidores adicionais, passe o nome do servidor e o número da porta com
a linha de comando:
mvn cl ean packag e jbo ss-as: d epl o y -D d epl o y. ho stname= l o cal ho st D d epl o y. po rt= 10 0 9 9
Reportar um erro
3.2.9. Alt erações do Desenvolviment o do est ilo de Serviço
3.2 .9 .1 . At ualização do s Aplicat ivo s que usam as Im plant açõ e s de e st ilo de Se rviço
74
Su mário
Embora o JBoss EAP 6 não use mais os descritores de estilo de serviço, o contêiner suporta essas
implantações de estilo de serviço sem alteração quando possível. Isto significa que se você usar
descritores de implantação jbo ss-servi ce. xml ou jbo ss-beans. xml em seu aplicativo do
JBoss EAP 5.x, eles devem ser executados com pouca ou sem nenhuma modificação no JBoss EAP
6. Você pode continuar a empacotar os arquivos no EAR ou SAR, ou você pode substituir os
arquivos diretamente no diretório de implantações. Caso você esteja executando um servidor
autônomo, o diretório de implantações encontra-se no: EAP_HOME/stand al o ne/d epl o yments/.
Caso você esteja executando um managed domain, a pasta de implantações encontra-se localizada
no EAP_HOME/d o mai n/d epl o yments/.
Reportar um erro
3.2.10. Alt erações da Invocação Remot a
3.2 .1 0 .1 . Migração do s Aplicat ivo s Im plant ado s do JBo ss EAP 5 que re aliza
Invo caçõ e s Re m o t as ao JBo ss EAP 6
Su mário
Existem duas maneiras de tornar as invocações remotas ao servidor no JBoss EAP 6:
Você pode usar o novo API do cliente EJB específico do JBoss para realizar a invocação.
Você pode usar o JND I para pesquisar um proxy para seu bean e invocar no proxy retornado.
Essa seção cobre a opção 2: alterações de codificação requeridas para os clientes que usam o
JND I.
No JBoss EAP 5, a interface remota do EJB foi limitada ao JND I, por default, sob o nome
" ejbName/local" para interfaces locais e " ejbName/remote" para interfaces remotas. O aplicativo do
cliente pesquisa então o bean usando o " ejbName/remote" .
No JBoss EAP 6, você pode usar o ejb: NAMESPACE_NAME para acesso remoto ao EJBs com a
seguinte sintaxe; para beans stateless:
e jb:<app-name>/<module-name>/<distinct-name>/<bean-name>!<fullyqualified-classname-of-the-remote-interface>
Para beans stateful:
e jb:<app-name>/<module-name>/<distinct-name>/<bean-name>!<fullyqualified-classname-of-the-remote-interface>?stateful
Os valores a serem substituídos na sintaxe acima são:
<app-name> - o nome do aplicativo dos EJBs implantados. Isto é tipicamente o nome ear sem o
sufixo .ear, no entanto, o nome pode ser substituído no arquivo application.xml. Caso o
aplicativo não seja implantado com um .ear, esse valor é uma sequência vazia. Vamos assumir
que esta amostra não estava implantada como um EAR.
75
<mo d ul e-name> - o nome do módulo dos EJBs implantados no servidor. Isto é tipicamente o
nome jar da implantação EJB, sem o sufixo .jar, mas pode ser substituído usando o ejb-jar.xml.
Nessa amostra, assuma que os EJBs foram implantados num jboss-as-ejb-remote-app.jar, de
forma que o nome do módulo é jboss-as-ejb-remote-app.
<d i sti nct-name> - é um nome distinto opcional para o EJB. Essa amostra não usa um nome
distinto, portanto usa uma sequência vazia.
<bean-name> - por default é um nome de classe simples da classe de implantação do bean.
<ful l y-q ual i fi ed -cl assname-o f-the-remo te-i nterface> - o nome da classe
inteiramente qualificado de visualização remota.
At u aliz ação d o có d ig o d o clien t e
Assuma que você implantou o seguinte EJB stateless a um servidor do JBoss EAP 6. Perceba que
isto o expõe a uma visualização remota para o bean.
@ Stateless
@ Remote(RemoteCalculator.class)
p ublic class CalculatorBean implements RemoteCalculator {

@ Override
public int add(int a, int b) {
return a + b;
}

@ Override
public int subtract(int a, int b) {
return a - b;
}

}
No JBoss EAP 5, a pesquisa EJB do cliente e a invocação foi codificada como o seguinte:
I nitialContext ctx = new InitialContext();
R emoteCalculator calculator = (RemoteCalculator)
ctx.lookup("CalculatorBean/remote");
i nt a = 204;
i nt b = 340;
i nt sum = calculator.add(a, b);
No JBoss EAP 6, a pesquisa do cliente e a invocação com o uso da informação descrita acima, é
codificada como o seguinte:
final Hashtable jndiProperties = new Hashtable();
j ndiProperties.put(Context.URL_PKG_PREFIXES,
"org.jboss.ejb.client.naming");
final Context context = new InitialContext(jndiProperties);
final String appName = "";
final String moduleName = "jboss-as-ejb-remote-app";
final String distinctName = "";
final String beanName = CalculatorBean.class.getSimpleName();
76
final String viewClassName = RemoteCalculator.class.getName();
final RemoteCalculator statelessRemoteCalculator = (RemoteCalculator)
context.lookup("ejb:" + appName + "/" + moduleName + "/" + distinctName
+ "/" + beanName + "!" + viewClassName);

i nt a = 204;
i nt b = 340;
i nt sum = statelessRemoteCalculator.add(a, b);
Caso o seu cliente estiver acessando um EJB stateful, você deve anexar " ?stateful" ao final da
pesquisa do contexto como abaixo:
final RemoteCalculator statefulRemoteCalculator = (RemoteCalculator)
context.lookup("ejb:" + appName + "/" + moduleName + "/" + distinctName
+ "/" + beanName + "!" + viewClassName + "?stateful")
Uma amostra de trabalho completa, incluindo ambos código do cliente e servidor pode ser
encontrada no Quickstart. Para maiores informações, consulte a Revisão de Tutoriais do Quickstart no
capítulo Iniciação dos Aplicativos de Desenvolvimento do Guia de Desenvolvimento para o JBoss EAP 6
no https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/.
Para maiores informações sobre as invocações remotas usando o JND I, refira-se à Invocação do
Bean de Sessão Remotamente usando o JNDI no capítulo Enterprise JavaBeans do Guia de
Desenvolvimento para o JBoss EAP 6 no
Reportar um erro
3.2 .1 0 .2 . Invo cação do Be an de Se ssão Re m o t a usando o JNDI
Essa tarefa descreve como adicionar e suportar um cliente remoto para a invocação dos beans de
sessão usando o JND I. Essa tarefa assume que o projeto está sendo construído usando o Maven.
O ejb-remo te quickstart contém os projetos Maven operantes que demostram essa funcionalidade.
A inicialização rápida contém projetos para ambos beans de sessão para implantação e ao cliente
remoto.
Essa tarefa assume que os beans de sessão não requerem autenticação.
Pré- req u isit o s
Os seguintes pré-requisitos devem ser seguidos antes da inicialização:
Você deve possuir um projeto Maven criado e pronto para uso.
A configuração para o repositório Maven do JBoss EAP 6 já ter sido adicionada.
Os beans de sessão que você deseja invocar já terem sido implantados.
Os beans de sessão implantados devem implantar interfaces comerciais.
As interfaces comerciais remotas dos beans de sessão estão disponíveis como uma dependência
Maven. Caso as interfaces comerciais remotas estiverem ainda disponíveis como um arquivo
JAR, é recomendável adicionar o JAR ao seu repositório como um artefato. Refira-se à
documentação Maven para as metas i nstal l : i nstal l -fi l e como orientação,
http://maven.apache.org/plugins/maven-install-plugin/usage.html
77
Você precisa saber do hostname e a porta JND I do servidor hosting dos beans de sessão.
Você deverá configurar o projeto corretamente com o objetivo de invocar um bean de sessão de um
cliente remoto.
Pro ced imen t o 3.25. Ad ição d a C o n f ig u ração d o Pro jet o Maven p ara a In vo cação R emo t a
d o s B ean s d e Sessão
1. Ad icio n e as d ep en d ên cias d o p ro jet o so licit ad as
O po m. xml para o projeto deve ser atualizado para incluir as dependências necessárias.
2. Ad icio n e o arq u ivo jbo ss-ejb-cl i ent. pro perti es
O API do cliente JBoss EJB espera encontrar um arquivo na raiz do projeto nomeado
jbo ss-ejb-cl i ent. pro perti es que contém a informação da conexão para o serviço
JND I. Adicione este arquivo ao diretório src/mai n/reso urces/ de seu projeto com o
seguinte conteúdo.
# In the following line, set SSL_ENABLED to true for SSL
remote.connectionprovider.create.options.org.xnio.Options.SSL_ENABL
ED=false
remote.connections=default
# Uncomment the following line to set SSL_STARTTLS to true for SSL
#
remote.connection.default.connect.options.org.xnio.Options.SSL_STAR
TTLS=true
remote.connection.default.host=localhost
remote.connection.default.port = 4447
remote.connection.default.connect.options.org.xnio.Options.SASL_POL
ICY_NOANONYMOUS=false
# Add any of the following SASL options if required
#
ICY_NOANONYMOUS=false
#
ICY_NOPLAINTEXT=false
#
remote.connection.default.connect.options.org.xnio.Options.SASL_DIS
ALLOWED_MECHANISMS=JBOSS-LOCAL-USER
Altere o portal e o nome do host para coincidir com o seu servidor. O 4 4 4 7 é o número de
porta default. Configure a linha SSL_ENABLED para true e descomente a linha
SSL_ST AR T T LS. A interface remota no contêiner suporta as conexões com e sem segurança
usando a mesma porta.
3. Ad icio n e d ep en d ên cias p ara as in t erf aces co merciais
Adicione as dependências Maven ao po m. xml para interfaces comerciais remotas dos
beans de sessão.
< dependency>

<groupId>org.jboss.as.quickstarts</groupId>

<artifactId>jboss-as-ejb-remote-server-side</artifactId>

<type>ejb-client</type>
78

<version>${project.version}</version>
< /dependency>
Agora que o projeto já foi configurado corretamente, você pode adicionar o código de acesso e
invocar os beans de sessão.
Pro ced imen t o 3.26 . O b t en ção d e u m Pro xy B ean u san d o o JN D I e Mét o d o s d e In vo cação
d o B ean
1. Man u seio d as exceçõ es ch ecad as
Os métodos usados no seguinte código (Ini ti al C o ntext() e l o o kup()) possuem uma
exceção de checagem do tipo javax. nami ng . Nami ng Excepti o n. Essas chamadas de
método devem tanto ser inseridas num bloco de tentativa/captura que captura o
Nami ng Excepti o n ou num método que é declarado ao lançar o Nami ng Excepti o n. O
ejb-remo te quickstart usa a segunda técnica.
2. C riação d o C o n t ext o JN D I
O objetivo do Contexto JND I fornece o mecanismo de solicitação de recursos a partir do
servidor. Crie um contexto JND I usando o seguinte código:
final Hashtable jndiProperties = new Hashtable();
j ndiProperties.put(Context.URL_PKG_PREFIXES,
"org.jboss.ejb.client.naming");
final Context context = new InitialContext(jndiProperties);
As propriedades de conexão para o serviço JND I são lidas a partir do arquivo jbo ss-ejbcl i ent. pro perti es.
3. U so d o mét o d o lo o ku p ( ) d o C o n t ext p JN D I p ara o b t er u m p ro xy d e b ean
Invoque o método l o o kup() do proxy do bean e passe-o ao nome JND I do bean de sessão
que você requer. Isto retornará um objeto que deve ser convertido ao tipo de interface
comercial remota que contém os métodos que você deseje invocar.
final RemoteCalculator statelessRemoteCalculator =
(RemoteCalculator) context.lookup(

"ejb:/jboss-as-ejb-remote-server-side/CalculatorBean!" +

RemoteCalculator.class.getName());
Os nomes do JND I do bean de sessão são definidos usando a síntese especial.
4. Mét o d o s d e In vo cação
Agora que você possui um objeto de bean de proxy você pode invocar qualquer um dos
métodos contidos na interface comercial remota.
i nt a = 204;
i nt b = 340;
S ystem.out.println("Adding " + a + " and " + b + " via the remote
stateless calculator deployed on the server");
79
i nt sum = statelessRemoteCalculator.add(a, b);
S ystem.out.println("Remote calculator returned sum = " + sum);
O bean passa a solicitação de invocação do método ao bean de sessão no servidor, onde
isto é executado. O resultado é retornado ao bean do proxy que então o retorna ao
chamador. A comunicação entre o bean de proxy e o bean de sessão remota é transparente
ao chamador.
Agora você deve estar apto a configurar o projeto Maven para suportar a invocação dos beans de
sessão num servidor remoto e escrever a invocação do código nos métodos de beans de sessão
usando o bean proxy restaurado a partir do servidor usando o JND I.
Reportar um erro
3.2.11. Alt erações EJB 2.x
3.2 .1 1 .1 . At ualização do s Aplicat ivo s que usam o EJB 2 .x
O JBoss EAP 6 fornece suporte para o EJB 2.x. No entanto, você precisa realizar algumas
modificações no código e iniciar o servidor com o perfil completo.
Pro ced imen t o 3.27. Execu t e o EJB 2.x n o JB o ss EAP 6
1. Mo d if iq u e o C ó d ig o em u so p ara as N o vas R eg ras d o JN D I N amesp ace
A partir do EJB 3.0, você deverá usar o prefixo completo do JND I com o EJB 2.x. Consulte a
Seção 3.1.8.1, “ Atualização dos Nomes JND I Namespace do Aplicativo” para maiores
informações sobre as amostras de regras e códigos do JND I.
As amostras que apresentam como atualizar os JND I namespaces a partir das liberações
antigas podem ser encontradas na Seção 3.1.8.5, “ Amostra do JND I Namespaces nos
Lançamentos Anteriores e como são especificados no JBoss EAP 6” .
2. Mo d if icação d o D escrit o r d o Arq u ivo jbo ss-web. xml
Modifique o <jnd i -name> para cada <ejb-ref> usar o novo formato de pesquisa
inteiramente qualificado JND I.
3. Su b st it u a o arq u ivo d o d escrit o r d a imp lan t ação jbo ss. xml
O descritor da implantação jbo ss-ejb3. xml substitui o descritor da implantação
jbo ss. xml para substituição e adição à recursos fornecidos pelo Java Enterprise Edition
(EE - Edição do Java Enterprise) definidos no descritor da implantação ejb-jar. xml . O
novo arquivo é incompatível com o jbo ss. xml e o jbo ss. xml é agora ignorado nas
implantações.
4. In icie o Servid o r co m o s Perf is C o mp let o s
O EJB 2.x requer o Perfil Completo da Edição do Java Enterprise 6. Passe o argumento -c
stand al o ne-ful l . xml à linha de comando quando iniciando o servidor, com o objetivo
de iniciar o JBoss EAP 6 com o perfil completo.
5. O clu st erin g n ão é mais su p o rt ad o
O clustering dos beans de entidade EJB 2.x não é mais suportado no JBoss EAP 6.
80
Reportar um erro
3.2.12. Alt erações do JBoss AOP
3.2 .1 2 .1 . At ualização do s Aplicat ivo s que usam o JBo ss AOP
O JBoss AOP (Aspect Orientated Programing - Programação Orientada do Aspecto) não está mais
incluído no JBoss EAP 6. Nos lançamentos anteriores, o JBoss AOP foi usado pelo contêiner EJB.
No JBoss EAP 6, o contêiner EJB usa um novo mecanismo. Caso o seu aplicativo usar o JBoss
AOP, você deve modificar o seu código de aplicativo conforme abaixo.
R ef at o ração d o Ap licat ivo
As configurações EJB3 padrões que eram realizadas anteriormente no arquivo ejb3i ntercepto rs-ao p. xml são agora configuradas no arquivo de configuração. Isto é um
arquivo stand al o ne/co nfi g urati o n/stand al o ne-ful l . xml para o servidor autônomo.
Caso você esteja executando o seu servidor num managed domain, este é o arquivo
d o mai n/co nfi g urati o n/d o mai n. xml .
Os Interceptores AOP ao lado do servidor devem modificar o uso do Java EE Intercepto r
default. Refira-se ao capítulo Interceptores de Contêiner no Guia de Desenvolvimento do JBoss EAP
6 localizado no Portal do Cliente
https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/, para
maiores informações sobre os interceptores do contêiner e como usar o interceptor ao lado do
cliente.
U so d as B ib lio t ecas d o JB o ss AO P
Caso você não esteja apto a refatorar o código, você pode obter uma cópia das bibliotecas do
JBoss AOP e empacotá-las com o aplicativo. As bibliotecas AOP podem funcionar no JBoss EAP
6, mas não são implantadas. Você pode manualmente implantá-las usando o seguinte
argumento da linha de comando, quando você inicia o seu servidor:
D jbo ss. ao p. path= PATH_TO_AOP_CONFIG
Nota
Embora as bibliotecas do JBoss AOP possam funcionar no JBoss EAP 6, isto não é uma
configuração suportada.
Reportar um erro
3.2.13. Aplicat ivos Seam 2.2 de Migração
3.2 .1 3.1 . Migração do s Arquivo s Se am 2 .2 para o JBo ss EAP 6
Visão G eral
Quando você migrar um aplicativo Seam 2.2, você precisa configurar a fonte de dados e especificar
quaisquer dependências de módulo. Você precisa determinar também se o aplicativo possui
quaisquer dependências em arquivos que não lançam o JBoss EAP 6 e copiar quaisquer JARs
dependentes no diretório l i b/ do aplicativo.
81
Importante
por intenção ajudá-lo executar o seu aplicativo no JBoss EAP 6 como primeira etapa.
Lembre-se de que o empacotamento do Hibernate 3 com o aplicativo Seam 2.2 não é uma
Pro ced imen t o 3.28. Mig ração d o s Arq u ivo s Seam 2.2
1. At u aliz ação d a co n f ig u ração d a f o n t e d e d ad o s
Algumas das amostras Seam 2.2 usam a fonte de dados JD BC default nomeada
java: /Exampl eD S. A fonte de dados default foi alterada no JBoss EAP 6 para
java: jbo ss/d ataso urces/Exampl eD S. Caso seu aplicativo usar a fonte de dados da
amostra, você pode realizar o seguinte:
Caso você deseje usar um banco de dados de amostra que lança o JBoss EAP 6,
modifique o arquivo MET A-INF/persi stence. xml para substituir o elemento jtad ata-so urce existente com o nome JND I da fonte de dados do banco de dados de
amostra:
< !-- <jta-data-source>java:/ExampleDS</jta-data-source> -->
< jta-data-source>java:jboss/datasources/ExampleDS</jta-datasource>
Caso você preferir manter um banco de dados existente, você pode adicionar a definição
da fonte de dados ao arquivo
EAP_HOME/stand al o ne/co nfi g urati o n/stand al o ne. xml .
Importante
A seguinte definição é uma cópia da fonte de dados HSQL definida no JBoss EAP 6:
< datasource name="ExampleDS" jndi-name="java:/ExampleDS"
enabled="true" jta="true" use-java-context="true" useccm="true">

<connection-url>jdbc:h2:mem:test;DB_CLOSE_DELAY=1</connection-url>

<user-name>sa</user-name>

</security>
< /datasource>
82
Você pode também adicionar a definição da fonte de dados usando a interface da linha
de comando do Management CLI. Segue abaixo uma amostra da sintaxe que você deve
usar para adicionar a fonte de dados. O " \" no final da linha indica a continuação do
comando na linha seguinte.
Exemp lo 3.1. Amo st ra d a sin t axe p ara ad ição d a d ef in ição d a f o n t e d e d ad o s
$ EAP_HOME/bin/jboss-cli --connect
[standalone@ localhost:9999 /] data-source add --name=ExampleDS
--jndi-name=java:/ExampleDS \
--connection-url=jdbc:h2:mem:test;DB_CLOSE_DELAY=-1 -driver-name=h2 \
--user-name=sa --password=sa
Para maiores informações de como configurar a fonte de dados, consulte a Seção 3.1.6.2,
“ Atualização da Configuração da Fonte de D ados” .
2. Ad ição d e q u aisq u er d ep en d ên cias req u erid as
Uma vez que os aplicativos Seam 2.2 usam o JSF 1.2, você precisa adicionar dependências
para os módulos JSF 1.2 e excluir os módulos JSF 2.0. Para completar este procedimento,
você precisa criar um arquivo jbo ss-d epl o yment-structure. xml no diretório MET AINF/ do EAR que contém os seguintes dados:
<deployment>

export="true"/>

</dependencies>
</deployment>

</exclusions>

</dependencies>
</sub-deployment>
Caso seu aplicativo usar frameworks de registro em log de terceiros, você precisa adicionar
as dependências descritas na: Seção 3.1.4.1, “ Modificação das D ependências de Registro
em Log” .
3. C aso o seu ap licat ivo u sar o H ib ern at e 3.x, p rimeiro t en t e execu t ar o ap licat ivo
u san d o as b ib lio t ecas d o H ib ern at e 4
Caso o seu aplicativo não usar o Contexto Persistente Gerenciado Seam, busca Hibernate,
validação ou quaisquer outros recursos com o Hibernate 4, você pode estar apto a executar
com as bibliotecas do Hibernate 4. No entanto, caso você observar o
83
C l assNo tFo und Excepti o ns ou C l assC astExcepti o ns que direcionam às classes
Hibernate ou verificar erros similares aos seguintes, você terá que seguir as instruções da
próxima etapa e modificar o seu aplicativo para uso das bibliotecas do Hibernate 3.3.
Caused by: java.lang.LinkageError: loader constraint
violation in interface itable initialization: when resolving method
"org.jboss.seam.persistence.HibernateSessionProxy.getSession(Lorg/hi
bernate/EntityMode;)Lorg/hibernate/Session;" the class loader
(instance of org/jboss/modules/ModuleClassLoader) of the current
class, org/jboss/seam/persistence/HibernateSessionProxy, and the
class loader (instance of org/jboss/modules/ModuleClassLoader) for
interface org/hibernate/Session have different Class objects for the
type org/hibernate/Session used in the signature
4. C ó p ia d o s arq u ivo s d ep en d en t es a p art ir d o s f ramewo rks ext ern o s o u d e o u t ras
lo caliz açõ es
Caso o seu aplicativo usar o Hibernate 3.x e você não estiver apto a usar o Hibernate 4 com
sucesso no seu aplicativo, você precisará usar uma cópia do Hibernate 3-x JARs no
diretório /l i b e excluir o módulo Hibernate na seção de implantações do MET AINF/jbo ss-d epl o yment-structure. xml , conforme o seguinte:
<deployment>

</exclusions>
<deployment>
Não existe nenhuma etapa adicional que você deve realizar quando você aplicar o bundle
no seu aplicativo. Consulte a Seção 3.2.2.2, “ Configuração das Alterações para Aplicativos
que usam o Hibernate e o JPA” para maiores informações.
5. D ep u ração e reso lu ção d o s erro s Seam 2.2 JN D I
Quando você migrar o aplicativo Seam 2.2, você poderá ver erros
javax. nami ng . NameNo tFo und Excepti o n no log conforme o seguinte:
javax.naming.NameNotFoundException: Name 'jboss-seam-booking' not
found in context ''
Caso você não deseje modificar as pesquisas JND I através do código, você pode modificar
o arquivo co mpo nents. xml do aplicativo, conforme abaixo:
a. Su b st it u ição d o elemen t o co re- in it exist en t e
Primeiro, você pode substituir o elemento core-init existente, conforme abaixo:
< !-- <core:init jndi-pattern="jboss-seam-booking/#
{ejbName}/local" debug="true" distributable="false"/>
< core:init debug="true" distributable="false"/>
84
-->
b. En co n t re as men sag en s IN FO JN D I b in d in g IN FO n o lo g d o servid o r
A seguir, encontre as mensagens INFO binding JND I que são emitidas no log do
servidor quando o aplicativo é implantado. As mensages binding JNID I devem
parecer-se com o seguinte:
INFO
org.jboss.as.ejb3.deployment.processors.EjbJndiBindingsDeploym
entUnitProcessor (MSC service thread 1-1) JNDI bindings for
session bean
named AuthenticatorAction in deployment unit subdeployment
"jboss-seam-booking.jar" of deployment "jboss-seambooking.ear" are as follows:
java:global/jboss-seam-booking/jboss-seambooking.jar/AuthenticatorAction!org.jboss.seam.example.bookin
g.Authenticator
java:app/jboss-seambooking.jar/AuthenticatorAction!org.jboss.seam.example.bookin
g.Authenticator
java:module/AuthenticatorAction!org.jboss.seam.example.bookin
g.Authenticator
java:global/jboss-seam-booking/jboss-seambooking.jar/AuthenticatorAction
java:app/jboss-seam-booking.jar/AuthenticatorAction
java:module/AuthenticatorAction
c. Ad ição d o s elemen t o s d o co mp o n en t e
Para cada mensagem INFO binding JNID I, adicione um elemento co mpo nent
correspondente ao arquivo co mpo nents. xml :
< component
class="org.jboss.seam.example.booking.AuthenticatorAction"
jndi-name="java:app/jboss-seambooking.jar/AuthenticatorAction" />
Para maiores informações sobre como depurar e resolver os problemas de migração,
consulte a Seção 4.2.1, “ D epuração e Solução dos Problemas de Migração” .
Para uma lista de problemas de migração conhecidos com os arquivos, consulte a
Seção 3.2.13.2, “ Problemas de Migração do Seam 2.2 Archive” .
R esu lt ad o
O arquivo Seam 2.2 implementa e é executado com êxito no JBoss EAP 6.
Reportar um erro
3.2 .1 3.2 . Pro ble m as de Migração do Se am 2 .2 Archive
O Seam 2.2 D ro o ls e Java 7 n ão são co mp at íveis
O Seam 2.2 D rools e Java 7 são incompatíveis e falham com um
org.drools.RuntimeD roolsException: o valor '1.7' não é um erro de nível de linguagem
válido.
85
O Seam 2.2.5 d et ermin ad o co mo cg l i b. jar n ão p ermit e o f u n cio n amen t o d a
amo st ra Sp rin g
Quando a amostra Spring estiver executando usando o cg l i b. jar assinado que lançou
o Seam 2.2.5 no JBoss EAP 5, ocorre uma falha com a seguinte causa:
java.lang.SecurityException: class
"org.jboss.seam.example.spring.UserService$$EnhancerByCGLIB$$7d6c3
d12"'s signer information does not match signer information of
other classes in the same package
A solução para este problema é sair do cg l i b. jar, conforme abaixo:
zi p -d $SEAM_D IR /l i b/cg l i b. jar MET A-INF/JBO SSC O D \*
A amo st ra Seamb ay f alh a co m o No tLo g g ed InExcepti o n
A causa deste problema é o cabeçalho da mensagem estar nulo enquanto processando a
mensagem no SOAPRequestHandler e, consequentemente, a ID de conversação não ser
enviada.
Para resolver esse problema substitua o
o rg . jbo ss. seam. webservi ce. SO AP R eq uestHand l er. hand l eO utbo und ,
conforme descrito no https://issues.jboss.org/browse/JBPAPP-8376.
A amo st ra Seamb ay f alh a co m o Unsuppo rted O perati o nExcepti o n: n en h u ma
t ran sação
Este problema é causado pelas alterações no nome JND I do UserTransaction no JBoss
EAP 6.
A solução para este problema é substituir o
o rg . jbo ss. seam. transacti o n. T ransacti o n. g etUserT ransacti o n, conforme
descrito no https://issues.jboss.org/browse/JBPAPP-8322.
A amo st ra d e t aref as lan ça o o rg . jbo ss. resteasy. spi . Unhand l ed Excepti o n: n ão
f o i p o ssível can celar o marsh all d a men sag em so licit ad a
Este problema é causado pelo incompatibilidade entre o seam-resteasy-2.2.5 incluído no
JBoss EAP 5.1.2 e o RESTEasy 2.3.1.GA incluído no JBoss EAP 6.
Para solucionar este problema use jbo ss-d epl o yment-structure. xml para excluir
resteasy-jaxrs, resteasy-jettison-provider e resteasy-jaxb-provider da implantação principal
e resteasy-jaxrs, resteasy-jettison-provider, resteasy-jaxb-provider e resteasy-yaml-provider
do jbo ss-seam-tasks. war, conforme descrito no
https://issues.jboss.org/browse/JBPAPP-8315. Então, é necessário incluir as bibliotecas
RESTEasy empacotadas com o Seam 2.2 no EAR.
D ead lo ck en t re o o rg . jbo ss. seam. co re. Synchro ni zati o nIntercepto r e b lo q u eio
EJB d a in st ân cia d e co mp o n en t e st at ef u l d u ran t e u ma so licit ação AJAX
Uma página de erro " Causado pelo javax.servlet.ServletException" é exibida com a
mensagem: " javax.el.ELException: /main.xhtml @36,71 value=" #{hotelSearch.pageSize}" :
org.jboss.seam.core.LockTimeoutException: não foi possível adquirir o bloqueio no
componente @Synchronized hotelSearch" ou com mensagem de erro similar.
O problema é que o Seam 2 realiza o próprio bloqueio fora do bloqueio bean de sessão
stateful (SFSB) e com escopo diferente. Isto significa que se um thread acessar um EJB
duas vezes na mesma transação, após a primeira invocação isto terá o SFSB bloqueado,
86
mas o seam não será bloqueado. Um segundo thread pode adquirir o bloqueio seam, que
então atingirá o bloqueio EJB e entrará em espera. Quando o primeiro thread tentar sua
segunda invocação, ele bloqueará no deadlock e interceptor seam 2. No Java EE 5, os
EJBs lançariam uma exceção imediatamente no acesso atual. Esse comportamento foi
alterado no Java EE 6.
Para solucionar este problema, adicione o @AccessTimeout(0) ao EJB. Isto fará com que o
C o ncurrentAccessExcepti o n seja lançado imediatamente quando esta situação
ocorrer.
A amo st ra D vd st o re cria f alh as o rd en ad as co m o
javax. ejb. EJBT ransacti o nR o l l ed backExcepti o n
A amostra do dvdstore exibe o seguinte erro:
JBAS011437: Found extended persistence context in SFSB invocation
call stack but that cannot be used because the transaction already
has a transactional context associated with it. This can be
avoided by changing application code, either eliminate the
extended persistence context or the transactional context. See
JPA spec 2.0 section 7.6.3.1.
Este problema é devido às alterações na especificação JPA.
A solução para este problema é alterar o contexto de persistência para o transacti o nal
no C hecko utActi o n e classes Sho wO rd ersActi o n, além de usar a operação de
mesclagem do gerenciador de entidade nos métodos cancel O rd er e d etai l O rd er.
O p ro ved o r d o JB o ss C ach e Seam C ach e n ão p o d e ser u sad o n o JB o ss EAP 6
O JBoss Cache não é suportado no JBoss EAP 6. Isto leva o provedor do JBoss Cache
Seam a falhar no aplicativo Seam do servidor do aplicativo com:
java.lang.NoClassDefFoundError:
org/jboss/util/xml/JBossEntityResolver
.
O H ib ern at e 3.3.x Au t o scan p ara o p ro b lema d as en t id ad es JPA co m o JB o ss EAP 6
A correção para este problema é listar todas as classes no arquivo persistence.xml
manualmente. Por exemplo:
< persistence xmlns="http://java.sun.com/xml/ns/persistence"
version="1.0">

<persistence-unit name="example_pu">

<description>Hibernate 3 Persistence Unit.</description>

<jta-data-source>java:jboss/datasources/ExampleDS</jtadata-source>

<property name="jboss.as.jpa.providerModule"

</properties>

<class>com.acme.Foo</class>
87

<class>com.acme.Bar</class>
</persistence-unit>
/persistence>
<

A ch amd ad o ao s co mp o n en t es EJB Seam p ara n ão EJB T h read s resu lt a n u m
javax.n amin g .N ameN o t Fo u n d Excep t io n
Este problema é o resultado de alterações no JBoss EAP 6 para implantar o novo sistema
de carregamento de classe nova modular e para adotar as novas convenções do JND I
namespace padronizado. O java: app namespace é designado para os nomes
compartilhados por todos os componentes num aplicativo único. Não EE threads, tais
como os threads assíncrono Quartz, devem usar o java: g l o bal namespace, que é
compartilhado pelos aplicativos implantados na instância do servidor do aplicativo.
Caso você receba um javax. nami ng . NameNo tFo und Excepti o n, quando você tentar
chamar os componentes do EJB Seam a partir dos métodos assíncrono Quartz, você deve
modificar o arquivo co mpo nents. xml para uso do nome JND I global, por exemplo:
< component class="org.jboss.seam.example.quartz.MyBean" jndiname="java:global/seam-quartz/quartz-ejb/myBean"/>
Para maiores informações sobre as alterações do JND I, refira-se à Seção 3.1.8.1,
“ Atualização dos Nomes JND I Namespace do Aplicativo” . Para as maiores informações
sobre este problema específico, refira-se ao BZ#948215 - Seam2.3
javax.naming.NameNotFoundException trying to call EJB Seam components from quartz
asynchronous methods nas Notas de Lançamento 2.2.0 para o JBoss Web Framework Kit no
Portal do Cliente no
https://access.redhat.com/site/documentation/JBoss_Web_Framework_Kit/.
Reportar um erro
3.2.14 . Aplicat ivos Spring de Migração
3.2 .1 4 .1 . Aplicat ivo s Spring de Migração
A informação a respeito da migração dos aplicativos Spring pode ser encontrada na documentação
JBoss Web Framework Kit. Você pode baixar este documento a partir do Portal do Cliente no
https://access.redhat.com. Clique em K n o wled g e → Pro d u ct D o cu men t at io n , encontre o JBoss
Enterprise Middleware e clique no link JBoss Web Framework Kit.
Reportar um erro
3.2.15. Out ras Alt erações que Afet am a Migração
3.2 .1 5 .1 . Out ras alt e raçõ e s que po de m afe t ar sua Migração
Segue abaixo uma lista de outras alterações no JBoss EAP 6 que poderia impactar os esforços de
migração.
Seção 3.2.15.2, “ Alteração do Nome Maven Plug-in”
Seção 3.2.15.3, “ Modificação dos Aplicativos do Cliente”
88
Reportar um erro
3.2 .1 5 .2 . Alt e ração do No m e Mave n Plug-in
O jbo ss-maven-pl ug i n não foi atualizado e não funciona no JBoss EAP 6. Você deve usar o
o rg . jbo ss. as. pl ug i ns: jbo ss-as-maven-pl ug i n para implantar ao diretório correto.
Reportar um erro
3.2 .1 5 .3. Mo dificação do s Aplicat ivo s do Clie nt e
Caso deseje migrar um aplicativo de cliente que conectará ao JBoss EAP 6, você deve estar ciente
que o nome e a localização do JAR que agrupam as bibliotecas dos clientes foram alterados. Esse
JAR é agora nomeado jbo ss-cl i ent. jar e está localizado no diretório
EAP_HOME/bi n/cl i ent/. Isto substitui o EAP_HOME/cl i ent/jbo ssal l -cl i ent. jar e contém
todas as dependências requeridas ao conectar o JBoss EAP 6 a partir do cliente remoto.
Reportar um erro
89
Capítulo 4. Ferramentas e Dicas
4 .1. Recursos para Assist i-lo com a Migração
4 .1.1. Recursos que podem orient á-lo em sua Migração
Segue abaixo uma lista de recursos que podem orientá-lo na migração de um aplicativo para o
JBoss EAP 6.
Ferramen t as
Existem diversas ferramentas que ajudam automaticamente algumas das alterações da
configuração. Consulte a Seção 4.1.2, “ Familiarize-se com as Ferramentas que podem
orientá-lo na Migração” para maiores informações.
D icas d e D ep u ração
Para uma lista das causas e resoluções de problemas e erros que você poderá encontrar
enquanto migrando o seu aplicativo, consulte a Seção 4.2.1, “ D epuração e Solução dos
Problemas de Migração” .
Amo st ra d e Mig ração
Para amostras de aplicativos que foram migrados ao JBoss EAP 6, consulte a Seção 4.3.1,
“ Revise a Migração dos Aplicativos de Amostra” .
Reportar um erro
4 .1.2. Familiariz e-se com as Ferrament as que podem orient á-lo na Migração
Su mário
Existem algumas ferramentas que podem assisti-lo no processo de sua migração. Segue abaixo
uma lista dessas ferramentas juntamente com a descrição do que elas fazem.
T at t let ale
Você precisa encontrar e retificar as dependências do aplicativo com a mudança no
carregamento de classe modular. O Tattletale pode ajudá-lo a identificar os nomes do
módulo de dependência e gerar o XML da configuração para seu aplicativo.
Seção 4.1.3, “ Uso do Tattle para encontrar D ependências do Aplicativo”
Ferramen t a d e Mig ração Iro n Jacamar
No JBoss EAP 6, as fontes de dados e adaptadores de recurso não são mais configurados
em um arquivo separado. Eles estão apenas definidos no arquivo de configuração do
servidor e usam novos esquemas. A Ferramenta de Migração IronJacamar pode ajudar a
converter a configuração antiga em um formato esperado pelo JBoss EAP 6.
Seção 4.1.6, “ Uso da Ferramenta IronJacamar para Migração da Fonte de D ados e
Configurações do Adaptador de Recurso”
Reportar um erro
4 .1.3. Uso do T at t le para encont rar Dependências do Aplicat ivo
90
⁠Capít ulo 4 . Ferrament as e Dicas
Su mário
D evido às alterações de carregamento de classe no JBoss EAP 6, você poderá ver os traços do
C l assNo tFo und Excepti o n ou C l assC astExcepti o n no log do Jboss quando você migrar o
seu aplicativo. Para resolver esses erros, você precisa encontrar os JARs que contém as classes
especificadas pelas exceções.
O Tattletale é uma excelente ferramenta de terceiros que escaneia recursivamente o seu aplicativo e
fornece relatórios detalhados sobre seu conteúdo. O Tattletale 1.2.0.Beta2 ou mais avançado
contém suporte adicional para orientação com o novo carregamento da classe de Módulos do
JBoss usados no JBoss EAP 6. O relatório do " JBoss EAP 6" do Tattletale pode ser usado para
identificar automaticamente e gerar os nomes do módulo de dependência para inclusão de seu
arquivo jbo ss-d epl o yment-structure. xml do aplicativo.
Pro ced imen t o 4 .1. In st alação e execu ção d o T at t let ale p ara en co n t rar d ep en d ên cias d o
ap licat ivo
1. Seção 4.1.4, “ D ownload e Instalação do Tattletale”
2. Seção 4.1.5, “ Criação e Revisão do Relatório Tattletale”
Nota
O Tattletale é uma ferramenta de terceiros e não é suportado como parte do JBoss EAP 6.
Para a maioria da documentação sobre como instalar e usar o Tattletale, visite o website
Tattletale no http://www.jboss.org/tattletale.
Reportar um erro
4 .1.4 . Download e Inst alação do T at t let ale
Pro ced imen t o 4 .2.
1. Realize o download do Tattletale de versão 1.2.0.Beta2 ou mais recente a partir do
http://sourceforge.net/projects/jboss/files/JBoss% 20Tattletale.
2. D escomprima o arquivo ao diretório de sua escolha.
3. Modifique o arquivo T AT T LET ALE_HO ME/jbo ss-tattl etal e. pro perti es realizando o
seguinte:
a. Adicione o ee6 e as7 à propriedade pro fi l es.
profiles=java5, java6, ee6, as7
b. D escomente as propriedades scan e repo rts.
91
Nota
O Tattletale é uma ferramenta de terceiros e não é suportado como parte do JBoss EAP 6.
Para a maioria da documentação sobre como instalar e usar o Tattletale, visite o website
Tattletale no http://www.jboss.org/tattletale.
Reportar um erro
4 .1.5. Criação e Revisão do Relat ório T at t let ale
1. Crie um relatório Tattletale emitindo o comando: java -jar
TATTLETALE_HOME/tattl etal e. jarAPPLICATION_ARCHIVEOUTPUT_DIRECTORY
Por exemplo: java -jar tattl etal e-1. 2. 0 . Beta2/tattl etal e. jar
appl i cati o ns/jbo ss-seam-bo o ki ng . ear o utput-resul ts/
2. Num navegador, abra o arquivo OUTPUT_DIRECTORY/i nd ex. html e clique em " JBoss
EAP 6" na seção " Reports" .
a. A coluna na esquerda lista os arquivos usados pelo aplicativo. Clique no link
ARCHIVE_NAME para detalhes de visualização sobre o arquivo, tal como sua
localização, informação de manifesto e classes que isto contém.
b. O link jbo ss-d epl o yment-structure. xml na coluna da direita apresenta como
especificar a dependência do módulo para o arquivo nomeado na coluna da
esquerda. Clique neste link para verificar como definir a informação do módulo de
dependência da implantação para este arquivo.
Nota
O Tattletale é uma ferramenta de terceiros e não é suportado como parte do EAP 6. Para a
maioria da documentação sobre como instalar e usar o Tattletale, visite o website Tattletale
no http://www.jboss.org/tattletale.
Reportar um erro
4 .1.6. Uso da Ferrament a IronJacamar para Migração da Font e de Dados e
Configurações do Adapt ador de Recurso
Su mário
Nas versões anteriores do servidor do aplicativo, as fontes de dados e adaptadores de recurso eram
configuradas e implantadas usando um arquivo com sufixo *-d s. xml . A distribuição IronJacamar
1.1 contém uma ferramenta de migração que pode ser usada para converter esses arquivos de
configuração ao formato esperado pelo JBoss EAP 6. As ferramentas analisam o arquivo de
configuração da fonte a partir do lançamento anterior, criam e gravam a configuração XML a um
92
arquivo resultante num novo formato. Esse XML pode ser copiado e colado sob o subsistema no
arquivo de configuração do servidor do JBoss EAP 6. Essas ferramentas fazem o seu melhor
trabalho para converter atributos e elementos antigos em novo formato. No entanto, pode ser
necessário realizar modificações adicionais ao arquivo gerado.
Pro ced imen t o 4 .4 . In st alação e execu ção d a f erramen t a d e Mig ração Iro n Jacamar
1. Seção 4.1.7, “ D ownload e Instalação da Ferramenta de Migração IronJacamar”
2. Seção 4.1.8, “ Uso da Ferramenta de Migração IronJacamar para converter um Arquivo de
Configuração da Fonte de D ados”
3. Seção 4.1.9, “ Uso da Ferramenta IronJacamar para Converter um Arquivo de Configuração
do Adaptador de Recurso”
Nota
A ferramenta de Migração IronJacamar é a ferramenta de terceiros e não é suportada como
parte do JBoss EAP 6. Consulte o http://www.jboss.org/ironjacamar para maiores informações
sobre o IronJacamar. Consulte o http://www.ironjacamar.org/documentation.html para
acessar a mais recente documentação sobre como instalar e usar essa ferramenta.
Reportar um erro
4 .1.7. Download e Inst alação da Ferrament a de Migração IronJacamar
Nota
A ferramenta de migração está apenas disponível na versão IronJacamar 1.1 ou superior.
1. Baixe o IronJacamar 1.1 ou distribuição ampla a partir do:
http://www.jboss.org/ironjacamar/downloads/
2. D escomprime o arquivo baixado num diretório de sua escolha.
3. Encontre o script conversor na distribuição IronJacamar.
O script Linux está localizado no: IRONJACAMAR_HOME/d o c/as/co nverter. sh
O arquivo em lote do Windows está localizado no:
IRONJACAMAR_HOME/d o c/as/co nverter. bat
93
Nota
acessar a mais recente documentação de como instalar e usar essa ferramenta.
Reportar um erro
4 .1.8. Uso da Ferrament a de Migração IronJacamar para convert er um
Arquivo de Configuração da Font e de Dados
Pro ced imen t o 4 .6 .
1. Abra uma linha de comando e navegue ao diretório IRONJACAMAR_HOME/d o cs/as/.
2. Execute o script conversor digitando o seguinte comando:
No Linux: . /co nverter. sh -d s SOURCE_FILE TARGET_FILE
No Microsoft Windows: . /co nverter. bat -d s SOURCE_FILE TARGET_FILE
O SOURCE_FILE é o arquivo -ds.xml da fonte de dados do lançamento anterior. O
TARGET_FILE contém uma nova configuração.
Por exemplo, para converter o arquivo de configuração da fonte de dados jbo ss-seambo o ki ng -d s. xml localizado no diretório atual, você digitaria:
No Linux: . /co nverter. sh -d s jbo ss-seam-bo o ki ng -d s. xml newd ataso urce-co nfi g . xml
No Microsoft Windows: . /co nverter. bat -d s jbo ss-seam-bo o ki ng -d s. xml newd ataso urce-co nfi g . xml
Perceba que o parâmetro para a conversão da fonte de dados é -d s.
3. Copie o elemento <d ataso urce> a partir do arquivo de destino e cole-o no arquivo de
configuração do servidor sob o elemento <subsystem
xml ns= "urn: jbo ss: d o mai n: d ataso urces: 1. 1"><d ataso urces>.
Importante
Caso você esteja executando um managed domain, copie o XML ao arquivo
Caso você esteja executando num servidor autônomo, copie o XML no arquivo
4. Modificação do XML gerado ao novo arquivo de configuração.
94
Segue abaixo uma amostra do arquivo de configuração da fonte de dados jbo ss-seambo o ki ng -d s. xml para a amostra do Seam 2.2 Booking que foi lançado com o JBoss EAP
5.x:
< datasources>
<local-tx-datasource>

<jndi-name>bookingDatasource</jndi-name>

<connection-url>jdbc:hsqldb:.</connection-url>

<driver-class>org.hsqldb.jdbcDriver</driver-class>

<password></password>
</local-tx-datasource>
< /datasources>
Segue abaixo o arquivo de configuração que foi gerado pela execução do script conversor.
O arquivo gerado contém um elemento <d ri ver-cl ass>. A maneira preferida de definir a
classe do driver no JBoss EAP 6 é usar um elemento <d ri ver>. Segue abaixo o XML
resultando no arquivo de configuração do JBoss EAP 6 com modificações para comentar o
elemento <d ri ver-cl ass> e adicionar o elemento <d ri ver>:
< subsystem xmlns="urn:jboss:domain:datasources:1.1">
<datasources>

<datasource enabled="true" jndiname="java:jboss/datasources/bookingDatasource" jta="true"

pool-name="bookingDatasource" use-ccm="true" use-javacontext="true">

<connection-url>jdbc:hsqldb:.</connection-url>

<!-- Comment out the following driver-class element

since it is not the preferred way to define this.

<driver-class>org.hsqldb.jdbcDriver</driver-class>
->

<transaction-isolation>TRANSACTION_NONE</transactionisolation>

<pool>

<prefill>false</prefill>

<use-strict-min>false</use-strict-min>

<flush-strategy>FailingConnectionOnly</flush-strategy>

</pool>

</security>

<validate-on-match>false</validate-on-match>

<background-validation>false</background-validation>

<use-fast-fail>false</use-fast-fail>

</validation>

<track-statements>false</track-statements>

</statement>

</datasource>

<!-- The following driver element was not in the

XML target file. It was created manually. -->
95

<driver name="h2" module="com.h2database.h2">
<xa-datasource-class>org.h2.jdbcx.JdbcDataSource</xadatasource-class>

</driver>

</drivers>
</datasources>
< /subsystem>

Nota
Reportar um erro
4 .1.9. Uso da Ferrament a IronJacamar para Convert er um Arquivo de
Configuração do Adapt ador de Recurso
1. Abra uma linha de comando e navegue ao diretório IRONJACAMAR_HOME/d o cs/as/.
2. Execute o script conversor digitando o seguinte comando:
No Linux: . /co nverter. sh -ra SOURCE_FILE TARGET_FILE
No Microsoft Windows: . /co nverter. bat -ra SOURCE_FILE TARGET_FILE
O SOURCE_FILE é um arquivo -ds.xml adaptador de recurso do lançamento anterior. O
TARGET_FILE contém uma nova configuração.
Por exemplo, para converter o arquivo de configuração do adaptador de recurso
mttestad apter-d s. xml localizado no diretório atual, você digitaria:
No Linux: . /co nverter. sh -ra mttestad apter-d s. xml new-ad apterco nfi g . xml
No Microsoft Windows: . /co nverter. bat -ra mttestad apter-d s. xml newad apter-co nfi g . xml
Perceba que o parâmetro para a conversão do adaptador de recurso é -ra.
3. Copie todo o elemento <reso urce-ad apters> do arquivo de destino e cole-o no arquivo
de configuração sob o elemento <subsystem xml ns= "urn: jbo ss: d o mai n: reso urcead apters: 1. 1">
Importante
96
Caso você esteja executando um managed domain, copie o XML ao arquivo
Caso você esteja executando um servidor autônomo, copie o XML ao arquivo
4. Modificação do XML gerado ao novo arquivo de configuração.
Segue abaixo um exemplo do arquivo de configuração do adaptador de recurso
mttestad apter-d s. xml a partir do JBoss EAP 5.x TestSuite:
<!-==================================================================
== -->


<!-==================================================================
== -->
< connection-factories>
<tx-connection-factory>

<jndi-name>JBossTestCF</jndi-name>

<xa-transaction/>

<rar-name>jbosstestadapter.rar</rar-name>

<connectiondefinition>javax.resource.cci.ConnectionFactory</connectiondefinition>

<config-property name="IntegerProperty"
type="java.lang.Integer">2</config-property>

<config-property name="BooleanProperty"
type="java.lang.Boolean">false</config-property>

<config-property name="DoubleProperty"
type="java.lang.Double">5.5</config-property>

<config-property name="UrlProperty"
type="java.net.URL">http://www.jboss.org</config-property>

<config-property name="sleepInStart" type="long">200</configproperty>

<config-property name="sleepInStop" type="long">200</configproperty>
</tx-connection-factory>

<jndi-name>JBossTestCF2</jndi-name>

<xa-transaction/>

97

<jndi-name>JBossTestCFByTx</jndi-name>

<xa-transaction/>

<track-connection-by-tx>true</track-connection-by-tx>

< /connection-factories>
Segue abaixo o arquivo de configuração que foi gerado pela execução do script conversor.
Substitua o valor do atributo do nome da classe " FIXME_MCF_CLASS_NAME" no XML
gerado com o nome de classe correto da alocação de conexão gerenciada, neste caso o
" org.jboss.test.jca.adapter.TestManagedConnectionFactory" . Segue abaixo o XML resultante
no arquivo de configuração do JBoss EAP 6 com modificações ao valor do elemento
<cl ass-name>.
< subsystem xmlns="urn:jboss:domain:resource-adapters:1.1">
<resource-adapters>

<resource-adapter>

<archive>jbosstestadapter.rar</archive>

<transaction-support>XATransaction</transaction-support>

<!-- Replace the "FIXME_MCF_CLASS_NAME" class-name value with the
correct class name
<connection-definition class-name="FIXME_MCF_CLASS_NAME"
enabled="true"

jndi-name="java:jboss/JBossTestCF" pool-name="JBossTestCF"

use-ccm="true" use-java-context="true"> -->

classname="org.jboss.test.jca.adapter.TestManagedConnectionFactory"

enabled="true"

jndi-name="java:jboss/JBossTestCF" pool-name="JBossTestCF"

use-ccm="true" use-java-context="true">

<config-property name="IntegerProperty">2</config-property>

<config-property name="sleepInStart">200</config-property>
98

<config-property name="sleepInStop">200</config-property>
<config-property name="BooleanProperty">false</config-property>

<config-property
name="UrlProperty">http://www.jboss.org</config-property>

<config-property name="DoubleProperty">5.5</config-property>

<pool>

</pool>

</security>

</validation>

</resource-adapter>

<resource-adapter>

correct class name

enabled="true"

jndi-name="java:jboss/JBossTestCF2" pool-name="JBossTestCF2"

enabled="true"

jndi-name="java:jboss/JBossTestCF2" pool-name="JBossTestCF2"

<config-property

<pool>

</pool>

</security>

99

</validation>

</resource-adapter>

<resource-adapter>

correct class name
enabled="true"

jndi-name="java:jboss/JBossTestCFByTx" poolname="JBossTestCFByTx"

enabled="true"

jndi-name="java:jboss/JBossTestCFByTx" poolname="JBossTestCFByTx"

<config-property

<pool>

</pool>

</security>

</validation>

</resource-adapter>
</resource-adapters>
< /subsystem>

100
Nota
Reportar um erro
4 .2. Problemas da Migração de Depuração
4 .2.1. Depuração e Solução dos Problemas de Migração
D evido ao carregamento de classe, regras de nomeação JND I e outras alterações no servidor do
aplicativo, você poderá encontrar exceções ou outros erros caso você tente implantar seu aplicativo
" como-está" . Segue abaixo a descrição de como resolver algumas das exceções mais comuns e
erros que você venha a encontrar.
Seção 4.2.2, “ D epuração e Solução do ClassNotFoundExceptions e NoClassD efFoundErrors”
Seção 4.2.5, “ D epuração e Resolução dos ClassCastExceptions”
Seção 4.2.6, “ D epuração e Solução do D uplicateServiceExceptions”
Seção 4.2.7, “ D epuração e Resolução dos Erros da Página de D epuração do JBoss Seam”
Reportar um erro
4 .2.2. Depuração e Solução do ClassNot FoundExcept ions e
NoClassDefFoundErrors
Su mário
O ClassNotFoundExceptions ocorre normalmente devido a uma dependência não-resolvida. Isto
significa que você deve definir explicitamente as dependências em outros módulos ou copiar os
JARs de fontes externas.
1. Tente primeiro a Seção 4.2.3, “ Busque a D ependência de Módulo do JBoss”
2. Caso não haja um módulo para a classe ausente, a Seção 4.2.4, “ Busca do JAR na
Instalação Anterior”
Reportar um erro
4 .2.3. Busque a Dependência de Módulo do JBoss
Para resolver a dependência, primeiro tente o módulo que contém a classe especificada pelo
C l assNo tFo und Excepti o n pesquisando no diretório
EAP_HOME/mo d ul es/system/l ayers/base/. Caso você encontrar um módulo para a classe,
você deve adicionar a dependência à entrada do manifesto.
101
Por exemplo, caso você verificar este rastreamento ClassNotFoundException no log:
Caused by: java.lang.ClassNotFoundException:
org.apache.commons.logging.Log
from [Module "deployment.TopicIndex.war:main" from Service Module
Loader]
at
org.jboss.modules.ModuleClassLoader.findClass(ModuleClassLoader.java:188)
Encontre o módulo do JBoss contendo essa classe efetuando o seguinte:
Pro ced imen t o 4 .9 .
1. D etermine primeiramente se existe um módulo claro para a classe.
a. Navegue ao diretório EAP_HOME/mo d ul es/system/l ayers/base/ e busque pelo
caminho do módulo combinando a classe nomeada no
C l assNo tFo und Excepti o n.
Você pode encontrar o o rg /apache/co mmo ns/l o g g i ng / de caminho modular.
b. Abra o arquivo
EAP_HOME/mo d ul es/system/l ayers/base/o rg /apache/co mmo ns/l o g g i ng
/mai n/mo d ul e. xml e encontre o nome do módulo. Neste caso, isto é
" org.apache.commons.logging" .
c. Adicione o nome do módulo às D ependências no arquivo MANIFEST . MF:
Dependencies: org.apache.commons.logging
2. Caso não haja caminho de módulo óbvio para a classe, você precisa encontrar a
dependência em outra localização.
a. Busque pela classe nomeada no C l assNo tFo und Excepti o n do Relatório
Tattletale.
b. Busque o módulo contendo o JAR no diretório EAP_HOME/mo d ul es e encontre o
nome do módulo como na etapa anterior.
Reportar um erro
4 .2.4 . Busca do JAR na Inst alação Ant erior
Caso a classe não seja encontrada no JAR empacotado num módulo definido pelo servidor, busque
o JAR em sua instalação EAP5_HOME ou seu diretório l i b/ anterior do servidor.
Por exemplo, caso você veja este traço C l assNo tFo und Excepti o n no log:
Caused by: java.lang.NoClassDefFoundError:
org/hibernate/validator/ClassValidator at
java.lang.Class.getDeclaredMethods0(Native Method)
Busque pelo JAR contendo essa classe efetuando o seguinte:
102
1. Abra o terminal e navegue ao diretório EAP5_HOME/.
2. Emita o comando:
g rep ' o rg . hi bernate. val i d ato r. C l assVal i d ato r' `fi nd . \-name
' *. jar' `
3. Você poderá encontrar mais de um resultado. Neste caso, o seguinte resultado é o JAR que
precisamos:
Binary file ./jboss-eap-5.1/seam/lib/hibernate-validator.jar
matches
4. Copie esse JAR ao diretório l i b/ do aplicativo.
Caso você precisar de um número grande de JARs, será mais fácil definir um módulo para as
classes. Para maiores informações sobre esse assunto, refira-se aos Módulos no capítulo
Iniciação dos Aplicativos de Desenvolvimento do Guia de Desenvolvimento para o JBoss EAP 6
no https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/.
5. Reconstrua e reimplante o aplicativo.
Reportar um erro
4 .2.5. Depuração e Resolução dos ClassCast Except ions
Os ClassCastExceptions acontecem com frequência uma vez que a classe está sendo carregada por
um carregador de classe que eles estendem. Eles podem também ser o resultado da mesma classe
existente em JARs múltiplos.
1. Busque pelo aplicativo para encontrar todos os JAR(s) que contém a classe nomeada pelo
C l assC astExcepti o n. Caso exista um módulo definido para a classe, encontre e remova
os JAR(s) duplicados a partir do WAR ou EAR do aplicativo.
2. Encontre o módulo do JBoss contendo a classe e defina claramente a dependência no
arquivo MANIFEST . MF ou no arquivo jbo ss-d epl o yment-structure. xml . Refira-se ao
Carregamento de Classe e Subimplantações no capítulo Carregamento de Classe e Módulos do
Guia de Desenvolvimento para o JBoss EAP 6 no
https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/ para
maiores informações.
3. Caso você não esteja apto a resolver isto usando as etapas acima, você pode normalmente
determinar a causa do problema imprimindo a informação do carregador da classe ao log.
Por exemplo, você observará o seguinte C l assC astExcepti o n no log:
java.lang.ClassCastException: com.example1.CustomClass1 cannot be
cast to com.example2.CustomClass2
a. No seu código, imprima a informação do carregador das classes nomeados pelo
C l assC astExcepti o n ao log, por exemplo:
l ogger.info("Class loader for CustomClass1: " +

103
com.example1.CustomClass1.getClass().getClassLoader().toString
());
l ogger.info("Class loader for CustomClass2: " +

com.example2.CustomClass2.getClass().getClassLoader().toString
());
b. A informação no log apresenta quais módulos são carregados nas classes e,
baseado no seu aplicativo, você precisa remover ou mover os JAR(s) em conflito.
Reportar um erro
4 .2.6. Depuração e Solução do Duplicat eServiceExcept ions
Caso você obter um D uplicateServiceExceptions para uma sub-implantação de um JAR ou uma
mensagem que o aplicativo WAR já foi instalado quando você implantar seu JBoss EAP 6, isto pode
ter decorrido de alterações da maneira em que o JBossWS manuseia a sua implantação.
O lançamento do JBossWS 3.3.0 introduziu um novo novo Algoritmo de Mapeamento Raiz de
Contexto para servlet baseados nos pontos de extremidade que permitem isto tornar-se diretamente
compatível com o TCK6. Caso o arquivo EAR do aplicativo conter um JAR com o mesmo nome, o
JBossWS pode criar um contexto WAR e um contexto da web com o mesmo nome. O contexto da web
conflita com o contexto WAR e isto resulta em erros de implantação. Resolva os problemas de
implantação em uma das seguintes maneiras:
Renomeie o arquivo JAR a um nome que é diferente ao WAR, de forma que a web gerada e os
contextos WAR sejam únicos.
Forneça um elemento <co ntext-ro o t> ao arquivo jbo ss-web. xml .
Forneça um elemento <co ntext-ro o t> ao arquivo jbo ss-webservi ces. xml .
Personalize o elemento <co ntext-ro o t> para o WAR no arquivo appl i cati o n. xml .
Reportar um erro
4 .2.7. Depuração e Resolução dos Erros da Página de Depuração do JBoss
Seam
Após você migrar e implantar o seu aplicativo com sucesso, você pode encontrar um erro do
período de execução que o redireciona à página " D epuração do JBoss Seam" . O URL para esta
página é " http://localhost:8080/APPLICATION_CONTEXT/debug.seam" . Esta página permite que
você visualize e inspecione os componentes Seam em qualquer dos contextos associados com a
sessão de login atual.
104
Fig u ra 4 .1. Pág in a d e D ep u ração d o JB o ss Seam
A razão mais provável de você ter sido redirecionado à esta página é devido ao Seam ter pego uma
Exceção que não foi manuseada no código do aplicativo. A causa principal da exceção pode ser
normalmente encontrada em um dos links na " Página de D epuração do JBoss Seam" .
1. Expanda a seção C o mpo nent na página e procure pelo componente
o rg . jbo ss. seam. caug htExcepti o n.
2. A causa e o rastreamento de pilha deve levá-lo às dependências ausentes.
105
Fig u ra 4 .2. In f o rmação o rg . jbo ss. seam. caug htExcepti o n d o co mp o n en t e
3. Use a técnica descrita na Seção 4.2.2, “ D epuração e Solução do ClassNotFoundExceptions
e NoClassD efFoundErrors” para resolver as dependências do módulo.
Na amostra acima, a solução mais simples é adicionar o rg . sl f4 j ao MANIFEST . MF
Dependencies: org.slf4j
Outra opção é adicionar uma dependência para o módulo ao arquivo jbo ssd epl o yment-structure. xml :

</dependencies>

</deployment>
Reportar um erro
4 .3. Revise a Migração dos Aplicat ivos da Amost ra
106
4 .3.1. Revise a Migração dos Aplicat ivos de Amost ra
Visão G eral
Segue abaixo uma lista dos aplicativos de amostra do JBoss EAP 5.x que foram migrados ao JBoss
EAP 6. Para visualizar os detalhes de como a alteração aconteceu num aplicativo em particular,
clique no link abaixo.
Seção 4.3.2, “ Migração da Amostra Seam 2.2 JPA para o JBoss EAP 6”
Seção 4.3.3, “ Migração da Amostra do Seam 2.2 JPA para o JBoss EAP 6”
Seção 4.3.4, “ Migração do Seam 2.2 Booking Archive ao JBoss EAP 6: Instruções de Etapa-porEtapa”
Reportar um erro
4 .3.2. Migração da Amost ra Seam 2.2 JPA para o JBoss EAP 6
Su mário
A seguinte lista de tarefas resume as alterações necessárias para migração com êxito do aplicativo
de amostra Seam 2.2 JPA para o JBoss EAP 6. Esse aplicativo de amostra pode ser encontrado na
distribuição do JBoss EAP 5.1 sob EAP5.1_HOME/jbo ss-eap-5. 1/seam/exampl es/jpa/
Importante
Pro ced imen t o 4 .12. Mig ração d a amo st ra Seam 2.2 JPA
1. R emo ção d o arq u ivo jb o ss- web
Remova o arquivo jbo ss-web. xml do diretório jbo ss-seam-jpa. war/WEB-INF/. O
carregamento da classe definido no jbo ss-web. xml é agora o comportamento default.
2. Mo d if icação d o arq u ivo jbo ss-seam-jpa. jar/MET A-INF/persi stence. xml
co n f o rme ab aixo .
a. Remova ou comente a propriedade hi bernate. cache. pro vi d er_cl ass no
arquivo jbo ss-seam-jpa. war/WEB-INF/cl asses/MET AINF/persi stence. xml :
< !-- <property name="hibernate.cache.provider_class"
value="org.hibernate.cache.HashtableCacheProvider"/> -->
b. Adicione a propriedade do módulo do fornecedor do arquivo jbo ss-seambo o ki ng . jar/MET A-INF/persi stence. xml :
107
< property name="jboss.as.jpa.providerModule"
c. Altere a propriedade jta-d ata-so urce para uso do nome JND I da fonte de dados
JD BC:
3. Ad ição d as d ep en d ên cias Seam 2.2
Copie os seguintes JARs da biblioteca Seam 2.2, SEAM_HO ME/l i b/, ao diretório jbo ssseam-jpa. war/WEB-INF/l i b/:
antlr.jar
slf4j-api.jar
slf4j-log4j12.jar
hibernate-entitymanager.jar
hibernate-core.jar
hibernate-annotations.jar
hibernate-commons-annotations.jar
hibernate-validator.jar
4. C riação d e u m arq u ivo jb o ss- d ep lo ymen t - st ru ct u re p ara ad icio n ar as
d ep en d ên cias rest an t es
Crie um arquivo jbo ss-d epl o yment-structure. xml na pasta jbo ss-seamjpa. war/WEB-INF/ contendo os seguintes dados:

</exclusions>

</dependencies>

</deployment>
R esu lt ad o :
108
O aplicativo da amostra Seam 2.2 implanta e executa com êxito no JBoss EAP 6.
Reportar um erro
4 .3.3. Migração da Amost ra do Seam 2.2 JPA para o JBoss EAP 6
Su mário
A migração do Seam 2.2 Booking EAR é mais complicada do que a amostra Seam 2.2 JPA WAR. A
documentação para a migração da amostra Seam 2.2 JPA WAR pode ser encontrada na
Seção 4.3.2, “ Migração da Amostra Seam 2.2 JPA para o JBoss EAP 6” . Para migrar o aplicativo,
você deve realizar o seguinte:
1. Inicialize o JSF 1.2 ao invés do JSF 2 default.
2. Empacote versões antigas dos Hibernate JARs ao invés de usar aquelas que lançam o
JBoss EAP 6.
3. Altere os bindings JND I para uso da nova sintaxe portátil do Java EE 6 JND I.
As primeiras duas etapas foram feitas na migração da amostra Seam 2.2 JPA WAR. A terceira etapa
é nova e é necessária uma vez que o EAR contém EJBs.
Importante
Pro ced imen t o 4 .13. Mig ração d a amo st ra Seam 2.2 B o o kin g
1. C rie o arq u ivo jbo ss-d epl o yment-structure. xml
Crie um novo arquivo nomeado jbo ss-d epl o yment-structure. xml no jbo ss-seambo o ki ng . ear/MET A-INF/ e adicione o seguinte conteúdo:
<deployment>

export="true"/>

</dependencies>
109

</deployment>
<exclusions>
</exclusions>
<dependencies>
</dependencies>
</sub-deployment>
</jboss-deployment-structure>

2. Mo d if iq u e o arq u ivo jbo ss-seam-bo o ki ng . jar/MET A-INF/persi stence. xml
co n f o rme o seg u in t e.
a. Remova ou comente a propriedade do hibernate para a classe do provedor do
cache:
b. Adicione a propriedade do módulo do provedor ao arquivo jbo ss-seambo o ki ng . jar/MET A-INF/persi stence. xml :
< property name="jboss.as.jpa.providerModule"
c. Altere a propriedade jta-d ata-so urce para uso do nome JND I da fonte de dados
JD BC:
3. C o p ie o s JAR s a p art ir d a d ist rib u ição Seam 2.2
Copie os seguintes JARs a partir da distribuição Seam 2.2 EAP5.x_HOME/jbo sseap5. x/seam/l i b/ no diretório jbo ss-seam-bo o ki ng . ear/l i b.
antlr.jar
slf4j-api.jar
slf4j-log4j12.jar
hibernate-core.jar
hibernate-entitymanager.jar
hibernate-annotations.jar
hibernate-commons-annotations.jar
4. Alt ere o s n o mes d e p esq u isa JN D I
110
Altere os strings de pesquisa JND I no arquivo jbo ss-seam-bo o ki ng . war/WEBINF/co mpo nents. xml . O JBoss EAP 6 efetua o binds nos EJBs usando as regras de
sintaxe portátil JND I e você não pode usar o jndiPattern que era usado no JBoss EAP 5.
Segue abaixo os strings de pesquisa EJB JND I do aplicativo que devem ser alterados no
JBoss EAP 6:
java:global/jboss-seam-booking/jboss-seambooking/HotelSearchingAction!org.jboss.seam.example.booking.HotelSe
arching
java:app/jboss-seambooking/HotelSearchingAction!org.jboss.seam.example.booking.HotelSe
arching
java:module/HotelSearchingAction!org.jboss.seam.example.booking.Hot
elSearching
java:global/jboss-seam-booking/jboss-seambooking/HotelSearchingAction
java:app/jboss-seam-booking/HotelSearchingAction
java:module/HotelSearchingAction
Os strings de pesquisa para os EJBs de framework Seam 2.2 devem ser alteradas conforme
abaixo:
java:global/jboss-seam-booking/jbossseam/EjbSynchronizations!org.jboss.seam.transaction.LocalEjbSynchro
nizations
java:app/jbossseam/EjbSynchronizations!org.jboss.seam.transaction.LocalEjbSynchro
nizations
java:module/EjbSynchronizations!org.jboss.seam.transaction.LocalEjb
Synchronizations
java:global/jboss-seam-booking/jboss-seam/EjbSynchronizations
java:app/jboss-seam/EjbSynchronizations
java:module/EjbSynchronizations
Você pode usar uma das seguintes abordagens:
a. Ad ição d o s elemen t o s d o co mp o n en t e
Você pode adicionar um jnd i -name para cada EJB ao WEBINF/co mpo nents. xml :

<component
class="org.jboss.seam.example.booking.BookingListAction"
jndi-name="java:app/jboss-seam-booking/BookingListAction" />
111

<component
class="org.jboss.seam.example.booking.ChangePasswordAction"
jndi-name="java:app/jboss-seam-booking/ChangePasswordAction"
/>
b. Você pode modificar o código pela adição da anotação @ JND IName(val ue= "")
especificando o caminho JND I. Segue abaixo uma amostra alterada do código bean
de sessão stateless. Uma descrição detalhada deste processo pode ser encontrada
na documentação de referência Seam 2.2.
@ Stateless
@ Name("authenticator")
@ JndiName(value="java:app/jboss-seambooking/AuthenticatorAction")
p ublic class AuthenticatorAction

implements Authenticator

{
. ..

}
R esu lt ad o :
O aplicativo da amostra Seam 2.2 Booking implanta e executa com êxito no JBoss EAP 6.
Reportar um erro
4 .3.4 . Migração do Seam 2.2 Booking Archive ao JBoss EAP 6: Inst ruções de
Et apa-por-Et apa
Este é um guia de etapa-por-etapa de como portar o arquivo do aplicativo Seam 2.2 Booking do
JBoss EAP 5.1 ao JBoss EAP 6. Embora existam três abordagens para os aplicativos de migração,
muitos desenvolvedores podem estar inclinados a implantar o arquivo do aplicativo (como ele é) ao
servidor do JBoss EAP 6 para checar o que acontece. O propósito desta documentação é
apresentar os tipos de problemas que você poderá encontrar quando você realizar isto e como você
pode depurar e resolver esses problemas.
Para esta amostra, o aplicativo EAR é implantado ao diretório
EAP6_HOME/stand al o ne/d epl o yments sem nenhuma alteração além da extração dos arquivos.
Isto permite você modificar com facilidade os arquivos XML contidos com os arquivos uma vez que
você se deparar e solucionar os problemas.
112
Importante
Hibernate 3 empacotado dentro do aplicativo. O Hibernate 4, que é fornecido através do
Pro ced imen t o 4 .14 . Mig ração d e seu ap licat ivo
1. Seção 4.3.5, “ Construção e D epuração da Versão do JBoss EAP 5.1 do Aplicativo Seam 2.2
Booking”
2. Seção 4.3.6, “ D epuração e resolução do erros e exceções do Seam 2.2 Booking Archive
D eployment”
3. Seção 4.3.7, “ D epuração e Resolução de erros e exceções do Seam 2.2 Booking Archive
Runtime”
A partir daqui, você estará apto a acessar com sucesso o aplicativo num navegador usando o URL
http://localhost:8080/seam-booking/. Entre como demo/demo e verifique a página de boas vindas do
Booking.
R evise o su mário d as alt eraçõ es
Seção 4.3.8, “ Revisão do Sumário das Alterações feitas quando Migrando o Aplicativo Seam 2.2
Booking”
Reportar um erro
4 .3.5. Const rução e Depuração da Versão do JBoss EAP 5.1 do Aplicat ivo
Seam 2.2 Booking
Antes da migração deste aplicativo, você precisa construir o aplicativo Seam 2.2 Booking do JBoss
EAP 5.1, extrair o arquivo e copiá-lo a uma pasta de implantação do JBoss EAP 6.
Pro ced imen t o 4 .15. C o n st ru ção e imp lan t ação d o EAR
1. Contrução do EAR:
$ cd /EAP5_HOME/jboss-eap5.1/seam/examples/booking
$ ANT_HOME/ant explode
2. Copie o EAR ao diretório de implantações EAP6_HOME:
$ cp -r EAP5_HOME/seam/examples/booking/exploded-archives/jbossseam-booking.ear EAP6_HOME/standalone/deployments/
$ cp -r EAP5_HOME/seam/examples/booking/exploded-archives/jbossseam-booking.war EAP6_HOME/standalone/deployments/jboss-seam.ear
$ cp -r EAP5_HOME/seam/examples/booking/exploded-archives/jbossseam-booking.jar EAP6_HOME/standalone/deployments/jboss-seam.ear
113
3. Inicie o servidor do JBoss EAP 6 e verifique o log. Você verá o seguinte:
INFO [org.jboss.as.deployment] (DeploymentScanner-threads - 1)
Found jboss-seam-booking.ear in deployment directory.
To trigger deployment create a file called jboss-seambooking.ear.dodeploy
4. Crie um arquivo vazio com o nome jbo ss-seam-bo o ki ng . ear. d o d epl o y e copie-o ao
diretório EAP6_HOME/stand al o ne/d epl o yments. Você precisa copiar este arquivo no
diretório de implantações diversas vezes enquanto migrando este aplicativo. Portanto,
mantenha isto numa localização da qual você pode encontrar com facilidade. No log, você
deverá ver agora as seguintes mensagens indicando que a implantação está ocorrendo:
INFO [org.jboss.as.server.deployment] (MSC service
Starting deployment of "jboss-seam-booking.ear"
Starting deployment of "jboss-seam-booking.jar"
Starting deployment of "jboss-seam.jar"
Starting deployment of "jboss-seam-booking.war"
thread 1-1)
thread 1-3)
thread 1-6)
thread 1-2)
A partir daqui, você encontra o primeiro erro de implantação. A próxima etapa, você
verificará cada problema e aprenderá como depurá-lo e resolvê-lo.
Consulte a Seção 4.3.6, “ D epuração e resolução do erros e exceções do Seam 2.2 Booking
Archive D eployment” para maiores informações sobre como depurar e resolver problemas de
implantação.
Clique na Seção 4.3.4, “ Migração do Seam 2.2 Booking Archive ao JBoss EAP 6: Instruções
de Etapa-por-Etapa” para retornar ao tópico anterior.
Reportar um erro
4 .3.6. Depuração e resolução do erros e exceções do Seam 2.2 Booking
Archive Deployment
Na etapa anterior, Seção 4.3.5, “ Construção e D epuração da Versão do JBoss EAP 5.1 do
Aplicativo Seam 2.2 Booking” , você construiu o aplicativo Seam 2.2 Booking do JBoss EAP 5.1 e o
implantava na pasta de implantação do JBoss EAP 6. Nessa etapa, você depura e resolve cada erro
de implantação que você encontrou.
Importante
Pro ced imen t o 4 .16 . D ep u ração e reso lu ção d o s erro s d e imp lan t ação e exceçõ es
114
1. Problema - java.lang.ClassNotFoundException: javax.faces.FacesException
Quando você implanta o aplicativo, o log contém o seguinte erro:
ERROR \[org.jboss.msc.service.fail\] (MSC service thread 1-1)
MSC00001: Failed to start service jboss.deployment.subunit."jbossseam-booking.ear"."jboss-seam-booking.war".POST_MODULE:
org.jboss.msc.service.StartException in service
jboss.deployment.subunit."jboss-seam-booking.ear"."jboss-seambooking.war".POST_MODULE:
Failed to process phase POST_MODULE of subdeployment "jboss-seambooking.war" of deployment "jboss-seam-booking.ear"
(.. additional logs removed ...)
javax.faces.FacesException from \[Module "deployment.jboss-seambooking.ear:main" from Service Module Loader\]
at
org.jboss.modules.ModuleClassLoader.findClass(ModuleClassLoader.java
:191)
O q u e sig n if ica:
O ClassNotFoundException indica que falta uma dependência. Neste caso, ele não pode
encontrar a classe javax. faces. FacesExcepti o n e você precisa adicionar a
dependência.
C o mo reso lver ist o :
Busque pelo nome do módulo para aquela classe no diretório
EAP6_HOME/mo d ul es/system/l ayers/base/ apenas observando o caminho que
coincide com a classe faltante. Neste caso, você pode encontrar dois módulos que
coincidem com o caminho:
javax/faces/api/main
javax/faces/api/1.2
Ambos os módulos possuem o mesmo nome de módulo: javax. faces. api , porém um
deles no diretório principal é para JSF 2.0 e outro localizado no diretório 1.2 é para JSF 1.2.
Caso houvesse apenas um módulo disponível, você poderia criar simplesmente um arquivo
MANIFEST . MF e adicionar a dependência do módulo. Neste caso, você deseja usar a
versão JSF 1.2 ao invés da versão 2.0 no principal, de forma que você precisa especificar
uma e excluir a outra. Para isto, crie um arquivo jbo ss-d epl o yment-structure. xml no
diretório do MET A-INF/ do EAR que contém os seguintes dados:
<deployment>

</dependencies>
</deployment>

115

</exclusions>
<dependencies>

</dependencies>
</sub-deployment>

Na seção d epl o yment, você adiciona a dependência para o javax. faces. api do
módulo JSF 1.2. Você pode adicionar também a dependência do módulo JSF 1.2 na seção
de subimplantação para o WAR e excluir o módulo para o JSF 2.0.
Reimplante o aplicativo apenas deletando o arquivo
EAP6_HOME/stand al o ne/d epl o yments/jbo ss-seam-bo o ki ng . ear. fai l ed e
criando um arquivo jbo ss-seam-bo o ki ng . ear. d o d epl o y vazio no mesmo diretório.
2. Problema - java.lang.ClassNotFoundException: org.apache.commons.logging.Log
ERROR [org.jboss.msc.service.fail] (MSC service thread 1-8)
MSC00001: Failed to start service jboss.deployment.unit."jbossseam-booking.ear".INSTALL:
org.jboss.msc.service.StartException in service
jboss.deployment.unit."jboss-seam-booking.ear".INSTALL:
Failed to process phase INSTALL of deployment "jboss-seambooking.ear"
(.. additional logs removed ...)
org.apache.commons.logging.Log from [Module "deployment.jboss-seambooking.ear.jboss-seam-booking.war:main" from Service Module
Loader]
O C l assNo tFo und Excepti o n indica a falta de uma dependência. Neste caso, ele não
pode buscar a classe o rg . apache. co mmo ns. l o g g i ng . Lo g e você precisa adicionar a
dependência.
Busque pelo nome do módulo para aquela classe no diretório
EAP6_HOME/mo d ul es/system/l ayers/base/ apenas observando o caminho que
coincide com a classe faltante. Neste caso, você pode encontrar um módulo que coincide o
caminho o rg /apache/co mmo ns/l o g g i ng /. O nome do módulo é
“ org.apache.commons.logging” .
Modifique o arquivo jbo ss-d epl o yment-structure. xml e adicione a dependência do
módulo à seção de implantação do arquivo.
< module name="org.apache.commons.logging" export="true"/>
O jbo ss-d epl o yment-structure. xml deve parecer-se com o seguinte:
116
<deployment>

</dependencies>
</deployment>

</exclusions>

</dependencies>
</sub-deployment>
3. Problema - java.lang.ClassNotFoundException: org.dom4j.D ocumentException
ERROR [org.apache.catalina.core.ContainerBase.[jboss.web].[defaulthost].[/seam-booking]] (MSC service thread 1-3) Exception sending
context initialized event to listener instance of class
org.jboss.seam.servlet.SeamListener: java.lang.NoClassDefFoundError:
org/dom4j/DocumentException
(... additional logs removed ...)
org.dom4j.DocumentException from [Module "deployment.jboss-seambooking.ear.jboss-seam.jar:main" from Service Module Loader]
O C l assNo tFo und Excepti o n indica que falta uma dependência. Neste caso, ele não
pode buscar pela classe o rg . d o m4 j. D o cumentExcepti o n.
Encontre o nome do módulo no diretório EAP6_HOME/mo d ul es/system/l ayers/base/
procurando pelo o rg /d o m4 j/D o cumentExcepti o n. O nome do módulo é “ org.dom4j” .
Modifique o arquivo jbo ss-d epl o yment-structure. xml para adicionar a dependência
do módulo à seção de implantação do arquivo.
< module name="org.dom4j" export="true"/>
O arquivo jbo ss-d epl o yment-structure. xml deve agora parecer-se com o abaixo:
117
<deployment>

</dependencies>
</deployment>

</exclusions>

</dependencies>
</sub-deployment>
4. Problema - java.lang.ClassNotFoundException: org.hibernate.validator.InvalidValue
org.jboss.seam.servlet.SeamListener: java.lang.RuntimeException:
Could not create Component:
org.jboss.seam.international.statusMessages
org.hibernate.validator.InvalidValue from [Module
"deployment.jboss-seam-booking.ear.jboss-seam.jar:main" from
Service Module Loader]
O C l assNo tFo und Excepti o n indica que falta uma dependência. Neste caso, isto não
pode encontrar a classe o rg . hi bernate. val i d ato r. Inval i d Val ue.
Existe um módulo “ org.hibernate.validator” , mas o JAR não contém a classe
o rg . hi bernate. val i d ato r. Inval i d Val ue, portanto a adição da dependência do
módulo não resolve este problema. Neste caso, o JAR contendo a classe fazia parte da
implantação do JBoss EAP 5.1. Procure pelo JAR que contém a classe ausente no diretório
EAP5_HOME/seam/lib/. D igite o seguinte para abrí-lo:
118
$ cd EAP5_HOME/seam/lib
$ grep 'org.hibernate.validator.InvalidValue' `find . -name
'*.jar'`
O resultado apresenta:
$ Binary file ./hibernate-validator.jar matches
$ Binary file ./test/hibernate-all.jar matches
Neste caso, copie o hi bernate-val i d ato r. jar para o diretório jbo ss-seambo o ki ng . ear/l i b/
$ cp EAP5_HOME/seam/lib/hibernate-validator.jar jboss-seambooking.ear/lib
5. Problema - java.lang.InstantiationException: org.jboss.seam.jsf.SeamApplicationFactory
INFO [javax.enterprise.resource.webcontainer.jsf.config] (MSC
service thread 1-7) Unsanitized stacktrace from failed start...:
com.sun.faces.config.ConfigurationException: Factory
'javax.faces.application.ApplicationFactory' was not configured
properly.
at
com.sun.faces.config.processor.FactoryConfigProcessor.verifyFactorie
sExist(FactoryConfigProcessor.java:296) [jsf-impl-2.0.4-b09jbossorg-4.jar:2.0.4-b09-jbossorg-4]
Caused by: javax.faces.FacesException:
org.jboss.seam.jsf.SeamApplicationFactory
at
javax.faces.FactoryFinder.getImplGivenPreviousImpl(FactoryFinder.ja
va:606) [jsf-api-1.2_13.jar:1.2_13-b01-FCS]
at
com.sun.faces.config.processor.FactoryConfigProcessor.verifyFactorie
sExist(FactoryConfigProcessor.java:294) [jsf-impl-2.0.4-b09jbossorg-4.jar:2.0.4-b09-jbossorg-4]
... 11 more
Caused by: java.lang.InstantiationException:
org.jboss.seam.jsf.SeamApplicationFactory
at java.lang.Class.newInstance0(Class.java:340) [:1.6.0_25]
at java.lang.Class.newInstance(Class.java:308) [:1.6.0_25]
at
javax.faces.FactoryFinder.getImplGivenPreviousImpl(FactoryFinder.ja
va:604) [jsf-api-1.2_13.jar:1.2_13-b01-FCS]
... 16 more
119
O co m. sun. faces. co nfi g . C o nfi g urati o nExcepti o n e
java. l ang . Instanti ati o nExcepti o n indicam um problema de dependência. Neste
caso, a causa não é óbvia.
Você precisa encontrar o módulo que contém as classes co m. sun. faces. Enquanto não
há módulo co m. sun. faces, existem dois módulos co m. sun. jsf-i mpl . Uma checagem
rápida do jsf-i mpl -1. 2_13. jar no diretório 1.2 demonstra que isto contém as classes
co m. sun. faces. Assim como realizado com o
javax. faces. FacesExcepti o nC l assNo tFo und Excepti o n, você deseja usar a versão
JSF 1.2 ao invés da versão JSF 2.0 no principal, de forma que você pode especificar um e
excluir o outro. Você precisa modificar o jbo ss-d epl o yment-structure. xml para
adicionar a dependência do módulo à seção da implantação do arquivo. Você precisa
também adicioná-lo à subimplantação WAR e excluir o módulo JSF 2.0. O arquivo deve
parecer-se com o seguinte:
<deployment>

export="true"/>

</dependencies>
</deployment>

</exclusions>

</dependencies>
</sub-deployment>
6. Problema - java.lang.ClassNotFoundException: org.apache.commons.collections.ArrayStack
com.sun.faces.config.ConfigureListener: java.lang.RuntimeException:
com.sun.faces.config.ConfigurationException: CONFIGURATION FAILED!
org.apache.commons.collections.ArrayStack from [Module
"deployment.jboss-seam-booking.ear:main" from Service Module
Loader]
120
org.apache.commons.collections.ArrayStack from [Module
"deployment.jboss-seam-booking.ear:main" from Service Module
Loader]
O C l assNo tFo und Excepti o n indica que falta uma dependência. Neste caso, ele não
pode buscar a classe o rg . apache. co mmo ns. co l l ecti o ns. ArrayStack.
Encontre o nome do módulo no diretório EAP6_HOME/mo d ul es/system/l ayers/base/
procurando pelo caminho o rg /apache/co mmo ns/co l l ecti o ns. O nome do módulo é
“ org.apache.commons.collections” . Modifique o jbo ss-d epl o yment-structure. xml
para adicionar a dependência do módulo à seção de implantação do arquivo.
< module name="org.apache.commons.collections" export="true"/>
O arquivo jbo ss-d epl o yment-structure. xml deve agora parecer-se com o abaixo:
<deployment>

export="true"/>

</dependencies>
</deployment>

</exclusions>

</dependencies>
</sub-deployment>
7. Problema - Serviços com dependências indisponíveis/faltantes
121
ERROR [org.jboss.as.deployment] (DeploymentScanner-threads - 2)
{"Composite operation failed and was rolled back. Steps that
failed:" => {"Operation step-2" => {"Services with
missing/unavailable dependencies" =>
["jboss.deployment.subunit.\"jboss-seam-booking.ear\".\"jboss-seambooking.jar\".component.AuthenticatorAction.START missing [
jboss.naming.context.java.comp.jboss-seam-booking.\"jboss-seambooking.jar\".AuthenticatorAction.\"env/org.jboss.seam.example.book
ing.AuthenticatorAction/em\" ]","jboss.deployment.subunit.\"jbossseam-booking.ear\".\"jboss-seambooking.jar\".component.HotelSearchingAction.START missing [
jboss.naming.context.java.comp.jboss-seam-booking.\"jboss-seambooking.jar\".HotelSearchingAction.\"env/org.jboss.seam.example.boo
king.HotelSearchingAction/em\" ]","
"jboss.deployment.subunit.\"jboss-seam-booking.ear\".\"jboss-seambooking.jar\".component.BookingListAction.START missing [
jboss.naming.context.java.comp.jboss-seam-booking.\"jboss-seambooking.jar\".BookingListAction.\"env/org.jboss.seam.example.bookin
g.BookingListAction/em\" ]","jboss.persistenceunit.\"jboss-seambooking.ear/jboss-seam-booking.jar#bookingDatabase\" missing [
jboss.naming.context.java.bookingDatasource ]"]}}}
Quando você obter um erro “ Services with missing/unavailable dependencies” , observe o
texto entre parênteses após " falta" . Neste caso você verá:
missing [ jboss.naming.context.java.comp.jboss-seam-booking.\"jbossseambooking.jar\".AuthenticatorAction.\"env/org.jboss.seam.example.book
ing.AuthenticatorAction/em\" ]
O “ /em” indica um Gerenciador de Entidade e problema de fonte de dados.
No JBoss EAP 6, a configuração de fonte de dados foi alterada e precisa ser definida no
arquivo EAP6_HOME/stand al o ne/co nfi g urati o n/stand al o ne. xml . Uma vez que o
JBoss EAP 6 lança uma fonte de dados de amostra que já está definida no arquivo
stand al o ne. xml , modifique o arquivo persi stence. xml para uso da amostra da fonte
de dados neste aplicativo. Quando pesquisando no arquivo stand al o ne. xml , você pode
perceber que o jnd i -name para amostra da fonte de dados é
java: jbo ss/d ataso urces/Exampl eD S. Modifique o arquivo jbo ss-seambo o ki ng . jar/MET A-INF/persi stence. xml para comentar o elemento jta-d ataso urce existente e substituí-lo pelo o seguinte:
< !-- <jta-data-source>java:/bookingDatasource</jta-data-source> -->
< jta-data-source>java:jboss/datasources/ExampleDS</jta-data-source>
122
8. Nessas alturas, o aplicativo implanta sem nenhum erro, mas quando você acessa o URL
http://localhost:8080/seam-booking/ num navegador e tenta " Entrar na Conta" , você obterá
um erro do período de execução " A página não está redirecionando a propriedade" . Na
próxima etapa você aprenderá como depurar e solucionar os erros do período de execução.
Consulte a Seção 4.3.7, “ D epuração e Resolução de erros e exceções do Seam 2.2 Booking
Archive Runtime” para maiores informações sobre como depurar e resolver problemas do
período de execução.
Reportar um erro
4 .3.7. Depuração e Resolução de erros e exceções do Seam 2.2 Booking
Archive Runt ime
Na Etapa anterior, Seção 4.3.6, “ D epuração e resolução do erros e exceções do Seam 2.2 Booking
Archive D eployment” , você aprendeu como depurar os erros de implantação. Nessa etapa, você
depura e resolve cada erro do período de execução que encontrar.
Importante
Pro ced imen t o 4 .17. D ep u ração e reso lu ção d as exceçõ es e erro s d o p erío d o d e
execu ção
Neste caso, quando você implantar o aplicativo você não vê quaisquer erros no log. No entanto,
quando você acessar o URL do aplicativo, os erros aparecerão no log.
1. Problema - javax.naming.NameNotFoundException: Name 'jboss-seam-booking' not found
in context ''
Quando você acessa o URL http://localhost:8080/seam-booking/ num navegador, você
obterá uma mensagem " A página não está redirecionando a propriedade" e o log contém o
seguinte erro:
SEVERE [org.jboss.seam.jsf.SeamPhaseListener] (http--127.0.0.1-80801) swallowing exception: java.lang.IllegalStateException: Could not
start transaction
at
org.jboss.seam.jsf.SeamPhaseListener.begin(SeamPhaseListener.java:59
8) [jboss-seam.jar:]
(... log messages removed ...)
Caused by: org.jboss.seam.InstantiationException: Could not
instantiate Seam component:
org.jboss.seam.transaction.synchronizations
at org.jboss.seam.Component.newInstance(Component.java:2170)
123
[jboss-seam.jar:]
Caused by: javax.naming.NameNotFoundException: Name 'jboss-seambooking' not found in context ''
at
org.jboss.as.naming.util.NamingUtils.nameNotFoundException(NamingUt
ils.java:109)
Um NameNo tFo und Excepti o n indica um problema de nomeação JND I. As regras de
nomeação JND I foram alteradas no JBoss EAP 6, de forma que você precisa modificar os
nomes de busca para seguir as novas regras.
Para depurar isto, observe no rastreamento do log servidor antecedente ao que o JND I
binding foi usado. Você poderá observar o seguinte no log do servidor:
15:01:16,138 INFO
[org.jboss.as.ejb3.deployment.processors.EjbJndiBindingsDeploymentUn
itProcessor] (MSC service thread 1-1) JNDI bindings for session bean
named RegisterAction in deployment unit subdeployment "jboss-seambooking.jar" of deployment "jboss-seam-booking.ear" are as follows:
java:global/jboss-seam-booking/jboss-seambooking.jar/RegisterAction!org.jboss.seam.example.booking.Register
java:app/jboss-seambooking.jar/RegisterAction!org.jboss.seam.example.booking.Register
java:module/RegisterAction!org.jboss.seam.example.booking.Register
java:global/jboss-seam-booking/jboss-seambooking.jar/RegisterAction
java:app/jboss-seam-booking.jar/RegisterAction
java:module/RegisterAction
[JNDI bindings continue ...]
Existe o total de oito NFO JND I bindings listados no log, um para cada bean: RegisterAction,
BookingListAction, HotelBookingAction, AuthenticatorAction, ChangePasswordAction,
HotelSearchingAction, EjbSynchronizations, and TimerServiceD ispatcher. Você precisa
modificar o arquivo l i b/co mpo nents. xml do WAR para usar o novo JND I bindings. No
log, perceba que todos os EJB JND I bindings iniciam com " java:app/jboss-seambooking.jar" . Substitua o elemento co re: i ni t conforme o seguinte:
< !-<core:init jndi-pattern="jboss-seam-booking/#
{ejbName}/local" debug="true" distributable="false"/> -->
< core:init jndi-pattern="java:app/jboss-seam-booking.jar/#
{ejbName}" debug="true" distributable="false"/>
Em seguida, você precisa adicionar o EjbSynchronizations e TimerServiceD ispatcher JND I
bindings. Adicione os seguintes componentes ao arquivo:
124
< component class="org.jboss.seam.transaction.EjbSynchronizations"
jndi-name="java:app/jboss-seam/EjbSynchronizations"/>
< component class="org.jboss.seam.async.TimerServiceDispatcher"
jndi-name="java:app/jboss-seam/TimerServiceDispatcher"/>
O arquivo components.xml deve parecer-se com o seguinte:
< components xmlns="http://jboss.com/products/seam/components"
xmlns:core="http://jboss.com/products/seam/core"
xmlns:security="http://jboss.com/products/seam/security"
xmlns:transaction="http://jboss.com/products/seam/transaction"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation=

"http://jboss.com/products/seam/core
http://jboss.com/products/seam/core-2.2.xsd

http://jboss.com/products/seam/transaction
http://jboss.com/products/seam/transaction-2.2.xsd

http://jboss.com/products/seam/security
http://jboss.com/products/seam/security-2.2.xsd

http://jboss.com/products/seam/components
http://jboss.com/products/seam/components-2.2.xsd">

<!-- <core:init jndi-pattern="jboss-seam-booking/#

<core:init jndi-pattern="java:app/jboss-seam-booking.jar/#

<core:manager conversation-timeout="120000"

concurrent-request-timeout="500"

conversation-id-parameter="cid"/>

<transaction:ejb-transaction/>

<security:identity authenticate-method="#
{authenticator.authenticate}"/>

<component
class="org.jboss.seam.transaction.EjbSynchronizations"

jndi-name="java:app/jboss-seam/EjbSynchronizations"/>

<component class="org.jboss.seam.async.TimerServiceDispatcher"

jndi-name="java:app/jbossseam/TimerServiceDispatcher"/>
< /components>
Reimplante o aplicativo apenas excluindo o arquivo stand al o ne/d epl o yments/jbo ssseam-bo o ki ng . ear. fai l ed e criando um arquivo jbo ss-seambo o ki ng . ear. d o d epl o y vazio no mesmo diretório.
2. Problema - O aplicativo implanta e executa sem o erro. Quando você acessa o URL
http://localhost:8080/seam-booking/ num navegador e tenta o login, isto falha com a
mensagem " O Login falhou. A transação falhou." Você deve verificar um traço de exceção no
log do servidor:
13:36:04,631 WARN [org.jboss.modules] (http-/127.0.0.1:8080-1)
Failed to define class
org.jboss.seam.persistence.HibernateSessionProxy in Module
125
Service Module Loader: java.lang.LinkageError: Failed to link
org/jboss/seam/persistence/HibernateSessionProxy (Module
Service Module Loader)
....
Caused by: java.lang.LinkageError: Failed to link
org/jboss/seam/persistence/HibernateSessionProxy (Module
Service Module Loader)
...
Caused by: java.lang.NoClassDefFoundError:
org/hibernate/engine/SessionImplementor
at java.lang.ClassLoader.defineClass1(Native Method)
[rt.jar:1.7.0_45]
...
org.hibernate.engine.SessionImplementor from [Module
Service Module Loader]
...
O ClassNotFoundException indica a biblioteca Hibernate ausente. Neste caso está no
hi bernate-co re. jar.
Copie o hi bernate-co re. jar JAR a partir no diretório EAP 5_HO ME/seam/l i b/ ao
diretório jbo ss-seam-bo o ki ng . ear/l i b.
3. Problema - O aplicativo implanta e executa sem erro. Quando você acessa o URL
http://localhost:8080/seam-booking/ num navegador, você está apto a efetuar o login com
sucesso. No entanto, quando você tentar reservar um hotel, você verá um traço da exceção.
Para depurar isto, você deve primeiramente remover o jbo ss-seambo o ki ng . ear/jbo ss-seam-bo o ki ng . war/WEB-INF/l i b/jbo ss-seam-d ebug . jar
uma vez que isto mascara o erro verdadeiro. Neste caso, você deve verificar o seguinte erro:
java.lang.NoClassDefFoundError:
org/hibernate/annotations/common/reflection/ReflectionManager
O NoClassD efFoundError indica a biblioteca Hibernate ausente.
Copie o hi bernate-anno tati o ns. jar e hi bernate-co mmo ns-anno tati o ns. jar
JARs a partir do diretório EAP 5_HO ME/seam/l i b/ ao diretório jbo ss-seambo o ki ng . ear/l i b.
126
4. Os erros do período de execução e aplicativo deve ser resolvido
Neste caso, o aplicativo implanta e executa sem erro.
Reportar um erro
4 .3.8. Revisão do Sumário das Alt erações feit as quando Migrando o
Aplicat ivo Seam 2.2 Booking
Embora seja mais eficiente determinar as dependências com antecedência e adicionar as
dependências implícitas em uma única etapa, esse exercício apresenta como os problemas
aparecem no log e fornece alguma informação de como depurá-los e resolvê-los. Segue abaixo um
sumário das alterações realizadas ao aplicativo quando migrando-o ao JBoss EAP 6.
Importante
1. Você criou um arquivo jbo ss-d epl o yment-structure. xml no diretório MET A-INF/ do
EAR. Você adicionou o <d epend enci es> e <excl usi o ns> para resolver o
C l assNo tFo und Excepti o ns. Este arquivo contém os seguintes dados:
<deployment>

export="true"/>

</dependencies>
</deployment>

</exclusions>

127

</dependencies>
</sub-deployment>

2. Você copiou os seguintes JARs a partir do diretório EAP5_HOME/jbo ss-eap5. 1/seam/l i b/ ao diretório jbo ss-seam-bo o ki ng . ear/l i b/ para solucionar o
C l assNo tFo und Excepti o ns:
hibernate-core.jar
3. Você modificou o arquivo jbo ss-seam-bo o ki ng . jar/MET A-INF/persi stence. xml
conforme o seguinte.
a. Você alterou o elemento jta-d ata-so urce para uso do banco de dados da
amostra que lança o JBoss EAP 6:
< !-- <jta-data-source>java:/bookingDatasource</jta-datasource> -->
b. Você comentou a propriedade hibernate.cache.provider_class:
4. Você modificou o arquivo l i b/co mpo nents. xml do WAR para uso de novos JND I
bindings
a. Você pode substituir o elemento existente co re: i ni t conforme abaixo:
< !-- <core:init jndi-pattern="jboss-seam-booking/#
< core:init jndi-pattern="java:app/jboss-seam-booking.jar/#
b. Você adicionou elementos do componente para o " EjbSynchronizations" e
" TimerServiceD ispatcher" JND I bindings
< component
class="org.jboss.seam.transaction.EjbSynchronizations" jndiname="java:app/jboss-seam/EjbSynchronizations"/>
128
<component
class="org.jboss.seam.async.TimerServiceDispatcher" jndiname="java:app/jboss-seam/TimerServiceDispatcher"/>
Reportar um erro
129
Histórico de Revisão
R evisão 1.0.0- 2
Mo n O ct 13 2014
Built from Content Specification: 14877, Revision: 551330
130
C S B u ild er R o b o t