Instruções passo a passo: desenvolvimento de teste antes da codificação com o recurso gerar com base no uso

Este tópico demonstra como usar o recurso Gerar do Uso, que oferece suporte ao desenvolvimento de test-first.

O primeiro desenvolvimento de teste é uma abordagem para o design de software na qual você primeiro escreve testes de unidade com base nas especificações do produto e, em seguida, grava o código-fonte necessário para fazer os testes terem êxito. O Visual Studio dá suporte ao desenvolvimento de teste primeiro gerando novos tipos e membros no código-fonte quando você os referencia pela primeira vez em seus casos de teste, antes que eles sejam definidos.

O Visual Studio gera os novos tipos e membros com interrupção mínima no fluxo de trabalho. Você pode criar stubs para tipos, métodos, propriedades, campos ou construtores sem deixar seu local atual no código. Quando você abre uma caixa de diálogo para especificar opções de geração de tipo, o foco retorna imediatamente para o arquivo aberto atual quando a caixa de diálogo é fechada.

O recurso Gerar com Base no Uso pode ser usado com estruturas de teste integradas ao Visual Studio. Neste tópico, o Microsoft Unit Testing Framework é demonstrado.

Observação

As instruções deste artigo ilustram a versão mais recente da experiência de desenvolvimento interativo (IDE) disponível no Visual Studio. Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário. Talvez você esteja usando uma versão diferente do Visual Studio ou configurações de ambiente diferentes. Para obter mais informações, consulte Personalizar o IDE.

Criar um projeto da Biblioteca de Classes do Windows e um projeto de teste

1. No C# ou no Visual Basic, crie um novo projeto da Biblioteca de Classes do Windows . Nomeie-o GFUDemo_VB ou GFUDemo_CS, dependendo de qual idioma você está usando.

2. No Gerenciador de Soluções, clique com o botão direito do mouse no ícone da solução na parte superior, escolha Adicionar>Novo Projeto.

3. Crie um novo projeto do Projeto de Teste de Unidade (.NET Framework ).

Adicionar uma referência ao projeto biblioteca de classes

1. No Gerenciador de Soluções, em seu projeto de teste de unidade, clique com o botão direito do mouse na entrada Referências e escolha Adicionar Referência.

2. Na caixa de diálogo Gerenciador de Referência , selecione Projetos e selecione o projeto da biblioteca de classes.

3. Escolha OK para fechar a caixa de diálogo Gerenciador de Referência .

4. Salve sua solução. Agora você está pronto para começar a escrever testes.

Gerar uma nova classe a partir de um teste de unidade

1. O projeto de teste contém um arquivo chamado UnitTest1. Clique duas vezes neste arquivo no Gerenciador de Soluções para abri-lo no editor de código. Uma classe de teste e um método de teste foram gerados.

2. Localize a declaração da classe UnitTest1 e renomeie-a para AutomobileTest.

   Observação

   O IntelliSense agora fornece duas alternativas para a conclusão da instrução IntelliSense: modo de conclusão e modo de sugestão. Use o modo de sugestão para situações em que classes e membros são usados antes de serem definidos. Quando uma janela do IntelliSense está aberta, você pode pressionar Ctrl+Alt+Space para alternar entre o modo de conclusão e o modo de sugestão. Consulte Usar o IntelliSense para obter mais informações. O modo de sugestão ajudará quando você estiver digitando Automobile na próxima etapa.

3. Localize o método e renomeie-o TestMethod1() para DefaultAutomobileIsInitializedCorrectly(). Dentro desse método, crie uma nova instância de uma classe nomeada Automobile, conforme mostrado nas capturas de tela a seguir. Um sublinhado ondulado é exibido, indicando um erro em tempo de compilação e uma lâmpada de erro de Ações Rápidas aparece na margem esquerda ou diretamente abaixo do rabisco, se você passa o mouse sobre ele.

   

   

4. Escolha ou clique na lâmpada Ações Rápidas . Você verá uma mensagem de erro informando que o tipo Automobile não está definido. Você também recebe algumas soluções.

5. Clique em Gerar novo tipo para abrir a caixa de diálogo Gerar Tipo . Essa caixa de diálogo fornece opções que incluem a geração do tipo em um projeto diferente.

6. Na lista Projeto , clique em GFUDemo_VB ou GFUDemo_CS para instruir o Visual Studio a adicionar o arquivo ao projeto da biblioteca de classes em vez do projeto de teste. Se ainda não estiver selecionado, escolha Criar novo arquivo e nomeie-o Automobile.cs ou Automobile.vb.

   

7. Clique em OK para fechar a caixa de diálogo e criar o novo arquivo.

8. No Gerenciador de Soluções, procure no nó de projeto GFUDemo_VB ou GFUDemo_CS para verificar se o novo arquivo Automobile.vb ou Automobile.cs está lá. No editor de código, o foco ainda está em AutomobileTest.DefaultAutomobileIsInitializedCorrectly, o que permite que você continue gravando seu teste com um mínimo de interrupção.

Gerar um stub de propriedade

Suponha que a especificação do produto indica que a Automobile classe tem duas propriedades públicas nomeadas Model e TopSpeed. Essas propriedades devem ser inicializadas com valores padrão de "Not specified" e -1 pelo construtor padrão. O teste de unidade a seguir verificará se o construtor padrão define as propriedades como seus valores padrão corretos.

1. Adicione a seguinte linha de código ao DefaultAutomobileIsInitializedCorrectly método de teste.

   C#

   Assert.IsTrue((myAuto.Model == "Not specified") && (myAuto.TopSpeed == -1));
   

   VB

   Assert.IsTrue((myAuto.Model = "Not specified") And (myAuto.TopSpeed = -1))
   

2. Como o código faz referência a duas propriedades indefinidas em Automobile, uma linha ondulada aparece sob Model e TopSpeed. Passe o mouse sobre Model, escolha a lâmpada de erro Ações Rápidas e, em seguida, escolha Gerar propriedade 'Automobile.Model'.

3. Gere um stub de propriedade para a propriedade TopSpeed da mesma maneira.

   Automobile Na classe, os tipos das novas propriedades são inferidos corretamente do contexto.

Gerar um stub para um novo construtor

Agora, criaremos um método de teste que gerará um stub de construtor para inicializar as propriedades Model e TopSpeed. Posteriormente, você adicionará mais código para concluir o teste.

1. Adicione o seguinte método de teste adicional à sua AutomobileTest classe.

   C#

   [TestMethod]
   public void AutomobileWithModelNameCanStart()
   {
       string model = "Contoso";
       int topSpeed = 199;
       Automobile myAuto = new Automobile(model, topSpeed);
   }
   

   VB

   <TestMethod()> Public Sub AutomobileWithModelNameCanStart()
       Dim model As String = "Contoso"
       Dim topSpeed As Integer = 199
       Dim myAuto As New Automobile(model, topSpeed)
   End Sub
   

2. Clique na lâmpada de erro Ações Rápidas sob a linha ondulada vermelha e, em seguida, clique em Gerar construtor em 'Automobile'.

   No arquivo da classe Automobile, observe que o novo construtor examinou os nomes das variáveis locais que são usadas na chamada do construtor, encontrou propriedades que têm os mesmos nomes na classe Automobile e incluiu código no corpo do construtor para armazenar os valores de argumento nas propriedades Model e TopSpeed.

3. Depois de gerar o novo construtor, um sublinhado ondulado aparece sob a chamada para o construtor padrão em DefaultAutomobileIsInitializedCorrectly. A mensagem de erro afirma que a classe Automobile não possui um construtor que aceite zero argumentos. Para gerar um construtor padrão explícito que não tenha parâmetros, clique na lâmpada de erro ações rápidas e clique em Gerar construtor em 'Automóvel'.

Gerar um stub para um método

Suponha que a especificação indica que um novo Automobile pode ser colocado em um IsRunning estado se suas Model propriedades e TopSpeed propriedades forem definidas como algo diferente dos valores padrão.

1. Adicione as linhas a seguir ao AutomobileWithModelNameCanStart método.

   C#

   myAuto.Start();
   Assert.IsTrue(myAuto.IsRunning == true);
   

   VB

   myAuto.Start()
   Assert.IsTrue(myAuto.IsRunning = True)
   

2. Clique na lâmpada de erro de Ações Rápidas para a chamada do método myAuto.Start e clique em Gerar método 'Automobile.Start'.

3. Clique na lâmpada Ações Rápidas referente à propriedade IsRunning e clique em Gerar a propriedade 'Automobile.IsRunning'.

   A Automobile classe agora contém um método chamado Start() e uma propriedade chamada IsRunning.

Executar os testes

1. No menu Teste , escolha Executar>Todos os Testes.

   O comando Executar>Todos os Testes executa todos os testes em quaisquer estruturas de teste gravadas para a solução atual. Nesse caso, há dois testes e ambos falham, conforme o esperado. O DefaultAutomobileIsInitializedCorrectly teste falha porque a Assert.IsTrue condição retorna False. O AutomobileWithModelNameCanStart teste falha porque o Start método na Automobile classe gera uma exceção.

   A janela Resultados do Teste é mostrada na ilustração a seguir.

   

2. Na janela Resultados do Teste , clique duas vezes em cada linha de resultado do teste para ir para o local de cada teste.

Implementar o código-fonte

1. Adicione o código a seguir ao construtor padrão para que as propriedades Model, TopSpeed e IsRunning sejam todas inicializadas para seus valores padrão corretos de "Not specified", -1 e False (ou false para C#).

   C#

   public Automobile()
   {
       this.Model = "Not specified";
       this.TopSpeed = -1;
       this.IsRunning = true;
   }
   

   VB

   Sub New()
       Model = "Not specified"
       TopSpeed = -1
       IsRunning = True
   End Sub
   

2. Quando o método Start é chamado, ele deve definir o sinalizador IsRunning como true somente se as propriedades Model ou TopSpeed forem definidas como algo diferente de seu valor padrão. Remova o NotImplementedException do corpo do método e adicione o código a seguir.

   C#

   public void Start()
   {
       if (this.Model != "Not specified" || this.TopSpeed != -1)
           this.IsRunning = true;
       else
           this.IsRunning = false;
   }
   

   VB

   Sub Start()
       If Model <> "Not specified" Or TopSpeed <> -1 Then
           IsRunning = True
       Else
           IsRunning = False
       End If
   End Sub
   

Executar os testes novamente

• No menu Teste , aponte para Executar e clique em Todos os Testes.

  Desta vez, os testes são aprovados. A janela Resultados do Teste é mostrada na ilustração a seguir.

  

Conteúdo relacionado

• Gerar com base no uso
• Características do editor de código
• Usar o IntelliSense
• Realizar teste de unidade do seu código
• Ações Rápidas