Android - An Open Handset Alliance Project

android.content
public class

android.content.ContentQueryMap

java.lang.Object
	java.util.Observable
		android.content.ContentQueryMap

Caches the contents of a cursor into a Map of String->ContentValues and optionally keeps the cache fresh by registering for updates on the cursor. The column of the database that is to be used as the key of the map is user-configurable, and the ContentValues contains all columns other than the one that is designated the key.

The cursor data is accessed by row key and column name via getValue().

Summary

Public Constructors

					ContentQueryMap(Cursor cursor, String columnNameOfKey, boolean keepUpdated, Handler handlerForUpdateNotifications)
					Creates a ContentQueryMap that caches the contents of the cursor.

Public Methods

				void	close()
				Map	getRows()
				ContentValues	getValues(String rowName)
					Access the ContentValues for the row specified by rowName
				void	requery()
					Requeries the cursor and reads the contents into mValues

Methods inherited from class java.util.Observable

addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

	Object	clone()
		Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
	boolean	equals(Object o)
		Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
	void	finalize()
		Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
final	Class	getClass()
		Answers the unique instance of java.lang.Class which represents the class of the receiver.
	int	hashCode()
		Answers an integer hash code for the receiver.
final	void	notify()
		Causes one thread which is `wait` ing on the receiver to be made ready to run.
final	void	notifyAll()
		Causes all threads which are `wait` ing on the receiver to be made ready to run.
	String	toString()
		Answers a string containing a concise, human-readable description of the receiver.
final	void	wait(long time, int frac)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait(long time)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait()
		Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by `notify` or `notifyAll`).

Details

Public Constructors

public ContentQueryMap(Cursor cursor, String columnNameOfKey, boolean keepUpdated, Handler handlerForUpdateNotifications)

Creates a ContentQueryMap that caches the contents of the cursor.

Parameters

cursor	the cursor whose contents should be cached
columnNameOfKey	the column that is to be used as the key of the values map
keepUpdated	true if the cursor should be monitored for changes and the map updated when changes do occur
handlerForUpdateNotifications	the Handler that should be used to receive notifications of changes (if requested). Normally you pass null here, but if you know that the thread that is creating this isn't a thread that can receive messages then you can create your own handler and use that here.

Public Methods

public void close()

public Map getRows()

public ContentValues getValues(String rowName)

Access the ContentValues for the row specified by rowName

Parameters

rowName	which row to read

Returns

the ContentValues for the row, or null if the row wasn't present in the cursor

public void requery()

Requeries the cursor and reads the contents into mValues

synchronized	void	addObserver(Observer observer)
		Adds the specified Observer to the list of observers.
synchronized	void	clearChanged()
		Clears the changed flag for this Observable.
synchronized	int	countObservers()
		Answers the number of Observers in the list of observers.
synchronized	void	deleteObserver(Observer observer)
		Removes the specified Observer from the list of observers.
synchronized	void	deleteObservers()
		Removes all Observers from the list of observers.
synchronized	boolean	hasChanged()
		Answers the changed flag for this Observable.
	void	notifyObservers()
		If `hasChanged()` returns true, calls the `update()` method for every Observer in the list of observers using null as the argument.
	void	notifyObservers(Object data)
		If `hasChanged()` returns true, calls the `update()` method for every Observer in the list of observers using the specified argument.
synchronized	void	setChanged()
		Sets the changed flag for this Observable.

Android - An Open Handset Alliance Project

Documentation

Goodies

android.content.ContentQueryMap

Summary

Public Constructors

Public Methods

Methods inherited from class java.util.Observable

Methods inherited from class java.lang.Object

Details

Public Constructors

public ContentQueryMap(Cursor cursor, String columnNameOfKey, boolean keepUpdated, Handler handlerForUpdateNotifications)

Parameters

Public Methods

public void close()

public Map getRows()

public ContentValues getValues(String rowName)

Parameters

Returns

public void requery()


e.g. "intent" or "activity"