Tutorial para atividades do Trabalho Prático da disciplina DCC 603 Engenharia de Software

Tutorial para atividades do Trabalho Prático da disciplina DCC 603 Engenharia de Software Antes de iniciar o tutorial, baixar os seguintes arquivos da página do Prof. Wilson: Plataforma reutilizável: http://homepages.dcc.ufmg.br/~wilson/praxis/3.0/praxis.zip Linha de base da iteração C2: http://homepages.dcc.ufmg.br/~wilson/praxis/3.0/merci/c2.zip Descompactar os arquivos baixados em uma pasta de sua escolha. Atividade 1 Configurando os Modelos UML e artefatos de gestão 1 Abrir o RSA 7.5 e criar um novo Workspace. 2 Importar, sem copiar, o Projeto Perfis (que contém o perfil de UML) da pasta dos componentes reutilizáveis. Para isso: Acionar o menu Arquivo > Importar e escolher Projetos Existentes no Espaço de Trabalho, como na figura abaixo. Acionar Avançar>

Encontrar a pasta onde foi descompactado o arquivo com a plataforma e escolher a pasta Perfis, como ilustrado abaixo: 3 Repetir o passo 2 para o projeto Modelos localizado dentro da pasta da plataforma reutilizável, mas agora, marcando a opção Copiar Projetos no Espaço de Trabalho. 4 Renomear o projeto importado no passo 3 para Praxis.Modelos. 5 Marcar os dois Modelos (Praxis Modelo da solução e Mapeador) do Projeto Praxis.Modelos como somente leitura, através do botão direito do mouse, Propriedades e depois marcar a opção Somente Leitura. 6 Repetir o passo 2 para os projetos Modelos e Gestão localizados na linha de base da iteração C1, mas marcando a opção Copiar Projetos no Espaço de Trabalho. Ao final, a lista de projetos na visualização Explorador de Projeto deve se parecer com a figura abaixo:

Atividade 2 Reproduzir o Modelo do Problema do Merci. Nesta atividade utilizaremos o RSA para reproduzir uma parte do Modelo do Problema do merci, aprendendo como utilizar a ferramenta para criar elementos e diagramas UML. Assumiremos que o seu workspace está da forma como deveria ao final da atividade 1 (acima). Criando um novo modelo e aplicando o perfil de UML do Praxis 1 Criar um modelo UML vazio no Workspace, com o nome de sua escolha. Para isso, vá ao menu Arquivo > Novo > Projeto... Na tela que se abre, escolha a opção Projeto UML e depois em Avançar. Na tela seguinte, digite o nome do seu modelo, como por exemplo, <nome do produto> Modelo do Problema e depois clique em Avançar. Na tela seguinte, escolha para criar seu modelo com base em um modelo vazio e preencha o nome do arquivo, como ilustrado abaixo. Clique em Concluir. 2 Por padrão, o RSA cria um pacote e não um modelo. Para converter o pacote recém criado (figura abaixo) em um modelo, clicar com o botão direito nele, e acionar o comando Refatorar > Converter Pacote em Modelo.

3 Aplicar o perfil de modelagem do Praxis. Isso permitirá que apliquemos estereótipos do Praxis para os elementos de modelagem, como classes, atividades, associações e outros. Para aplicar o perfil, selecione o modelo recém criado e vá na visualização Propriedades. Dentro desta visualização, escolha a aba lateral chamada Perfis, como ilustrado abaixo. 4 Clique no comando Incluir Perfil e escolha o perfil do Praxis, selecionando a opção Perfil no Espaço de Trabalho, como ilustrado abaixo. Clique em Ok. Ignorar o aviso clicando em OK.

5 Aplicar o estereótipo <<systemmodel>> no seu modelo. Para isso, selecione o na árvore do projeto (Project Explorer) e verifique a visualização Propriedades. Escolha a aba lateral Estereótipos, como ilustrado abaixo. Clique em Aplicar Estereótipos e marque a opção systemmodel cujo perfil é o Standard. Note que após aplicar o estereótipo, seu modelo ganhou um adorno <<systemmodel>> na frente de seu nome na árvore do projeto. Isso ocorrerá sempre que aplicar estereótipos nos elementos de modelagem.

Montando a estrutura de pacotes e pastas padrão do Praxis no seu modelo 1 Utilizando o botão direito do mouse, acione o comando Incluir UML > Pacote para criar pacotes em seu modelo, até que fique igual ao do Merci, como ilustrado abaixo. Não preocupar com os diagramas neste momento. 2 Vá até a pasta onde está a raiz do seu modelo no sistema de e replique a estrutura de pastas do Merci. Para saber onde está o arquivo, clique com o botão direito no modelo e acione Properties (obs: veja que isso é diferente da visualização Propriedades). A tela abaixo se abrirá.

A raiz do seu modelo está informada em Local (na tela acima). Acessar esta pasta no Windows Explorer e reproduzir as pastas do Merci, como na figura abaixo. Obs: Apenas porque estamos copiando o exemplo do merci, neste caso, copiar os anexos (arquivos dentro das pastas) para sua estrutura de diretórios também. Não faça isso no seu trabalho. Você deve usar os gabaritos que estão na plataforma do Praxis, que vêm vazios. Incluindo os anexos de descrição geral Nesta etapa incluiremos os anexos de descrição geral do Merci no seu novo modelo. Para isso, primeiro temos que habilitar a visualização de anexos na árvore do projeto. 1 Na visualização Explorador de Projeto, acione o comando Customizar Visualização, como exibido na figura abaixo.

2 Desmarcar a opção Elementos UML na aba Filtros, como ilustrado na figura abaixo. Clique em OK. 3 Agora, adicione um a um os anexos de descrição geral no Pacote Visão de Requisitos\Descrição geral, da mesma forma que está no Merci. Para isso, clicar com o botão direito do mouse no pacote correto e acionar Incluir UML > URL. Na tela que se abrirá, marcar a opção Utilize a representação de caminho relativo para todas as referências de arquivo.

4 Clicar em Procurar e escolher um dos arquivos que foram copiados. Repita para os outros 2 anexos. Note que 1 anexo fica no pacote Perspectiva do Produto e os outros dois no pacote Descrição Geral. Criando caso de uso e atores Nesta etapa criaremos um diagrama, um ator, um caso de uso, uma associação entre eles e depois arrastaremos os elementos para os pacotes corretos. 1 Escolha aleatoriamente um dos pacotes dentro do pacote Visão de requisitos\requisitos funcionais, como por exemplo, Administração. 2 Com o botão direito do mouse no pacote escolhido, acionar Incluir Diagrama > Diagrama de Caso de Uso e o nomeie de Visão Geral. Este diagrama tem o objetivo de mostrar todos os casos de uso do pacote e o relacionamento deles com os atores. 3 Clicar duas vezes no diagrama criado para visualizá lo. Utilizando a paleta de elementos UML, adicionar um ator, um caso de uso e uma associação entre eles. Seu diagrama deverá ficar como abaixo. 4 Renomear o caso de uso para o caso de uso que deseja imitar, como por exemplo, Gestão de usuários. Para isso, basta clicar sobre ele no diagrama e começar a digitar o novo nome. Renomear o ator também, colocando o nome correto para o caso de uso escolhido. No caso da Gestão de usuários, ele se chama Gerente. 5 Aplicar os estereótipos corretos para o caso de uso e para o ator, assim como feito para o modelo (View Properties, aba Stereotypes). O caso de uso deve receber o estereótipo <<appusecase>> e o ator <<useractor>>. Ao final, seu diagrama deve ficar como o abaixo. 6 Agora, note que todos os elementos criados no diagrama estão, na árvore do projeto, no mesmo pacote que o diagrama. No entanto, cada elemento tem seu pacote correto. Nesse caso, o ator deve ser movido (arrastado) para o pacote Visão de requisitos\descrição geral\usuários e sistemas externos.

7 Criar um diagrama de Caso de uso no pacote onde o ator foi movido, chamado Visão Geral. Abra o diagrama criado e arraste o ator, da árvore do projeto, para o diagrama. Note que um mesmo elemento da árvore pode estar em mais de um diagrama do modelo, sem necessidade de duplicá lo. Isso é um erro muito comum dos alunos, que frequentemente duplicam o elemento na árvore. Obs: Nessa atividades não documentaremos os elementos UML, mas no trabalho prático, TODOS os elementos da UML em seu modelo, incluindo os pacotes, devem estar documentados. Isso é feito na visualização Propriedades, aba Documentação.

Criando os fluxos de casos de uso Uma das grandes modificações no Praxis 3.0 é a utilização de diagramas de atividade para modelar os fluxos de evento de um caso de uso. Na versão anterior, tudo era feito textualmente em um arquivo anexo ao caso de uso. Tomaremos aqui, como base, o caso de uso Gestão de usuários para realizar o tutorial, mas você pode fazer com qualquer outro. 1 No caso de uso que você criou na etapa anterior, clicar com o botão direito do mouse e acionar Incluir Diagrama > Diagrama de Atividade). Nomear a atividade recém criada dentro do caso de uso de Visão geral. Note que já é criado automaticamente dentro da atividade, um diagrama de atividades da UML. Renomeá lo para Visão Geral. 2 Criar todas as pré condições e pós condições do caso de uso escolhido. Para criá las clicar com o botão direito do mouse no caso de uso e acionar Incluir UML > Restrição. 3 Nomear as restrições criadas com os mesmos nomes do caso de uso de exemplo. No caso desse tutorial, Invocação e Consistência com a realidade. Por hora, seu caso de uso deverá ficar assim na árvore do modelo: 4 Colocar os estereótipos corretos nas restrições (<<precondition>> e <<postcondition>>). Invocação é <<precondition>> e Consistência com a realidade <<postcondition>>. 5 Para documentar restrições não o fazemos no campo Documentação como para os outros elementos. As restrições são documentadas na aba Geral, da visualização Propriedades. Abaixo ilustramos a documentação da Invocação (pré condição do caso de uso). Faça isso para as outras restrições que você criou.

6 Abrir o diagrama de atividades dentro da atividade Visão geral e arrastar as restrições para o diagrama. Por convenção, a pré condição fica na parte de cima do diagrama e as póscondições na parte de baixo. Seu diagrama deverá ficar como o abaixo. Vamos agora criar os fluxos de evento, que são representados por atividades com estereótipo apropriado. Para exemplificar, usaremos o fluxo alternativo Inclusão de novo usuário. 7 Clicar com o botão direito do mouse no caso de uso e acionar Incluir UML > Diagrama de Atividade, nomeando a para Inclusão de novo usuário. Renomear também o diagrama dentro da atividade para este mesmo nome. 8 Aplicar o estereótipo <<altflow>> na atividade que acabou de criar. 9 Adicionar duas Partições (raias) no diagrama do fluxo alternativo. Para isso basta arrastar o elemento da paleta para o diagrama dentro da atividade. 10 Uma das raias deverá ter o nome do produto e a outra o nome do ator do caso de uso. No caso do Merci, uma se chama Merci e a outra Gerente, que é o ator do caso de uso Gestão de usuários que estamos imitando. O seu diagrama deverá ficar como abaixo.

11 No caso da raia que representa o ator, devemos formalizar esse conceito. Para isso basta arrastar o ator correto da árvore do projeto e soltar sobre o nome da partição que possui o mesmo nome do ator. Note que o nome da raia mudou para Gerente:Gerente. 12 Utilizar os elementos da paleta e reproduzir o diagrama de atividades do fluxo de Inclusão de novo usuário. Você utilizará os elementos abaixo no caso desse fluxo. Inicial Final da Atividade Ação Fluxo 13 Criar uma restrição para o fluxo do caso de uso Inclusão de novo usuário. Estereotipá la com <<precondition>> e incluir sua documentação. Depois arrastar a restrição para o topo do diagrama. 13 Ao final, seu diagrama deverá ficar como abaixo.

14 Por fim, abrir o diagrama da atividade Visão Geral, arrastar o fluxo alternativo Inclusão de novo usuário) para dentro desse diagrama. Ao fazer isso, um novo elemento de UML é criado: CallBehaviorAction, que representa uma chamada ao comportamento da atividade (ou fluxo alternativo). Estereotipar esse CallBehaviorAction com o mesmo estereótipo da atividade que ele representa, ou seja, <<altflow>>. Ao final, seu diagrama ficará como abaixo:

Repetir os passos de 2 a 14 para outro fluxo do seu caso de uso. Criando as classes de análise e realizações dos casos de uso Como você já está um pouco familiarizado com o uso da ferramenta, diminuiremos o nível de detalhes do tutorial. Nessa etapa criaremos as classes de entidade, controle e fronteira que colaborarão para realizar as funcionalidades descritas nos diagramas de atividade. 1 No Pacote Visão de Análise > Estrutura > Administração, reproduzir os elementos que estão nesse mesmo pacote no Merci. São os pacotes Estoque e Usuários e dentro deles algumas classes (Incluir UML > Classe). 2 Aplicar os estereótipos corretos nas classes: <<boundary>>, que representam as telas do sistema, <<control>> que são classes que concentram as regras de negócio e lógicas mais complexas e <<persistententity>> que são as entidades que normalmente serão persistidas em banco de dados. 3 Alguns estereótipos do Praxis possuem atributos, como <<boundary>> e <<persistententity>>. Esses atributos devem sempre ser preenchidos. Para isso, vá na visualização Propriedades, aba Estereótipos e preencha os na tabela Propriedades do Estereótipo, como ilustrado abaixo. Para cada classe, criar também APENAS os atributos como no exemplo. NÃO criar as operações. 4 Crie também os diagramas do tipo Diagrama de Formulário Livre dentro desses pacotes e replique o conteúdo deles, criando as associações entre as classes através do diagrama. Como já temos nossas classes que colaborarão com troca de mensagens para realizar os fluxos dos casos de uso, vamos agora representar essa colaboração entre elas. 5 No pacote Visão de Análise\Realizações\Administração, crie uma colaboração (Incluir UML > Colaboração) e a nomeie como Gestão de usuários. Aplicar o estereótipo <<analysiscollaboration>> nela.

6 Crie um Diagrama de Formulário Livre nesse mesmo pacote, chamado visão geral. Nesse diagrama, arrastar a colaboração criada e o caso de uso que estamos modelando (nesse exemplo, Gestão de usuários). Criar uma dependência do tipo realização que sai da colaboração e aponta para o caso de uso. Esse tipo de dependência fica no grupo Classe, na paleta. Seu diagrama deverá ficar como abaixo. 7 O Praxis possui vários padrões para exibição dos elementos nos diagramas, que devem ser respeitados. No caso das colaborações, devem ser exibidos na forma icônica. Para isso, vá no diagrama, clique com o botão direito do mouse na colaboração e acione Filtros > Estilo de Estereótipo e Visibilidade > Estereótipo : Imagem de Forma, como mostra a figura abaixo. Por fim, vamos adicionar os atores, classes de entidade, fronteira e controle como atributos da colaboração, representando os participantes que realizam as funcionalidades do caso de uso. 8 No exemplo da gestão de usuários, criaremos 4 atributos com os nomes g, tru, tu e u, que representarão, respectivamente, Gerente (ator), Tratador de usuários (controle), Tela de usuários (fronteira) e Usuário (entidade persistente). Para fazer a associação entre o atributo da colaboração e o que ele representa, usar a visualização Propriedades, aba Geral e preencher o campo Tipo. Abaixo ilustramos o preenchimento do atributo u com a entidade Usuário.

Note que o atributo deve ser alterado para visibilidade pública (Public). Realizando os fluxos de evento do caso de uso Essa é a útlima etapa da análise no Modelo do Problema. O objetivo é mostrar como os atores, fronteiras (telas), controladores e entidades colaborarão para realizar cada um dos fluxos de evento. Essa é uma atividade muito parecida com a programação em uma linguagem, mas num nível mais alto de abstração. Tentaremos identificar quais as operações cada classe possuirá. As operações representam serviços (ou responsabilidades) de cada classe, no conceito de Orientação a Objetos. A realização, que no Praxis é modelada como interações, mostra como cada funcionalidade de um fluxo do caso de uso será realizado pelo sistema através de troca de mensagens (chamadas às operações) entre as classes. Para cada fluxo do caso de uso que estamos realizando, devemos criar uma Interação dentro da colaboração (criada na etapa anterior) com o mesmo estereótipo do fluxo de caso de uso que ela realiza. Dentro de cada Interação, criamos um diagrama de seqüência da UML. Nesse diagrama, cada classe participante é representado por uma raia. As setas entre as linhas de cada raia representam uma chamada de operação de uma classe para a outra. Reproduzir uma Interação do caso de uso que realizou, criando o diagrama de seqüência da mesma forma que no exemplo. NÃO COPIAR, para praticar o uso da ferramenta. Ao fim, um diagrama de seqüência de uma interação deverá ficar como o da figura abaixo, que ilustra a realização do fluxo alternativo Inclusão de novo usuário. Nesse diagrama, poderemos ver o ator (Gerente) enviando uma mensagem Novo para a Tela de Usuários. Ao criar essa mensagem, uma operação com o mesmo nome será criada na classe Tela de Usuários. No Praxis, uma mensagem do ator para a tela representa o clique de um botão.

Referências Todo este material é baseado naquele utilizado por Cássia Rodrigues de Carvalho F. Leite, em seu estágio de docência, 2º semestre de 2009 e no material elaborado por Vítor Alcântara Batista no curso de Especialização em Engenharia de Software do DCC/UFMG.