com.cloudant.client.api

Class View

java.lang.Object

com.cloudant.client.api.View

public class View
extends java.lang.Object

This class provides access to the View APIs.

Usage Example:

 List<Foo> list = db.view("example/foo")
	.startKey("start-key")
	.endKey("end-key")
	.limit(10)
	.includeDocs(true)
	.query(Foo.class);
  
  // scalar values
  int count = db.view("example/by_tag")
 	.key("couchdb")
 	.queryForInt(); 
 
 // pagination
 Page<Foo> page = db.view("example/foo").queryPage(...);
 
 

Since:

0.0.1

Author:

Ganesh K Choudhary

See Also:

CouchDatabaseBase.view(String), ViewResult

Constructor Summary

Constructors

Constructor and Description
View()

Method Summary

Methods

Modifier and Type	Method and Description
View	descending(java.lang.Boolean descending) Reverses the reading direction, not the sort order.
View	endKey(java.lang.Object... endKey)
View	endKeyDocId(java.lang.String endKeyDocId)
View	group(java.lang.Boolean group)
View	groupLevel(java.lang.Integer groupLevel)
View	includeDocs(java.lang.Boolean includeDocs)
View	inclusiveEnd(java.lang.Boolean inclusiveEnd)
View	key(java.lang.Object... key)
View	keys(java.util.List<java.lang.String> keys) Supplies a key list when calling _all_docs View.
View	limit(java.lang.Integer limit)
<T> java.util.List<T>	query(java.lang.Class<T> classOfT) Queries a view.
boolean	queryForBoolean()
int	queryForInt()
long	queryForLong()
java.io.InputStream	queryForStream() Queries a view as an InputStream
java.lang.String	queryForString()
<T> Page<T>	queryPage(int rowsPerPage, java.lang.String param, java.lang.Class<T> classOfT) Queries a view for pagination, returns a next or a previous page, this method figures out which page to return based on the given param that is generated by an earlier call to this method, quering the first page is done by passing a null param.
<K,V,T> ViewResult<K,V,T>	queryView(java.lang.Class<K> classOfK, java.lang.Class<V> classOfV, java.lang.Class<T> classOfT) Queries a view.
View	reduce(java.lang.Boolean reduce)
View	skip(java.lang.Integer skip)
View	stale(java.lang.String stale)
View	startKey(java.lang.Object... startKey)
View	startKeyDocId(java.lang.String startKeyDocId)
View	updateSeq(java.lang.Boolean updateSeq)

Methods inherited from class java.lang.Object

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

Constructor Detail

View

public View()

Method Detail

queryForStream

public java.io.InputStream queryForStream()

Queries a view as an InputStream

The stream should be properly closed after usage, as to avoid connection leaks.

Returns:

The result as an InputStream.

query

public <T> java.util.List<T> query(java.lang.Class<T> classOfT)

Queries a view.

Type Parameters:

T - Object type T

Parameters:

classOfT - The class of type T

Returns:

The result of the view query as a List<T>

queryView

public <K,V,T> ViewResult<K,V,T> queryView(java.lang.Class<K> classOfK,
                                  java.lang.Class<V> classOfV,
                                  java.lang.Class<T> classOfT)

Queries a view.

Type Parameters:

K - Object type K (key)

V - Object type V (value)

Parameters:

classOfK - The class of type K.

classOfV - The class of type V.

classOfT - The class of type T.

Returns:

The View result entries.

queryForInt

public int queryForInt()

Returns:

The result of the view as int.

queryForBoolean

public boolean queryForBoolean()

Returns:

The result of the view as boolean.

key

public View key(java.lang.Object... key)

Parameters:

key - The key value, accepts a single value or multiple values for complex keys.

startKey

public View startKey(java.lang.Object... startKey)

Parameters:

startKey - The start key value, accepts a single value or multiple values for complex keys.

startKeyDocId

public View startKeyDocId(java.lang.String startKeyDocId)

Parameters:

startKeyDocId -

Returns:

endKey

public View endKey(java.lang.Object... endKey)

Parameters:

endKey - The end key value, accepts a single value or multiple values for complex keys.

endKeyDocId

public View endKeyDocId(java.lang.String endKeyDocId)

Parameters:

endKeyDocId -

Returns:

descending

public View descending(java.lang.Boolean descending)

Reverses the reading direction, not the sort order.

queryForString

public java.lang.String queryForString()

Returns:

The result of the view as String.

limit

public View limit(java.lang.Integer limit)

Parameters:

limit -

Returns:

group

public View group(java.lang.Boolean group)

Parameters:

group - Specifies whether the reduce function reduces the result to a set of keys, or to a single result. Defaults to false (single result).

groupLevel

public View groupLevel(java.lang.Integer groupLevel)

Parameters:

groupLevel -

Returns:

queryForLong

public long queryForLong()

Returns:

The result of the view as long.

queryPage

public <T> Page<T> queryPage(int rowsPerPage,
                    java.lang.String param,
                    java.lang.Class<T> classOfT)

Queries a view for pagination, returns a next or a previous page, this method figures out which page to return based on the given param that is generated by an earlier call to this method, quering the first page is done by passing a null param.

Type Parameters:

T - Object type T

Parameters:

rowsPerPage - The number of rows per page.

param - The request parameter to use to query a page, or null to return the first page.

classOfT - The class of type T.

Returns:

Page

stale

public View stale(java.lang.String stale)

Parameters:

stale - Accept values: ok | update_after (update_after as of CouchDB 1.1.0)

skip

public View skip(java.lang.Integer skip)

Parameters:

skip - Skips n number of documents.

reduce

public View reduce(java.lang.Boolean reduce)

Parameters:

reduce - Indicates whether to use the reduce function of the view, defaults to true if the reduce function is defined.

includeDocs

public View includeDocs(java.lang.Boolean includeDocs)

Parameters:

includeDocs -

Returns:

inclusiveEnd

public View inclusiveEnd(java.lang.Boolean inclusiveEnd)

Parameters:

inclusiveEnd - Indicates whether the endkey is included in the result, defaults to true.

updateSeq

public View updateSeq(java.lang.Boolean updateSeq)

Parameters:

updateSeq -

Returns:

keys

public View keys(java.util.List<java.lang.String> keys)

Supplies a key list when calling _all_docs View.

Parameters:

keys -

Returns: