net.zer0bandwidth.android.lib.content.querybuilder

Class UpdateBuilder

java.lang.Object

net.zer0bandwidth.android.lib.content.querybuilder.QueryBuilder<UpdateBuilder,java.lang.Integer>

net.zer0bandwidth.android.lib.content.querybuilder.UpdateBuilder

public class UpdateBuilder
extends QueryBuilder<UpdateBuilder,java.lang.Integer>

Builds an insertion query against a given ContentResolver and Uri.

Examples

Update all rows.

     int nUpdated = QueryBuilder.update( rslv, uri )
             .setValues( vals )
             .updateAll()
             .execute()
             ;
 

Update specific rows.

     int nUpdated = QueryBuilder.update( rslv, uri )
             .setValues( vals )
             .where( "some_column=?", sSomeValue )
             .execute()
             ;
 

Since:

zer0bandwidth-net/android 0.1.7 (#38)

Nested Class Summary

Nested classes/interfaces inherited from class net.zer0bandwidth.android.lib.content.querybuilder.QueryBuilder

QueryBuilder.ExecutionException, QueryBuilder.UnboundException

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	LOG_TAG

Fields inherited from class net.zer0bandwidth.android.lib.content.querybuilder.QueryBuilder

m_asExplicitWhereParams, m_rslv, m_sExplicitWhereFormat, m_uri, m_valsToWrite

Constructor Summary

Constructors

Constructor and Description
UpdateBuilder()
UpdateBuilder(android.content.ContentResolver rslv, android.net.Uri uri)
UpdateBuilder(android.content.Context ctx, android.net.Uri uri)

Method Summary

Modifier and Type	Method and Description
java.lang.Integer	executeQuery(android.content.ContentResolver rslv, android.net.Uri uri) Consumed by QueryBuilder.execute() and QueryBuilder.executeOn(android.content.ContentResolver, android.net.Uri) to actually carry out the operation.
UpdateBuilder	updateAll() Convenience grammar specifying that all rows should be updated.

Methods inherited from class net.zer0bandwidth.android.lib.content.querybuilder.QueryBuilder

delete, deleteFrom, deleteFrom, execute, executeOn, executeOn, getContentResolver, getWhereFormat, getWhereParams, insert, insertInto, insertInto, onDataSource, onDataSource, select, selectFrom, selectFrom, setValues, update, update, update, validateDataContextBinding, where, where, where

Methods inherited from class java.lang.Object

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

Field Detail

LOG_TAG

public static final java.lang.String LOG_TAG

Constructor Detail

UpdateBuilder

public UpdateBuilder(android.content.ContentResolver rslv,
                     android.net.Uri uri)

UpdateBuilder

public UpdateBuilder(android.content.Context ctx,
                     android.net.Uri uri)

UpdateBuilder

public UpdateBuilder()

Method Detail

updateAll

public UpdateBuilder updateAll()

Convenience grammar specifying that all rows should be updated.

Returns:

(fluid)

executeQuery

public java.lang.Integer executeQuery(android.content.ContentResolver rslv,
                                      android.net.Uri uri)
                               throws java.lang.Exception

Description copied from class: QueryBuilder

Consumed by QueryBuilder.execute() and QueryBuilder.executeOn(android.content.ContentResolver, android.net.Uri) to actually carry out the operation. In the implementation class, this method should consist solely of the ContentResolver query method call, plus any other pre-checks which might be able to short-circuit the query execution.

Specified by:

executeQuery in class QueryBuilder<UpdateBuilder,java.lang.Integer>

Parameters:

rslv - the resolver through which the query should be executed

uri - the URI at which the query should be executed

Returns:

the return type appropriate to the query action

Throws:

java.lang.Exception - if anything goes wrong