. . .

Writing a simple Messenger App with ApiOmat

As you might have heard, ApiOmat provides an array of useful modules with packaged functionality which are ready to use. This tutorial will show how simple it is to use this type of module in your app. In this example, we choose Andoid as language.

Creating the app in ApiOmat

First you have to login and wait until the dashboard has loaded. Create a new app and add the "Messaging" module from the Module Market.

images/download/attachments/27724717/messaging_moduleAdd.png

Deploy the app after the module has been added.

Now your app is up and running. Download the SDK for Android in the SDK screen.

Creating an Android App

First, unzip the downloaded SDK to your src folder. com.apiomat.frontend.basics.MemberModel should be now accessible as Java class.

The messaging module enables users (members) of your app to send messages to each other and store them in the recipient's inbox. The app consists of four screens (or "activities" in the android world):

  • Account screen - where members can log in to the app

  • Inbox screen - the inbox / received messages of the member

  • Send screen - where the member can send a new message

  • Main screen - starting point of the app

The connection from the SDK to ApiOmat has to be initialized once to set up the credentials. You can do this in the Main screen during the onCreate method:

public void onCreate( Bundle savedInstanceState ) {
super.onCreate( savedInstanceState );
Intent me = getIntent( );
// Try to get user credentials from saved bundle
Bundle b = me.getExtras( ) != null ? me.getExtras( ) : savedInstanceState;
//If no credentials were found, open account screen
if ( b == null || !b.containsKey( USERNAME ) ) {
Intent intent = new Intent( this, AccountActivity.class );
startActivity( intent );
}
else {
//Init your member
User m = new User( );
m.setUserName( b.getString( USERNAME ) );
m.setPassword( b.getString( PASSWORD ) );
 
//Initialize SDK
Datastore.configureWithCredentials( m );
 
//Load or create our member on server via a async task
CreateOrLoadMemberTask task = new CreateOrLoadMemberTask( );
task.execute( m );
...
setContentView( R.layout.main );
}

Now that the SDK knows which URL and credentials to use, we can try to load our member from the server (if it already exists) or create a new one. Since requesting tasks are done asynchronously in Android, we use the CreateOrLoadMemberTask.doInBackground method:

protected User doInBackground( User... users ) {
User user = users[ 0 ];
//try to load member
user.loadMe( );
if ( user.getHref( ) == null ){
//OK, does not exist, create a new one
user.save( );
}
return user;
}

Sending or receiving messages itself is very easy. Simply create a new thread for the request (requests in the main thread raise an exception, as you might already know) and call the models methods, e.g. for sending:

MessageModel mm = new MessageModel( );
mm.setMessageText( messageText.toString( ) );
mm.setReceiverUserName( recipient.toString( ) );
mm.save();

The app is finished!

Further documentation on the Messaging module can be found in our wiki.

Attention: If you use the code without unzipping your own SDK into it, you will have to change the base URL and apiKey in the MemberModel class to your own values. These can be found in the SDK or in the deploy screen.