Creación de propiedades y pruebas de clase C #

En este tutorial, vamos a iniciar los inicios de una aplicación de tipo CRM ficticia. Un sistema de gestión de relaciones con los clientes simplemente realiza un seguimiento de los clientes y sus datos relacionados. Usaremos Visual Studio para crear una nueva clase de Cliente y luego definiremos las propiedades que necesitamos para un cliente. Estos incluirán cosas como el nombre, apellido, dirección de correo electrónico, etc. En el camino, agregaremos un proyecto de prueba a nuestra solución de estudio visual. En ese proyecto, crearemos una clase de prueba adjunta para la clase Cliente para asegurarnos de que funcione correctamente. Empecemos.

---

Agregar un nuevo proyecto

Para comenzar a construir nuestra nueva clase de Cliente, primero necesitamos un nuevo proyecto en Visual Studio. Podemos hacer clic en Archivo-> Nuevo-> Proyecto para abrir el asistente de nueva clase.

Una vez allí podemos elegir un nombre tanto para la solución como para el proyecto. El nombre del proyecto es CRMBIZ y la solución es simplemente CRM. CRMBIZ significa "Business Layer Manager Business Layer" y, por supuesto, CRM simplemente significa "Customer Relationship Manager".

Después de que se solucione todo esto, se nos da un nuevo archivo de clase para comenzar en el editor y el explorador de soluciones.

---

Construyendo una clase de cliente

Cambiemos el nombre de esa clase predeterminada a Customer.cs y creemos la clase como vemos a continuación. Nuestro objetivo aquí es crear una Clase que pueda representar a un cliente en nuestro sistema CRM. Podemos ver los siguientes miembros de la clase.

• apellido
• Apellido
• Nombre de pila
• Dirección de correo electrónico
• Identificación del cliente
• Nombre completo

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34

using System;   namespace CRMBIZ {     public class Customer     {         private string _lastName;         public string LastName         {             get             {                 return _lastName;             }             set             {                 _lastName = value;             }         }           public string FirstName { get; set; }           public string EmailAddress { get; set; }           public int CustomerId { get; private set; }           public string FullName         {             get             {                 return LastName + ", " + FirstName;             }         }     } }

---

Cree una prueba unitaria para la clase

Queremos asegurarnos de que nuestra clase funcione utilizando una prueba unitaria. Tiene sentido crear una nueva carpeta para contener el proyecto de prueba unitaria. Así que seguimos adelante y hacemos clic con el botón derecho en el nombre de la solución, luego elegimos Agregar-> Nueva carpeta de solución y lo llamamos Prueba.

Una vez que esté completo, podemos agregar un nuevo proyecto de prueba en la nueva carpeta de la solución. Haga clic derecho en la carpeta Prueba, luego elija Agregar-> Nuevo proyecto y elija la opción Prueba unitaria.

En nuestro caso lo llamamos CRMBIZ.Test. Puedes nombrar el tuyo como quieras. Para que el proyecto de prueba realmente pueda probar el código en nuestro proyecto principal, necesitamos hacer referencia a un ensamblado del proyecto principal. Esto se puede hacer haciendo clic derecho en el nodo Referencias del proyecto de prueba, luego eligiendo agregar la referencia al proyecto principal como vemos aquí.

---

Agregar métodos de prueba

En nuestro nuevo proyecto de prueba, podemos cambiar el nombre del archivo de prueba predeterminado a CustomerTest.cs. Nuestro objetivo es probar la clase Cliente en el proyecto, por lo que la convención es usar el nombre de la clase seguido de la palabra Prueba. Las pruebas siguen el mismo enfoque para cualquier situación.

• Configurar los datos
• Toma una acción
• Afirmar los resultados

Entonces eso es lo que hacemos a continuación. Primero, configuramos los datos creando un nuevo objeto Cliente. Este es un objeto real derivado de la clase que creamos anteriormente.

---

CustomerTest.cs

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25

using System; using Microsoft.VisualStudio.TestTools.UnitTesting;   namespace CRMBIZ.Test {     [TestClass]     public class CustomerTest     {         [TestMethod]         public void FullNameTestValid()         {             // Set up the data             Customer customer = new Customer();             customer.FirstName = "Heather";             customer.LastName = "Smith";             string expected = "Smith, Heather";               // Take an action             string actual = customer.FullName;               // Assert the results             Assert.AreEqual(expected, actual);         }     } }

¿Qué nos hace el código anterior? Vamos a examinar Primero, creamos un nuevo objeto de cliente.

---

Asignar datos a la propiedad FirstName.

---

Asignar datos a la propiedad LastName.

---

A continuación, configuramos los datos esperados que queremos ver después de acceder a la propiedad customer.FullName. Esto debería devolvernos el apellido, una coma, luego un espacio y finalmente el nombre del cliente.

---

Entonces estamos listos para tomar una acción. Accedemos a la propiedad FullName y almacenamos el resultado en la actualvariable.

---

Finalmente, podemos afirmar si esta condición es verdadera.

---

Cuando ejecutamos la prueba en el explorador de pruebas, ¡parece que está funcionando!

---

Fortaleciendo el Getter FullName

Ahora podemos modificar el getter en la clase Customer para FullName. Con el código actualizado a continuación, se agrega algo de lógica para determinar si se necesita o no una coma dependiendo de si solo tiene el primer nombre o solo el apellido.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43

using System;   namespace CRMBIZ {     public class Customer     {         private string _lastName;         public string LastName         {             get             {                 return _lastName;             }             set             {                 _lastName = value;             }         }           public string FirstName { get; set; }           public string EmailAddress { get; set; }           public int CustomerId { get; private set; }           public string FullName         {             get             {                 string fullName = LastName;                 if (!string.IsNullOrWhiteSpace(FirstName))                 {                     if (!string.IsNullOrWhiteSpace(fullName))                     {                         fullName += ", ";                     }                     fullName += FirstName;                 }                 return fullName;             }         }     } }

Ahora podemos probar mejor la clase. Podemos verificar si todas las propiedades funcionan como se esperaba.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55

using System; using Microsoft.VisualStudio.TestTools.UnitTesting;   namespace CRMBIZ.Test {     [TestClass]     public class CustomerTest     {         [TestMethod]         public void FullNameTestValid()         {             // Set up the data             Customer customer = new Customer();             customer.FirstName = "Heather";             customer.LastName = "Smith";             string expected = "Smith, Heather";               // Take an action             string actual = customer.FullName;               // Assert the results             Assert.AreEqual(expected, actual);         }           [TestMethod]         public void FullNameFirstNameEmpty()         {             //-- Arrange             Customer customer = new Customer();             customer.LastName = "Smith";             string expected = "Smith";               //-- Act             string actual = customer.FullName;               //-- Assert             Assert.AreEqual(expected, actual);         }           [TestMethod]         public void FullNameLastNameEmpty()         {             //-- Arrange             Customer customer = new Customer();             customer.FirstName = "Heather";             string expected = "Heather";               //-- Act             string actual = customer.FullName;               //-- Assert             Assert.AreEqual(expected, actual);         }     } }

La ejecución de todas las pruebas muestra que la clase parece estar funcionando muy bien.

---

Los objetos son tipos de referencia

Vimos en un tutorial anterior que en C #, los objetos son tipos de referencia . Recapitulando rápidamente, los tipos de referencia almacenan un puntero a sus datos. Los tipos de valor almacenan sus datos directamente. Este es un concepto importante. Esencialmente, puede tener múltiples variables que apuntan a los mismos datos cuando se usan tipos de referencia.

A continuación, utilizamos el static modificador en un nuevo miembro del Cliente, InstanceCount. El modificador estático declara que un miembro pertenece directamente a la clase, en lugar de a un objeto instanciado desde la clase. Por lo tanto, accede a un miembro estático utilizando el nombre de la clase, no la variable de objeto.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44

using System;   namespace CRMBIZ {     public class Customer     {         public static int InstanceCount { get; set; }         private string _lastName;         public string LastName         {             get             {                 return _lastName;             }             set             {                 _lastName = value;             }         }           public string FirstName { get; set; }           public string EmailAddress { get; set; }           public int CustomerId { get; private set; }           public string FullName         {             get             {                 string fullName = LastName;                 if (!string.IsNullOrWhiteSpace(FirstName))                 {                     if (!string.IsNullOrWhiteSpace(fullName))                     {                         fullName += ", ";                     }                     fullName += FirstName;                 }                 return fullName;             }         }     } }

---

Prueba de miembros estáticos

Probemos el concepto anterior. En el código actualizado a continuación, ahora tenemos un método de prueba llamado StaticTest(). La prueba crea tres nuevos objetos de cliente y los almacena en tres variables diferentes. Cada variable hace referencia a un objeto de cliente diferente. Observe lo que estamos haciendo después de cada asignación de un nombre a la propiedad FirstName en cada objeto de cliente. Estamos haciendo uso de ese InstanceCount estático de arriba para incrementar su valor cada vez que se crea un nuevo objeto y se le asigna un valor. Luego afirmamos que el recuento de referencia es tres como creemos que debería ser.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77

using System; using Microsoft.VisualStudio.TestTools.UnitTesting;   namespace CRMBIZ.Test {     [TestClass]     public class CustomerTest     {         [TestMethod]         public void FullNameTestValid()         {             // Set up the data             Customer customer = new Customer();             customer.FirstName = "Heather";             customer.LastName = "Smith";             string expected = "Smith, Heather";               // Take an action             string actual = customer.FullName;               // Assert the results             Assert.AreEqual(expected, actual);         }           [TestMethod]         public void FullNameFirstNameEmpty()         {             // Set up the data             Customer customer = new Customer();             customer.LastName = "Smith";             string expected = "Smith";               // Take an action             string actual = customer.FullName;               // Assert the results             Assert.AreEqual(expected, actual);         }           [TestMethod]         public void FullNameLastNameEmpty()         {             // Set up the data             Customer customer = new Customer();             customer.FirstName = "Heather";             string expected = "Heather";               // Take an action             string actual = customer.FullName;               // Assert the results             Assert.AreEqual(expected, actual);         }           [TestMethod]         public void StaticTest()         {             // Set up the data             var c1 = new Customer();             c1.FirstName = "Heather";             Customer.InstanceCount += 1;               var c2 = new Customer();             c2.FirstName = "Susan";             Customer.InstanceCount += 1;               var c3 = new Customer();             c3.FirstName = "Erica";             Customer.InstanceCount += 1;               // Take an action               // Assert the results             Assert.AreEqual(3, Customer.InstanceCount);         }     } }

¡Ejecutar el conjunto de pruebas muestra que las cosas todavía funcionan bastante bien!

---

Creación de propiedades de clase C # y resumen de pruebas

En este tutorial utilizamos Visual Studio para crear una nueva solución y proyecto para comenzar a crear una clase de Cliente para una aplicación de tipo CRM. A continuación, creamos la clase Customer, que como aprendimos antes, define un tipo. Cada vez que usa la palabra clave class en C # , está creando un tipo. Por defecto, una nueva clase agregada a un proyecto en Visual Studio no tiene modificador de acceso. Esto significa que si desea acceder a la clase desde otros componentes, deberá realizar un ajuste y agregar la public palabra clave a la clase. También tuvimos una idea del desarrollo impulsado por pruebas en C #, ya que creamos una clase de prueba adjunta a la clase Customer llamada CustomerTest.