Crear pruebas unitarias para aplicaciones de ASP.NET MVC (VB)

por Stephen Walther

Aprenda a crear pruebas unitarias para acciones de controlador. En este tutorial, Stephen Walther realiza una demostración de cómo probar si una acción del controlador devuelve una vista determinada, devuelve un conjunto determinado de datos o devuelve un tipo diferente de resultado de acción.

El objetivo de este tutorial es demostrar cómo puede escribir pruebas unitarias para los controladores en las aplicaciones de ASP.NET MVC. Se describe cómo crear tres tipos diferentes de pruebas unitarias. Aprenderá a probar la vista que devuelve una acción del controlador, a probar el elemento ViewData devuelto por una acción del controlador y a probar si una acción del controlador le redirecciona a una segunda acción del controlador.

Creación del controlador en Prueba

Para empezar, creemos el controlador que pretendemos probar. El controlador, denominado ProductController, se encuentra en la lista 1.

Lista 1: ProductController.vb

Public Class ProductController
     Inherits System.Web.Mvc.Controller

     Function Index()
          ' Add action logic here
          Throw New NotImplementedException()
     End Function

     Function Details(ByVal Id As Integer)
          Return View("Details")
     End Function
End Class

ProductController contiene dos métodos de acción denominados Index() y Details(). Ambos métodos de acción devuelven una vista. Observe que la acción Details() acepta un parámetro denominado Id.

Prueba de la vista devuelta por un controlador

Imagine que queremos probar si ProductController devuelve la vista correcta. Queremos asegurarnos de que cuando se invoca la acción ProductController.Details(), se devuelve la vista Detalles. La clase de prueba de la lista 2 contiene una prueba unitaria para probar la vista devuelta por la acción ProductController.Details().

Lista 2: ProductControllerTest.vb

Imports Microsoft.VisualStudio.TestTools.UnitTesting
Imports System.Web.Mvc
Imports Store

<TestClass()> Public Class ProductControllerTest
     <TestMethod()> Public Sub TestDetailsView()
          Dim controller As New ProductController()
          Dim result As ViewResult = controller.Details(2)
          Assert.AreEqual("Details", result.ViewName)

     End Sub
End Class

La clase de la lista 2 incluye un método de prueba denominado TestDetailsView(). Este método contiene tres líneas de código. La primera línea de código crea una instancia de la clase ProductController. La segunda línea de código invoca el método de acción Details() del controlador. Por su parte, la última línea de código comprueba si la vista que devuelve la acción Details() es la vista Detalles.

La propiedad ViewResult.ViewName representa el nombre de la vista devuelta por un controlador. Una gran advertencia sobre cómo probar esta propiedad. Hay dos formas en que un controlador puede devolver una vista. Un controlador puede devolver explícitamente una vista como esta:

Function Details(ByVal Id As Integer)
     Return View("Details")
End Function

Como alternativa, el nombre de la vista se puede deducir del nombre de la acción del controlador de la siguiente manera:

Function Details(ByVal Id As Integer)
     Return View()
End Function

Esta acción del controlador también devuelve una vista denominada Details. Sin embargo, el nombre de la vista se deduce del nombre de la acción. Si desea probar el nombre de la vista, debe devolver explícitamente el nombre de la vista de la acción del controlador.

Para ejecutar la prueba unitaria en la lista 2, escriba la combinación de teclas Ctrl-R, A, o bien haga clic en el botón Ejecutar todas las pruebas en la solución (vea la figura 1). Si la prueba arroja resultados satisfactorios, verá la ventana Resultados de pruebas en la figura 2.

Figura 01: Inserción de películas (haga clic para ver la imagen a tamaño completo)

Figura 02: Correcto (haga clic para ver la imagen a tamaño completo)

Prueba de los datos de vista devueltos por un controlador

Un controlador MVC pasa datos a una vista mediante algo denominado View Data. Por ejemplo, imagine que desea mostrar los detalles de un producto determinado al invocar la acción ProductController Details(). En ese caso, puede crear una instancia de una clase Product (definida en el modelo) y pasar la instancia a la vista Details aprovechando View Data.

La ProductController modificada de la lista 3 incluye una acción Details() actualizada que devuelve un producto.

Lista 3: ProductController.vb

Public Class ProductController
     Inherits System.Web.Mvc.Controller

     Function Index()
          ' Add action logic here
          Throw New NotImplementedException()
     End Function

     Function Details(ByVal Id As Integer)
          Dim product As New Product(Id, "Laptop")
          Return View("Details", product)
     End Function
End Class

En primer lugar, la acción Details() crea una instancia de la clase Product que representa un equipo portátil. A continuación, la instancia de la clase Product se pasa como segundo parámetro al método View().

Puede escribir pruebas unitarias para probar si los datos esperados se encuentran en los datos de vista. La prueba unitaria de la lista 4 comprueba si se devuelve un producto que representa un equipo portátil cuando se llama al método de acción ProductController Details().

Lista 4: ProductControllerTest.vb

Imports Microsoft.VisualStudio.TestTools.UnitTesting
Imports System.Web.Mvc
Imports Store

<TestClass()> Public Class ProductControllerTest

     <TestMethod()> Public Sub TestDetailsViewData()
          Dim controller As New ProductController()
          Dim result As ViewResult = controller.Details(2)
          Dim product As Product = result.ViewData.Model
          Assert.AreEqual("Laptop", product.Name)
     End Sub
End Class

En la lista 4, el método TestDetailsView() prueba los datos de vista devueltos, para lo que invoca el método Details(). ViewData se expone como una propiedad en el ViewResult devuelto invocando el método Details(). La propiedad ViewData.Model contiene el producto pasado a la vista. La prueba simplemente comprueba que el producto contenido en View Data tiene el nombre Laptop.

Prueba del resultado de la acción devuelto por un controlador

Una acción de controlador más compleja podría devolver diferentes tipos de resultados de acción en función de los valores de los parámetros pasados a la acción del controlador. Una acción del controlador puede devolver una variedad de tipos de resultados de acción, como ViewResult, RedirectToRouteResult o JsonResult.

Por ejemplo, la acción Details() modificada de la lista 5 devuelve la vista Details cuando se pasa un identificador de producto válido a la acción. Si pasa un identificador de producto no válido (un identificador con un valor inferior a 1), se le redirigirá a la acción Index().

Lista 5: ProductController.vb

Public Class ProductController
     Inherits System.Web.Mvc.Controller

     Function Index()
          ' Add action logic here
          Throw New NotImplementedException()
     End Function

     Function Details(ByVal Id As Integer)
          If Id < 1 Then
               Return RedirectToAction("Index")
          End If
          Dim product As New Product(Id, "Laptop")
          Return View("Details", product)
     End Function
End Class

Puede probar el comportamiento de la acción Details() con la prueba unitaria de la lista 6. La prueba unitaria de la lista 6 comprueba que se le redirecciona a la vista Index cuando se pasa un identificador con el valor -1 al método Details().

Lista 6: ProductControllerTest.vb

Imports Microsoft.VisualStudio.TestTools.UnitTesting
Imports System.Web.Mvc
Imports Store

<TestClass()> Public Class ProductControllerTest

     <TestMethod()> Public Sub TestDetailsRedirect()
          Dim controller As New ProductController()
          Dim result As RedirectToRouteResult = controller.Details(-1)
          Assert.AreEqual("Index", result.Values("action"))
     End Sub
End Class

Cuando se llama al método RedirectToAction() en una acción de controlador, esta devuelve RedirectToRouteResult. La prueba comprueba si RedirectToRouteResult redireccionará al usuario a una acción de controlador denominada Index.

Resumen

En este tutorial, ha aprendido a crear pruebas unitarias para acciones del controlador de MVC. En primer lugar, ha aprendido a comprobar si una acción de controlador devuelve la vista correcta. Ha aprendido a usar la propiedad ViewResult.ViewName para comprobar el nombre de una vista.

Luego, hemos examinado cómo puede probar el contenido de View Data. Ha aprendido a comprobar si el producto correcto se devolvió en View Data después de llamar a una acción del controlador.

Por último, hemos explicado cómo se puede probar si se devuelven distintos tipos de resultados de acción de una acción del controlador. Ha aprendido a probar si un controlador devuelve ViewResult o RedirectToRouteResult.

Anterior