Empezando con Windows Phone 7.1 (y XX)– Accediendo al DataSource desde un ListBoxItem

Trabajando en un escenario muy común me he encontrado con un pequeño problema. Veamos cuál es el asunto.

El Problema

El escenario es relativamente simple. Se trata de una página con un ListBox que presenta lugares (Venues) proporcionados por FourSquare.

image

Nada especialmente complicado. Vamos a echarle un vistazo al XAML asociado a la página (bueno, no vamos a mirarlo todo, que es un rollo. Vamos a lo más relevante).

   1: <phone:PhoneApplicationPage x:Class="Lcdad.SquareMatrix.Pages.MainPage"

   2:                             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

   3:                             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

   4:                             xmlns:phone="clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone"

   5:                             xmlns:shell="clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone"

   6:                             xmlns:d="http://schemas.microsoft.com/expression/blend/2008"

   7:                             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"

   8:                             xmlns:i="clr-namespace:System.Windows.Interactivity;assembly=System.Windows.Interactivity"

   9:                             xmlns:c4f="clr-namespace:Coding4Fun.Phone.Controls;assembly=Coding4Fun.Phone.Controls"

  10:                             xmlns:toolkit="clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Toolkit"

  11:                             mc:Ignorable="d"

  12:                             d:DesignWidth="480"

  13:                             d:DesignHeight="696"

  14:                             FontFamily="{StaticResource PhoneFontFamilyNormal}"

  15:                             FontSize="{StaticResource PhoneFontSizeNormal}"

  16:                             Foreground="{StaticResource PhoneForegroundBrush}"

  17:                             SupportedOrientations="PortraitOrLandscape"

  18:                             Orientation="Portrait"

  19:                             shell:SystemTray.IsVisible="True"

  20:                             DataContext="{Binding Main, Source={StaticResource Locator}}">

  21:  

  22:     <Grid x:Name="LayoutRoot"

  23:           Background="Transparent">

  24:         <Grid.RowDefinitions>

  25:             <RowDefinition Height="Auto" />

  26:             <RowDefinition Height="*" />

  27:         </Grid.RowDefinitions>

  28:  

  29:         <!--TitlePanel contains the name of the application and page title-->

  30:         <Grid x:Name="ContentPanel"

  31:               Grid.Row="1"

  32:               Margin="12,0,12,0">

  33:             

  34:             <ListBox x:Name="ListaLugares" ItemsSource="{Binding Path=Lugares}">

  35:                 <ListBox.ItemTemplate>

  36:                     <DataTemplate>

  37:                         <StackPanel>

  38:                             <Grid x:Name="ItemGrid">

  39:                                 <Grid.ColumnDefinitions>

  40:                                     <ColumnDefinition Width="6" />

  41:                                     <ColumnDefinition Width="*" />

  42:                                 </Grid.ColumnDefinitions>

  43:                                 

  44:                                 <c4f:Tile x:Name="TileSeleccionar" Grid.Column="1" Margin="0,6,6,0" Width="6" />

  45:                                 <TextBlock x:Name="TextoLugar" Grid.Column="3" Text="{Binding Path=name}" />

  46:                             </Grid>

  47:  

  48:                             <toolkit:ContextMenuService.ContextMenu>

  49:                                 <toolkit:ContextMenu x:Name="MenuCheckin">

  50:                                     <toolkit:MenuItem 

  51:                                         x:Name="OpcionCheckin" 

  52:                                         Header="{Binding Source={StaticResource LocationHelper}, 

  53:                                         Path=Recursos.OpcionCheckin}", 

  54:                                         Command=""></toolkit:MenuItem>

  55:                                 </toolkit:ContextMenu>

  56:                             </toolkit:ContextMenuService.ContextMenu>

  57:                         </StackPanel>

  58:                     </DataTemplate>

  59:                 </ListBox.ItemTemplate>

  60:             </ListBox>

  61:         </Grid>

  62:     </Grid>

  63: </phone:PhoneApplicationPage>

Se trata de mostrar una lista de lugares “venues” proporcionados por Four Square, una vez disponemos de los lugares más cercanos a la actual posición, debemos de seleccionar uno para poder hacer check-in sobre el mismo.

Para ello he incluido un control “ContextMenu” incluido en el paquete SilverlightToolkitWP (lo he bajado mediante NuGet). El mecanismo es indiferente, el quid de la cuestión está en las siguientes líneas.

   1: <ListBox x:Name="ListaLugares" ItemsSource="{Binding Path=Lugares}">

   2:     <ListBox.ItemTemplate>

   3:         <DataTemplate>

   4:             <StackPanel>

   5:                 <Grid x:Name="ItemGrid">

   6:                     <Grid.ColumnDefinitions>

   7:                         <ColumnDefinition Width="6" />

   8:                         <ColumnDefinition Width="auto" />

   9:                         <ColumnDefinition Width="*" />

  10:                     </Grid.ColumnDefinitions>

  11:                     

  12:                     <c4f:Tile x:Name="TileSeleccionar" Grid.Column="1" Margin="0,6,6,0" Width="6" />

  13:                     <TextBlock x:Name="TextoLugar" Grid.Column="3" Text="{Binding Path=name}" FontSize="{StaticResource PhoneFontSizeLarge}"/>

  14:                 </Grid>

  15:  

  16:                 <toolkit:ContextMenuService.ContextMenu>

  17:                     <toolkit:ContextMenu x:Name="MenuCheckin">

  18:                         <toolkit:MenuItem 

  19:                             x:Name="OpcionCheckin" 

  20:                             Header="{Binding Source={StaticResource LocationHelper}, 

  21:                             Path=Recursos.OpcionCheckin}"

  22:                             Command={}></toolkit:MenuItem>

  23:                     </toolkit:ContextMenu>

  24:                 </toolkit:ContextMenuService.ContextMenu>

  25:             </StackPanel>

  26:         </DataTemplate>

  27:     </ListBox.ItemTemplate>

  28: </ListBox>

Como podéis ver, el comando asociado al elemento del menú contextual no tiene asociado ninguna propiedad en la vista-modelo. La razón es la siguiente: La página tiene asociada la Vista-Modelo como contexto de datos (accede a ella mediante la propiedad Main del ViewModelLocator).

El ListBox tiene asociado, a su vez, una colección de elementos como contexto de datos. Esta colección es una propiedad de la Vista-Modelo llamada Lugares.

El problema es que queremos acceder a un comando de la VistaModelo desde un elemento ubicado en el interior del ListBox (dentro del DataTemplate) y no lo conseguimos. Pensando en el tema, cometí uno de los errores que últimamente me veo cometiendo con demasiada frecuencia: me voy a buscar la solución antes de pensarla yo mismo. Pude ver un post que os indico aquí para vuestra referencia y que resulta interesante por la idea que explora. Se trata de un Proxy para el DataSource. De forma resumida: creamos un objeto que hereda de FrameworkElement y que expone el DataSource del control padre, de esta forma podemos acceder al DataSource de la página a través del DataSource del ListBox.

La Solución

Sin embargo, voy a proponer una solución más sencilla (la verdad es que mucho más sencilla).

Haciendo uso del MVVM Light disponemos de una clase encargada de proporcionar acceso a cada una de las vistas. ¿No es así?

Efectivamente, el ViewModelLocator.

Bueno, pues ya está. Simplemente, cambiamos el binding para acceder a la VistaModelo de la siguiente manera.

   1: <toolkit:ContextMenuService.ContextMenu>

   2:     <toolkit:ContextMenu x:Name="MenuCheckin">

   3:         <toolkit:MenuItem 

   4:             x:Name="OpcionCheckin" 

   5:             Header="{Binding Source={StaticResource LocationHelper}, 

   6:             Path=Recursos.OpcionCheckin}" 

   7:             Command="{Binding Source={StaticResource Locator}, Path=Main.RealizarCheckin}">

   8:         </toolkit:MenuItem>

   9:     </toolkit:ContextMenu>

  10: </toolkit:ContextMenuService.ContextMenu>

Quizá no sea muy limpio, pero desde luego es mucho más sencillo.

Anuncios

Empezando con Windows Phone 7.1 (y XIII) – Creando una nueva vista. Navegación entre páginas.

¡El horror, oh el horror!

En el anterior post nos quedamos con una forma de crear un nuevo lugar un tanto deleznable.

image

Así pues, creo que lo mejor es hacer que la nueva interfaz aproveche la barra de aplicación de Windows Phone.

Aplicando algunos cambios.

Para ello, he realizado algunos cambios en la aplicación. He creado una carpeta en la solución donde podré organizar más fácilmente las páginas y he movido la página principal a dicha carpeta.

image

Esto me ha obligado a realizar algunos cambios menores en el código.

En el manifiesto de la aplilcación

image

En el cual se indica la página de inicio para la aplicación, he cambiado la ruta.

 1: <Tasks>

 2:     <DefaultTask

 3:         Name="_default"

 4:         NavigationPage="/Pages/MainPage.xaml" />

 5: </Tasks>

Y, en la propia página, he cambiado la url relativa a las imágenes.

 1: <controls:Panorama.Background>

 2:     <ImageBrush

 3:         ImageSource="../Resources/images/Panorama%20Green.png"/>

 4: </controls:Panorama.Background>

Ahora vamos a realizar algunos cambios en la página principal. De momento eliminaremos el PanoramaItem que estaba destinado a contener los controles para crear un nuevo lugar y añadiremos la posibilidad de crear un nuevo lugar desde cualquier punto de la página principal. Para ello, vamos a crear una ApplicationBar en la página principal.

 1: <phone:PhoneApplicationPage.ApplicationBar>

 2:     <shell:ApplicationBar

 3:             Mode="Minimized"

 4:             IsMenuEnabled="False"

 5:             Opacity="0.7">

 6:

 7:         <shell:ApplicationBarIconButton

 8:             x:Name="NuevoLugarButton"

 9:             IconUri="/Resources/icons/Add%20New%20Place.png"

 10:             Text="Nuevo Lugar" />

 11:     </shell:ApplicationBar>

 12: </phone:PhoneApplicationPage.ApplicationBar>

Esto nos permite disponer de una barra de aplicaciones que no siempre estará visible, de esta forma aprovecharemos al máximo el espacio vertical.

Asignando Acciones a los botones de la ApplicationBar

Maldición. El primer problema que me he encontrado es. ¿Cómo puedo utilizar Comandos con los botones de la Application Bar para aprovecharme del patrón visto antes en MVVM? El control dispone de una propiedad Click que te permite asignar código en el “Code Behind” de la Vista, pero no de la VistaModelo como vimos en el anterior post (mediante Binding).

El otro problema es. ¿Cómo puedo asignar al texto del botón una entrada de mi fichero de recursos? Ni con Visual Studio ni con Blend me permite hacer uso de mi clase para manejar los recursos de la aplicación.

Proporcionando soporte multi-idioma y comandos en un ApplicationBarIconButton

¿Queréis la respuesta rápida?

No es posible sin cierta cantidad de esfuerzo ya que la barra de aplicación no es un componente Silverlight. Se trata de un objeto controlado por el Shell de Windows Phone, con lo que no aplican las mismas reglas que a cualquier otro control que incluyas en tu aplicación.

Confused smile

Resumiento la situación actual

En fin, algo que parecía bastante trivial se está convirtiendo en un pequeño problema:

  1. La barra de aplicación no es un control Silverlight, con lo que trabajar con la misma haciendo uso del patrón MVVM resulta complicado (recordad que la idea es evitar, en la medida de lo posible) tocar el Code Behind de la página.
  2. La navegación se realiza mediante la clase NavigationService que está accesible desde la propia págia como una propiedad.
  3. Desde la VistaModelo deberíamos de evitar instanciar nuevas clases que nos introduzcan dependencias (si tienes la palabra clave “new” en tu código lo mejor que puedes hacer es revisar el código). Un patrón como IoC viene aquí que ni al pelo.
  4. Crear una nueva vista y asociar correctamente su VistaModelo de forma flexible.

Siguientes Pasos

Si bien es perfectamente posible realizar todas las tareas descritas en el punto anterior (con mayor o menor esfuerzo). Este es un buen momento para hacer un alto en el camino y revisar algunas opciones que nos ayudarán con el Modelo Vista Vista Modelo y proseguir con el desarrollo apoyándonos en alguno de los siguientes Frameworks.

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).

Empezando con Windows Phone 7.1 (y X) – Haciendo DataBinding sobre Colecciones

Tres modos de ver Mis Lugares

Como habéis visto, mi intención es que el control Panorama disponga de varias vistas sobre la misma colección de datos (Items).

El siguiente esquema muestra las clases que estoy utilizando en la capa de presentación.

Mis Lugares Favoritos: Clases MVVM
Mis Lugares Favoritos: Clases MVVM

Si le echáis un vistazo a la interfaz que declaro hay varias propiedades públicas que hacen referencia a diferentes filtros que voy a utilizar a la hora de mostrar mi conjunto de datos (Mis Lugares de Interés):

  • Items: Colección observable (ObservableCollection<T>) que contiene los lugares de interés del usuario.
  • Favoritos: Colección observable de aquellos lugares de interés que están marcados como favoritos.
  • Recientes: Colección observable de aquellos lugares de interés que se han creado recientemente.
  • Cercanos: Colección observable de aquellos lugares de interés que se encuentran próximos a la ubicación actual del usuario.

Como podéis ver, se trata de una coleccíon padre y diferentes subconjuntos de dicha colección. Uno podría suponer que algo así no nos debería de provocar demasiados problemas. Pongamos un ejemplo:

 1: public class MainViewModel: IMainViewModel {

 2:

 3:     public MainViewModel() {

 4:         Items = new ObservableCollection<MiLugar> ();

 5:     }

 6:

 7:     /// <summary>

 8:     /// La colección principal de lugares

 9:     /// </summary>

 10:     public ObservableCollection<MiLugar> Items { get; private set; }

 11:

 12:     /// <summary>

 13:     /// Filtra la colección principal por la propiedad Favorito

 14:     /// </summary>

 15:     public ObservableCollection<MiLugar> Favoritos {

 16:         get {

 17:

 18:             var result = from i en Items

 19:                          where i.Favorito == true

 20:                          select i;

 21:

 22:             return new ObservableCollection<MiLugar> (result);

 23:         }

 24:     }

 25:

 26:     /// <summary>

 27:     /// Ordena la colección principal mostrando primero los lugares más recientes

 28:     /// </summary>

 29:     public ObservableCollection<MiLugar> Recientes {

 30:         get {

 31:

 32:             var result = from i en Items

 33:                          orderby i.Creado descending

 34:                          select i;

 35:

 36:             return new ObservableCollection<MiLugar> (result);

 37:         }

 38:     }

 39:

 40:     /// <summary>

 41:     /// Ordena la colección principal mostrando primero los lugares más cercanos

 42:     /// </summary>

 43:     public ObservableCollection<MiLugar> Cercanos {

 44:         get {

 45:

 46:             // TODO: Mmmm... Aquí hay trabajo por hacer para ver cómo averiguamos los más "cercanos". De momento devolveremos todo

 47:             var result = from i en Items

 48:                          select i;

 49:

 50:             return new ObservableCollection<MiLugar> (result);

 51:         }

 52:     }

 53: }

Parece que no va a ser tan fácil

Una colección principal, dos o tres consultas Linq y devolvemos el resultado. ¿Sencillo, no?

Pues me temo que, además, completamente inútil: el código que veis arriba no nos sirve. En cualquier caso, dejad que os cuente alguna cosilla sobre el DataBinding y el ObservableCollection<T>. Cuando la página se carga, la infraestructura de DataBinding se subscribe a cambios en las colecciones. La idea es buena: mi vista expone unas pocas colecciones de datos que implementan el patrón Observable (no confundir con el patrón Observer), cuando cargo mis vistas con datos filtrados, la infraestructura de DataBinding se da cuenta y voilá, muestra automáticamente los datos actualizados. Lástima que, cada vez que realizo un filtrado de datos creo una nueva colección observable. La infraestructura de DataBinding estaba suscrita a los cambios de la anterior, con lo que no será capaz de darse cuenta de que ha habido cambios.

¿Qué puedo hacer que no sea extremadamente ineficiente? (Como vaciar la colección inicial e ir llenándola con los datos filtrados, que provocaría una notificación de cambio para el borrado y una nueva notificación por cada elemento nuevo que insertara)

CollectionViewSource al rescate

Pues existe un tipo que nos puede resultar de mucha ayuda en este aspecto: CollectionViewSource. Esta clase actúa como proxy que muestra vistas de una colección permitiendo Filtros, Ordenaciones y Agrupaciones.

Una forma de hacer uso de este control, muy cómoda todo sea dicho, pero no me termina de convencer desde el punto de vista de patrones de diseño (aunque todo es discutible).

Como habéis podido ver más arriba, mi ModelView expone una propiedad que representa la colección de todos “Mis Lugares”. Exponiendo tan solo esta colección, puedo montar todos los CollectionViewSource que quiera en la vista de manera declarativa. Veamos un ejemplo (he eliminado mucho código para centrarnos en lo importante)

 1: <phone:PhoneApplicationPage

 2:

 3:     xmlns:compMod="clr-namespace:System.ComponentModel;assembly=System.Windows"

 4:

 5:     <phone:PhoneApplicationPage.Resources>

 6:         <CollectionViewSource x:Key="filtroRecientes" Source="{Binding Path=Items}">

 7:             <CollectionViewSource.SortDescriptions>

 8:                 <compMod:SortDescription PropertyName="Modificado" Direction="Descending"></compMod:SortDescription>

 9:             </CollectionViewSource.SortDescriptions>

 10:         </CollectionViewSource>

 11:     </phone:PhoneApplicationPage.Resources>

 12:

 13:         <!--LayoutRoot is the root grid where all page content is placed-->

 14:      <Grid x:Name="LayoutRoot" Background="Transparent">

 15:         <!--Panorama control-->

 16:         <controls:Panorama Title="{Binding Source={StaticResource LocalizationHelper}, Path=LocalizedResources.TituloPanorama}" Foreground="{StaticResource PhoneTextBoxForegroundBrush}" >

 17:             <controls:Panorama.Background>

 18:                 <ImageBrush ImageSource="Resources/images/Panorama Green.png"/>

 19:             </controls:Panorama.Background>

 20:

 21:             <controls:PanoramaItem Header="{Binding Source={StaticResource LocalizationHelper}, Path=LocalizedResources.TituloTodos}" Orientation="Horizontal">

 22:                 <ListBox ItemsSource="{Binding Path=Items}" Foreground="{StaticResource PhoneTextBoxForegroundBrush}" />

 23:             </controls:PanoramaItem>

 24:

 25:             <controls:PanoramaItem Header="{Binding Source={StaticResource LocalizationHelper}, Path=LocalizedResources.TituloRecientes}" Orientation="Horizontal">

 26:                 <ListBox ItemsSource="{Binding Source={StaticResource filtroRecientes}}" Foreground="{StaticResource PhoneTextBoxForegroundBrush}" />

 27:             </controls:PanoramaItem>

 28:         </controls:Panorama>

 29:     </Grid>

 30: </phone:PhoneApplicationPage>

Lo primero de todo, he incluido una referencia al espacio de nombres System.ComponentModel. A continuación, he creado un nuevo recurso que será mi CollectionViewSource. Como podéis ver, dicha vista apunta a la propiedad Items en mi ModelView e incluye la descripción de una ordenación basada en una propiedad de mi Modelo, concretamente la propiedad Modificado que indica la fecha de la última modificación de los datos de un lugar.

 

image
Modelo MiLugar: Representa un Lugar de Interés

A continuación, el ListBox incluido dentro del PanoramaItem que muestra los lugares recientes. Simplemente tiene como fuente de datos el CollectionViewSource que acabamos de crear.

Sin embargo, no es ésta la forma en la que más me gusta hacer uso de este componente. Parece más adecuado exponer el CollectionViewSource como una propiedad más del ModelView.

 1: public class MainViewModel : IMainViewModel

 2: {

 3:     #region Miembros privados

 4:

 5:     private ObservableCollection<MiLugar> _items;

 6:     private CollectionViewSource _favoritos;

 7:     #endregion

 8:

 9:     #region Propiedades Públicas

 10:

 11:     /// <summary>

 12:     /// Una colección de lugares

 13:     /// </summary>

 14:     public ObservableCollection<MiLugar> Items

 15:     {

 16:         get { return _items; }

 17:         private set

 18:         {

 19:             if (_items != value)

 20:             {

 21:                 _items = value;

 22:                 NotifyPropertyChanged(PropNameItems);

 23:

 24:                 ActualizarVistas();

 25:             }

 26:         }

 27:     }

 28:

 29:

 30:     /// <summary>

 31:     /// Un subconjunto de lugares favoritos

 32:     /// </summary>

 33:     public CollectionViewSource Favoritos

 34:     {

 35:         get { return _favoritos; }

 36:     }

 37:     #endregion

 38:

 39:     /// <summary>

 40:     /// Actualiza las diferentes vistas expuestas sobre el conjunto de lugares favoritos.

 41:     /// </summary>

 42:     private void ActualizarVistas()

 43:     {

 44:         Favoritos.Source = Items;

 45:

 46:         Favoritos.View.Filter = new Predicate<object>(FiltroFavoritos);

 47:     }

 48:

 49:     /// <summary>

 50:     /// Establece como filtro para favoritos aquellos lugares marcados con el parámetro Favorito a true

 51:     /// </summary>

 52:     /// <param name="obj">Instancia sobre la que se establece el filtro</param>

 53:     /// <returns>true si el lugar es favorito, false en c.c.</returns>

 54:     private bool FiltroFavoritos(object obj)

 55:     {

 56:         var lugar = obj as MiLugar;

 57:         if (lugar == null)

 58:         {

 59:             return false;

 60:         }

 61:

 62:         return (lugar.Favorito == true);

 63:     }

 64: }

Ahora no hay más que hacer el DataBinding en la Vista XAML para que apunte a la nueva propiedad. ¿Correcto? Bueno, un matiz. la clase CollectionViewSource tiene una propiedad llamada CollectionViewSource.View que es la propiedad que realmente muestra la vista con el filtro.

 1: <controls:PanoramaItem Header="{Binding Source={StaticResource LocalizationHelper}, Path=LocalizedResources.TituloFavoritos}" Orientation="Horizontal" Foreground="{StaticResource PhoneBackgroundBrush}">

 2:     <ListBox ItemsSource="{Binding Path=Favoritos.View}" Foreground="{StaticResource PhoneTextBoxForegroundBrush}" />

 3: </controls:PanoramaItem>

El siguiente paso: añadir un formulario para el alta de lugares y tendremos nuestra primera versión operativa de la aplicación. Algo que poder enseñar y revisar. En el próximo post.

Empezando con Windows Phone 7.1 (y VI) – El Contexto de Datos

En esta primera aplicación, estoy creando un modelo de datos muy sencillo: esencialmente se trata de una colección de lugares de interés para el usuario. Poco más que añadir en esta primera iteración ya que, de momento, no daré soporte anidamientos y no habrá relaciones con otras entidades (al menos no las he identificado todavía). Queda para más adelante anidar lugares dentro de lugares y relacionar lugares con personas.

Para la creación del modelo de datos he comenzado con la entidad principal MiLugar: Se trata de una clase muy sencilla que proporciona dos propiedades. un identificador único y un nombre.

Entidad MiLugar en Iteración 1

Entidad MiLugar en Iteración 1

Caben destacar muy poquitas cosas de la entidad:

  1. Implementa la interfaz INotifyPropertyChanged que es de gran utilidad para comunicar cambios en propiedades de la entidad (una buena forma de que, por ejemplo, una vista sepa que la propiedad que tiene asociada a, digamos por ejemplo, un campo de texto ha cambiado y que, en consecuencia, ha de redibujar dicho campo de texto para mostrar el cambio). Veréis más adelante que esta interfaz está en el corazón de la forma en la que se asocian datos y vistas (llamadlas pantallas, si queréis).
  2. Que la entidad ha sido decorada con el atributo TableAttribute y que ambos campos han sido decorados, a su vez con el atributo ColumnAttribute. De esta manera estamos estableciendo las reglas con las que el contexto de datos podrá crear su implementación física a partir de la definición de mi entidad.
DetalleCodigoMiLugar_Iteracion1

Detalle de la entidad MiLugar en Iteración 1: Atributos Table y Column.

Como veis no tiene gran cosa (el código que veis aquí aun no ha sido probado, así que cruzo los dedos para que no me de ningún susto).

Actualización: Cabe decir que el código reflejado ahí arriba compila, pero no funciona en Windows Phone. ¿La razón? El tipo GUID no existe en SQL Server CE, poned en cambio uniqueidentifier y todo irá como la seda.

El siguiente paso es crear la clase encargada de representar el contexto de datos.

DataContext_Iteracion1

Diagrama de clases para el Contexto de Datos en Iteración 1

En este caso se trata de una clase que implementa el patrón Singleton y hereda de la clase DataContext. La única instancia del contexto de datos se puede obtener a través de la propiedad Instancia y contiene una colección de MiLugar que representamos como una propiedad de la clase Table (LugaresDeInteres).

En general, el contexto de datos tiene como propósito abstraernos de los detalles de acceso de la base de datos, limitándose a proporcionar colecciones (tablas) de entidades y mecanismos para buscar, insertar, editar y borrar elementos de dichas colecciones. En ningún momento nuestro código conocerá una sola línea orientada a abrir, crear, consultar o actualizar una base de datos.

Como podéis ver, el proceso de creación de la instancia de DataContext es bastante sencillo. Se pretende garantizar la concurrencia de hilos (cosa que, en esta aplicación será muy sencillo). A continuación, una implementación típica de Singleton y un pequeño detalle. Si la base de datos no ha sido creada todavía: la creamos mediante la línea _dataContext.CreateDatabase (); Fijaos que la cadena de conexión nos indica que la base de datos se referenciará en nuestro Almacén Aislado (IsolatedStorage)

DetalleInstanciaDataContext_Iteracion1

Detalle de la instanciación del DataContext en Iteración 1

A continuación, vamos a llevarnos el contexto de datos hacia arriba en nuestras capas de aplicación. La idea es utilizarlo en nuestras pantallas y, para eso, vamos a aprovechar la infraestructura que crea Visual Studio 2010 para implementar un patrón de capa de presentación llamado Modelo Vista – Vistamodelo (MVVM: Model view – ViewModel). Probablemente le dedique alguna entrada a este patrón, pero no ahora que todavía no lo tengo demasiado claro. Un par de trazos: los patrones de diseño para la capa de presentación llevan dando vueltas por ahí décadas. En un patrón típico Modelo Vista Presentación tienes lo siguiente:

  1. La Vista: Puedes asemejarla sin problemas a tu pantalla
  2. El Modelo: Los datos que se muestran en la vista.
  3. La Presentación: Lo que junta ambas cosas (definición donde las haya. ¿Eh?)

El MVVM es un patrón específico para Windows Presentation Foundation (WPF) que, os recuerdo, es un superconjunto de Silverlight que es con lo que montáis vuestras pantallas en Windows Phone.

Si no os parece mal, dejaremos la capa de presentación y su asociación con los datos para la siguiente entrada.