How-tos

Building an Android ToDo app with Bluemix and PubNub

Share this post:

In 2015, we announced our new partnership with IBM to bring our real-time data streaming and messaging capabilities to Bluemix, IBM’s cloud development platform, making it easy to launch IoT, Web, and Mobile apps built on real-time communication that scale globally. This blog post shows you how to build an Android ToDo app using Bluemix and PubNub.


PubNubLogo2014_hero

“There is an app for that,” quipped Steve Jobs famously, and what followed was a flourishing trend leading to the development of mobile apps to address our minutest problems. From time management to health, productivity to business, and even some funny apps like Face Swap, the list just keeps getting bigger.

In this blog post, we show you how to build and deploy an Android ToDo app using the Bluemix platform and services. Building an app is one small piece of the puzzle, but like all apps these days, if your app also relies on back-end content and logic, then hosting it and ensuring that it serves the users well might not always be a cakewalk. We show you some innovative ways in which you can reliably host your app under the Bluemix umbrella of services and reduce the overhead on the part of the developer.

App overview

The ToDo Android app that we are going to build here is a project collaboration app where multiple users, all belonging to the same project team, will log in and add or update ToDo items, or tasks. They will be able to create tasks and also post comments on other’s tasks. Tasks can also be marked with status to indicate whether they are open or complete.

Task List Comment List

The complete source code of this application, including the app and server, is available in the project shyampurk/bluemix-todo-app on GitHub.

Approach

Almost all the mobile apps built these days rely on server side business logic and data persistence for achieving their functionality. Representational State Transfer (REST) has emerged as the most popular way of enabling interaction between a client application and servers. REST offers a more flexible URL scheme based on objects, their behavior, and their states, compared to the earlier interpretation based on static file paths (during the Web 1.0 days).

While it is indeed a great leap, REST is still based on the HTTP protocol. The one fundamental flaw of HTTP is that it is a request response protocol. HTTP was designed to be that way so that the client could request resources from the server and server return that as a response. It was never designed for bidirectional , duplex, and conversational communications, which we have come to rely on so much for all modern applications these days.

For powering this Android App, we are going to use an alternative approach based on the Bluemix umbrella of services, which can eliminate some of the limitations of HTTP and make the applications more aware and responsive. For this ToDo app, this can be in the form of realtime task/comment updates or instant task notifications between the apps. All of this can be achieved without any workload on the application developer. In fact, building and deploying a realtime mobile app under Bluemix is manyfold simpler compared to the traditional approach. So let’s get started!

Powered by Bluemix, driven by PubNub

If you have ever deployed a RESTful service on your own, then you would know that this requires setting up a web server as an HTTP API gateway to handle all HTTP/REST requests from the client. Behind the scenes, we also need to set up a few application servers to handle different micro services and their business logic for each REST endpoint. This leads to a two-tiered architecture that looks something like this:

REST-Architecture

For deploying the server-side architecture of this ToDo application, we can simplify it as the entire heavy lifting of connecting the client Android App with the server is done using PubNub. PubNub is a third-party service available under the Bluemix catalog, which provides a messaging layer over the Internet for enabling bidirectional communication between multiple entities in real time and in a secured and reliable fashion. This way, the API gateway and app servers can be collapsed in a single tier like this:

PubNub-Architecture

In this way, the server-side application for this Android app can be hosted on a Bluemix container, either the Cloud Foundry runtime or a docker container. We have chosen the Cloud Foundry runtime with Python Buildpack as our server environment, which means that the server application is built on Python.

Behind the scenes, all messages exchanged between the client App and server are routed through the PubNub Data Stream Network, via a channel, which acts like a secured virtual tunnel, akin to a VPN connection. We can create multiple channels designated for each type of operation, which is the same as defining different REST API endpoints for invoking a different set of business logic.

App-Architecture

By using this approach, we can offload all our platform and messaging requirements to Bluemix and PubNub and deploy real-time applications within a single tier. We only need an extra component, which is a database for storing the task data. We have used IBM dashDB™ for this purpose, which is also available as Bluemix service.

Hooking an application to PubNub is easy. You do not have to make any HTTP REST API calls to the PubNub service. Instead, you can use one of the 70+ SDKs available for embedding PubNub messaging in different languages and frameworks. For this application, we used the following PubNub SDKs:

Project setup

  • Source code for the app server: Located under the server folder in the GitHub repository.
  • Source code for the ToDo app: Located under Android-Client folder in the GitHub repository. (You can build the ToDo App using the standard Android build procedure.)
  • README file: Contains steps for hosting the app server on Bluemix and using the mobile app.

Before deploying your application, make sure to sign up for a Bluemix and PubNub account. Visit the Bluemix registration page and PubNub add-on page to create your respective accounts. Both of the services offer a free tier account to play around with their offerings.

App operation

There are seven operations defined for this app:

  • Login: For allowing the user to log in to the app
  • Logout: For allowing the user to log out the app
  • Get Address Book: For getting all the users in the project
  • Get Task List: For getting the list of tasks
  • Create Task: For creating a new task
  • Update Task: For updating the status of task
  • Add Comment: For adding a comment to a task

As explained earlier, the architecture of this application is defined in such a way that every app operation is an endpoint that is assigned a separate PubNub channel. This helps in segregating the messages and their business logic based on the functionality.

App-Channels

Client server interaction

All operations are performed as a request response transaction between the server and app. When the app is launched, it follows a sequence of operations to perform a common set of procedures based on the user inputs as depicted in the sequence diagram below. ToDo-MSD_edited

The app also provides basic security features to ensure that a logged in user cannot log in again from another app instance, and the user session is tracked for dormancy, forcing the user to log in again if it is detected.

Application security

Security is a major concern for any application involving client-server interaction. For this ToDo app, because all message exchanges happen through the PubNub channels, that is the place where security can be compromised. PubNub has put in place a robust set of measures for ensuring security, which can be leveraged by application developers for making their apps secure. This can be in the form of:

  • Access control: PubNub allows fine-grained control over the access to channels. This means that the developer can decide which device can have access to the channel, can read and/or write to the channel, and for how long.
  • Message encryption: PubNub supports a built-in AES encryption and optional TLS/SSL support for all its APIs. The encryption keys are owned by the application developer, which ensures end-to-end fullproof encryption under the control of the application developer.

Advantages over standard REST-based implementation

Developers always have a choice to build their app using REST and develop and deploy all the supporting components on their own. But the effort of undertaking such an exercise gets exponentially high as the application scales up. Compared to that, here are some of the advantages of using Bluemix and PubNub for deploying your apps:

  • Bidirectional: PubNub APIs are bidirectional, meaning that both endpoints of the channel can communicate in either direction. This also means that the server can push a message to the client without the client sending a request or initiating a long polling session.
  • Realtime updates: Using the PubNub service also provides developers with a way to incorporate real-time features dynamically. Because the channels are shared by all Aapp instances of ToDo app, any update on the tasks and comments are received by all the running app instances, so that they can update their screens to reflect the current set of tasks along with their states and comments. If you are considering building this feature on your own, you will end up spending lot of time and effort to just make it work.
  • More secure: REST APIs are always publicly exposed and so they are under constant threat of Distributed Denial of Service (DDoS) attacks. Building a robust mechanism for countering such attacks requires additional tiers of server deployment, which is going to cost time and effort. With PubNub, these threats are inherently thwarted.
  • Less deployment overheads: Reducing the number of tiers and layers in server deployment is obviously good news for the company building the app, as it requires less overhead in terms of owning and managing the computing resources. Overall, it also greatly reduces the complexity of the deployment and simplifies the orchestration between the different components of the application.
  • Dynamic scalability: Both Bluemix and PubNub are built for scale, which means that you can scale up as needed as per your application usage, without ever worrying about the additional deployment overheads. On the other hand, both services offer a free tier account, which is good enough for prototyping and test deployment at no cost.
  • Lower time to build and deploy: Overall, it is much cheaper to own an application built on Bluemix and PubNub because you can save on both the initial development time, which translates to a faster go to market, and also the recurring maintenance overheads associated with the deployment.

REST will be history

One of the common performance issue with REST call is that it always opens a new connection for every request and then closes the connection after getting back the response. Doing this frequently is an obvious performance hit for modern web and mobile apps that rely on frequent, bidirectional communication. PubNub has engineered it in a way to allow massive scalability with a robust back-end infrastructure to support real-time and always on messaging applications.

PubNub provides SDKs for integrating with all the programming language build packs supported under Bluemix. Just like we have seen for Python in the case of this app, there are PubNub SDKs available for some of the most popular web and mobile app platforms such as Java™, Ruby, Go NodeJS, and ASP.NET. This opens up a huge opportunity for developing state of the art, real-time, and super alert applications that can not only be deployed under Bluemix with ease, but can also scale with ease.

Stay tuned for more demos and application use cases using Bluemix and the PubNub Data Stream Network!

Add Comment
No Comments

Leave a Reply

Your email address will not be published.Required fields are marked *

More How-tos Stories

Using SSH tunnels and Selenium to test web applications on a continuous delivery pipeline

Developers often have a need to test their web applications. In particular they often have a need to automate these tests as part of a continuous integration (CI) pipeline. One such tool that helps facilitate this test requirement is Selenium. Selenium is a piece of software which is designed to automate browser behaviour, in that you can program it to visit a particular web page and then perform a series of actions on that web page. Most often this is leveraged to test web applications, although its functionality is not limited to that single use case. With a default configuration, however, this isn’t possible as the Selenium Server has no way of reaching an application that has been started within a CI container.

Continue reading

Integrate and Analyze Diagnostic Logs with IBM Cloud Log Analysis

Analyzing diagnostic logs, monitoring application health and keeping track of security-related events are at the foundation of successfully running apps and services. IBM Cloud offers services for that purpose. Today, I am going to show you how to use IBM Cloud Log Analysis to integrate, search and analyze as well as visualize diagnostic logs in the IBM Cloud.

Continue reading

Obey your commands: Home automation using Watson and PubNub

Integration of voice control in smart devices is buzzing, and adoption continues to grow. Voice control provides a more natural way of interacting with connected apps and devices ranging from news feeds, traffic information to acting as personal assistants in the home. These intelligent devices respond to commands spoken in our own voice and act immediately.

Continue reading