com.box.androidsdk.content.requests

Class BoxRequestsEvent.GetEnterpriseEvents

java.lang.Object

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

com.box.androidsdk.content.requests.BoxRequestsEvent.GetEnterpriseEvents

Enclosing class:

BoxRequestsEvent

public static class BoxRequestsEvent.GetEnterpriseEvents
extends BoxRequest<E,R>

Request for retrieving a stream of all events in an enterprise.

Nested Class Summary

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

BoxRequest.BoxRequestHandler, BoxRequest.ContentTypes, BoxRequest.Methods

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	FIELD_CREATED_AFTER
static java.lang.String	FIELD_CREATED_BEFORE
static java.lang.String	FIELD_LIMIT
static java.lang.String	FIELD_STREAM_POSITION
static java.lang.String	FIELD_STREAM_TYPE
protected static java.lang.String	STREAM_TYPE
static java.lang.String	STREAM_TYPE_ALL
static java.lang.String	STREAM_TYPE_CHANGES
static java.lang.String	STREAM_TYPE_SYNC

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

mBodyMap, mContentType, mHeaderMap, mListener, mQueryMap, mRequestMethod, mRequestUrlString, mSession

Constructor Summary

Constructors

Constructor and Description
BoxRequestsEvent.GetEnterpriseEvents(java.lang.String requestUrl, BoxSession session) Creates an enterprise event stream with the default parameters.

Method Summary

Methods

Modifier and Type	Method and Description
E	send() Synchronously make the request to Box and handle the response appropriately.
BoxRequestsEvent.GetEnterpriseEvents	setCreatedAfter(java.util.Date date) Sets the lower bound on the timestamp of events returned in the request.
BoxRequestsEvent.GetEnterpriseEvents	setCreatedBefore(java.util.Date date) Sets the upper bound on the timestamp of events returned in the request.
R	setFilterDuplicates(boolean filterDuplicates) Sets whether or not the list of events contains duplicates which can be returned due to syncing issues.
R	setLimit(int limit) Sets the maximum number of events to return in the list of events.
R	setPreviousListEvents(E listEvents) Convenience method.
R	setStreamPosition(java.lang.String streamPosition) Sets the stream position of items that should be returned.
protected R	setStreamType(java.lang.String streamType) Limits the type of events returned.

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

buildUrl, createHttpRequest, createQuery, getIfMatchEtag, getIfNoneMatchEtag, getRequestHandler, getSession, getStringBody, importRequestContentMapsFrom, logDebug, parseHashMapEntry, parseJsonObject, setBody, setContentType, setHeaders, setIfMatchEtag, setIfNoneMatchEtag, setRequestHandler, setTimeOut, toTask

Methods inherited from class java.lang.Object

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

Field Detail

FIELD_CREATED_AFTER

public static final java.lang.String FIELD_CREATED_AFTER

See Also:

Constant Field Values

FIELD_CREATED_BEFORE

public static final java.lang.String FIELD_CREATED_BEFORE

See Also:

Constant Field Values

STREAM_TYPE

protected static final java.lang.String STREAM_TYPE

See Also:

Constant Field Values

STREAM_TYPE_ALL

public static final java.lang.String STREAM_TYPE_ALL

See Also:

Constant Field Values

STREAM_TYPE_CHANGES

public static final java.lang.String STREAM_TYPE_CHANGES

See Also:

Constant Field Values

STREAM_TYPE_SYNC

public static final java.lang.String STREAM_TYPE_SYNC

See Also:

Constant Field Values

FIELD_STREAM_POSITION

public static final java.lang.String FIELD_STREAM_POSITION

See Also:

Constant Field Values

FIELD_STREAM_TYPE

public static final java.lang.String FIELD_STREAM_TYPE

See Also:

Constant Field Values

FIELD_LIMIT

public static final java.lang.String FIELD_LIMIT

See Also:

Constant Field Values

Constructor Detail

BoxRequestsEvent.GetEnterpriseEvents

public BoxRequestsEvent.GetEnterpriseEvents(java.lang.String requestUrl,
                                    BoxSession session)

Creates an enterprise event stream with the default parameters.

Parameters:

requestUrl - URL for the events endpoint.

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

Method Detail

setCreatedAfter

public BoxRequestsEvent.GetEnterpriseEvents setCreatedAfter(java.util.Date date)

Sets the lower bound on the timestamp of events returned in the request.

Parameters:

date - date events should be created after.

Returns:

request with the updated created after date.

setCreatedBefore

public BoxRequestsEvent.GetEnterpriseEvents setCreatedBefore(java.util.Date date)

Sets the upper bound on the timestamp of events returned in the request.

Parameters:

date - date events should be created before.

Returns:

request with the updated created before date.

setStreamPosition

public R setStreamPosition(java.lang.String streamPosition)

Sets the stream position of items that should be returned. Usually a number in String format, but can be "now".

Parameters:

streamPosition - stream position to start from for returning events.

Returns:

the get events request

setStreamType

protected R setStreamType(java.lang.String streamType)

Limits the type of events returned. Can be set to: all: returns everything changes: returns tree changes sync: returns tree changes only for sync folders admin_logs: used for events in enterprise.

Parameters:

streamType - the type of events to get.

Returns:

the get events request

setLimit

public R setLimit(int limit)

Sets the maximum number of events to return in the list of events.

Parameters:

limit - max number of events to request.

Returns:

the get events request

setFilterDuplicates

public R setFilterDuplicates(boolean filterDuplicates)

Sets whether or not the list of events contains duplicates which can be returned due to syncing issues. By default this is true.

Parameters:

filterDuplicates - true to do duplicate removal, false to allow returned list to contain the duplicates.

Returns:

the get events request

setPreviousListEvents

public R setPreviousListEvents(E listEvents)

Convenience method. When set the request will be set to the next stream position from the given event and will will aggregate the new results with the provided list.

Parameters:

listEvents - A list of events to add to.

Returns:

A BoxRequestEvent object.

send

public E send()
                             throws BoxException

Description copied from class: BoxRequest

Synchronously make the request to Box and handle the response appropriately.

Overrides:

send in class BoxRequest<E extends BoxJsonObject,R extends BoxRequest<E,R>>

Returns:

the expected BoxObject if the request is successful.

Throws:

BoxException - thrown if there was a problem with handling the request.