APIArchiv

In meinem letzten Beitrag “Using the Android Interface Definition Language (AIDL) to make a Remote Procedure Call (RPC) in Android” habe ich die Grundlagen erläutert, wie die Kommunikation zwischen Prozessen in Android umgesetzt werden kann. Jetzt werden wir einen Blick auf ein Spezialgebiet in diesem Bereich werfen: Parcelables als Parameter einer AIDL Methode.

Wie im letzten Beitrag beschrieben, ist es möglich, entweder primitive Java Typen innerhalb einer Remote-Method Signature oder irgendeine Klasse, die das android.os.Parcelable Interface implementiert, zu benutzen. Über dies Interface ist es möglich, beliebig komplexe Datentypen zu definieren, die als Parameter oder Rückgabewerte von Methoden während eines Remote Method Aufrufs genutzt werden können.

Ich habe eine modifizierte Version des ersten Beispiel-Apps kreiert, um Ihnen ein einfaches Beispiel zu geben, das ein Parcelable Object als Methoden-Rückgabewert nutzt. Das Beispiel besteht aus einem Service, der ein Parcelable Message Object erzeugt, das die aktuelle Systemzeit sowie das Erscheinungsbild des Textes, wie Farbe, Größe und Stil, enthält. Im zweiten Teil des Beispiels finden Sie eine Activity, die mit dem AIDL IPC ein solches Message Object erzeugt, um die aktuelle Uhrzeit anzuzeigen. Die entsprechenden Projekte sind AIDLRemoteClientUsingParcelableObject für das Client-Projekt (enthält die Activity) und AIDLRemoteMessageServiceUsingParcelableObject für den Server (enthält den Service).

Es gibt verschiedene Möglichkeiten, mit einem Service zu kommunizieren. Ein häufig gebrauchter Ansatz ist die Verwendung von Intents, wobei der Service entsprechend der durchgeführten Intent-Action reagieren kann. Dies ist einfach zu realisieren, aber wenn der Service viele verschiedene Operationen definiert, kann der resultierende Code sehr komplex und dadurch nur schwer wartbar werden. Wenn Intents verwendet werden, muss der Entwickler sich außerdem immer darum kümmern, die Parameter zu dem Intent hinzuzufügen; und nachdem das Ergebnis empfangen wurde, müssen die Ergebnis-Parameter aus dem Intent extrahiert werden. Dies führt zu einem erhöhten Programmier-Overhead innerhalb des Clients wann immer eine Remote-Funktionalität aufgerufen wird, was zu fehleranfälligem Code führen kann.

Zur Vermeidung dieser Nachteile kann der integrierten Remote Procedure Call (RPC) Mechanismus von Android verwendet werden. Zur Demonstration der Verwendung von RPCs in Android habe ich ein einfaches Beispiel erstellt. Dieses Beispiel besteht aus zwei Apps, wobei das erste einen Service und das zweite eine Activity enthält. Die Activity verbindet sich mit dem Service mit Hilfe des Android-RPC-Mechanismus und fordert einen string vom Service an.

Bei der Entwicklung von Anwendungen für das Android OS kommt es vor, dass allgemeine Activities oder Services mit wenig Änderungen in weiteren Anwendungen wieder verwendet werden könnten. Da Sie diese Klassen nicht in jedes einzelnen Projekt kopieren möchten – was zu einem kaum handhabbarem Code führen würde – wäre es besser, einen Weg zu finden, den Quellcode dieser Klassen aus weiteren Projekten heraus zu referenzieren. Für Nicht-Android-Anwendungen kann man das Problem lösen, indem man den Code in mehrere Bibliotheken aufteilt, so dass die gewünschte Funktionalität von mehreren Projekten referenziert werden kann. Solange keine Interaktion mit externen Ressourcen nötig ist, ist das auch in Android Projekten ohne weiteres möglich (erstellen Sie ein jar und referenzieren Sie es in den Projekten). Aber wenn Sie mit externen Ressourcen arbeiten, können diese Klassen nicht innerhalb einer Bibliothek verwendet werden, weil das Android SDK keine passenden IDs innerhalb der “R”-Klasse für externe Ressourcen erzeugt, die in einer referenzierten jar-Datei enthalten sind.

In diesem Beitrag möchte ich Ihnen verschiedene Lösungen für dieses Problem zeigen, wodurch Sie vermeiden können, den Quellcode in die Projekte zu kopieren.

Today we are going to take a look at custom entries for a Spinner or ListView. Android allows the developers to create custom layouts for the entries in a Spinner or ListView. Using this mechanism it’s possible to implement highly customized designs for the default GUI elements such as the spinner. For example it’s possible to implement a spinner with entries consisting of an image and of multiple lines of text. In this post I will explain the three steps required to implement this functionality using the Query Contacts App from my previous post. In this App I’ve implemented a Spinner with custom entries to display the contact photo together with the contact name embedded in a single entry. Furthermore each element of the ListView which is used to display the details of the contact contains two lines of text.
Because the implementation of a custom ListView element is very similar to implementing a custom Spinner element I will only explain the Spinner element and mention the differences when implementing a custom entry for a ListView. Of course you can browse or download the source code of the example App at our SVN repository at Google Code (http://code.google.com/p/android-contacts-contract-example/) or use svn to check the project out and your allowed to reuse portions of this code as you wish.

Defining the Layout

The first step when using a custom layout for a Spinner entry is to define a layout xml file. The file must be located in the “res/layout” folder of your project. In our example I’ve created the “res/layout/ spinner_entry_with_icon.xml” layout file which contains a TableLayout with an ImageView and a TextView element.

<?xml version="1.0" encoding="utf-8"?>
<TableLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
>
<TableRow android:id="@+id/tableRow1" android:layout_width="wrap_content" android:layout_height="wrap_content">
<ImageView android:layout_width="32sp" android:src="@drawable/icon" android:id="@+id/spinnerEntryContactPhoto" android:layout_height="32sp" />
<TextView android:textSize="22sp" android:textStyle="bold" android:layout_width="fill_parent" android:id="@+id/spinnerEntryContactName" android:layout_height="fill_parent" android:paddingLeft="5sp" />
</TableRow>
</TableLayout>

Implementing the Adapter

Implementing the Adapter is the next and only step which requires some coding. There are two interfaces available which can be implemented one for Spinner “android.widget.SpinnerAdapter“ and the other for ListView “android.widget.ListAdapter”. But we don’t have to implement all methods defined in this interfaces because there exists an abstract super class which we can use. The “android.widget.BaseAdapter” class provides all core methods required by the two interfaces mentioned above we only have to take care of four abstract methods.

  1. public int getCount()

    This method should return the amount of entries this adapter provides.

  2. public Object getItem(int position)

    This method should return the object associated with the given position.

  3. public long getItemId(int position)

    This method should return the row id for the given position.

  4. public View getView(int position, View convertView, ViewGroup parent)

    This method should return a View which represents this position. We will use our custom layout here in this method.

For the Spinner Adapter in our example I’ve created the class “ContactsSpinnerAdapter” defined as shown below.

public class ContactsSpinnerAdapater extends BaseAdapter implements
SpinnerAdapter {
private final List<SpinnerEntry> content;
private final Activity activity;

public ContactsSpinnerAdapater(List<SpinnerEntry> content,
Activity activity) {
super();
this.content = content;
this.activity = activity;
}
…
}

If you want to implement a custom layout for a ListView just implement the ListAdapter interface instead of the SpinnerAdapter interface.

The data which this Adapter provides is stored in the filed variable content as a default java list. The reference to this list together with the reference to the Activity is provided in the constructor. The reference to the Activity is required later when creating the custom View. The first three methods are very simple to implement. The method getCount will just return the size of our list, getItem returns the item in the list at the given position and getItemId returns the same row number as the given position.

public int getCount() {
return content.size();
}

public SpinnerEntry getItem(int position) {
return content.get(position);
}

public long getItemId(int position) {
return position;
}

The important method is the getView method. I’ve used the default layout inflater to parse the layout file and to make the GUI elements available in the code.

public View getView(int position, View convertView, ViewGroup parent) {
final LayoutInflater inflater = activity.getLayoutInflater();
final View spinnerEntry = inflater.inflate(
R.layout.spinner_entry_with_icon, null);	// initialize the layout from xml

Now we can access the View spinnerEntry in the same way as we are used to from Activitys. Using the findViewById Method we can get the GUI child elements such as the ImageView and the TextView. Furthermore, according to the given position we can get the data from the content of the adapter and use the information stored there to set the data in the GUI elements (setText and setImageBitmap). In the last step we return the spinnerEntry View.

	final TextView contactName = (TextView) spinnerEntry
.findViewById(R.id.spinnerEntryContactName);
final ImageView contactImage = (ImageView) spinnerEntry
.findViewById(R.id.spinnerEntryContactPhoto);
final SpinnerEntry currentEntry = content.get(position);
contactName.setText(currentEntry.getContactName());
contactImage.setImageBitmap(currentEntry.getContactPhoto());
return spinnerEntry;
}

Adding the Adapter to the View

Adding the custom adapter to a Spinner or ListView is the same as with default Adapters like the ArrayAdapter. In our example we add the adapter to our Spinner in the MainActivity:

contactSpinner = (Spinner)findViewById(R.id.contactsSpinner);
final List<SpinnerEntry> spinnerContent = new LinkedList<SpinnerEntry>();
final ContactsSpinnerAdapater adapter = new ContactsSpinnerAdapater(spinnerContent, this);
contactSpinner.setAdapter(adapter);

Result and Summary

The resulting Spinner entries will look like this:

Custom Spinner Entries

You can easily adapt the presented approach to your own needs and thus create custom Spinner and ListView elements that match the needs of your App.