Empezando con Windows Phone 7.1 (y XI) – Un repaso a MVVM y el formulario de Nuevo Lugar

Para terminar de cerrar la funcionalidad básica de la aplicación de “Mis Lugares Favoritos” es necesario proporcionar al usuario la posibilidad de dar de alta un nuevo lugar.

Para ello bastará con hacer un formulario sencillo donde el usuario pueda rellenar los campos mínimos del nuevo lugar (me apunto la posibilidad de sugerir lugares próximos a la posición actual). En gran medida este formulario podrá utilizarse para modificar lugares existentes también.

Antes de lanzarme a construir dicho formulario me gustaría repasar un poco el patrón Modelo Vista Vista-Modelo.

El Patrón Modelo Vista VistaModelo

image

Como se puede ver en la figura superior el patrón es muy parecido al Modelo Vista Presentación.

  1. Vista: Representa lo que el usuario ve en pantalla. Idealmente, el código que contiene es un constructor y una llamada a InitializeComponents. La vista conoce al componente VistaModelo (normalmente a través de su DataContext). Esto se hace, idealmente, a través de una interfaz que evite el acoplamiento. Normalmente la forma en que  la Vista conoce a la VistaModelo es mediante el DataBinding y mediante Comandos. Hemos visto ya algo del DataBinding y, espero, en este blog veremos algo sobre los comandos.
  2. VistaModelo: Envía notificaciones a la Vista. Para evitar acoplamiento y que la VistaModelo sepa nada de la Vista, las notificaciones se envían implementando la interfaz INotifyPropertyChanged o INotifyCollectionChanged. A su vez, conoce el Modelo ya que lo actualiza. En general se encarga de sincronizar el trabajo entre Modelo y Vista, transformando o validando el Modelo antes de proporcionárselo a la Vista.
  3. Modelo: Envía notificaciones a la VistaModelo, de nuevo mediante la interfaz INotifyPropertyChanged o INotifyCollectionChanged. El Modelo no “conoce” a ninguno de los demás componentes. Suele encapsular la lógica de negocio y los datos.

¿Cómo se comunican los componentes?

Por un lado tenemos la forma en que comunicamos que una propiedad o una colección ha cambiado. Para ello disponemos de las interfaces INotifyPropertyChanged e INotifyCollectionChanged.

Por otro lado, es muy común (y es la razón por la que escribo este post) que la vista deba comunicar a la VistaModelo que ha de realizar algún tipo de acción sobre el modelo (lo común es que sea a petición del usuario) como añadir un elemento al modelo, modificar o borrar uno existente, etc… Para ello se hace uso de los Commands.

Commands

Como decía, es normal que el usuario quiera realizar algún tipo de operación sobre el modelo. Para ello se hace uso de Comandos. Los comandos son una abstracción que permite asociar una operación a un control en la Vista. Encapsulan el código relacionado con la operación de forma que se facilita el desacoplamiento de su representación en la vista (un botón, un control para ordenar. Vaya, multitud de posibilidades…).

La VistaModelo puede implementar dichos comandos de varias formas, pero resumiento, expondrá objetos que implementen la interfaz ICommand. De esta forma, la manera en que la Vista interactúa con el comando definido en la VistaModelo puede definirse de manera declarativa, eliminando así la necesidad de escribir código.

Nada de todo esto es un invento de Microsoft. Se trata de, sencillamente, la aplicación de patrones de diseño existentes a una tecnología (Silverlight) de manera que pueda sacársele el mayor partido.

¿Por qué?

Bueno, como ya hemos dicho. La implementación de patrones de diseño no sólo permite aplicar soluciones ya probadas a problemas concretos. En este caso, mediante el desacoplamiento y evitando el solapamiento de responsabilidades dispondremos de un código más fácil de mantener y probar.

¿Qué componentes puedo cambiar y de qué forma afectan a los demás componentes? Bueno, como se deduce del diagrama de componentes, el más delicado es el Mdelo, ya que cambios en el mismo van a obligarme a cambiar la VistaModelo. A su vez, cambios en la VistaModelo, pueden obligarme a cambiar la Vista. Si el “conocimiento” que cada componente tiene sobre otro es a través de una interfaz, entonces evitaré que cambios en la implementación de un componente puedan llegar a afectar a otro.

Al lío.

Bien, todo esta parrafada previa era necesaria para poder realizar la pantalla de creación de nuevo Lugar. La razón es evidente: necesito montar un comando que permita crear un nuevo lugar.

Para ello vamos a modificar la interfaz que implementa mi VistaModelo y vamos a crear una nueva propiedad que devuelva una instancia de ICommand y que nos permita crear un nuevo lugar. Cualquier clase que implemente esta interfaz tiene a su cargo dos responsabilidades:

  1. Definir una función específica (el método ICommand.Execute)
  2. Definir el estado de un componente visual que, normalmente, será el encargado de lanzar dicha función (la propiedad ICommand.CanExecute)

Por ejemplo, un botón que nos permita crear un nuevo lugar estará o no habilitado dependiendo de la propiedad CanExecute y, cuando sea pulsado por el usuario, invocará el método Execute. Para cumplir religiosamente con el patrón MVVM, se implementa también un evento, CanExecuteChanged, que indica si la propiedad CanExecute ha cambiado de estado o no.

Para ello, voy a crear primero un método dentro de mi VistaModelo que me permita crear un nuevo lugar. Este método no será invocado directamente desde la vista, así que no estará presente en la interfaz de mi VistaModelo.

image

Por otro lado, imaginad que creo otro dos o tres comandos (por ejemplo, ActualizarLugar, BorrarLugar y CompartirLugar). Esto significaría crear los correspondientes métodos en la VistaModelo y otras tres clases que implementen ICommand.

La solución está en la red (en docenas de sitios la solución aportada es más o menos la misma) yo no voy a ser menos y voy a montar una clase que implemente ICommand y que, a la vez, me permita delegar fácilmente la lógica en la VistaModelo sin hacer que el número de clases en mi proyecto crezca de forma descontrolada.

   1: public class DelegateCommand : ICommand

   2: {

   3:     private Func<object, bool> _puedeEjecutarAccion;

   4:     private Action<object> _accion;

   5:  

   6:     public DelegateCommand(Action<object> accion)

   7:         : this(accion, null)

   8:     {

   9:     }

  10:  

  11:     public DelegateCommand(Action<object> accion, Func<object, bool> puedeEjecutarAccion)

  12:     {

  13:         if (accion == null)

  14:         {

  15:             throw new ArgumentNullException(Resources.Jdmveira_WindowsPhone_Util.AccionParameterNull);

  16:         }

  17:  

  18:         _accion = accion;

  19:         _puedeEjecutarAccion = puedeEjecutarAccion;

  20:     }

  21:  

  22:     public event EventHandler CanExecuteChanged;

  23:  

  24:     public bool CanExecute(object parameter)

  25:     {

  26:         bool result = false;

  27:  

  28:         if (_puedeEjecutarAccion != null)

  29:             result = _puedeEjecutarAccion(parameter);

  30:  

  31:         return result;

  32:     }

  33:  

  34:     public void Execute(object parameter)

  35:     {

  36:         _accion(parameter);

  37:     }

  38:  

  39:     public void RaiseCanExecuteChanged(EventArgs args)

  40:     {

  41:         if (CanExecuteChanged != null)

  42:             CanExecuteChanged(this, args);

  43:     }

  44: }

Si tengo que ponerle una pega a la clase que podéis ver arriba es que no es muy limpia la forma en que se comunica que la propiedad CanExecute ha cambiado. Como la clase DelegateCommand delega la funcionalidad en métodos externos, no tiene control sobre cuándo ha cambiado el valor de CanExecute así que ha de “confiar” en que la clase externa que lo utiliza se acordará de invocar el evento correspondiente. Mientras intento dar con una forma más limpia y completa tendrá que valer. ¿No?
 
Ahora queda preparar el comando desde la VistaModelo para que pueda ser invocado fácilmente desde la vista (utilizando DataBinding).
   1: public class MainViewModel : IMainViewModel

   2: {

   3:     #region Constantes

   4:  

   5:     private const string PropNameItems = "Items";

   6:     private DataHelper _dataHelper;

   7:     private CollectionViewSource _favoritos;

   8:     private ObservableCollection<MiLugar> _items;

   9:     private ICommand _comandoCrearLugar;

  10:  

  11:     #endregion Constantes

  12:  

  13:     #region Constructores

  14:  

  15:     public MainViewModel()

  16:     {

  17:         // Si estamos en modo diseño no tiene sentido cargar la base de datos

  18:         if (!DesignerProperties.IsInDesignTool)

  19:             _dataHelper = new DataHelper();

  20:  

  21:         _items = new ObservableCollection<MiLugar>();

  22:         _favoritos = new CollectionViewSource();

  23:         _comandoCrearLugar = new DelegateCommand(AccionCrearNuevoLugar, PuedeCrearNuevoLugar);

  24:  

  25:         ActualizarVistas();

  26:     }

  27:  

  28:     public ICommand CrearNuevoLugar    

  29:     {

  30:         get { return _comandoCrearLugar; }

  31:     }

  32:  

  33:     private void AccionCrearNuevoLugar(object nuevo)

  34:     {

  35:         throw new NotImplementedException();

  36:     }

  37:  

  38:     private bool PuedeCrearNuevoLugar(object nuevo)

  39:     {

  40:         throw new NotImplementedException();

  41:     }

  42:  

  43:     ...

Por último, habrá que ir creando una nueva interfaz para que el usuario introduzca los datos del nuevo lugar. Aprovecharé una nueva entrada en el blog para este tema, ya que parece un buen momento para sacar información de localización del usuario (al fin y al cabo podemos asumir que está dando de alta un nuevo lugar cuando se encuentra en el mismo… Probablemente).