Conteúdo

• Usando diagramas de classes
• Criando diagramas de classes e adicionando elementos
• Gerando e editando o código-fonte Java
• Localizando elementos do diagrama
• Documentando classes e diagramas
• Representando links e associações
• Criando diagramas de dependência
• Salvando diagramas e atualizando arquivos de origem Java

Pré-requisitos

Para que este tutorial possa ser usado, o IDE deve ser instalado em seu sistema e você deve estar familiarizado com as partes básicas do IDE. Você também deve ter uma familiaridade básica com a linguagem de programação em Java e UML. Para ter um conhecimento básico do IDE, consulte os tópicos de Fundamentos do IDE na ajuda on-line. Uma boa fonte para técnicas e teorias UML é a página de recursos UML oficial em http://www.uml.org/.

Requisitos do sistema

Este tutorial presume que o seu sistema atenda aos requisitos especificados na seção Requisitos do sistema das Notas de versão do NetBeans Enterprise Pack 6.0.

Software necessário para este tutorial

Antes de começar, baixe e instale o software seguinte:

• NetBeans 6.0
  
  Selecione a opção Download completo.

Para criar o diagrama de classes

1. Se necessário, inicie o IDE e abra o projeto UMLTutorialProject criado anteriormente.
2. Na janela Projetos, expanda o nó e clique com o botão direito do mouse no nó Modelo.
3. Escolha Adicionar > Diagrama no menu pop-up.
   
   O Novo assistente é aberto, exibindo a página Criar novo diagrama.
4. Na lista Tipo de diagrama, selecione Diagrama de classe.
5. No campo Nome do diagrama, digite ClassDiagram.
6. Deixe a definição padrão no campo Espaço de nome e clique em Terminar.
   O IDE realiza os seguintes procedimentos:
   
   • Cria o nó ClassDiagram no nó Modelo
   • Exibe o novo diagrama no Editor de diagramas (o diagrama está vazio neste ponto)
   • Abre a Paleta de modelagem

início

Para adicionar e rotular elementos de classe

1. Na seção Básico da Paleta de modelagem, selecione o ícone de classe e clique no Editor de diagramas.
   Esta ação coloca um elemento de classe no diagrama.
2. Desmarque o ícone, clicando com o botão direito do mouse em qualquer lugar no Editor de diagramas.
   
   Observação: sempre que você selecionar um ícone, pode colocar várias instâncias deste elemento no editor Diagrama clicando mais de uma vez.
3. Caso ainda não esteja selecionado, selecione o elemento de classe recém-adicionado, clicando nele uma vez.
4. Digite EntryStation e pressione Enter.
   O IDE realiza os seguintes procedimentos:
   
   • Rotula o elemento de classe com o nome EntryStation
   • Cria uma operação pública chamada EntryStation()
   • Exibe as propriedades da classe na janela Propriedades
   • Adiciona um elemento de classe com o nome EntryStation sob o nó Modelo na janela Projetos

início

Para adicionar atributos usando o menu pop-up

Agora que desenhou e rotulou o elemento EntryStation, você precisa descrever seus atributos.

1. Caso ele ainda não esteja selecionado, selecione o elemento EntryStation no Editor de diagramas.
2. Clique com o botão direito do mouse na palavra Atributos e escolha Inserir atributo no menu pop-up.
   Um editor de uma linha é aberto, exibindo a seguinte informação:
   

   visibility type name[ranges]=initialValue{name=value}
   

3. Digite stationID e pressione Enter.
   Um atributo denominado stationID do tipo int aparece na classe EntryStation e as seguintes operações são criadas na classe:
   

   public int getStationID()
   public void setStationID(int val)
   

   Observe que as operações get e set são criadas porque você manteve a configuração padrão.

início

Para adicionar operações

1. No Editor de diagramas, selecione o elemento de classe EntryStation.
2. Clique com o botão direito do mouse na palavra Operações e escolha Inserir operação no menu pop-up.
   Um editor de uma linha é aberto, exibindo a seguinte informação:
   

   visibility returnType name(parameter) {properties, ...}
   

3. Digite validateEntryStation e pressione Enter.
   O IDE cria uma nova operação.

início

(Opcional) Para editar atributos ou operações

Quando você clica duas vezes em um atributo ou em uma operação em uma classe, é aberto um Editor de caixas de combinação, como mostrado na figura seguinte.

Quando você clica em cada parte do atributo ou operação, o rótulo dessa parte aparece em negrito na caixa de combinação. Se aplicável, a parte selecionada da operação ou atributo possui uma lista suspensa de valores.

Por exemplo:

1. Clique duas vezes no atributo stationID na classe EntryStation.
2. Clique na palavra private.
   Observe que a palavra visibility aparece em negrito.
3. Pressione CTRL + seta para baixo.
   É aberta uma lista suspensa que exibe os valores que você pode selecionar para a visibilidade do atributo.
4. Selecione um novo valor na lista suspensa e pressione Enter.
   O atributo é atualizado com o novo valor.
   
   Observação: você também pode digitar um novo valor diretamente no editor. Se você não vir o que precisa na lista suspensa, use as teclas de seta para direita e para esquerda para posicionar o seu cursor e digitar o valor apropriado.
5. Neste tutorial, use o valor private e pressione Enter para fechar o editor.

início

Para adicionar e definir as classes restantes

Agora você precisa adicionar mais classes para concluir um diagrama de classes da aplicação bancária simples. Depois de adicionar as classes, rotule-as e adicione atributos e operações, como descrito abaixo, usando as técnicas que aprendeu até aqui neste tutorial.

1. Na seção Básico da Paleta de modelagem, selecione o ícone de classe e clique cinco vezes no Editor de diagramas para colocar os elementos de classe adicionais como mostrado na figura seguinte.
   

   

2. Desmarque o ícone de classe, clicando com o botão direito do mouse em qualquer lugar no Editor de diagramas.
   
   Observação: você pode selecionar e arrastar os novos elementos de classe para organizá-los como mostrado no diagrama anterior, para que você possa ver cada um claramente no diagrama.
3. Selecione o primeiro elemento de classe não nomeado abaixo do elemento EntryStation e chame-o de ATM.
4. Com o elemento de classe ATM ainda selecionado, adicione um atributo da forma seguinte:
   

   private float cashOnHand

5. Adicione um segundo atributo na classe ATM e defina-o da forma seguinte:
   

   private float dispensed
     

   Os atributos aparecem no diagrama de classes.
   
   Observação: à medida que você adicionar atributos e operações às classes, o tamanho dos elementos da Classe aumentará. Para melhorar a aparência do diagrama, mova os elementos de classe, conforme necessário, para que você possa ver cada elemento claramente. Ao fazer isso, tenha cuidado para selecionar o elemento de classe e não um atributo ou operação individual.
6. Selecione o primeiro elemento de classe localizado abaixo da classe ATM e chame-o de Consortium.
7. Adicione uma operação na classe Consortium. Adicionar operações é semelhante a adicionar atributos. Clique com o botão direito do mouse na palavra Operações e selecione Inserir operações.
8. Digite validateAccountInfo e pressione Enter.
   O IDE cria a nova operação da seguinte forma:
   

   public void validateAccountInfo()
   

9. Selecione o elemento de classe à direita da classe ATM e rotule-o de CashierStation.
10. Adicione duas operações desta classe da seguinte forma:
    

    public int verifyCard()
    
    public float verifyAmountAvailable()
      

11. Rotule os dois elementos de Classe restantes como Branch e User.
    Para a classe User não há atributos ou operações.
12. Para a classe Branch, adicione um atributo da seguinte forma:
    

    private char connected
      

Para gerar código-fonte Java

Você pode modelar a sua aplicação Java e, em seguida, gerar o código-fonte Java correspondente para o seu modelo. Para gerar o código-fonte, você precisa criar um projeto Java e usá-lo para armazenar o código gerado para o seu projeto UML.

1. No menu principal, escolha Arquivo > Novo projeto e, em seguida, adote o seguinte procedimento:
   
   1. Em Categorias, selecione Geral.
   2. Em Projetos, selecione Aplicação Java.
   3. Clique em Próximo.
2. No campo Nome do projeto, digite JavaPrj1.
3. Em Local do projeto, clique em Explorar e selecione o diretório UMLTutorial.
4. Desmarque as caixas de seleção Definir como projeto principal e Criar classe principal.
5. Clique em Terminar.
   Uma caixa de diálogo de progresso se abre. Quando o projeto JavaPrj1 é criado, ele aparece na janela Projetos.
6. Na janela Projetos, clique com o botão direito do mouse no nó UMLTutorialProject e escolha Gerar código no menu pop-up.
7. Na caixa de diálogo Gerar código, clique em Explorar.
8. Na caixa de diálogo Escolher a pasta de destino, localize a pasta de destino do projeto JavaPrj1 que você acabou de criar.
   Por exemplo: C:\Temp\UMLTutorial\JavPrj1\src
9. Clique em Abrir.
10. De volta na caixa de diálogo Gerar código, desmarque a caixa de verificação Fazer backup dos arquivos de origem existentes e clique em OK.
11. Na caixa de diálogo Autorizar salvamento do projeto UML, clique em Sim.
    O IDE gera o código-fonte Java e a janela Saída exibe o andamento do processo de geração do código.
12. Na janela Projetos, expanda o nó JavaPrj1 > Pacote de origem e clique duas vezes no nó <pacote padrão>.
    Observe que a pasta contém os arquivos de origem Java que são nomeados de forma semelhante aos elementos de classe que você criou no modelo ClassDiagram.

início

Para adicionar atributos usando o Editor de código-fonte Java

Agora, adicione outro atributo a EntryStation usando o Editor de código-fonte. Depois de modificar o arquivo de origem Java, você usará o recurso Reverter engenharia para refletir a alteração no elemento do modelo UML correspondente.

1. Na janela Projetos, expanda o nó UMLTutorialProject e o nó Modelo, se necessário.
2. Clique com o botão direito do mouse no nó EntryStation e escolha Navegar até a origem no menu pop-up.
   Um Editor de código-fonte chamado EntryStation.java aparece, exibindo o código-fonte da classe.
3. No Editor de código-fonte, digite o código seguinte abaixo do primeiro atributo:
   

   private boolean isOperating
     

4. Pressione Ctrl-S para salvar a alteração.
5. Clique com o botão direito do mouse no Editor de código-fonte e escolha Reverter engenharia no menu pop-up.
   A caixa de diálogo Engenharia reversa se abre.
6. Selecione Usar projeto UML existente na caixa de diálogo Reverter engenharia e escolha UMLTutorialProject como o projeto de destino.
7. Clique em OK para chamar o processo de engenharia reversa.
8. Na caixa de diálogo Autorização para sobrescrever elemento de modelo, clique em Sim para sobregravar o modelo existente da classe EntryStation.
9. Clique na aba ClassDiagram para retornar o foco para o Editor de diagramas.
   O atributo isOperating aparece no elemento de classe EntryStation.
   
   Observação: clique no botão Ajustar à janela na barra de ferramentas Diagrama para centralizar o diagrama na janela. Este botão permite que você ajuste o nível de zoom, se necessário, para ler os rótulos ou abrir espaço para colocar mais elementos no diagrama.

início

Para localizar objetos no Editor de diagramas a partir da janela Projetos

• Na janela Projetos, clique duas vezes no nó EntryStation.
  No Editor de diagramas, o elemento de classe EntryStation é selecionado e centralizado.

Para localizar objetos na janela Projetos a partir do Editor de diagramas

1. No Editor de diagramas, selecione a classe Consortium e clique nela com o botão direito do mouse.
2. Escolha Selecionar no modelo no menu pop-up.
   Na janela Projetos, o nome do objeto de destino é realçado.

início

Para usar a janela Documentação de UML

1. (Opcional) Se a janela Documentação de UML não estiver visível, escolha Janelas > Outra > Documentação de UML.
2. No Editor de diagramas, selecione o elemento de classe EntryStation.
3. Clique dentro da caixa de texto da janela Documentação de UML.
4. Digite Describes the actions of the EntryStation class.
5. Clique com botão direito do mouse no elemento de classe EntryStation e selecione Gerar código no menu pop-up.
6. Na caixa de diálogo Gerar código, clique em OK.
7. Na caixa de diálogo Autorizar salvamento do projeto UML, clique em Sim.
   O novo código Java é gerado.
8. Clique na aba EntryStation.java do Editor de código-fonte.
   Você vê que o texto que digitou na janela Documentação foi substituído pelo arquivo de origem EntryStation.java.

início

Para documentar atributos usando a janela Propriedades

1. Clique na aba ClassDiagram para retornar o foco para o Editor de diagramas.
2. Na janela Projetos, expanda o nó EntryStation.
3. Selecione o nó do atributo rotulado private boolean isOperating.
   As propriedades do atributo aparecem na janela Propriedades de UML.
4. Na janela Propriedades, clique no botão de reticências (...) na linha Documentação.
   Um editor personalizado é aberto, como mostrado na figura seguinte.
   

   

5. Digite o texto Maintains if EntryStation is operating e clique em OK.
6. No Editor de diagramas, clique com botão direito do mouse no elemento de classe EntryStation e selecione Gerar código no menu pop-up.
7. Na caixa de diálogo Gerar código, clique em OK.
8. Na caixa de diálogo Autorizar salvamento do projeto UML, clique em Sim.
   O novo código Java é gerado.
9. Clique na aba Editor de código-fonte de EntryStation.java.
   Você vê o texto digitado no código fonte logo acima do atributo isOperating.

início

Para documentar diagramas usando o ícone de comentário

Você pode adicionar notas que descrevam informações específicas de um elemento selecionado no diagrama, usando o ícone de comentário localizado na Paleta de modelagem.

1. Clique na aba ClassDiagram para retornar para o Editor de diagramas.
2. Na seção Comentários da Paleta de modelagem, selecione o ícone de comentário .
3. Clique uma vez à direita e acima do elemento CashierStation.
   Um elemento de comentário é colocado no diagrama.
4. Desmarque o ícone, clicando com o botão direito do mouse em qualquer lugar no Editor de diagramas.
5. Enquanto o elemento de comentário estiver selecionado, digite Cashier stations have limited funds e pressione Enter.
   O texto aparece no elemento de comentário.
6. Na seção Comentários da Paleta de modelagem, selecione o ícone de link de comentário .
7. Clique uma vez dentro de CashierStation e clique novamente dentro do elemento de comentário.
   Um link se encaixa entre o elemento de comentário e o elemento de classe.
8. Desmarque o ícone, clicando com o botão direito do mouse em qualquer lugar no Editor de diagramas.
9. Repita as etapas de 2 a 8 para colocar e vincular um segundo elemento de comentário no diagrama do elemento de classe Branch.
   Use o seguinte texto: A branch belongs to a Member Institution.

Para representar uma associação de classe

1. Na seção Associação da Paleta de modelagem, selecione o ícone de agregação .
2. Clique dentro do elemento ATM e, em seguida, clique no elemento Consortium.
   É desenhado um link entre as duas classes.
3. Clique com o botão direito do mouse em qualquer local no Editor de diagramas para desmarcar o ícone.
   Essa relação é representada na janela Projetos, como mostrado na figura seguinte.
   

   

4. Selecione o link de agregação entre ATM e Consortium.
   Quando o link é selecionado, a cor muda para azul.
5. Aponte o cursor para próximo do meio da linha selecionada e clique com o botão direito do mouse.
6. Escolha Rótulos > Nome do link no menu pop-up.
7. Digite AccountVerification no campo Nome e pressione Enter.
   O link é rotulado como mostrado na figura seguinte
   

   

8. Na seção Associação da Paleta de modelagem, selecione o ícone de associação e desenhe um link de CashierStation para Branch.
9. Clique com o botão direito do mouse em qualquer local no Editor de diagramas para desmarcar o ícone.

início

Para representar uma associação qualificada

Uma associação qualificada relaciona duas classes e um qualificador. O qualificador é um atributo especial que reduz a multiplicidade efetiva de uma associação. Você representa uma associação qualificada como uma caixa pequena no fim da linha da associação ao lado da classe que ela qualifica.

A próxima etapa mostra como criar uma associação qualificada entre a classe ATM e a classe Consortium.

• Clique com o botão direito do mouse no link de agregação, onde ele se une à classe Consortium e escolha Mostrar qualificador. Um qualificador anexa-se ao elemento de classe Consortium como mostrado na figura seguinte.
  

  

início

Para definir a multiplicidade da associação

Você deseja definir a multiplicidade desta associação. Entretanto, por padrão, esses rótulos estão ocultos. Use as etapas seguintes para exibir os rótulos no link de associação.

1. Clique com o botão direito do mouse no link entre Consortium e ATM, e escolha Rótulos > Ambas as multiplicidades de extremidade.
   O menu pop-up fecha e os rótulos do link aparecem.
2. Clique com o botão direito do mouse no pequeno losango na parte superior do link de agregação (próximo do elemento ATM) e escolha Definir multiplicidade.
   
   Observação: se você tiver dificuldade para fazer o menu de pop-up correto aparecer, estique a seta agregada movendo o elemento Consortium para longe do elemento ATM.
3. Selecione 1..*.
   Observe que a parte inferior do link é rotulada de 1 como mostrado na figura seguinte.
   

   

4. Siga um procedimento semelhante e defina a multiplicidade do link de associação entre CashierStation e Branch, como mostrado na figura seguinte.

   

início

Para representar generalização e herança

Generalização é a relação entre uma classe e uma ou mais versões refinadas dessa classe. A classe que está sendo refinada é chamada de superclasse e cada versão refinada é subclasse. Os atributos e as operações da superclasse podem ser exibidos em suas subclasses, conseqüentemente, cada subclasse é considerada herdeira dos recursos da superclasse. Você pode organizar as classes, usando a herança para compartilhar a estrutura comum. Um link de generalização significa que uma classe pode herdar uma série de atributos e operações da classe pai.

1. Na seção Básico da Paleta de modelagem, selecione o ícone de generalização .
2. Clique dentro do elemento de classe ATM e, em seguida, clique no elemento de classe EntryStation.
   A caixa de diálogo Selecionar métodos para redefinir se abre.
3. Marque a caixa de verificação ao lado do nó ATM para selecionar todos os métodos e clique em OK.
   Os métodos selecionados são adicionados ao elemento de classe ATM e um link de generalização se encaixa entre os dois elementos de classe.
4. Desenhe outro link de generalização, clicando primeiro em CashierStation e, em seguida, clicando em EntryStation.
5. Na caixa Selecionar métodos para redefinir, marque a caixa de verificação ao lado do nó CashierStation para selecionar todos os métodos e clique em OK.
6. Clique com o botão direito do mouse em qualquer local no Editor de diagramas para desmarcar o ícone de generalização.
7. Seu diagrama concluído deve ser semelhante à figura seguinte.