Dicas de Mapeamento no NHibernateQuick Up Date - .Net Magazine 77

A principal cr�tica em cima do NHibernate, e tamb�m de outras ferramentas de mapeamento objeto-relacional, � a baixa qualidade da estrutura de tabelas e relacionamento que � criada. O que muita gente se esquece, � que n�o � o NHibernate que cria essa estrutura, � voc� que define como ela ser� criada, atrav�s dos arquivos de mapeamento. O fato � que, depois que o NHibernate cria a estrutura do banco, um DBA ou pessoa experiente em banco de dados relacional, deve analisar a estrutura criada e sugerir ou realizar prov�veis melhorias. Mas existem algumas coisas que voc� j� pode definir no mapeamento e evitar passar �vergonha� naquela reuni�o com o DBA. Sendo assim, dedicamos essa coluna a dar algumas dicas de boas pr�ticas no mapeamento NHibernate, principalmente para a defini��o e cria��o de �ndices. Nomes das FKs Vamos come�ar resolvendo uma das maiores reclama��es de DBAs, os nomes das FKs. Se voc� j� deixou o NHibernate criar alguma estrutura de banco de dados, j� deve ter ouvido essa reclama��o: �Porque voc� criou uma FK chamada fk3172150e1cd5af92? N�o dava pra criar com um nome melhor n�o?� A resposta � sim, e d� pra fazer isso de forma bem simples, veja a seguir:

<many-to-one name="Uf" column="ID_UF" class="UnidadeFederativa" cascade="none" lazy="false"
      foreign-key="fk_uf"/>

�ndices

Outra reclama��o recorrente � quanto aos �ndices. Alguns DBAs preferem criar eles mesmos este tipo de coisa, mas quando voc� sabe que vai precisar de um �ndice, � bom definir no pr�prio mapeamento. Se voc� quer criar um �ndice de uma �nica coluna, pode fazer assim:

<property name="Nome" column="NOME"  type="string" length="50" not-null="true" 
     index="idx_cidade_nome"/>

E se voc� quiser criar um �ndice entre duas ou mais colunas, basta repetir essa propriedade index nas colunas envolvidas, usando � claro o mesmo nome.

Chave �nica

Chaves �nicas tamb�m s�o caracter�sticas comuns da maioria dos bancos de dados, e que podemos definir de forma gen�rica no NHibernate. Se voc� quer definir uma coluna como chave �nica, pode fazer assim:


<property name="CodigoMunicipio" column="CODIGO" type="string" length="10" not-null="true"
   unique="true" />

Ou se voc� quiser definir uma chave �nica com a jun��o de duas ou mais colunas, tamb�m pode fazer assim:

<property name="Nome" column="NOME"  type="string" length="50" not-null="true" 
   unique-key="uk_CodigoNome" />
<property name="CodigoMunicipio" column="CODIGO" type="string" length="10" not-null="true"
   unique-key="uk_CodigoNome" />

Basicamente com essas dicas voc� � capaz de definir no pr�prio mapeamento NHibernate, como devem ser criados os �ndices no seu banco de dados. Na Listagem 1 voc� v� o mapeamento completo dos exemplos mostrados aqui.

Listagem 1. Mapeamento completo


<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2"                       
assembly="Dominio"  namespace=" Dominio.Entidades" >
 
<class name="Cidade" table="CIDADE" lazy="false">
             <id name="Id" column="ID_CIDADE" unsaved-value="0">               
                    <generator class="native"/>
             </id>
            
             <property name="Nome" column="NOME"  type="string" length="50" not-null="true" 
index="idx_cidade_nome"/>
             <property name="CodigoMunicipio" column="CODIGO" type="string" length="10"
not-null="true" unique="true" />       
             <many-to-one name="Uf" column="ID_UF" class="UnidadeFederativa" cascade="none"
lazy="false" foreign-key="fk_uf"/>
       </class>
 
</hibernate-mapping>