Click here to Skip to main content
15,860,943 members
Articles / Mobile Apps / Windows Phone 7

Weekly Thai Recipe! for Windows Phone

Rate me:
Please Sign up or sign in to vote.
4.92/5 (37 votes)
6 Jul 2012CPOL12 min read 77.5K   1.8K   82   28
A complete WP7 application with a central management website (ASP.NET MVC4) for recipe management and push notifications

SplashScreen Weekly Thai Recipe Screenshot Weekly Thai Recipe

Contents

  • Contents
  • Introduction
  • Weekly Thai Recipe
  • Overall Architecture
  • Weekly Thai Recipe Phone Architecture
  • Weekly Thai Recipe Management Architecture
  • Tools and frameworks
  • Using the source
  • Conclusion
  • What's next?
  • History
  • Introduction

    This article describes the implementation and process of developing Weekly Thai Recipe. Weekly Thai Recipe is the third application that I developed for the Window Phone. This article is also the third article about developing for windows phone. More information about why I am developing Windows phone applications can be found here and here.

    I got a lot of positive reactions from my first and second article, which made me decide to write a new article and also open up the source of this application. I hope that this article will inspire other people to start developing new windows phone applications. I wrote this article during the implementation of the application and finished it just after Weekly Thai Recipe got certified. Weekly Thai Recipe is currently available in the Marketplace.

    Weekly Thai Recipe

    The application Weekly Thai Recipe is an application that provides original recipes from Thailand. The Thai cuisine consist mostly of lightly prepared dishes with strong aroma. It is know for its spiciness and always tries to balance 3 to 4 fundamental tastes in each dish being sour, sweet, bitter and salty.

    When the application is started it shows three recipes. Every week that passes another original Thai recipe is added to the recipe list in the application. This new recipe is received from a webservice and stored locally on the phone. A live tile and toast notifications are used to notify the user that a new recipe is available. 

    Overall Architecture 

    The architecture of Weekly Thai Recipe consists of three main parts. First, the Windows Phone application that shows the recipes, secondly a web service and website which manage recipes and last the Microsoft Push Notification Service which is needed to be able to send notifications and tile updates to the Windows phone.

    Image 3

    To register an application with MPNS and send a push notification your application has to follow the following proces. 

    1. Register with MPNS 
    2. The application registers itself with the MPNS and retrieves an uri that uniquely identifies the channel on which this single Windows Phone device can be notified.

    3. Register with webservice
    4. The application sends this uri and a unique identifier to a custom webservice (my implementation uses ASP.NET Web API) which stores this unique identifier and uri in a SQL database. 

    5. Send push notification 
    6. Via the website it is possible to send push notifications to all the registered phones. The web application retrieves all registered uri's and sends a specially formatted XML message to the uri to notify each phone .

    7. Send the push notification to the phone
    8. MPNS acts as a broker which receives the XML message and then sends it to the phone

    By acting as a middle man, MPNS is able to provide control over who and how many messages are send to phones. It will prevent for example applications flooding an windows phone with too many push notifications.

    Weekly Thai Recipe Phone Architecture

    The application on the windows phone that receives and shows the recipes consists of three parts.

    Image 4

    First, there is the view which consist of the Windows Phone panorama control. The application uses the MVVM pattern to separate views from the logic. To assist in using the MVVM pattern the MVVM Light framework is used. 

    Secondly there are a set of service that allow the viewmodel or model to retrieve data from the local storage or from an external source. To assist in retrieving data from external sources such as the recipe web service the RestSharp library for Window Phone is used.

    And last there is the local recipe storage layer which is responsible for retrieving and storing local recipe data. The recipe's are stored in the isolated storage of the phone in XML format.

    Two different scenarios

    These layers assist in two different types of scenario (connected and disconnected) that are supported by the application.

    1. Disconnected scenario

    When the phone has (temporary) no network connection, the application will not receive any recipes from the external recipe webservice. Therefore, the application has a set of 3 recipes which are distributed together with the application. When a user does not have a network connection, the application is still able to show the list of the three fixed recipe's.

    The application checks to see if there is a network connection available and if there is none it receives the recipes from the local XML file. Whether the application has a network connection or not is abstracted by the services layer. The view just calls GetRecipes and receives them.

    2. Connected scenario 

    If the phone has a network connection the viewmodel instructs the service to retrieve the recipes. The service layer detects that there is a network connection and send a request to the recipe webservice to check if the latest recipe is already retrieved or not. If not it retrieves the latest recipe, stores it onto the isolated storage of the phone and returns the three fixes recipes and the dynamic recipes to the view.

    By designing the application this way, it doesn't have to retrieve the recipes everytime from the webservice. Instead, if it has the latest recipe, it just returns the recipes from the local storage. After the development of the application I also notices that there are other frameworks that provide these kind of (caching) services. For example, AgFx that provides this functionality. I will be looking at integrating this framework in the next version of the application.

    View (Panorama control)

    The panorama control is a control that provide parallax scolling which can be used to provide a digital magazine look and feel. Normally the control has a solid background. But for my app I wanted to do something different. I found an article by Jeff Wilcox that describes a way to smoothly fade the background of the panorama control. I decided to use this method and use a timer that rotates the background image of the panorama control. 

    This video shows the effect in the application, every 10 second a different background is shown using a fade effect. I used three different images of recipes.

    The BackgroundImageRotator class is responsible for providing new images to the Background image brush.

    C#
    public ImageBrush Rotate()
    {
      if (CurrentTheme == AppTheme.Dark)
      {
        string backgroundImageLocation = string.Format("/Images/Panorama{0}.jpg", this.currentBackgroundIndex + 1);
        var backgroundImageBrush = new ImageBrush{ ImageSource = new BitmapImage(new Uri(backgroundImageLocation, UriKind.Relative)) };
    
        this.currentBackgroundIndex++;
        if (this.currentBackgroundIndex >= NumberOfBackgroundImages)
        {
            this.currentBackgroundIndex = 0;
        }
    
        return backgroundImageBrush;
      }
      return null;
    }

    The Rotate method iterates over the available images and every time it gets called the next image bruch is returned.

    Security

    The webservice uses forms authentication to validate if the request comes from a trusted client. This mild form of security prevents the anonymous use of the recipe webservice. The RestSharp library provides a nice clean method to use forms authentication from the client.

    A RestRequest is used to perform the request to the webservice. ASP.NET MVC4 is used to implement the recipe webservice and website. Out of the box ASP.NET MVC4 provides a JsonLogin action on the account controller to perform the authentication.

    C#
    private static RestRequest CreateAuthenticationRequest()
    {
        var request = new RestRequest("account/JsonLogin", Method.POST);
        request.AddParameter("UserName", Constants.Settings.UserName);
        request.AddParameter("Password", Constants.Settings.Password);
        return request;
    }

    If successfully authenticated ASP.NET forms authentication provides you with an authorization cookie that should be added to each subsequent request. The RestSharp library provides an easy way to handle this by using a cookiecontainer. When providing an instance of the cookie container to the RestClient, it handles adding the authorization cookie to each subsequent request.

    C#
    var client = new RestClient(Constants.Settings.Recipe_Service_Api_Url);
    client.CookieContainer = new CookieContainer();

    Advertising

    It is really easy to integrate ads into your windows phone application. There are different advertisement providers that you can use. Below is a list of possible advertisements providers that you can use with Windows Phone.

    This is not a complete list. Advertisement on windows phone is still developing, new providers come and existing provides go.

    I used Microsoft Pubcenter for adding advertisement to Weekly Thai Recipe. Mainly I choose this provider because the integration was very easy todo. I show the advertisement in the recipe detail screen, see the bottom of the screenshot below.

    Image 5

    To use Microsoft Pubcenter, you have to sign up at the website and place the adcontrol on to a view of your application. You have to enter your application Id and ad unit Id in the control. That's basically it, you can change the size of the advertisement or provide different size of controls on different views.

    <Grid x:Name="AdvertisementRow" Grid.Row="2">
      <my:AdControl 
        AdUnitId="your ad unit id" 
        ApplicationId="your application id" 
        Height="80" 
        HorizontalAlignment="Left" Margin="0,-6,0,0" 
        Name="adControl1" 
        VerticalAlignment="Top" 
        Width="480" />
      </Grid>

    Weekly Thai Recipe Management Architecture

    As mentioned in the previous section the recipe and notification management part of the application is implemented using ASP.NET MVC4 (Beta). Both ASP.NET MVC4 and WebApi are used to provide services to the windows phone application.

    There are two areas of functionality provides by the central application, the service to store and retrieve recipes and the ability to notify users of the windows phone application that a new recipe is available.

    Image 6

    Razor views are used to provide functionality to store new recipes and they also provide the functionality to send notifications to the connected phones. Dapper is used to retrieve and store data from the database. Dapper is a simple and fast object mapper for .Net. Dapper is open source framework and is used by the famous StackOverflow web site.

    Push notifications

    Push notification such as toast notification and tile updates are created by sending an XML message to the url that is received from the Windows Phone application. The central application stores all these url in a SQL database, so that they can be used later to send notifications.

    Toast notifications

    The class ToastSender is responsible for sending toast notifications to all the connection phones. When the Send method is called, the toast notification XML message is send to all the connected phones.

    public void Send(
       string title, 
       string message, 
       PhoneUriCollection phoneUriCollection)
    {
      var toastMessage = "" +
        "<wp:Notification xmlns:wp=\"WPNotification\">" +
           "<wp:Toast>" +
              "<wp:Text1>{0}</wp:Text1>" +
              "<wp:Text2>{1}</wp:Text2>" +
           "</wp:Toast>" +
        "</wp:Notification>";
    
      toastMessage = string.Format(toastMessage, title, message);
    
      var messageBytes = System.Text.Encoding.UTF8.
           GetBytes(toastMessa  ge);
    
      foreach (var uri in phoneUriCollection.Values)
      {
        try
        {
          messageSender.Send(uri, 
            messageBytes, NotificationType.Toast);
        }
        catch (Exception error)
        {
            ErrorSignal.FromCurrentContext().Raise(error);
        }
      }
    }

    The toast notification XML message has two text strings, one that indicates the title and another one for the actual text of the notification. This functionality is provided using the razor view from below.

    Image 7

    Tile notifications

    The class TileSender is responsible for sending Tile notifications to the phones. It works the same as the NotificationSender but a different XML message is send to the phones.

    public void Send(
      string frontTitle, 
      int count, 
      string frontImageLocation, 
      string backTitle, 
      string backImageLocation, 
      string backContent, 
      PhoneUriCollection phoneUriCollection)
    {
      var tileMessage = "" +
        "<wp:Notification xmlns:wp=\"WPNotification\">" +
          "<wp:Tile>" +
            "<wp:BackgroundImage>{2}</wp:BackgroundImage>" +
            "<wp:Count>{1}</wp:Count>" +
            "<wp:Title>{0}</wp:Title>" +
            "<wp:BackBackgroundImage>{4}</wp:BackBackgroundImage>" +
            "<wp:BackContent>{5}</wp:BackContent>" +
            "<wp:BackTitle>{3}</wp:BackTitle>" +
          "</wp:Tile> " +
      "</wp:Notification>";
    
      tileMessage = string.Format(
        tileMessage, 
        frontTitle, 
        count, 
        frontImageLocation, 
        backTitle, 
        backImageLocation, 
        backContent);
    
      var messageBytes = System.Text.Encoding.UTF8.GetBytes(tileMessage);
    
      foreach (var uri in phoneUriCollection.Values)
      {
        try
        {
          messageSender.Send(uri, messageBytes, NotificationType.Tile);
        }
        catch (Exception error)
        {
          ErrorSignal.FromCurrentContext().Raise(error);
        }
      }
    }

    Sending the push notification XML message

    The MessageSender class is responsible for sending the bytes of the XML message to the server. The "X-WindowsPhone-Target" and the "X-NotificationClass" headers are added to Http request to indicates the type of notification and when the notification should be send to the phone.

    public void Send(Uri uri, byte[] message, NotificationType notificationType)
    {
      var request = (HttpWebRequest)WebRequest.Create(uri);
      request.Method = WebRequestMethods.Http.Post;
      request.ContentType = "text/xml";
      request.ContentLength = message.Length;
    
      request.Headers.Add(
        "X-MessageID", 
        Guid.NewGuid().ToString());
    
      switch (notificationType)
      {
        case NotificationType.Toast:
          request.Headers["X-WindowsPhone-Target"] = "toast";
          request.Headers.Add(
            "X-NotificationClass",  
            ((int)BatchingInterval.ToastImmediately)
               .ToString(CultureInfo.InvariantCulture));
          break;
        case NotificationType.Tile:
          request.Headers["X-WindowsPhone-Target"] = "token";
          request.Headers.Add(
            "X-NotificationClass", 
            (int)BatchingInterval.TileImmediately).
               ToString(CultureInfo.InvariantCulture));
          break;
        default:
          request.Headers.Add(
            "X-NotificationClass",
            (int)BatchingInterval.RawImmediately).
               ToString(CultureInfo.InvariantCulture));
          break;
      }
    
      using (var requestStream = request.GetRequestStream())
      {
        requestStream.Write(message, 0, message.Length);
      }
    
      try
      {
        var response = (HttpWebResponse)request.GetResponse();
      }
      catch (WebException ex)
      {
        Debug.WriteLine(string.Format("ERROR: {0}", ex.Message));
        throw ex;
      }
    }

    Weekly Thai Recipe uses two types of push notifications, toast and tile. The third type, raw notifications is not used. Raw notifications can be used to send custom data to your windows phone application. Note, that if your application is not running the raw notification is discarded.

    Communication from the view to the service

    Communication from the view to the service is implemented using jQuery. The service is implemented using an WEB API controller.

    [Authorize]
    public class ToastController : ApiController
    {
      private readonly ISubscriptionRepository subscriptionRepository;
    
      private readonly ToastSender toastSender;
    
      public ToastController(ISubscriptionRepository subscriptionRepository, ToastSender toastSender)
      {
        this.subscriptionRepository = subscriptionRepository;
        this.toastSender = toastSender;
      }
    
      [HttpPost]
      public void Send(string toastTitle, string toastMessage)
      {
        try
        {
          PhoneUriCollection phonesCollection = subscriptionRepository.GetAll();
          toastSender.Send(toastTitle, toastMessage, phonesCollection);
        }
        catch (Exception error)
        {
          ErrorSignal.FromCurrentContext().Raise(error);
          throw new HttpResponseException(error.Message,
             HttpStatusCode.InternalServerError);
        }
      }
    }

    The ToastController is responsible for receiving the Toast send request. It contains a title and a message that should be send to all the registered phones.

    A javascript class is used to actually send the message to the controller. The inialize methods binds a method to the blick event of the sendToastButton. The method retrieves the value from the title and message text field and sends them to the controller using the $.ajax jQuery method. When the method succeeds it shows an alert that the toast has been send.

    JavaScript
    var toastInitializer = function () {
    
      var initialize = function (sendToastUrl) {
    
        $('#sendToastButton').click(function () {
    
          var toastTitle = $('#toastTitle').val();
          var toastMessage = $('#toastMessage').val();
    
          if (toastTitle.length > 0 && toastMessage.length > 0) {
            $.ajax({
              url: sendToastUrl,
              success: function (data) {
                alert('Toast is send');
              },
              data: {
                toastTitle: toastTitle,
                toastMessage: toastMessage
              },
              dataType: "json",
              type: "POST"
           });
         }
       });
      };
    
      return {
        initialize: initialize
      };
    };

    Error handling on the client is centralized by overriding the jQuery $.ajax error method.

    var generalErrorHandler = function() {
    
      var initialize = function() {
        $.ajaxSetup({
          "error": function (xhr) {
            var errorMessage = $('#errorMessage');
            if (errorMessage.length > 0) {
              errorMessage.html(xhr.responseText);
            }
    
            var errorDialog = $('#errorDialog');
            if (errorDialog.length > 0) {
              errorDialog.show();
            }
          } 
        });
      };
    
      return {
        initialize: initialize
      };
    };

    An error div is added to the shared ASP.NET MVC _Layout.cshtml that shows the actual error

    <body>
      <div id="errorDialog" class="errorDialog" style="display: none">
        <div id="errorIcon" class="errorIcon" style="cursor: pointer;" ><!-- --></div>
        <div class="messageText">
          <span id="errorMessage"></span>
        </div>
      </div>
      @this.RenderBody()
    </body>

    The general error handler and all the necessary javascript classes are initialized in the $(document).ready method of the main view.

    $(document).ready(function () {
    
      var errorHandler = new generalErrorHandler();
      errorHandler.initialize();
    
      var toast = new toastInitializer();
      toast.initialize('@Url.Action("Send", "api/Toast")');
    
      var tile = new tileInitializer();
      tile.initialize('@Url.Action("Send", "api/Tile")');
    
      var recipe = new recipeSaver();
      recipe.initalize('@Url.Action("Save", "api/Recipe")');
    
    });

    Dapper Data Access

    I used Dapper for data access because using a full ORM such as Entity Framework or NHibernate is just too much for managing those two or three database tables. Dapper is what is called a micro orm. It provides a subset of the services provided by a full ORM. This enables you to have more power and control over how records are stored and retrieved from the database.

    Dapper provides functionality to parameterize queries and materialize the results from those queries. For example, the following source code is used to retrieve all the registered phones (subscriptions) from the database.

    IEnumerable<subscription> subscriptions = connection.Query<subscription>(@"select PhoneId, Uri from subscription");
    </subscription></subscription>

    Dapper takes care of performing the query and creating a list of subscription instances filled with the data from the database. The mapping between the table columns and the property of the class is based on the name of the column and the name of the property. These two column name and property name should be the same for Dapper to recognize this.

    Tools and frameworks

    Below the list of tools and frameworks I used for developing Weekly Thai Recipe.

    Windows Phone Application

    Central Management Application

    Using the source

    There a two solutions inside the source package. For opening the Windows Phone solution you need Visual Studio 2010 and the Windows Phone SDK installed. For opening the central recipe management solution you need to install ASP.NET MVC4 (beta).

    There is a detached SQL server database in the source package which you can attach to your local SQL server to create a fully working application. If you use this database can login with username Codeproject and password Codeproject. 

    Conclusion

    The application is available in the marketplace and the full source code can be downloaded from the top of the article. If you like the article, a vote or comment is appreciated. Thanks.

    What's next?

    My next Window Phone project will be a game using the XNA framework. I am still figuring out the details, but it will appear here on CodeProject in the form of a article.

    History

    • v1.0 First version
    • v1.1 Update of the source of the central application to use the RC of ASP.NET MVC4 (Thanks to Jeff Albrecht for the headsup!) 
    • v1.2 Added a detached database to the source zip to create a complete package.   

    License

    This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


    Written By
    Architect http://www.simpletechture.nl
    Netherlands Netherlands
    Patrick Kalkman is a senior Software Architect with more than 20 years professional development experience. He works for SimpleTechture where he helps teams develop state of the art web applications.

    Patrick enjoys writing his blog. It discusses agile software development. Patrick can be reached at patrick@simpletechture.nl.

    Published Windows 8 apps:


    Published Windows Phone apps:


    Awards:

    Best Mobile article of March 2012
    Best Mobile article of June 2012

    Comments and Discussions

     
    GeneralMy vote of 5 Pin
    Guus Beltman13-Dec-13 0:15
    Guus Beltman13-Dec-13 0:15 
    GeneralMy vote of 5 Pin
    Patrice Biperra Production20-Jan-13 12:53
    Patrice Biperra Production20-Jan-13 12:53 
    GeneralRe: My vote of 5 Pin
    Patrick Kalkman20-Feb-13 7:11
    Patrick Kalkman20-Feb-13 7:11 
    QuestionScreenshots missing Pin
    zzeroo12-Jan-13 5:13
    zzeroo12-Jan-13 5:13 
    AnswerRe: Screenshots missing Pin
    Patrick Kalkman15-Jan-13 20:02
    Patrick Kalkman15-Jan-13 20:02 
    GeneralRe: Screenshots missing Pin
    zzeroo23-Jan-13 1:25
    zzeroo23-Jan-13 1:25 
    QuestionThanks.. Pin
    vaishalipardeshi25-Oct-12 20:36
    vaishalipardeshi25-Oct-12 20:36 
    AnswerRe: Thanks.. Pin
    Patrick Kalkman3-Dec-12 9:02
    Patrick Kalkman3-Dec-12 9:02 
    GeneralMy vote of 5 Pin
    Kanasz Robert21-Sep-12 0:56
    professionalKanasz Robert21-Sep-12 0:56 
    GeneralRe: My vote of 5 Pin
    Patrick Kalkman8-Oct-12 22:01
    Patrick Kalkman8-Oct-12 22:01 
    Thank you very much Robert!
    Patrick Kalkman

    My latest article: Weekly Thai Recipe! for Windows Phone
    My Blog: SemanticArchitecture.net

    GeneralMy vote of 5 Pin
    Florian Rappl7-Jul-12 2:54
    professionalFlorian Rappl7-Jul-12 2:54 
    GeneralRe: My vote of 5 Pin
    Patrick Kalkman9-Jul-12 15:52
    Patrick Kalkman9-Jul-12 15:52 
    GeneralGood article Pin
    Wonde Tadesse6-Jul-12 17:02
    professionalWonde Tadesse6-Jul-12 17:02 
    GeneralRe: Good article Pin
    Patrick Kalkman6-Jul-12 23:09
    Patrick Kalkman6-Jul-12 23:09 
    QuestionMy Vote of 5 Pin
    dotnet_spinner6-Jul-12 5:05
    dotnet_spinner6-Jul-12 5:05 
    AnswerRe: My Vote of 5 Pin
    Patrick Kalkman6-Jul-12 23:09
    Patrick Kalkman6-Jul-12 23:09 
    GeneralMy vote of 5 Pin
    Slacker0075-Jul-12 7:11
    professionalSlacker0075-Jul-12 7:11 
    GeneralRe: My vote of 5 Pin
    Patrick Kalkman5-Jul-12 10:55
    Patrick Kalkman5-Jul-12 10:55 
    QuestionMy vote of 5 Pin
    Marcelo Ricardo de Oliveira30-Jun-12 17:26
    mvaMarcelo Ricardo de Oliveira30-Jun-12 17:26 
    AnswerRe: My vote of 5 Pin
    Patrick Kalkman1-Jul-12 5:01
    Patrick Kalkman1-Jul-12 5:01 
    GeneralMy vote of 5 Pin
    Manoj Kumar Choubey29-Jun-12 7:32
    professionalManoj Kumar Choubey29-Jun-12 7:32 
    GeneralRe: My vote of 5 Pin
    Patrick Kalkman1-Jul-12 5:01
    Patrick Kalkman1-Jul-12 5:01 
    GeneralMy vote of 5 Pin
    indyfromoz25-Jun-12 14:02
    indyfromoz25-Jun-12 14:02 
    GeneralRe: My vote of 5 Pin
    Patrick Kalkman26-Jun-12 8:37
    Patrick Kalkman26-Jun-12 8:37 
    GeneralArrhhh Pin
    Vitaly Tomilov25-Jun-12 11:04
    Vitaly Tomilov25-Jun-12 11:04 

    General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

    Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.