com.box.androidsdk.content.requests

Class BoxRequestsBookmark.GetBookmarkInfo

java.lang.Object

com.box.androidsdk.content.requests.BoxRequest<E,R>

com.box.androidsdk.content.requests.BoxRequestItem<BoxBookmark,BoxRequestsBookmark.GetBookmarkInfo>

com.box.androidsdk.content.requests.BoxRequestsBookmark.GetBookmarkInfo

All Implemented Interfaces:

BoxCacheableRequest<BoxBookmark>, java.io.Serializable

Enclosing class:

BoxRequestsBookmark

public static class BoxRequestsBookmark.GetBookmarkInfo
extends BoxRequestItem<BoxBookmark,BoxRequestsBookmark.GetBookmarkInfo>
implements BoxCacheableRequest<BoxBookmark>

Request for retrieving information on a bookmark

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.box.androidsdk.content.requests.BoxRequest

BoxRequest.BoxRequestHandler<R extends BoxRequest>, BoxRequest.ContentTypes, BoxRequest.Methods

Field Summary

Fields inherited from class com.box.androidsdk.content.requests.BoxRequestItem

mId, QUERY_FIELDS

Fields inherited from class com.box.androidsdk.content.requests.BoxRequest

JSON_OBJECT, mBodyMap, mContentType, mHeaderMap, mListener, mQueryMap, mRequestMethod, mRequestUrlString, mRequiresSocket, mSession, mTimeout

Constructor Summary

Constructors

Constructor and Description
GetBookmarkInfo(java.lang.String id, java.lang.String requestUrl, BoxSession session) Creates a bookmark information request with the default parameters

Method Summary

Modifier and Type	Method and Description
java.lang.String	getIfNoneMatchEtag() Returns the etag currently set in the if-none-match header.
BoxBookmark	sendForCachedResult() Sends the request to fetch results from cache synchronously.
BoxRequestsBookmark.GetBookmarkInfo	setIfNoneMatchEtag(java.lang.String etag) Sets the if-none-match header for the request.
BoxFutureTask<BoxBookmark>	toTaskForCachedResult() Converts the request to a BoxCacheFutureTask that can be used to execute the request asynchronously.

Methods inherited from class com.box.androidsdk.content.requests.BoxRequestItem

getId, onSendCompleted, setFields

Methods inherited from class com.box.androidsdk.content.requests.BoxRequest

buildUrl, createHeaderMap, createHttpRequest, createQuery, equals, getIfMatchEtag, getRequestHandler, getSession, getSocket, getStringBody, handleSendForCachedResult, handleToTaskForCachedResult, handleUpdateCache, hashCode, importRequestContentMapsFrom, logDebug, logRequest, onSend, parseHashMapEntry, parseJsonObject, send, sendRequest, setBody, setContentType, setHeaders, setIfMatchEtag, setRequestHandler, setTimeOut, toTask

Methods inherited from class java.lang.Object

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

Constructor Detail

GetBookmarkInfo

public GetBookmarkInfo(java.lang.String id,
                       java.lang.String requestUrl,
                       BoxSession session)

Creates a bookmark information request with the default parameters

Parameters:

id - id of the bookmark to get information on

requestUrl - URL of the bookmark information endpoint

session - the authenticated session that will be used to make the request with

Method Detail

setIfNoneMatchEtag

public BoxRequestsBookmark.GetBookmarkInfo setIfNoneMatchEtag(java.lang.String etag)

Sets the if-none-match header for the request. The bookmark will only be retrieved if the etag does not match the most current etag for the bookmark.

Overrides:

setIfNoneMatchEtag in class BoxRequest<BoxBookmark,BoxRequestsBookmark.GetBookmarkInfo>

Parameters:

etag - etag to set in the if-none-match header.

Returns:

request with the updated if-none-match header.

getIfNoneMatchEtag

public java.lang.String getIfNoneMatchEtag()

Returns the etag currently set in the if-none-match header.

Overrides:

getIfNoneMatchEtag in class BoxRequest<BoxBookmark,BoxRequestsBookmark.GetBookmarkInfo>

Returns:

etag set in the if-none-match header, or null if none set.

sendForCachedResult

public BoxBookmark sendForCachedResult()
                                throws BoxException

Description copied from interface: BoxCacheableRequest

Sends the request to fetch results from cache synchronously.

Specified by:

sendForCachedResult in interface BoxCacheableRequest<BoxBookmark>

Returns:

the cached results of the request

Throws:

BoxException - thrown if there is no implementation of BoxCache set in BoxConfig, or if there was another issue getting cached results.

toTaskForCachedResult

public BoxFutureTask<BoxBookmark> toTaskForCachedResult()
                                                 throws BoxException

Description copied from interface: BoxCacheableRequest

Converts the request to a BoxCacheFutureTask that can be used to execute the request asynchronously.

Specified by:

toTaskForCachedResult in interface BoxCacheableRequest<BoxBookmark>

Returns:

a task that will fetch the results from the cache

Throws:

BoxException - thrown if there is no implementation of BoxCache set in BoxConfig.