Transformações de JPA em UML

A transformação de JPA em UML gera elementos de modelo de Unified Modeling Language (UML) anotados de projetos ou artefatos Java™ que contêm o código de Java Persistence API (JPA).
Para criar projetos e artefatos JPA, você deve ativar os seguintes recursos:
Antes de utilizar esta transformação para gerar elementos de modelo UML, você deve instalar componentes específicos e ativar recursos específicos.
  1. Você deve instalar os seguintes componentes:
    • Transformações e edições gráficas Java, Java Persistence API (JPA) e EJB 3.0
    • Ferramentas para WebSphere Application Server, versão 7.0
  2. Você deve ativar os seguintes recursos:
    • Transformação Java Persistence API
    • Ferramenta EJB 3.0 Transformation Profile
  3. Se você configurar a transformação para usar o design contract management protocol (DCMP) modelagem reconciliada, e configurar a transformação de UML em JPA, ou reversa, para criar relacionamentos de rastreamento entre entidades JPA e elementos UML, é necessário ativar os seguintes recursos:
    • Modelagem EJB 3.0
    • Modelagem JPA
    Nota: A categoria de recurso Modelagem contém os recursos Modelagem EJB 3.0 e Modelagem JPA.

Origens de Transformação Válidas

É possível especificar os seguintes itens como a origem de uma transformação de JPA em UML:
  • Projetos Java
  • Pastas de origem Java
  • Pacotes Java
  • Arquivos Java

Se você szelecionar qualquer um desses itens na visualização Package Explorer em vez de utilizar o editor de Configuração de Transformação, os elementos de origem selecionados substituem o projeto de origem ou os elementos que foram especificados na configuração de transformação. A configuração de transformação não é afetada e a origem especificada na página Origem e Destino do editor de configuração de transformação ou no assistente de Nova Configuração de Transformação não é alterada.

Destinos de Transformação Válidos

Um destino de transformação válido é um modelo UML ou pasta de um projeto UML.

Descritores de Implementação e Arquivos de Persistência

É possível configurar a transformação para gerar elementos e estereótipos UML usando as informações em um descritor de implementação, que consiste nos seguintes arquivos de persistência que estão localizados na pasta META-INF do projeto de origem de transformação:
  • orm.xml: Contém as anotações JPA que correspondem aos elementos UML na origem da transformação
  • persistence.xml: Contém um elemento <mapping-file> que se refere a orm.xml

Se o descritor de implementação não contiver as informações para gerar os elementos ou estereótipos UML necessários, a transformação usa as anotações JPA no código Java.

Comparando e Fundindo Saída de Transformação com Modelos UML de Destino

A transformação de JPA em UML utiliza a funcionalidade de comparação e fusão para determinar as diferenças entre o modelo de destino e o modelo temporário gerados pela transformação. Ao executar a transformação, o editor de fusão exibe as diferenças entre os dois modelos. No editor de fusão, é possível selecionar as alterações que a transformação funde ao modelo de destino.

Filtros no Editor de Fusão

Você pode utilizar os filtros no editor de fusão para mostrar ou ocultar os diferentes tipos de deltas que ocorrem quando você executa a transformação de Java em UML. Para simplificar a visualização no editor de fusão, clique no ícone Filtros na barra de ferramentas e selecione os filtros para aplicar.

Por exemplo, a transformação não configura limites superiores e inferiores ao transformar elementos de multiplicidade, como atributos e parâmetros. No modelo temporário, limites superior e inferior são configurados para nulo se nenhum tipo de coleta for gerado. Se os limites superior e inferior forem especificados explicitamente no modelo UML de destino, mesmo se esses valores de limite especificarem uma multiplicidade padrão igual a 0..1, existe um delta entre o modelo temporário e o modelo de destino. Para modelos grandes, esses deltas triviais podem ser numerosos, o que dificultaria ver outros deltas no editor de fusão. Para ocultar esse tipo de delta, selecione o filtro Remover por Filtro Alterações Triviais de Limite Inferior e Superior.

Limitações da transformação em modelagem reconciliada

A transformação de JPA em UML não transforma informações sobre origens de dados.

Integração com a Equipe de Suporte

A transformação fornece funcionalidade de integração com os sistemas de controle de versão IBM® Rational Team Concert, CVS, Rational ClearCase, e Rational ClearCase LT, que possibilita efetuar o registro de saída dos arquivos automaticamente ou incluir novos arquivos. É necessário ativar os recursos de equipe para trabalhar com os sistemas de gerenciamento de configuração.


Feedback