Java – Wiebe Elsinga

How-To: Android Client – Server designs

W.Elsinga — Fri, 08 Oct 2010 06:15:18 +0000

Applications are usually designed so that a Server provides a service to a Client. Choosing an implementation depends on the requirements. Inside this article I will be explaining three implementation types:

SOAP
Servlet
JSON

I will use the Android application which was developed inside my previous post.

SOAP

Simple Object Access Protocol is basically designed to provide a lightweight mechanism to exchange data in a XML format. Setting up a SOAP web service isn’t al that difficult. There is a disadvantage of using SOAP, and that’s overhead. Because there is no default SOAP support inside the Android library, I will be using kSOAP.

So lets set-up an implementation.

Create a server implementation

public class Hello {

public String sayHello(String name) {
return "Hello " + name;
}
}

Create an Android implementation
Create a call to the server

private void callService(SoapSerializationEnvelope envelope) {
HttpTransportSE androidHttpTransport = new HttpTransportSE(URL);

// Call the URL
try {
androidHttpTransport.call(SOAP_ACTION, envelope);
} catch (IOException e) {
display("Error:" + e.getClass().getName() + ": " + e.getMessage());
} catch (XmlPullParserException e) {
display("Error:" + e.getClass().getName() + ": " + e.getMessage());
}
}

Handle the response

private SoapPrimitive getResultFromService(String text) {
SoapObject request = new SoapObject(NAMESPACE, METHOD_NAME);
SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);

request.addProperty("name", text);

envelope.setOutputSoapObject(request);

callService(envelope);

SoapPrimitive result = null;
try {
result = (SoapPrimitive) envelope.getResponse();
} catch (SoapFault e) {
display("Error:" + e.getClass().getName() + ": " + e.getMessage());
}
return result;
}

Download source code BackEndWSDL [5kB] and FrondEndWSDL [114kB]

Servlet

The most simple form of exchanging data is by way of HTTP(s) with the use of Java Servlets. There’s no need to serialize to/from XML, so it can be a real time saver.

So lets set-up an implementation.

Create a server implementation

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
String text = "";
StringBuffer sb = new StringBuffer();
try {
BufferedReader reader = new BufferedReader(new InputStreamReader(request.getInputStream()));
String line = reader.readLine();
while (line != null) {
sb.append(line);
line = reader.readLine();
}
if (sb.length() != 0) {
text = sb.toString();
}
} catch (Exception e) {
}

response.setContentType("text/plain");
response.setHeader("Cache-Control", "no-cache");

if (StringUtils.isNotEmpty(text)) {
response.getWriter().write(HELLO_STRING + text);
} else {
response.getWriter().write(HELLO_STRING);
}

}

Create an Android implementation
Create a call to the server

private InputStream callService(String text) {
InputStream in = null;

try {
URL url = new URL(SERVLET_URL);
URLConnection conn = url.openConnection();

HttpURLConnection httpConn = (HttpURLConnection) conn;
httpConn.setRequestMethod("POST");
httpConn.setDoInput(true);
httpConn.setDoOutput(true);
httpConn.connect();

DataOutputStream dataStream = new DataOutputStream(conn.getOutputStream());

dataStream.writeBytes(text);
dataStream.flush();
dataStream.close();

int responseCode = httpConn.getResponseCode();
if (responseCode == HttpURLConnection.HTTP_OK) {
in = httpConn.getInputStream();
}
} catch (Exception ex) {
display("Error: Not not connect");
}
return in;
}

Handle the response

private String getResultFromServlet(String text) {
String result = "";
InputStream in = callService(text);
if(in!=null) {
result= convertStreamToString(in);
} else {
result = "Error: Service not returning result";
}
return result;
}

private static String convertStreamToString(InputStream is) {
BufferedReader reader = new BufferedReader(new InputStreamReader(is));
StringBuilder sb = new StringBuilder();

String line = null;
try {
while ((line = reader.readLine()) != null) {
sb.append(line + "\n");
}
} catch (IOException e) {
e.printStackTrace();
} finally {
try {
is.close();
} catch (IOException e) {
e.printStackTrace();
}
}
return sb.toString();
}

Download source code BackEndServlet [242kB] and FrondEndServlet [16kB]

JSON

So SOAP has the advantage of using a model, and HTTP(s) has the advantage of being simple. There is an implementation that uses both. JavaScript Object Notation is a light-weight data-interchange format, think of it as XML on a diet

So lets set-up an implementation.

Create a server implementation

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
String text = "";
StringBuffer sb = new StringBuffer();
try {
BufferedReader reader = new BufferedReader(new InputStreamReader(request.getInputStream()));
String line = reader.readLine();
while (line != null) {
sb.append(line);
line = reader.readLine();
}
if (sb.length() != 0) {
text = sb.toString();
}
} catch (Exception e) {
System.out.println(e);
}

response.setContentType("text/plain");
response.setHeader("Cache-Control", "no-cache");

JsonObject jsonObj=new JsonObject();

if (StringUtils.isNotEmpty(text)) {
jsonObj.addProperty(JSON_KEY, HELLO_STRING + text);
} else {
jsonObj.addProperty(JSON_KEY, HELLO_STRING);
}
PrintWriter out = response.getWriter();
out.println(jsonObj);
}

Create an Android implementation
Create a call to the server

private InputStream callService(String text) {
InputStream in = null;

try {
URL url = new URL(SERVLET_URL);
URLConnection conn = url.openConnection();

HttpURLConnection httpConn = (HttpURLConnection) conn;
httpConn.setRequestMethod("POST");
httpConn.setDoInput(true);
httpConn.setDoOutput(true);
httpConn.connect();

DataOutputStream dataStream = new DataOutputStream(conn
.getOutputStream());

dataStream.writeBytes(text);
dataStream.flush();
dataStream.close();

int responseCode = httpConn.getResponseCode();
if (responseCode == HttpURLConnection.HTTP_OK) {
in = httpConn.getInputStream();
}
} catch (Exception ex) {
display("Error: Not not connect");
}
return in;
}

Handle the response

private String getResultFromServlet(String text) {
String result = "";

InputStream in = callService(text);
if (in != null) {
JSONObject jsonResponse;
try {
jsonResponse = new JSONObject(convertStreamToString(in));
result = jsonResponse.getString("output");
} catch (JSONException e) {
result = "Error: JSON Object couldn't be made";
}
} else {
result = "Error: Service not returning result";
}
return result;
}

private static String convertStreamToString(InputStream is) {
BufferedReader reader = new BufferedReader(new InputStreamReader(is));
StringBuilder sb = new StringBuilder();

String line = null;
try {
while ((line = reader.readLine()) != null) {
sb.append(line + "\n");
}
} catch (IOException e) {
} finally {
try {
is.close();
} catch (IOException e) {
e.printStackTrace();
}
}
return sb.toString();
}

Download source code BackEndJSON [399kB] and FrondEndJSON [15kB]

How-To: Automatic testing for Android Applications

W.Elsinga — Tue, 03 Aug 2010 03:30:50 +0000

After setting up your Android development environment, and Developing an Android Application it’s time to set-up a automatic Android Test environment. The steps to achieve this are:

Choose a test technique.
Creating a test project.
Make the test.
Run the test.

I will use the Android application which was developed inside my previous post.

[Update 15-03-2011] Updated to Android 2.3.3.
[Update 15-03-2011] Updated to Robotium 2.2.

Choose a test technique

There are different techniques you can use to test Android applications. The most commonly known is by way of JUnit. JUnit is used to test the technical quality of applications. But what about the testing the functional use of a application, like you would do it with Selenium for web application. For Android applications there is a similar tool for testing called Robotium. It is a UI testing tool which simulates touching, clicks, typing, and other users’ actions relevant for Android applications. In this example I will be using Robotium.

Creating a test project

From within Eclipse select File menu, New and Other.
Choose Android Test Project inside the Android folder.
Provide the information about the Android Test project and click Next.
Press Finish. You should see the following directory structure

Because I will be creating a Robotium test, I must provide the robotium-solo-2.2.jar as library.

Make the test

From within Eclipse select File menu, New and JUnit Test Case.
Provide the information about the Junit Test Case and click Finish.
Change MainTest.java to the following

package com.my;

import java.util.ArrayList;

import com.jayway.android.robotium.solo.Solo;

import android.app.Activity;
import android.test.ActivityInstrumentationTestCase2;
import android.widget.TextView;

public class MainTest extends ActivityInstrumentationTestCase2 {

private Solo solo;
private Activity activity;

public MainTest() {
super("com.my", Main.class);
}

@Override
protected void setUp() throws Exception {
super.setUp();

this.activity = this.getActivity();
this.solo = new Solo(getInstrumentation(), this.activity);
}

@Override
public void tearDown() throws Exception {
try {
this.solo.finalize();
} catch (Throwable e) {
e.printStackTrace();
}
this.activity.finish();
super.tearDown();
}

/**
* @throws Exception Exception
*/
public void testDisplay() throws Exception {
String text = "Congratulations";

//Enter "Congratulations" inside the EditText field.
this.solo.enterText((EditText) this.activity.findViewById(R.id.EditText01), text);

//Click on the button named "Click".
this.solo.clickOnButton("Click");

//Check to see if the given text is displayed.
assertTrue(this.solo.searchText(text));

TextView outputField = (TextView) this.activity.findViewById(R.id.TextView01);
ArrayList currentTextViews = this.solo.getCurrentTextViews(outputField);
assertFalse(currentTextViews.isEmpty());

TextView output = currentTextViews.get(0);
assertEquals(text, output.getText().toString());
}

}

Run the test

Al that is left is running the test.

Right click MyAndroidAppTestProject.
Select Android Junit Test within the Run-As option.
Be patient, the emulator starts up very slow. You should get the following result

Appendix

Download source code Android.zip [16kB] and AndroidTest.zip [16kB]

How-To: Developing an Android Application

W.Elsinga — Mon, 02 Aug 2010 02:13:28 +0000

After setting up your Android development environment, it’s time you implement your first (simple) Android application. The steps to achieve this are:

Creating a project.
Create your user interface.
Code the application.
Run the application.

I will make an Android application which will provide a field where a user can type in a word and, after clicking on a button, will display that word.

[Update 15-03-2011] Updated to Android 2.3.3.

Creating a project

Before creating a project, you have to decide what the version of your Android Platform your application will be running on. You can view the current most used Android Platform on http://developer.android.com/resources/dashboard/platform-versions.html. In this example I will be using Android 2.3.3.

From within Eclipse select File menu, New and Android Project.
Provide the information about the Android project and click Next.
You can optional create a test project, which I will not do.
Press Finish. You should see the following directory structure.

So what do I see?. The project name is MyAndroidAppProject. It is displayed under the Package Explorer on the left of the window.

src: This contains the .java source files for your project. In this example, there are two files: Main.java and R.java. The Main.java file is the source file for your activity. The R.java file is a compiler-generated file that references all the resources found in your project. You should not modify this file.

Android Library: Contains all the class libraries needed for an Android application.

res: Contains all the resources used in your application. It contains three other sub-folders: drawable, layout, and values. You will see the use of the files contained in each sub folders shortly.

AndroidManifest.xml: Is the manifest file for your Android application. You will specify the permissions needed by your application as well as other features needed by your application (such as intent-filters, receivers, etc).

Create your user interface

The Andoid SDK allows two ways of building the user interface: via a rich editor and XML files. The XML method is preferred as it allows you to declaratively define the UI of an application without needing to write lots of code. In addition, it allows a clean separation of logic and UI.

Double-click on main.xml located under the res/layout folder.
Add three UI elements (EditText, Button and TextView).
Select the EditText element and change the property Layout Width to fill_parent.
Select the Button element and also change the property Layout Width to fill_parent.
Select the TextView element and also change the property Layout Width to fill_parent.

The main.xml should look as follows:

version="1.0" encoding="utf-8"?>
xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
>

android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="@string/hello"
/>

android:id="@+id/EditText01"
android:layout_height="wrap_content"
android:layout_width="fill_parent"
android:inputType="text"
/>

android:text="@+id/Button01"
android:id="@+id/Button01"
android:layout_height="wrap_content"
android:layout_width="fill_parent"
/>

android:id="@+id/TextView01"
android:layout_height="wrap_content"
android:layout_width="fill_parent"
/>
>

Notice that in the element, the value of the android:text attribute is @string/hello. @string refers to the strings.xml.

Double-click on strings.xml located under the res/values folder.
Change the file as follows:

version="1.0" encoding="utf-8"?>
>
name="hello">Welcome to My Android App>
name="app_name">MyAndroidApp>
name="btntxt">Click>
>

Finally assign the btntxt string attribute to the button property of the main.xml. The main.xml should look as follows:

version="1.0" encoding="utf-8"?>
xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
>

android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="@string/hello"
/>

android:id="@+id/EditText01"
android:layout_height="wrap_content"
android:layout_width="fill_parent"
android:inputType="text"
/>

android:text="@string/btntxt"
android:id="@+id/Button01"
android:layout_height="wrap_content"
android:layout_width="fill_parent"
/>

android:id="@+id/TextView01"
android:layout_height="wrap_content"
android:layout_width="fill_parent"
/>
>

Code the application

Change Main.java to the following:

package com.my;

import android.app.Activity;
import android.os.Bundle;
import android.text.Editable;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;

public class Main extends Activity {

EditText input;
TextView output;
Button buttonClick;

/ ** Called when the activity is first created. */
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);

input = (EditText) findViewById(R.id.EditText01);
output = (TextView) findViewById(R.id.TextView01);
buttonClick = (Button) findViewById(R.id.Button01);
buttonClick.setOnClickListener(new View.OnClickListener() {

public void onClick(View v) {
display(input.getText());
}
});
}

protected void display(Editable text) {
output.setText(text);
}
}

Run the application

Al that is left is running the application.

Right click MyAndroidAppProject.
Select Android Application within the Run-As option.
Be patient, the emulator starts up very slow. You should get the following result:

Selecting MyAndroidApp.

Enter some text and press on Click…

Appendix

Download source code Android.zip [16kB]

Android Continuous Integration

W.Elsinga — Mon, 26 Jul 2010 06:05:44 +0000

So I have been working on a Selenium RC solution with the use of Robotium. To guaranty stable implementation I have set up a Android Continuous Integration Environment. With the use of Maven and Hudson (as done here) I have achieved this.

Until next time…

p.s. Interesting vid

[qrcodetag/]

Functioneel Testen voor Android

W.Elsinga — Thu, 06 May 2010 03:49:40 +0000

Zoals vele collega’s ben ook ik bezig met het ontwikkelen van een Android applicatie. Na 4 uurtjes was daar toch mijn eerste Android app.
Ja en als goede software ontwikkelaar natuurlijk doet, unit-testen. Met JUnit de code getest. Maar ik wou ook de “frond-end” functionaliteit testen, en daar stookte het.

Tijdens mijn dagelijkse ontwikkel werkzaamheden maak ik Web applicaties en lever ik middels Selenium ook functionele testen op. Helaas ben ik tot de conclusie gekomen dat dit nog ontbreekt bij het ontwikkelen van Android applicaties.

Ik heb gekeken of Positron (een Google code project) iets is. Positron voorziet in het uitvoeren van Android Activiteiten om zodoende een test scenario na te spelen.
Ik heb ook gekeken naar Robotium. Dit is nou precies wat ik zoek, dus ben nu bezig om dit te gebruiken om functionele test te maken.

[qrcodetag/]

JavaOne 2008 – Dag 3

W.Elsinga — Fri, 30 May 2008 00:51:59 +0000

Wie ooit naar San Fransisco gaat moet uiteraard de Golden Gate Bridge gezien hebben, dus plichtsgetrouw werd de reis voortgezet naar dit stukje Amerikaanse cultuur. Al deden we dit wel op een oer Hollandse manier, juist de fiets.

Helaas na dat we de brug waren overgestoken en we even ruste voor een drankje, kwam ik er achter dat ik mijn digitale camera was verloren. &#$*$Q#&. Had ik zoveel mooie foto’s gemaakt, het enige wat ik nog overhield was het hoesje. Maargoed. Na verder te hebben gefietst zijn we met de pont terug gevaren langs Alcatraz heen.

Na al dat gefiets werd onze dag vervolgd met een reis naar het Moscone Center, waar we bijzonder gemakkelijk ons toegangsbewijs tot de JavaOne conference kregen (dat scheelt dinsdag weer een uur in de rij staan). Ook een complete tas gevuld met ICT overlevings-middelen ontbrak niet, alles was tot in de puntjes verzorgd!.

JavaOne 2008 – Dag 2

W.Elsinga — Fri, 30 May 2008 00:32:48 +0000

Na het ontbijt toch maar even de manager van het hotel gesproken waar mijn collega’s zaten om te zorgen dat ze maar een kamer voor mij moesten regelen. En dat lukte.

En daar sta je dan, down town San Francisco. Vandaag maar eens een stuk de stad gaan bekijken.

Na een prachtige route langs de baai zijn we naar Fisherman’s Wharf. Mooi om daar de zeeleeuwen te zien liggen op Pier 39, maar verder allemaal erg toeristies.

Toen zijn we weer via de buiten wijken terug naar het hotel gelopen. Dit was alleen erg afzien omdat de straten daar erg stijl omhoog en omlaag liepen, dus na het avond eten kon ik met zekerheid zeggen, slapen was wederom geen probleem enkel probleem.

JavaOne 2008 – Dag 1

W.Elsinga — Fri, 30 May 2008 00:06:00 +0000

Heb ik alles bij me: Telefoon!, IPod (voor de zekerheid ook maar het aankoopsbewijs mee)!, Paspoort!. Ik ben er dan eindelijk klaar voor, de JavaOne in San Francisco.

En daar gingen we dan, met 6 andere collega’s op weg naar de grootste Java conferentie die er is. De rit duurde iets meer dan 14 uur, tussenstop niet meegerekend, maar dankzij het tijdsverschil kwamen we om iets voor 17.00 aan in San Fransisco. Dat betekende s’ even flink doorhalen, want we waren aan het begin van de avond al behoorlijk moe!.

Ja en dan lekker je koffers kwijt in je hotel kamer om eens de stad te gaan verkennen. Nou dat ging bij mij tegelijk. Helaas was er iets niet goed gegaan met het boeken van de kamer bij het hotel, dus kreeg ik als enige een kamer in een ander hotel. Dus al ‘sightseeingde’ naar mijn ander hotel toe.

We zijn we nog even de stad in geweest om een hapje te eten, maar eigenlijk waren we te moe om ook nog maar iets verder te ondernemen; morgen hebben we een vrije dag, dus lekker op tijd naar bed was ook eigenlijk best een goede optie..

JavaOne 2008

W.Elsinga — Tue, 12 Feb 2008 01:53:30 +0000

Het is weer de tijd van het jaar om mijn kennis te delen met andere Java collega’s. En dit jaar ga ik dan eindlijk naar de JavaOne.

JavaOne is het grootste Java congres ter wereld waar tussen de 14.000 en 20.000 bezoekers komen. In de week van 5 t/m 9 mei zal ik in San Francisco veel horen over uiteenlopende zaken die zich afspelen in mijn vakgebied, Java.

Javapolis 2007 – RoundUp

W.Elsinga — Tue, 12 Feb 2008 01:27:49 +0000

Na en drukke periode prive en op het werk heb ik dan toch eindelijk de tijd om een verslag te geven van de JavaPolis 2007. Terwijl het thema van vorig jaar Meet your Idiols was, heb ik dit jaar meer van mijn idiols gezien. James Gosling, Joshua Blog, Bruce Eckel en Scott Ambler waren onder andere sprekers waarvan ik genoten heb.

Hier een korte impressie van de onderwerpen die besproken werden.

Flex en JavaFX.
JavaFX werkt goed ‘verkocht’ door James Golsing en Sun. Het zou de nieuwe generatie web technologie zijn. Dit betekend nog niet dat de ICT wereld hier meteen mee aan de haal moet gaan voor implementatie van hun software, de syntax van de taal is nog geeneens stabiel. Er werden leuke voorbeelden gegeven, maar deze lieten niet zien waarom JavaFX (en of Flex) gebruikt zouden moeten worden, namelijk voor het op een declaratief manier programmeren van gebruikers interfaces.

Agile
Scott Ambler, liet aan de hand van statastieken zien dat de meerderheid van de Amerikaanse software bedrijven wel een of meerdere projecten op de Agile manier uitvoerd. Dit betekend dat Agile toch erg volwassen begint te worden, en onderwerpen aanroept die nog niet waren aangekaart zoals modelering, testing en documenteren op een Agile manier.

Wicket
Het web framework Wicket wordt steeds pupulairder. Martijn Dashorts gaf een presenatie over dit web framework, en durfte het zelfs aan om tijdens zijn presenatie een web applicatie te maken. In mijn ogen is dit framework ideaal voor Agile software ontwikkelen.

Additionele onderwepen
– De product Bamboo van Atlassian geeft de mogelijkheid om telematry naar voren te halen van de software builds.
– Eclipse heeft een Ajax Toolkit Framework uitgebracht, tijdens het ontwikkelen en testen van Ajax in Eclipse.

Quotes
Tot slot nog een aantal quotes van de JavaPolis 2007.

The less predictable an event or task the larger the allowance for variation in a project plan

Full alphabet soup compliance