com.oracle.bmc.osmanagement

Class EventPaginators

java.lang.Object

com.oracle.bmc.osmanagement.EventPaginators

@Generated(value="OracleSDKGenerator",
           comments="API Version: 20190801")
public class EventPaginators
extends Object

Collection of helper methods that can be used to provide an Iterable interface to any list operations of Event where multiple pages of data may be fetched. Two styles of iteration are supported:

• Iterating over the Response objects returned by the list operation. These are referred to as ResponseIterators, and the methods are suffixed with ResponseIterator. For example: listUsersResponseIterator
• Iterating over the resources/records being listed. These are referred to as RecordIterators, and the methods are suffixed with RecordIterator. For example: listUsersRecordIterator

These iterables abstract away the need to write code to manually handle pagination via looping and using the page tokens. They will automatically fetch more data from the service when required.

As an example, if we were using the ListUsers operation in IdentityService, then the Iterable returned by calling a ResponseIterator method would iterate over the ListUsersResponse objects returned by each ListUsers call, whereas the Iterable returned by calling a RecordIterator method would iterate over the User records and we don’t have to deal with ListUsersResponse objects at all. In either case, pagination will be automatically handled so we can iterate until there are no more responses or no more resources/records available.

Constructor Summary

Constructors

Constructor and Description
EventPaginators(Event client)

Method Summary

Modifier and Type	Method and Description
Iterable<EventSummary>	listEventsRecordIterator(ListEventsRequest request) Creates a new iterable which will iterate over the EventSummary objects contained in responses from the listEvents operation.
Iterable<ListEventsResponse>	listEventsResponseIterator(ListEventsRequest request) Creates a new iterable which will iterate over the responses received from the listEvents operation.
Iterable<RelatedEventSummary>	listRelatedEventsRecordIterator(ListRelatedEventsRequest request) Creates a new iterable which will iterate over the RelatedEventSummary objects contained in responses from the listRelatedEvents operation.
Iterable<ListRelatedEventsResponse>	listRelatedEventsResponseIterator(ListRelatedEventsRequest request) Creates a new iterable which will iterate over the responses received from the listRelatedEvents operation.

Methods inherited from class java.lang.Object

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

Constructor Detail

EventPaginators

@ConstructorProperties(value="client")
public EventPaginators(Event client)

Method Detail

listEventsResponseIterator

public Iterable<ListEventsResponse> listEventsResponseIterator(ListEventsRequest request)

Creates a new iterable which will iterate over the responses received from the listEvents operation. This iterable will fetch more data from the server as needed.

Parameters:

request - a request which can be sent to the service operation

Returns:

an Iterable which can be used to iterate over the responses received from the service.

listEventsRecordIterator

public Iterable<EventSummary> listEventsRecordIterator(ListEventsRequest request)

Creates a new iterable which will iterate over the EventSummary objects contained in responses from the listEvents operation. This iterable will fetch more data from the server as needed.

Parameters:

request - a request which can be sent to the service operation

Returns:

an Iterable which can be used to iterate over the EventSummary objects contained in responses received from the service.

listRelatedEventsResponseIterator

public Iterable<ListRelatedEventsResponse> listRelatedEventsResponseIterator(ListRelatedEventsRequest request)

Creates a new iterable which will iterate over the responses received from the listRelatedEvents operation. This iterable will fetch more data from the server as needed.

Parameters:

request - a request which can be sent to the service operation

Returns:

an Iterable which can be used to iterate over the responses received from the service.

listRelatedEventsRecordIterator

public Iterable<RelatedEventSummary> listRelatedEventsRecordIterator(ListRelatedEventsRequest request)

Creates a new iterable which will iterate over the RelatedEventSummary objects contained in responses from the listRelatedEvents operation. This iterable will fetch more data from the server as needed.

Parameters:

request - a request which can be sent to the service operation

Returns:

an Iterable which can be used to iterate over the RelatedEventSummary objects contained in responses received from the service.