Casos de Uso Centrados em Dados (Primários)

Transcrição

1 B Módul Cass de Us Centrads em Dads (Primáris) A. Este é um módul prátic que traz tutriais cm passs para implementaçã de Cass de Us Padrões d jcmpany Develper Suite, incluind variações típicas (Inclusões e Extensões as Cass de Us).

2

3 6 Capítul Implementand Padrã Manter Classe 6 Implementand UC001.1 Manter UF- - Analisand a especificaçã A primeira especificaçã de Cas de Us que irems implementar está definida n diagrama da. Figura B6.1. Especificaçã para UC001.1 Manter UF-. Este diagrama simples, cm seus estereótips, é suficiente para ns dizer exatamente tud que precisams saber para cdificar este Cas de Us, cm precisã. Iss prque este é um Cas de Us Padrã definid pel jcmpany e autmatizad em grande parte tant pr generalizações presentes na arquitetura, através d jcmpany FS Framewrk, quant pr gerações de artefats via jcmpany IDE - Artifact Generatr, para a parte específica1. Imprtante: Cas vcê nã tenha realizad tutrial de criaçã de prjet d Capítul 3, faça agra, antes de iniciar este capítul. - Obtend Classes de Dmíni em Java Em tds s Cass de Us Padrões d jcmpany, smente as classes que representam Entidades de Dmíni precisam existir, cm pnt de partida para restante d desenvlviment, assistid pr rteirs Cheat-Sheets. De psse desta(s) classe(s), tds s demais artefats Java EE necessáris para a finalizaçã d Cas de Us serã gerads pr assistentes de criaçã ds plugins d módul jcmpany IDE, chamads de Pwerlgic jcmpany Cde Generatr. Prtant, tud que precisams para iniciar a cnstruçã d nss primeir Cas de Us é a btençã da classe Java Uf, pr alguma de duas frmas: Dirigid pr Mdel, através de geraçã via ferramentas CASE. Neste cas, pderiam ser utilizadas estratégias de geraçã de códig (u MDA) para btençã da classe a partir de um mdel UML cm da. Em nss cas, inclusive, seria especialmente simples se fazer ist uma vez que nsss mdels já estã n mesm plan de abstraçã das classes de cnstruçã, utilizand diretamente s nmes e tips padrões Java. Pde-se utilizar qualquer ferramenta CASE razável 1 Apesar da aparente simplicidade, mesm este Cas de Us Padrã inicial, chamad Manter Classe, escnde cmplexidades e perigs que muitas vezes passam despercebids, mesm pr um desenvlvedr sênir. Recmendams que a definiçã deste padrã seja lida, ns capítuls d Apêndice A, para uma melhr cmpreensã de tud que está envlvid.

4 Implementand Padrã "Manter Classe" para este fim, mas recmendams Enterprise Architect (EA - cm uma das melhres pções atuais em cust/benefíci. Criand-se as classes Java diretamente via Eclipse. N cas d prjetista e desenvlvedr serem a mesma pessa, u na hipótese de nã haver expertise em UML u ferramenta CASE dispnível, pde-se utilizar diálg d Eclipse para criaçã destas classes, diretamente - que farems em nss cas. Para a criaçã da classe Java crrespndente à entidade UF, residind em arquiv chamad Uf.java, devems seguir s seguintes passs: 1. Selecine prjet rhtutrial_cmuns, psicine n pacte cm.empresa.rhtutrial.entidade e acine clique-direit -> new -> Class. Figura B6.2. Diálg padrã para criaçã de Classes, n pacte padrã para Entidades de Dmíni 2. Infrme nme Uf (seguind cnvençã Java para nmes de classe), marque abstract e herde da classe pré-existente AppBaseEntity, dispnibilizada quand da criaçã d prjet, cnfrme a. Obs.: estas duas práticas sã recmendações, nã brigações, e serã explicadas mais adiante.

5 Capítul B6 Figura B6.3. Classe Uf, cm abstract marcad e superclasse AppBaseEntity (pcinal) 3. Digite as prpriedades nme e sigla cm private e tip String (cm para tdas as classes d pacte java.lang, imprt é desnecessári), cnfrme a. Figura B6.4. Classe Java crrespndente à Entidade UF, cm cmentári Javadc e práticas recmendadas. Cm dissems, a classe acima pderia ser facilmente gerada pr qualquer ferramenta CASE razável a partir de mdelagem UML. Mas repare que existem suplements na especificaçã da entidade reprduzida na : Respnsabilidades (respnsibilities); Restrições (cnstraints); Tamanhs máxims para as prpriedades. Irems discrrer sbre cm implementá-las, ns próxims tópics. Pr hra vams entender melhr a estrutura básica: n mdel UML nã herdams de AppBaseEntity. De nde, entã, tirams iss? A herança de AppBaseEntity, n nss cas, herda três prpriedades pré-mapeadas, altamente recmendadas cm padrões crprativs (embra pcinais). Em nssa hipótese, desenvlvedres sã instruíds para sempre herdarem estas prpriedades, de md que esta parte nã precise ser replicada pr tdas as especificações. Nã incluíms na especificaçã, pr questã de espaç, mas um dcument de padrões crprativs deve existir e estabelecer padrões abrangentes cm este, para pssibilitar a "especificaçã pr exceçã" (Specificatin by Exceptin). E que prpriedades sã estas?

6 Implementand Padrã "Manter Classe" versa: Pré-mapeada e cm nme de cluna crrespndente VERSAO, esta prpriedade implementa padrã JPA para tratament de cncrrência timista. Cm este tratament, quand qualquer alteraçã é realizada ns bjets, própri JPA incrementa um cntadr de versões nesta prpriedade, e passa a utilizá-l na where cnditin, para tds s cmands SQL de Update e Delete gerads. Deste md, se dis usuáris estã alterand mesm registr simultaneamente, há garantia de que um nã irá sbrepr atualizaçã de utr, cas segund nã esteja cm a versã atualizada ds dads recuperads. Esta é uma técnica altamente recmendada que, se nã usada, implica em sluções alternativas bem pires, tais cm: 1. Us de cncrrência pessimista (lcks n SGBD durante a atualizaçã pr um usuári), alg em desus e que penaliza dramaticamente a perfrmance (mesm cm estratégias de trava em nível de registrs ds SGBDs atuais); 2. Implementaçã manual de técnica similar, pels desenvlvedres. A nã usarem esta autmaçã, desenvlvedres deverã cdificar este teste nas cndições where de seus updates e deletes e em tdas elas, para evitar prblemas de cncrrência; 3. Em nssa experiência, quand nã se usa cntrle de versa d JPA (já existente há ans n Hibernate), na prática s desenvlvedres ignram este prblema e deixam ir para prduçã aplicações sem tratament de cncrrência. Ist é cnhecid cm anti-padrã last cmmit wins (a última mdificaçã sbrepõe anterires, mesm que usuári crrente ignre uma mdificaçã recente ns dads). Em sistemas de missã crítica, cm alt índice de cncrrência, este cenári ferece grande risc, e deve ser tratad. dataultalteraca e usuariultalteraca: Estas prpriedades implementam que é chamad n jcmpany de auditria pauta mínima. Seus valres sã atualizads pel jcmpany para guardar lgin d usuári que realizu a última alteraçã n bjet (registr n SGBD) e também a data/hra desta mdificaçã. Elas se prestam para eventuais averiguações de segurança (auditrias) para rastrear usuáris que intrduzem infrmações prejudiciais à empresa, pr má fé u inadvertidamente. Apesar de smente manter últim usuári, cstuma ser pssível se encntrar históric de mdificações cm a análise de lgs ds SGBDs. É um tip de auditria mais leve que a criaçã de classes espelh, cnhecidas n jcmpany cm auditria rígida. Estas últimas sã utilizadas para classes de mair relevância e/u que precisem de auditrias mais frequentes. Já a respnsabilidade exibe é um mecanism padrã de especificaçã sugerid pel jcmpany, através d qual prjetista indica qual(is) prpriedade(s) ele deseja utilizar para representar bjets da Entidade quand aparecerem pels frmuláris da aplicaçã (Ex.: cmbs, radis, vinculads, u títuls). A especificaçã Java prevê um métd padrã para esta finalidade chamad tstring (manifestaçã em frmat String, d bjet), utilizad pel jcmpany para este fim (chamams a este métd, também, de lkup d bjet). Prtant, a especificaçã exibe ns define que implementar métd tstring de cada Entidade, aprpriadamente. - Entendend as Restrições Invariáveis (Invariant Cnstraints) As restrições u validações invariáveis (invariant cnstraints) sã restrições que devem sempre ser atendidas antes da criaçã u alteraçã definitiva, de uma agregaçã de bjets. Elas se cntrapõem às validações variáveis, que variam em cnfrmidade cm cada Cas de Us. O melhr lcal para se especificar e implementar restrições invariáveis, prtant, é n Mdel de Classes (de Dmíni), muit embra muits façam em especificações de Cas de Us u em definições de frmulári. Verems que jcmpany suprta a implementaçã de validações invariáveis via prgramaçã declarativa através de antações que pdem ser adicinadas cm cmplement a prcess de mapeament Objet-Relacinal. A dispensarms a prgramaçã prcedimental neste nível, maximizams reús e evitams perda de qualidade e prdutividade. Verems ainda que s cmpnentes Apache Trinidad (JSF) u Tag-Files (Struts) d jcmpany cnseguem herdar as declarações de restrições invariáveis das Entidades de Dmíni, deste md

7 Capítul B6 executand validações em frmuláris sem que seja necessári redundá-las pr tdas as camadas nde precisam ser verificadas. Evitand, pr exempl, redundância de verificaçã em classes de cntrle u em utr framewrk, cm Apache Validatr! - Gerand Mapeament para Classes de Lkup/Tabular - Objet-Relacinal I O próxim pass para nssa implementaçã é gerar uma primeira versã d mapeament ObjetRelacinal para nssa Entidade Uf. Para tant, irems utilizar plugin aprpriad d Pwerlgic jcmpany Cde Generatr, de númer 01, acessível a partir da tecla de atalh cntrl+n, tend-se a classe alv editada. 4. Acine cntrl+n para que diálg de assistentes padrões d Eclipse se abra cm uma relaçã de categrias. 5. Abaix da categria Pwerlgic jcmpany Cde Generatr encntram-se diverss assistentes que utilizarems a lng ds tutriais. Acine primeir 01 Mapeament Objet-Relacinal. Figura B6.5. Acinand cntrl+n sbre a classe Uf, e assistente para Mapeament Objet-Relacinal. 6. A primeira página d Assistente prvê tdas as infrmações essenciais que irems utilizar neste mment, nã smente para realizar mapeament Objet-Relacinal em si, mas também para prduzir uma versã recmendada para Entidades que cnsidere Padrões de Prjet e timizações pssíveis. A mstra diálg e suas principais seções sã descritas a seguir: Figura B6.6. Primeir pass d Assistente de Criaçã de Mapeament Objet-Relacinal.

8 Implementand Padrã "Manter Classe" #1. A primeira marcaçã Gerar Entidades descendentes se nã existirem faz cm que geradr prduza uma nva classe cm nme padrã <Entidade>Entity u utilizand sufix padrã para entidades definível n framewrk via antações. Ex: Para Uf.java, será prduzida uma classe adicinal UfEntity.java, cncreta e descendente de Uf.java. O default é utilizar este Padrã de Prjet, que ns ajudará a manter a parte abstrata da classe cm infrmações de dmíni separadas de códigs de implementaçã tais cm hashcde, equals, tstring u utrs que se façam necessáris. #2. A marcaçã Gerar mapeament ns métds indica para que mapeaments n padrã JPA sejam gerads em métds getters, e nã sbre as prpriedades. Este últim é default, pr ser mais legível. #3. A pçã EJB x POJO é reservada para us futur. Espera-se que crram diferenças n futur entre antações de POJOs simples e EJBs. Atualmente, n entant, nã há diferenças, a mens em nível das Entidades (u seja, entre EJB Entity Bean 3.0 x POJO persistids via JPA). #4. A marcaçã de Versã indica para plugin gerar uma prpriedade adicinal na classe declarada cm private Lng versa e cm mapeament Cm ist, pde-se reutilizar tratament de cncrrência timista padrã d JPA. Cm nssa classe herda de AppBaseEntity, default deste camp é assumid para nã gerar. #5. A marcaçã Auditria indica para plugin gerar as prpriedades private String usuariultalteraca e private java.util.date dataultalteraca, nmes padrões e reservads n jcmpany, utilizads pel framewrk para manter lgin d usuári que prduziu a última mdificaçã em um bjet (registr n SGBD) e a data/hra desta mdificaçã. Obs.: Neste e n cas anterir, jcmpany supõe que estes tips de atributs sã herdads (reutilizads) a perceber a herança de AppBaseEntity. Cm iss, altera default para evitar gerá-ls nvamente. #6. A marcaçã Infrmações Adicinais faz cm que uma segunda janela d Assistente seja apresentada cm infrmações adicinais que pssibilitam a geraçã de utras antações d jcmpany. Se desmarcarms esta pçã, btã de Next irá sumir. Deixe-a marcada, apenas para cnhecer a segunda janela. Nã irems, prém, alterar s seus valres padrões, para nss cas específic. #7. A lista em Estereótip traz algumas classificações de relacinaments e natureza de Entidades, segund padrões de Arquitetura d framewrk, que auxiliam na definiçã de bns mapeaments. N cas de Uf, deve-se selecinar estereótip tabular, mas desenvlvedr nã perceberá diferenças funcinais se nã fizer esta pçã. Esta marcaçã irá levar à geraçã de uma antaçã a mais na que será utilizada para timizações2. #8. O camp Classe traz a classe para mapeament em si. Cas tenha-se utilizad cntrl+n cm a classe selecinada, ela já virá preenchida neste camp. Cas tenha-se entrad pr utr caminh, deve-se selecinar uma classe de Entidade para mapeament. #9. N camp Tabela jcmpany gera uma prpsta para nme da Tabela relacinal (Table) d SGBD, basicamente clcand nmes em maiúsculas e utilizand sublinhads cm separadres. Pde-se mdificar nme e deve-se fazê-l para cincidir cm nmes de tabelas existentes, se fr cas. #10. A lista Identificadr traz diferentes estratégias para identificaçã de bjets, send OIDAut a preferível. Neste cas, framewrk irá gerar mapeament para us d padrã recmendad Object-ID cuja identificaçã é realizada via a prpriedade padrã private Lng id, cm valres gerads autmaticamente pel SGBD-R3. 2 Em linhas gerais: jcmpany irá utilizar algumas antações cm esta para realizar interceptações em implementações JPA baseadas n Hibernate, via Hibernate Listener, prcurand interceptar e evitar recuperações autmáticas a este tip de classe, já que sã mantidas em caching na camada de Cntrle.

9 Capítul B6 #11. O camp Sequence permite que se infrme nme para criaçã de uma estrutura de Sequence utilizada em alguns SGBDs relacinais, tais cm Oracle, para geraçã de valres de identificaçã. O Padrã d jcmpany é utilizar um Sequence pr Tabela e cm nme SE_<nme tabela>. Nvamente pde-se mdificar nme para cincidir cm Sequences existentes u para se mudar esta estratégia (Ex.: um únic sequence para várias tabelas). Para SGBDs que nã usem cnceit de Sequence, este camp é desprezad. #12. O camp Prpriedade smente é utilizad para gerações de chave natural, que nã estã n escp deste livr. #13. O camp CASE permite que se infrme DataSurce ODBC-JDBC para cnexã cm repsitóri d CASE Enterprise Architect, que permite recuperaçã de dads de tamanh e nulidade de prpriedades. #14. A cluna Prpriedade traz prpriedades da classe candidatas a serem persistidas, cm exceçã das prpriedades transientes (transient). #15. A cluna Estereótip define classificações de mapeaments típics utilizads n jcmpany. Deve-se reparar que, tal cm ns estereótips em nível da Classe, nã há intençã aqui de se esgtar s tips pssíveis de mapeament JPA, mas apenas de apresentar aqueles estereótips que sã distinguids pels padrões de arquitetura d framewrk. Pdem-se alterar mapeaments para utrs tips utilizand plugins cm s d prjet Dali e/u fazend ediçã simples das antações geradas, se precis fr, para cenáris diferenciads. #16. A cluna Cluna apresenta nmes sugerids para as prpriedades das classes que, tal cm n cas da Tabela, pdem ser mdificads e deverã ser cas estejams acessand uma base já existente. #17. A cluna Obrigatóri permite que se marque se a Cluna gerada na Tabela relacinal será gerada cm NOT NULL (Obrigatóri = Sim) u NULL (Obrigatóri = Nã). #18. A cluna Lkup permite que se selecine uma u mais clunas para cmprem a cláusula d métd padrã tstring, que será gerad pel jcmpany cncatenand-se estas clunas na rdem em que aparecem (pde depis ser editad, cm desejad). O jcmpany marca cm padrã a primeira cluna d tip String que encntrar. Cm pedid na especificaçã, usarems nme e sigla e, prtant, devems marcar ambas. #19. A cluna Classe é utilizada em relacinaments manytone, netmany e variações, cntend nme da classe referenciada pr prpriedades u cleções. Nrmalmente ele nã precisa ser infrmad, send autmaticamente preenchid pel jcmpany. #20. A cluna Tabela FK exibe um nme que será utilizad durante a geraçã de DDL autmatizada d jcmpany, especificamente para nmear Chaves Estrangeiras (Freign Keys) quand mapeand relacinaments. O JPA assume um nme cm base em hashcde intern, mas é recmendável que se infrme um nme legível n padrã exigid pel DBA. #21. A cluna Tip SGBD exibe tip que será utilizad para a geraçã da DDL (Data Definitin Language), códig que define tabelas para um SGBD relacinal. Nrmalmente nã deve ser editad já que s tips assumids sã adequads. #22. A cluna Tamanh exige que se definam s tamanhs limite (tamanh máxim) de cada cluna, cnfrme exigid pel esquema relacinal. Para tamanhs cm decimais deve ser utilizad frmat [inteir],[decimais] (Ex.: 11,2 para nze casas n ttal e duas casas decimais). N nss exempl inicial, nme terá 40 caracteres e sigla terá 2, cnfrme vems n mdel da. 3 As demais estratégias de identificaçã, cm chave cmpsta (natural), nã serã abrdadas neste livr, mas smente n Vlume II Tópics Avançads desta série. Cnsulte também a dcumentaçã d prdut na Ajuda On-Line para api em mapeament de chaves naturais.

10 Implementand Padrã "Manter Classe" 7. Após preencher tds s camps cnfrme exempl da, vá para próxim pass, cm Next, e cnclua Assistente sem mdificar nenhuma infrmaçã. Após a cnclusã, jcmpany irá gerar a classe UfEntity (cncreta) descendente de Uf (abstrata), cnfrme pedims, e cmplementar ambas cm diversas antações, métds getters e setters (padrões da especificaçã JavaBean), dentre utrs. Se realizarms uma engenharia reversa (sincrnizaçã) das classes Java btidas para a ferramenta CASE após esta geraçã, veríams que Mdel de Classes btid ficaria cm da Figura B6.74. Figura B6.7. Organizaçã Final d Mdel de Entidades. Imprtante 1: A classe AppBaseEntity em si é apenas um Bridge (intermediári) simples, que permite desacplament diret cm framewrk d jcmpany. A classe PlcBaseMapEntity é quem pssui atributs versa, dataultalteraca e usuariultalteraca. Ela pr sua vez herda de PlcBaseVO, que encapsula trataments genéricas para Object-Id (prpriedade id), bem cm para s métds padrões equals e hashcde. Tds estes sã recmendads pel JPA e pnts de falha cmuns quand prgramads de frma específica. Imprtante 2: Dit iss, mesm assim é pssível nã usar herança na entidade e slucinar este prblema através de geraçã de códig. Basta prjetista u desenvlvedr nã especificarem a herança que s plugins de geraçã de mapeament bjet-relacinal d jcmpany autmaticamente passam a sugerir a geraçã cmplementar das prpriedades supra-citadas (além de utras específicas cnfrme a necessidade em cada padrã). Usarems herança neste livr, mas exempl "rhdemfcls" que utilizams n capítul 3 traz entidades similares, sem us de herança e cm atributs de versã e auditria replicads na própria entidade. 8. Vams agra entender s detalhes d que fi gerad em cada uma das duas classes, Uf e UfEntity, exibidas respectivamente na Figura B6.8 e Figura B Dica: A cntrári d que fizems, para explanaçã, é recmendad que prjetista evite manter s níveis cncrets (UfEntity) e d framewrk (PlcBaseMapEntity) em seus diagramas, deste md mantend-se n seu fc, abstrat.

11 Capítul B6 Figura B6.8. Classe de Dmíni Uf, após geraçã de Mapeament Objet-Relacinal cm Plugin jcmpany. #1. Tdas as antações padrã JPA sã geradas. A antaçã de herança é gerada uma vez que a declaraçã de fica n nível descendente. #2. A antaçã PlcValidacaUnificada faz cm que jcmpany herde, em cmpnentes JSF que referenciam esta entidade, as suas declarações de "Nt Null, Length e utras d JPA", assumind defaults sem necessidade de redundar estas infrmações em cada cmpnente. Além diss, faz cm que tds s métds que retrnam "blean" e pssuem nmes iniciads cm "validaxxxxx" sejam disparads em cmplement às validações declarativas d Bean Validatin. #3. A prpriedade que implementa Object-Id id cm mapeaments crrespndentes é gerada. Nta: jcmpany faz manipulações de entidades utilizand métd getid, para Object-ID, u getidnatural, para chaves naturais. É, prtant, um us padrã. Cas se pte pr alterar nme da prpriedade para utr que nã id, deve-se prver getters e setters auxiliares, de adaptaçã 5. #4. As antações para mapeament de cada prpriedade sã geradas, também segund padrã JPA d Java EE 5, utilizand s critéris de tamanh e brigatriedade infrmads. #5. Finalmente, s getters e setters padrões da especificaçã JavaBean sã gerads para cada prpriedade. 5 O Object-Id u OID é um identificadr numéric intern e aut-gerad pel SGBD, mapead cm a Primary-Key n SGBD, implementa cnceit de chave fictícia u substituta, que é a estratégia de identificaçã mais recmendada pels DBAs mderns, d pnt de vista relacinal (evita infrmações na chave e sua redundância, precavend cntra prblemas graves tais cm n cas d An 2000). Além diss, esta estratégia é também essencial para uma implementaçã OO mais pura e prdutiva, advinda da generalizaçã da identificaçã de bjets cm diversas vantagens que serã discutidas n Vlume II deste livr.

12 Implementand Padrã "Manter Classe" Figura B6.9. Classe descendente UfEntity gerada para separar implementações d Desenvlvedr das infrmações de Dmíni. #1. Estas antações iniciadas cm prefix reservad SPlc (Pwerlgic Steretypes) sã d jcmpany e definem um estereótip padrã CDI (smente jcmpany 6.0.x). O estereótip "carimba" a classe cm uma "Entidade" para ativaçã de lógicas genéricas d jcmpany durante prcediments de IC/DI. #2. As antações que definem um Entity Bean n JPA, bem cm tabela de mapeament, sã geradas. #3. O AcessType é antaçã JPA, para indicar que antações estã nas prpriedades (field) e nã em métds. #4. Estas antações iniciadas cm prefix reservad Plc (Pwerlgic) sã d jcmpany e utilizadas para lógicas de timizaçã via especializações de Listeners. Em resum, pdem evitar a prduçã de queries desnecessárias para estas classes, já que sã mantidas em caching na camada Cntrle pel jcmpany. #5. As NamedQueries sã um recurs altamente recmendad pel JPA e utilizad pel jcmpany para maximizar s benefícis da prgramaçã declarativa. A NamedQuery cm nme padrã [Entidade].querySelLkup é utilizada pel jcmpany para recuperar bjets referenciads e traz unicamente as prpriedades de identificaçã e marcadas cm lkup (presentes também n tstring). Deste md, jcmpany evita recuperações perigsas e dispensa prgramaçã manual para preenchiment de frmuláris e suas referências6. #6. A Classe cncreta UfEntity sempre herda prpriedades e métds de dmíni de Uf e, deste md, separa prgramações de baix nível das prgramações de dmíni7. 6 As NamedQueries, assim cm mapeament em si, ficam nas Entidades de Dmíni, mas smente sã utilizadas pela camada de Persistência (DAO).

13 Capítul B6 #7. Um cnstrutr é gerad para cada NamedQuery padrã, de md a viabilizar a recuperaçã timizada smente das prpriedades necessárias. Deste md, evita-se risc de recuperações de grafs de bjets maires que s necessáris e também aprimra-se padrã de prgramaçã (para mais detalhes, verems exempls n capítul 17 sbre prgramaçã de regras de negóci). #8. Métd padrã Java tstring é gerad autmaticamente, utilizand-se as duas prpriedades de lkup marcadas e cm separaçã pr hífen. Este métd é utilizad pel jcmpany para expsiçã de valres da classe em bjets gráfics tais cm cmbs e radi, bem cm títuls dinâmics de páginas, em alguns Cass de Us Padrões que nã editem cleções, mas uma agregaçã de bjets pr vez. O desenvlvedr pde alterá-l para a frmataçã desejada. 9. Para finalizar, jcmpany também gera uma entrada da Entidade n arquiv "persistence.xml" (se fr us de JPA, nss cas) u hibernate.cfg.xml (Se fr us diret de Hibernate). Figura B6.10. Arquiv persistence.xml u hibernate.cfg.xml, acrescid da Entidade recém-mapeada. Fazend uma revisã de tud que gerams, pdems listar: Mapeament Objet-Relacinal em si, incluind um subcnjunt principal de pções JPA autmatizad pel framewrk. Mapeaments mais específics e rars pdem ser feits, sem prblemas, pssivelmente exigind uma u utra custmizaçã via códig prcedimental, mas 95% d esfrç de mapeament, segund nssa experiência prática, estarã reslvids e atendids pel segment padrã suprtad. Classe descendente para segmentaçã prjet/implementaçã, pcinal, prém altamente recmendada cm DP para simplificaçã e islament de regras de negóci e implementações de dmíni em geral. Antações específicas d jcmpany para us em timizações diversas, tais cm recuperações eficientes de referências (especialmente imprtantes para Cas de Us Padrã Manter Classe, que se cnstitui em grande parte de grups de bjets classificadres). 7 Métd tstring para exibiçã da classe em cmpnentes visuais e títuls de frmuláris. O interessante é que esta separaçã, apesar de nítida, é realizada n mesm plan de abstraçã. Ou seja, é um tip de separaçã de cnceits mais OO, que dispensa transfrmações de mdel em váris plans de abstraçã é um tip de separaçã de cnceits que tende a se preservar cm mair eficácia a lng d temp.

14 Implementand Padrã "Manter Classe" Getters e Setters para prpriedades, imprtações, e utras antações de menr imprtância, tal Registr n arquiv persistence.xml. Pr tud iss, percebems que plugin d Pwerlgic jcmpany Cde Generatr vai além da tarefa básica de geraçã de Mapeament Objet-Relacinal em si, prduzind na verdade uma primeira versã bastante aprimrada para implementaçã de Entidades de Dmíni que segue melhres práticas precnizadas pel jcmpany Patterns & Methds e autmatizadas em parte pel jcmpany FS Framewrk. É que chamams de plugins de prcess. Este tip de plugin fi discutid n capítul 3, e é vltad apenas para a criaçã de uma primeira versã da sluçã, de frma a evitar errs grsseirs. Na sequência, se frem necessáris ajustes e alterações quaisquer das antações prduzidas, deve-se utilizar plugins de ediçã cnvencinal d Eclipse, hmlgads e dispnibilizads n jcmpany para este fim. Imprtante 1: Apesar de nã ser utilizad para manutenções, cas desenvlvedr julgue cnveniente, pde disparar um desfaz (und), retrnand a classe a seu estad riginal e refazend a criaçã de uma nva primeira versã. O desfaz pde ser disparad n atalh exibid na Figura B6.11. Figura B6.11. Opçã de desfazer geraçã de mapeament Objet-Relacinal. Uma lista de mdificações a serem realizadas é apresentada antes da peraçã. Imprtante 2: O jcmpany irá desfazer últim prcediment executad. Para se desfazer perações antigas, deve-se editar s artefats envlvids e realizar ajustes manualmente. - Implementand Validações Invariáveis de Dmíni Validaçã de Entrada I Antes de implementarms nss Cas de Us em si, devems ainda cmplementar nssa Entidade cm antações de validações invariáveis, para garantir as restrições especificadas pel prjetista. O jcmpany implementa padrã Bean Validatin através d reús d framewrk Hibernate Validatr e faz um implementaçã adicinal interessante de herança de validações em cmpnentes de Tag-Files (Struts) u JSF. Nesta implementaçã, estes cmpnentes herdam s metadads das Entidade de Dmíni (desde que antadas cm PlcValidacaUnificada) e assim realizam, em uma única passada, uma validaçã cmpleta em frmuláris incluind tant as validações variáveis (intrínsecas a frmulári u Cas de Us específic) quant invariáveis (intrínsecas às Entidades u Mdel de Dmíni). Para garantir, pr exempl, que sigla tenha tamanh de n mínim duas psições, que é independente de qualquer Cas de Us, irems utilizar validações de entrada de dads invariáveis. 10. Para tant, edite a prpriedade sigla e sbre ela. Em seguida, digite cntrl+space. Uma lista de pções de validações declarativas d jcmpany aparecem. cnfrme a Figura B6.12.

15 Capítul B6 Figura B6.12. Validações via Antações d jcmpany (a antaçã está deslcada para exibir a prpriedade). Cada validaçã é exibida cm sua dcumentaçã javadc, que facilita a rápida inspeçã. 11. Após selecinar a validaçã desejada, cnheça as suas pções de declaraçã (prpriedades da antaçã) pressinand a tecla shift e sbrepnd muse sbre a antaçã, cnfrme a Figura B6.13. Figura B6.13. Apertar shift cm cursr d muse sbre a Antaçã exibe suas prpriedades. Veja que é pssível utilizar a prpriedade tam para indicar tamanh exat que desejams. 12. Infrme tam=2 para encerrar trabalh. 13. Em seguida, prcure pela que irems utilizar para garantir que s valres infrmads serã em letras maiúsculas. Esta segunda antaçã fica de exercíci para leitr, que deverá entã bter resultad exibid na Figura B6.14. Repare que usams uma Enumeraçã FrmatSimples definida dentr da Figura B6.14. Validações invariáveis declaradas para a prpriedade sigla. Até aqui reslverms a restriçã Siglas devem ser alfanuméricas e maiúsculas e também a restriçã de tamanh mínim de 2 para sigla (além de 1 para nme, implicitamente, já que é nullable=false). Estas sã validações sã em nível de prpriedade. Mas e quant às validações de duplicidade para nme e sigla? Elas sã validações que cnsiderams em nível de classe, já que devem percrrer váris bjets da classe para serem averiguadas. Cm irems reslvê-las? N cas da prpriedade nme, jcmpany já irá cuidar para que nã tenha valres duplicads, graças à nme ). Esta antaçã define uma prpriedade cm padrã para desprez de bjets. Neste cas, se nme nã fr infrmad, s demais valres d bjet serã desprezads e ele nã será persistid8. Cm aprimrament prátic, 8 Esta antaçã de metadads é também herdada pr cmpnentes visuais de frmulári que usam a mesma prpriedade cm um flag para facilitar descarte de linhas nã preenchidas. Em suma, para nss cas: se usuári nã preencher nme em uma instância (linha de frmulári crrespndente), cmpnentes de validaçã irã desprezar esta

16 Implementand Padrã "Manter Classe" esta também assume um teste de duplicata, já que tipicamente esta prpriedade de referência cstuma ser também um identificadr natural d bjet e nã aceitar duplicada (Este default pde ser alterad, mas nã é nss cas). Na Figura B6.15 explicitams a prpriedade e também indicadr para teste de duplicata. Figura B6.15. Antaçã PlcTabular cm prpriedade "nme" e teste de duplicata explícit (apesar de ser default) E quant à duplicidade de sigla? Neste cas, ultrapassams limite d que cnseguims fazer via prgramaçã declarativa, n escp de um bjet de dmíni. Vams utilizar este exempl para realizar uma prgramaçã invariável de camada Mdel, em capítuls de prgramaçã d Módul E. Pr hra, cnhecems esquema de validaçã invariável d jcmpany, basead em especializaçã d Bean Validatin. Uma lista cmpleta das validações invariáveis dispníveis será dispnibilizada a lng ds próxims tutriais, além de várias práticas de validaçã variável que pdem exigir prgramaçã específica para Cas de Us, persnalizaçã de mensagens, dentre utras intervenções. - Entendend a Orquestraçã via Cheat-Sheets (Flhas de Apntaments) Cm nss Mdel de Dmíni (Mdel de Classes para Entidades d Negóci) cmplet, mapead e decrad cm antações de validações e timizações, estams prnts para iniciar a cnstruçã de nss primeir Cas de Us Padrã. Prsseguir para prgramações de Cas de Us antes de estarms certs de explrar td ptencial de mdelagem OO, mapeament Objet-Relacinal e prgramaçã declarativa é um err que cbra seu preç na frma de queda de qualidade e prdutividade. Uma vez que estams certs de ter esgtad ptencial de sluçã n nível da Entidade, passarems a cntar cm um nv aliad para a cnfecçã d Cas de Us em si: s Cheat-Sheets u Flhas de Apntaments. Este recurs é utilizad pel jcmpany para prver rteirs que cnduzem desenvlvedr d iníci até fim da implementaçã de um Cas de Us Padrã, utilizand arquitetura MVC2-P. Neste cenári, s Cheat-Sheet sã utilizads cm rquestradres d prcess de cnstruçã, guiand desenvlvedr pr passs e plugins aprpriads em cada um deles. Tipicamente, um rteir em Cheat-Sheet d jcmpany irá seguir a seguinte estrutura: Pass 1: Apresentar Cas de Us Padrã brevemente, cm hiperlinks para definiçã mais extensa na dcumentaçã. Pass 2: Chamar um plugin de prcess específic d jcmpany, que irá criar uma primeira versã gerand tds s artefats nã-java (JSPs, XHTML, XML, Prperties, etc.) envlvids. Lembre-se que classes Java sã generalizadas. O jcmpany nã gera códig Java prcedimental, que preserva a prdutividade durante as manutenções! Passs 3, 4, 5 e 6: Em cada um destes passs, jcmpany abrirá s artefats gerads u alterads pela geraçã n pass 2, para as camadas MVC-P, respectivamente Visã, linha (Lembre-se: nã há acplament cm a herança de metadads e a camada de Dmíni é rtgnal, visível pr tdas as camadas d MVC. Em restand dúvidas, retrne a capítul IV d módul A).

17 Capítul B6 Cntrle, Mdel e Persistência. Cada pass abre artefat através de um plugin de ediçã hmlgad para este fim. Pass 7: O jcmpany dispara a cnstruçã e liberaçã d arquiv WAR via Maven, utilizand a liberaçã cmpleta na primeira chamada (alguns minuts) e a liberaçã rápida cm reinicializaçã nas subsequentes (alguns segunds). Vams acinar nss primeir rteir. 14. Acesse menu Help -> Cheat-Sheets.... Um diálg cm várias categrias de Cheat-Sheets aparecerá. 15. Selecine jcmpany e, dentr da categria, rteir Cas de Us Manter Classe. Figura B6.16. Relaçã de pções de rteirs d jcmpany, cm seleçã d Manter Classe. 16. Se primeir pass estiver fechad, deve-se clicar para expandi-l O primeir pass traz uma breve intrduçã e permite, cm clique n btã de ajuda, que se recupere a dcumentaçã cmpleta para padrã a ser desenvlvid, cnfrme destacad na Figura B6.17. Figura B6.17. Primeir pass d Cheat-Sheet cm destaque para btã de ajuda. 9 É pssível que um Cheat-Sheet abra cm pass inicial expandid, dependend d estad em que a última utilizaçã deixu rteir. O Eclipse prcura manter últim estad d Cheat-Sheet.

18 Implementand Padrã "Manter Classe" - Gerand Artefats Nã-Java Geraçã de Artefats I N segund pass, rteir irá acinar um plugin de prcess d jcmpany trazend um Assistente de Criaçã para Cas de Us Padrã cm diversas pções que irã resultar na geraçã, principalmente, de artefats nã Java envlvids, tais cm nvs arquivs XHTML e nvs registrs em XML. Pr questões didáticas, neste capítul vams apenas intrduzir cada janela deste assistente, explrand mais a fund smente infrmações que precisarems para nss Cas de Us atual. Em Cass de Us psterires, irems explicar diversas pções adicinais d Assistente de Criaçã, bem cm entender mais a fund que ele prduz. 18. A primeira página d Assistente é apresentada na cm preenchiment sugerid para nss Cas de Us UC001.1 Manter UF- e explicações sbre us de cada camp. Figura B6.18. Pass Inicial d Assistente de Criaçã para Manter Classe. #1. Opçã entre tecnlgia de Cntrle Struts u JSF: O jcmpany investiga prjet para assumir um padrã aprpriad, mas cm é pssível se cmpatibilizar as duas tecnlgias em Cass de Us diferentes, cm alguma prgramaçã adicinal, é dada a prtunidade para que desenvlvedr altere este padrã. #2. Opçã entre a tecnlgia de Visã entre JSP/Tiles e Facelets: O jcmpany dispnibiliza essas duas tecnlgias para a camada de visã. Para nss exempl, utilizarems a tecnlgia Facelets. #3. Opçã entre a tecnlgia de Mdel (Serviçs) entre POJO e EJB: Nã gera diferenças, send reservada para diferenciações futuras. #4. Prjet: Pde-se alterar prjet crrente (assumid pr default) para a geraçã em móduls, pr exempl. #5. Identificadr d Cas de Us (URL): É um text que será utilizad cm prefix pel jcmpany para a geraçã da URL, nme base de JSPs, XHTML, etc., seguind cnvenções de nmenclatura da Arquitetura. Para nss exempl, utilizarems uf, que irá gerar uma URL /uf e XHTML uftab.xhtml.

19 Capítul B6 #6. Entidade: Este camp permite que se selecine a Entidade raiz da Agregaçã envlvida, cujas prpriedades serã utilizadas cm base para a prpsta de um frmulári e cujas instâncias serã persistidas, segund a arquitetura MVC. Deve-se selecinar uma classe cncreta, n nss cas UfEntity. #7. Nme d pacte: Assumid. Nesta versã, nã deve ser mdificad. #8. Classe de Cntrle: Nme de Classe de Cntrle, cas se preveja a necessidade de implementaçã de prgramações nesta camada para Cas de Us. N nss cas, a única prgramaçã necessária é para a validaçã de duplicidade de siglas e irems preferir realizá-la a partir de events da camada Mdel para melhr reús. Farems utras regras para camada Cntrle mais adiante. Prtant, deve-se deixar padrã AppActin. #9. Classe de Mdel: Nme de Classe de Mdel (Serviç), cas se preveja a necessidade de implementaçã de prgramações nesta camada para Cas de Us. N nss cas, preferims fazer a prgramaçã de validaçã de duplicidade de siglas a partir de events da camada Mdel e, prtant, pdems pedir para que assistente crie uma classe cm nme padrã UfManager (Um Sessin Bean candidat!). Obs. 1: O jcmpany irá criar smente a estrutura básica destas classes (declaraçã) n prjet/pacte padrã. Cm já vims, jcmpany nã gera códigs Java prcedimentais, mas trabalha cm generalizações OO e prgramaçã declarativa para reutilizá-ls. Obs. 2: Os sufixs padrões para classes de Cntrle (Actin) e serviç de Mdel (Manager) sã definids em metadads via antações e pdem ser custmizads cm verems mais a frente. #10. Subdiretóri: É altamente recmendad que se defina um subdiretóri, preferencialmente cm mesm nme d identificadr d Cas de Us, para que jcmpany gere XHTMLs agrupadas abaix d mesm. Assim, infrmand-se uf em nss exempl, XHTML serã geradas abaix de /WEB-INF/fcls/uf. #11. Permissã de Acess: (Smente Struts) Pde-se infrmar nme de rles (Atres) que pderã acessar este Cas de Us, restringind este acess. Estas rles, que pdem ser várias, separadas pr vírgulas, serã geradas n Actin-Mapping d arquiv strutscnfig.xml, segund padrã Struts. O faces-cnfig.xml nã traz similar para JSF, prtant este prblema deve ser reslvid cm declarações padrões Java EE n web.xml u via prdut jcmpany Security, quand utilizand-se esta tecnlgia (nss cas). #12. Permissã de Manutençã: Neste cas, pde-se declarar rles (Atres), inclusive várias delas, separadas pr vírgula, que pderã acessar Cas de Us (URLs de implementaçã) cm privilégi de inclusã, alteraçã u exclusã. As demais cntinuam tend acess, smente de cnsulta. Esta é uma implementaçã específica de segurança realizada pel própri jcmpany. N nss cas, infrme Administradr para permitir smente cnsulta para utras rles, excet esta. 19. Após preencher tds s camps cm indicad na, irems apertar btã Next para seguir para a página (segunda página d Assistente), nde preencherems smente títul, cm UF em maiúscul. Títul: Títul a ser utilizad n Frmulári e Item de Menu que serã gerads. Usar UF, Manter UF u Gerir UF, cnfrme desejad. Cm recmendaçã geral, us de plural deve ser evitad (afinal, tds s títuls seriam plurais). Pr hra, nã explicarems as diversas pções desta segunda página, que verems em detalhe ns próxims capítuls. 20. Após infrmar títul, clique nvamente em Next para seguirms para a terceira página d Assistente.

20 Implementand Padrã "Manter Classe" Figura B6.19. Terceira página d Assistente de Criaçã d Cas de Us Padrã Manter Classe. Esta página ns permite persnalizar uma primeira versã de página XHTML, aprpriada para nss Cas de Us Padrã e que pderá ser estendida psterirmente para cnter especificidades. Em nss Cas de Us atual vams apenas entender algumas pções básicas deste pass, já que padrã assumid ns servirá sem necessidade de intervenções: #1. Usar I18n (Internatinalizatin): Indica para jcmpany gerar s rótuls de cada prpriedade n arquiv ApplicatinResurces.prperties e nã diretamente na página XHTML. #2. Usar brda na tabela: É uma pçã smente útil em temp de visualizaçã, que exibe brda na tabela HTML que define cntrn d frmulári, para auxíli visual apenas. A tabela que define frmuláris, nas peles d jcmpany, nã sã exibidas cm brdas, cm padrã. #3. Visualizar Pele: Permite que se esclha uma pele distinta para a visualizaçã, eventualmente uma pele específica da empresa nã pré-existente na palheta d cmb mtiv pel qual mesm pde ser mdificad. #4. Visualizar Manutençã: Acina um md de visualizaçã (Preview) d frmulári n Navegadr padrã d usuári. #5. Exempl de página send visualizada, que utilizarems em nss Cas de Us. #6. Cluna Usa? : Permite que prpriedades da classe sejam retiradas da visualizaçã n frmulári. Perceba que jcmpany já assume que prpriedades padrões de auditria pauta mínima nã devam aparecer. #7. Tip Página XHTML: O jcmpany dispnibiliza duas pções para a geraçã da estrutura de um frmulári Facelets - OO gera tags d jcmpany diretamente (plcf) e WYSIWYG utiliza tags html em sua cmpsiçã, n padrã "jsfc" d Facelets. A primeira viabiliza autcmplete na ediçã ds cmpnentes JSF e a segunda viabiliza uma melhr renderizaçã d HTML final, em temp de desenvlviment. Dica: Para camps auxiliares transientes n frmulári, recmenda-se a criaçã de prpriedades transientes (Ex.: private transient String auxiliar) nas classes cncretas.

21 Capítul B6 21. Para nss prpósit atual, pdems cncluir Assistente de Criaçã clicand em Finish e encerrand segund pass d rteir Cheat-Sheet. Após alerta de cnclusã da geraçã, próxim pass d rteir Cheat-Sheet se abrirá autmaticamente: Editand Artefats da Camada de Visualizaçã. - Editand artefats gerads Ediçã de Camada Visã I Os passs 3, 4, 5 e 6 ds Cheat-Sheets de geraçã de Cass de Us Padrões irã editar artefats prduzids em cada camada MVC-P, na rdem: Visã, Cntrle, Mdel e Persistência. Em nss cas específic, na camada Visã, plugin geru uma página XHTML, alteru arquiv de mensagens ApplicatinResurces.prperties e de menu geralmenu.xhtml para incluir rótuls e uma nva chamada via menu. Os dis primeirs arquivs pssuem um frmat diferente e, prtant, exige um editr distint. Vejams quais sã sugerids e hmlgads pel jcmpany: XHTML: O plugin hmlgad para ediçã de XHTMLs é JBss Tls, que irá se abrir cm padrã. Este editr também especializa d WTP e dispnibiliza pçã visual WYSIWYG (What Yu See Is What Yu Get) para Tags d jcmpany, graças a cnfigurações de especializaçã realizadas pela Pwerlgic. Especificamente para Cass de Us Manter Classe é gerad apenas um artefat de XHTML cm nme padrã [url]tab.xhtml, u seja: uftab.xhtml. Figura B6.20. Editr JBss Tls hmlgad para edições de XHTML. #1. Versã textual d XHTML. Pssui recurss de aut-cmplete a ajuda n-line sensitiva bastand que se psicine cursr sbre um atribut de Tag. #2. Visualizaçã da barra de títuls. Até a versã atual, ela nã fica exatamente alinhada cm as clunas e nem traduz rótuls I18n - estas sã limitações das APIs de custmizaçã d editr. Obs.: Repare que, na figura, a seleçã de um segment na parte visual selecina segment na parte text, facilitand sbremaneira a ediçã. #3. Visualizaçã das crrências de camps de entrada. A linha pntilhada em verde indica que serã exibidas várias crrências d trech circundad. #4. Visualizaçã de hierarquia de Tag. A clicar em Tag<>, editr exibe a hierarquia ancestral da Tag crrentemente selecinada. #5. Seleçã de Md de Ediçã. Recmenda-se mist, Visual/Surce. Mensagens I18n: O plugin hmlgad para a ediçã de arquivs de Prperties é JBss Tls Prperties Editr. Este plugin dispnibiliza um filtr para busca pr chave e/u valr. Além diss, alerta usuári quand há duplicidade de chaves.

22 Implementand Padrã "Manter Classe" Figura B6.21. Mensagens em váris idimas editadas simultaneamente e cm mensagens de validaçã. #1. Opções para Incluir Nva Mensagem, editar u Excluir selecinada. #2. Btões Up e Dwn para rdenaçã das chaves. #3. Opçã de pesquisa infrmand chave e/u valr. #4. Cluna cm as chaves cadastradas exibidas em rdem alfabética. #5. Visualizaçã ds valres de cada chave. Entrada de Menu: Cm já fi descrit, para ediçã de arquivs XHTML é utilizad plugin d JBss. O framewrk facelets é utilizad pel jcmpany, n JSF, para Gerência de Leiaute, que inclui s menus, que sã um imprtante leiaute de nível secundári. O assistente d jcmpany gera uma nva chamada para a URL principal d Cas de Us gerad (em nss cas /f/n/uftab ) a final d últim blc de menu que encntrar n arquiv padrã geralmenu.xhtml. - Editand artefats gerads Ediçã de Camada Cntrle I Na camada Cntrle, jcmpany irá inserir a declaraçã de flux de navegaçã n arquiv facescnfig.xml e gerar um arquiv de definiçã de antações de metadads para a camada Cntrle, chamad package-inf.java 10. Uma nva classe de cntrle também pderá ter sid gerada, cas desenvlvedr tivesse mdificad AppActin, durante Assistente de Criaçã d Cas de Us. Declaraçã de Flux de Navegaçã: O plugin hmlgad para ediçã de arquivs XML de definiçã de fluxs de cntrle, tais cm faces-cnfig.xml (JSF) u struts-cnfig.xml (Struts) é também RHDS, que prvê facilidades similares em ambs s cass. Estes arquivs definem flux de navegaçã para JSF u Struts, que n cas de um Cas de Us Manter Classe é trivial, mantend usuári sempre n mesm frmulári/url. Em JSF jcmpany irá gerar entradas n faces-cnfig.xml, cm URL padrã /t/[id d cas de us]. O prefix /t/ faz cm que Tiles atue. N nss cas específic, cm us de facelets, prefix gerad fi /n. Em Struts, jcmpany irá gerar entradas n struts-cnfig.xml, send uma declaraçã de frm-bean vazia (pis jcmpany trna desnecessári) cm nme [id d cas de us]frm, e utra de ActinMapping cm padrã /[id d cas de us]. Ex.: respectivamente, n nss cas, uffrm e /uf. 10 Em Struts, ele irá alterar struts-cnfig.xml e inserir estas infrmações de metadads n própri actin-mapping.

23 Capítul B6 Figura B6.22. Editr d Red Hat Studi hmlgad para arquivs faces-cnfig.xml e struts-cnfig.xml. #6. Arquiv de cnfiguraçã JSF para a aplicaçã, em frmat XML e cm auxíli em tdas as seções. #7. Uma regra de navegaçã (navigatin rule) de descnexã vem pré-cnfigurada para atender a btã gerad cm padrã n rdapé das aplicações #8. A nssa regra de navegaçã é gerada, cm flux simples, que apenas mantém usuári na mesma página. Nte que jcmpany intrduz sufixs padrões nas URLs (tab, neste cas), que sã cnvenções úteis para identificaçã simples de padrões pel framewrk. Pde-se alterar este padrã de URL, se desejad. #9. Cm ns utrs editres jbss Tls, abas permitem que se cmute para visualizaçã em md de diagrama u text XML. Figura B6.23. Md gráfic para exibiçã de fluxs de navegaçã, representand Descnexã e Mantém UF. Metadads de Cntrle (Metadads): Em JSF, jcmpany irá gerar um arquiv específic para cnter antações (Anntatin) cm nme package-inf.java. Este arquiv é criad dentr de um pacte padrã para cnter metadads u prgramaçã declarativa:

24 Implementand Padrã "Manter Classe" src/main/cnfig/cm/pwerlgic/jcmpany/cnfig/app/[url d cas de us]. Em nss cas, específic, abaix de: src/main/cnfig/cm/pwerlgic/jcmpany/cnfig/app/uftab. Estas antações servem para dar diretrizes a framewrk para acinar cmprtaments genérics desejáveis na camada Cntrle. Nã irems ns aprfundar ns metadads neste capítul. Classe de Cntrle: Para Struts u JSF, Assistente de Criaçã permite que se defina um nme de classe de cntrle para que seja criada dentr d padrã. Precisarems deste recurs em próxims tutriais. - Editand artefats gerads Ediçã de Camada Mdel/Dmíni I Na camada de Mdel/Dmíni, jcmpany irá gerar um utr arquiv de metadads para declaraçã d graf de classes envlvida n Cas de Us11. Este arquiv de metadads de Dmíni é também chamad package-inf.java e utilizad tant para JSF quant para Struts. A diferença será smente pacte que é criad n prjet rhtutrial_cmuns e cm padrã src/main/cnfig/cm/pwerlgic/jcmpany/cnfig/dmíni/app/[url d cas de us]. Em nss cas, específic, abaix de: src/main/cnfig/cm/pwerlgic/jcmpany/cnfig/dmíni/ app/uftab. Neste pass, além ds metadads, Cheat-Sheet também abrirá as Entidades, em nss exempl Uf.java e UfEntity.java, utilizand cm plugin de ediçã padrã JDT, naturalmente. - Editand artefats gerads Ediçã de Camada Persistência I Em tds s Cas de Us Padrã, jcmpany nã irá gerar artefats u classes na camada de Persistência, mas permitirá que se edite arquivs de cnfiguraçã intrínsecs a esta camada, tais cm hibernate.cfg.xml u persistence.xml. - Realizand Liberaçã Cmpleta via Maven Cnstruçã e Liberaçã I Neste pnt, já estams de psse de tds s artefats que precisams para nss Cas de Us finalizads. Eles fram nã smente gerads pel plugin de criaçã segund melhres práticas, cm ainda revisads e custmizads nde necessári, através de plugins de ediçã. N presente tutrial, ainda nã precisams de nenhuma custmizaçã específica, pis padrã ns atendeu perfeitamente. Mas ns próxims Cass de Us, mais cmplexs, irems explrar várias custmizações típicas. O pass de finalizaçã, prtant, se trata simplesmente d dispar de rtina Maven para empactament seguid de liberaçã. Esta rtina irá agrupar nsss prjets em um executável WAR, aprpriad para executar n Applicatin Server crrentemente cnfigurad - em nss cas, Cntêiner Web Tmcat 6.x (já que nã usarems EJB). 22. Clique n últim pass, certificand-se de que prjet rhtutrial está em fc. 23. Outra frma de acinar a liberaçã independente d Cheat-Sheet é disparand-se diretamente a pçã de Liberaçã para Tmcat Cmpleta Desenvlviment na barra de External Tls. Faça-, cnfrme indicad na figura. 11 Cm vims n capítul 5, este graf é cmpst da Agregaçã de Classes send mantida e também das classes utilizadas cm cnsulta, em uma Clabraçã (URL).

25 Capítul B6 Figura B6.24. Acinand Menu External Tls da barra de ícnes d Eclipse. N primeir acess será necessári marcar a pçã, cnfrme indicad na Figura B6.25, mas nas subsequentes um atalh será criad, facilitand dispar. Nte que diálg de External Tls permite diversas persnalizações das rtinas. Figura B6.25. Diálg d External Tls cm diversas tarefas Maven genéricas e pções. #1. A lista exibe tarefas Maven desenvlvidas e/u hmlgadas n jcmpany. #2. Em Wrking Directry vems que a variável ${prject_lc} indica cm alv prjet crrente. #3. Em arguments, diversas pções Maven sã usadas. Discutirems variações de us em utrs capítuls. 24. Após dispar, bserve resultad na janela Cnsle. O resultad final Ok da cnstruçã e liberaçã deve durar cerca de 2 minuts e mei, em uma máquina mediana, e ser similar a da Figura B6.26. Este temp será bem menr nas liberações subsequentes, cm verems n próxim capítul.

26 Implementand Padrã "Manter Classe" Figura B6.26. Relatóri final d Maven sbre a liberaçã cmpleta (primeira vez, mais demrada). 25. Para cmpreender resultad desta tarefa, cnfira diretóri nde se encntra instalad Tmcat, em [jcmpany]\servers\tmcat\, cnfrme a Figura B6.27. Figura B6.27. Diretóris d Tmcat mdificads em destaque. Cm funcina? Após gerar arquiv rhtutrial.war, a rtina Maven expande seu cnteúd na pasta webapps e envia um arquiv de definiçã de cntext (presente n template INI) para a pasta cnf\catalina\lcalhst. A cnfiguraçã é a mesma também para ambientes de desenvlviment Linux. - Definind atalhs de tarefas Maven específics para um prjet É cmum crrerem falhas a se clicar em Deply, cm resultad da perda de fc n prjet rhtutrial. Neste cas, pde-se clicar n prjet (para frçar fc) e reabrir pass d Cheat-Sheet (u clicar nvamente na tarefa d External Tls).

27 Capítul B6 Figura B6.28. Para liberaçã, via Cheat-Sheets u atalh External Tls, prjet principal deve estar em fc. Este prblema pde crrer prque, cm descrevems na Figura B6.25, as rtinas Maven d jcmpany estã cnfiguradas para pegar prjet crrentemente em fc n Eclipse (${prject_lc}). Para fugir deste incômd, é pssível se criar tarefas Maven apntand para cada prjet explicitamente, da seguinte frma: 1. Selecine, dentr d diálg d External Tls, a tarefa desejada e clique direit, acinand a pçã Duplicate, cm exibid na Figura B6.29. Figura B6.29. Duplicand uma tarefa d External Tls. 2. Em seguida, altere nme e trque Wrking Directry de ${prject_lc} para prjet específic, selecinand- através d btã Brwser Wrkspace. 3. A final, clique em Apply. A tela deve ficar similar à da Figura B6.30. Figura B6.30. Criand tarefas específicas de Liberaçã, cm partes mdificadas em amarel. Obs.: Esta prática pde levar à prliferaçã de tarefas, mas é útil para quem trabalha cm pucs prjets simultaneamente.

28 Implementand Padrã "Manter Classe" Preparand Infra-Estrutura para Testes Agra estams preparads para testar resultad de nss desenvlviment, mas precisams antes de um SGBD-R dispnível e de iniciar Applicatin Server. - Utilizand Apache Derby Pderíams alterar a cnexã padrã de pl JDBC que vem n template INI para ns cnectar em desenvlviment cm um SGBD-R Oracle u MySQL, pr exempl. Mas cm estams usand JPA, pdems utilizar uma pçã de SGBD-R mais leve e flexível, escrita em Java: Apache Derby12. O Apache Derby tem qualidade de prduçã para Mbile e suprta SQL ANSI em suas últimas versões, viabilizand um desenvlviment rbust e, graças a JPA/Hibernate, psterirmente prtável. O jcmpany hmlga também um plugin Eclipse para Apache Derby e já pré-cnfigura para facilitar a dispnibilizaçã imediata de um Banc de Dads lcal em escp d prjet. Este banc vem cm nme padrã banclcal. Pr fim, jcmpany também traz cnfigurads s arquivs de cntext d Tmcat cm pl JDBC para acessar este Banc de Dad lcal. Cm tud iss, pde-se inicar um desenvlviment prntamente, sem dependências externas u de quaisquer cnfigurações sujeitas a prblemas... Para ativar Apache Derby para nss prjet, precisams: 4. Adicine a natureza Apache Derby a prjet, clicand direit n mesm e acessand Apache Derby > Add Apache Derby Nature Figura B6.31. Adicinand Natureza Apache Derby a prjet Em seguida levante serviç, utilizand a pçã Apache Derby -> Start Derby Netwrk Server. Este SGBD-R pssui um trajet curis: criad pela empresa Cludscape, detinha nme de Cludscape DB. Esta empresa fi adquirida pela Infrmix, que pr sua vez fi adquirida pela IBM, que du prdut para grup Apache, quand mudu de nme para Apache Derby. Finalmente, na versã 6.0 d Java, está send incrprad cm sluçã embutida de SGBD-R.

29 Capítul B6 Figura B6.32. Iniciand serviç d Apache Derby. 6. Cnfira a ativaçã d serviç. O indicadr de que um serviç de Banc de Dads Derby está servind na prta 1527 é uma seta verde que passa a decrar prjet e uma mensagem (em prtuguês, já que Derby tem traduçã embutida para este idima!) na janela de cnsle. Figura B6.33. Indicadres de serviç de Banc de Dads Derby ativ. 7. Cnfira arquiv de cnexã de Pl JDBC. O arquiv rhtutrial.xml, cnhecid cm arquiv de cntext n Tmcat, pré-cnfigurad na aplicaçã, vem cm nme banclcal e pçã de aut-criaçã para que um nv Banc de Dads seja criad, se nã existir ( banc é criad na raiz d prjet rhtutrial ). Este arquiv deve ter sid liberad para a pasta cnf/catalina/lcalhst d Tmcat. Figura B6.34. Cnfigurações chave de pl para Derby. Obs.: Pde-se, naturalmente, alterar estas cnfigurações para se utilizar qualquer utr SGBD-R desejad, apenas cuidand para dispnibilizar driver JDBC de acess na pasta cmmn/lib d Tmcat. - Utilizand Apache Tmcat Cm Banc de Dads n ar, pdems ativar finalmente Tmcat, que usarems durante este livr. 8. Para iniciar Tmcat, clique n ícne d gat Tm, na barra d Eclipse. Figura B6.35. Atalhs para dispar, parada e reiníci d Tmcat.

30 Implementand Padrã "Manter Classe" O plugin para gerenciament d Tmcat hmlgad n jcmpany é Tmcat Sysde. Mais adiante verems cm cnfigurá-l para depuraçã e ht-deply (atualizaçã de classes que dispensam deply Maven). Um indicadr chave de que serviç d Tmcat está cnfigurad crretamente é a mensagem d cnectr HTTP na janela de cnsle d Tmcat, cm na Figura B6.36. Figura B6.36. Mensagem de serviç HTTP k. 9. Para executar a nssa aplicaçã, cm está send servida na prta 80, digite n Navegadr: - Entendend a Segurança Cntrle de Acess I Lg que executarms a chamada da aplicaçã, serems apresentads a uma página de autenticaçã d jcmpany, cnfrme a. Figura B6.37. Página de autenticaçã após a chamada da aplicaçã. Aqui nrmalmente cmeçam a surgir várias indagações cm relaçã à custmizaçã da aplicaçã, cm pr exempl: 10. Cm está definida a segurança? Que usuári utiliz? 11. E se minha aplicaçã dispensa autenticaçã (cm partes de um serviç de ecmmerce), cm evit a página de autenticaçã? E se ela mistura trechs restrits e utrs de acess livre? 12. Cm incluir meu Web-Design, lgtip, etc.? Nã irems respnder as itens 2 e 3 n presente capítul, mas farems uma breve intrduçã sbre item 1, para cmpreenderms que vem pré-cnfigurad d pnt de vista da aplicaçã e Applicatin Server/Cntêiner. Cnfiguraçã de restriçã de segurança padrã Java EE n prjet: Os templates INI já vêm cm pções de segurança pré-cnfiguradas n padrã Java EE, declaradas n arquiv web.xml. Basicamente, há uma restriçã definida para a página inicial da aplicaçã que permite acess smente para usuáris cm papel (rle) Membrs. Este é um papel cmumente adtad n jcmpany para representar Qualquer usuári que pssua um lgin/senha.

31 Capítul B6 Para mais infrmações sbre cm cnfigurar uma segurança padrã Java EE n arquiv web.xml, pde-se cnsultar dcumentaçã de tutrial da Sun n hiperlink: (capitul 32: Security) Cnfiguraçã de Realm em memória n Tmcat: Segund esta mesma especificaçã, devese definir um Realm n Applicatin Server, que pr sua vez definirá a estratégia e a base de armazenament para Usuáris, Senhas e Papéis. Um Realm pde definir us de um sistema de autenticaçã de rede, LDAP/Active Directry, u até de uma base em SGBD-R e/u Mainframe. Para cass mais cmplexs, eventualmente, pde-se ter que prgramar um módul de lgin, utilizand para iss padrã JAAS (Java Authenticatin and Authrizatin Service). A frma de cnfigurar um Realm é dependente d Applicatin Server. Para mais infrmações sbre cm cnfigurar um Realm n Tmcat 6.x pde-se cnsultar seguinte hiperlink n Web-Site d prdut: tmcat.apache.rg/tmcat-6.0-dc/realm-hwt.html. Resumidamente, para nss cas, jcmpany traz um Memry Realm d Tmcat, cnfigurad cm um usuári para testes, cm lgin admin e senha senha. Este usuári pssui s papéis Membrs e também AreaTecnica, utilizads em algumas restrições de segurança padrões d jcmpany (cm acess a item de menu Área de TI, que cnhecerems). Além diss, este usuári vem cm s papéis padrões de administraçã d Tmcat, manager e admin. Esta cnfiguraçã pde ser encntrada n arquiv [tmcat]\cnf\tmcat-users.xml (Irems mdificá-la, ns próxims tutriais). Página XHTML cntend frmulári para lgin padrã. Cm esta arquitetura, Applicatin Server será capaz de realizar a autenticaçã a partir de um frmulári de lgin que siga também um padrã Java EE, cm também é nss cas. Sem entrar em maires detalhes, pr hra, vams prsseguir, ns autenticand cm usuári admin e a senha senha. Entendend a Aplicaçã Gerada Neste tópic, vams cnhecer um exempl de aplicaçã na frma cm vem rganizada em templates INI. Em uma aplicaçã real, certamente realizaríams ajustes nestes templates para custmizar leiautes e pele (lk-and-feel) e até mesm cmprtaments de interaçã para atender a padrões de usabilidade e ergnmia específics de cada empresa/aplicaçã. Irems discutir cm fazems esta custmizaçã n módul D. Pr hra, vams ns cncentrar na parte funcinal da aplicaçã e recurss genérics de usabilidade/ergnmia que jcmpany dispnibiliza de frma prnta para us. - Leiaute Geral O leiaute da página inicial (hme-page) da aplicaçã irá variar ligeiramente cnfrme se esteja trabalhand cm Struts u JSF/Tiles u JSF/Facelets. Estas diferenças dizem respeit a variações saznais de funcinalidades que eventualmente nã estã dispníveis em uma u utra tecnlgia. O esquema de leiaute padrã está representad na Figura B6.38.

32 Implementand Padrã "Manter Classe" Figura B6.38. Página principal cm leiaute e apresentaçã básics. #1. Tp cntend nme da empresa, títul d frmulári crrente e sigla da aplicaçã. O títul central muda cnfrme cada frmulári e dcument vai send editad. #2. Barra de menu Pull-Dwn, utilizada n leiaute sistema, cm várias pções sugeridas cm padrã. #3. Barra de btões de quisque, sugerida para destacar funções imprtantes d negóci (pções de Cas de Us mais acessadas). #4. Área infrmativa sugerida, devend ser editada para cnter infrmações glbais de peraçã da aplicaçã. #5. Área custmizável da barra de rdapé, cntend nme cmplet da empresa e da aplicaçã, bem cm infrmações de cpyright e de cntrle da aplicaçã. #6. Área de cabeçalh gerida pel jcmpany, sugerida cm padrã cm diversas pções de utilitáris. Tdas estas áreas pdem ser persnalizadas. Em até cert nível, inclusive, smente cm algumas antações de metadads. Para alterações mais prfundas, n entant, será precis editar XHTMLs de leiaute n padrã Facelets e/u especializar XHTMLs de cmpnentes. - Persnalizaçã de Pele Cas as cres apresentadas na página principal da nã cincidam cm as cres de sua aplicaçã, nã se precupe: a parte decrativa da aplicaçã é realizada em peles que pdem inclusive ser esclhidas de uma palheta e mdificadas para gst de cada usuári. Vams selecinar a pele pret e branc, clicand n menu Prefs/Language -> Persnalizar Pele (u através da pçã d utilitári). Experimente variar a seleçã pr várias peles e, a final, mantenha a pele de sua preferência neste livr, irems utilizar principalmente a pele Pret e Branc até módul D, quand aplicarems um Web-Design própri.

33 Capítul B6 Figura B6.39. Seleçã da pele Pret e Branc. Lembre-se de clicar em F12-Gravar para cnfirmaçã. Cas se esteja utilizand Firefx, um Widget d jquery UI Theme Rller aparecerá a lad d menu, smente em temp de desenvlviment, para permitir a desenvlvedr e Web-Design experimentarem utras paletas de peles d mercad, dispnibilizadas n site d Theme Rller - estas paletas sã "transientes" (nã estã embutidas na aplicaçã) mas pdem servir de pnt de partida para a criaçã de uma nva pele a ser incrprada na aplicaçã. Figura B6.40. Seleçã de pele transitória a partir de Widget d jquery UI Theme Rller Persnalizaçã de Leiaute Assim cm n cas da pele, própri leiaute mais abrangente da aplicaçã pde ser persnalizad a gst e necessidade de cada usuári, ficand ambs salvs em ckies, que nã causa sbrecarga na aplicaçã. Para persnalizar leiaute, acesse a pçã Prefs/Language -> Persnalizar Leiaute ( us de Layut u Leiaute pde ser esclhid e mdificad n arquiv de mensagens ApplicatinResurces.prperties ). Nte que leiaute, em algumas versões, diferentemente da pele smente se mdifica após uma nva submissã d navegadr! - Persnalizaçã de Frmulári Nrmalmente, frmuláris de entrada de dads sã apresentads na seçã de crp (centr) d leiaute principal seçã que cstuma ser a única a variar em cnfrmidade cm a implementaçã de cada Cas de Us. Pdems ver esta um frmulári em açã ( que prduzims) via pçã Menu Inicial -> Manter UF 13. Cm a pçã de custmizaçã de frmuláris que acessams via pçã Prefs/Language -> Persnalizar Frmulári, pr exempl, cnseguims alterar a barra de ações (btões) para serem apresentads smente cm ícnes. 13 O frmulári se abrirá cm mensagens de err prque nã tems ainda tabelas para que funcine adequadamente. Se clicarms n btã F7-Nv irems criar linhas de entrada que ns permitirã ver seu leiaute intern.

34 Implementand Padrã "Manter Classe" Figura B6.41. Frmulári cm pele transitiva (lightness) e barra de btões "smente cm ícnes". - Gerand Esquema Relacinal (DDL) - Geraçã de DDL I Para cnseguirms perar nss Cas de Us inicial, precisarems criar esquema relacinal n nss SGBD Apache Derby, que atualmente pssui apenas um banc de dads cm nme banclcal, ttalmente vazi. Este esquema é definid em linguagem padrã cnhecida cm DDL (Data Definitin Language). Felizmente, jcmpany traz algumas pções de menu abaix de Área de TI, especialmente dispníveis para usuáris cm papel (rle) AreaTecnica e uma delas irá ns apiar em gerar DDLs autmaticamente a partir d mapeament Objet-Relacinal da aplicaçã. 13. Acesse a pçã Área de TI -> Esquema DDL Geraçã e selecine Atualizaçã n cmb cm rótul Tip de Esquema. 14. Clique, em seguida, em Gerar Esquema. O jcmpany, através de reús e especializações em utilitáris Hibernate, irá sugerir um esquema DDL, necessári para sincrnizar mapeament atual da aplicaçã cm esquema atual d SGBD. Em nss estági, iss significa criar a tabela UF e, eventualmente dependend d SGBD-R e de sua versã, também tabelas auxiliares que utilizadas para geraçã autmática de identificadres14. Figura B6.42. Utilitári para geraçã de DDL. Obtençã d esquema relacinal a partir d mapeament O-R. #1. Opções para geraçã d esquema DDL de Criaçã (independente da existência u nã de estruturas), Atualizaçã (criaçã u alteraçã de esquemas, apenas se necessári e em funçã de análise d esquema atual n SGBD) u Exclusã (geraçã d esquema para exclusã de tdas as estruturas existentes). #2. Tips de estruturas relacinais analisadas/geradas. 14 Em Oracle u versões nvas d Derby, pr exempl, esta segunda tabela nã é necessária, send utilizads Sequences u utrs esquemas interns cm padrã, para geraçã de Object-Id.