org.kohsuke.github

Class GHNotificationStream

java.lang.Object

org.kohsuke.github.GHNotificationStream

All Implemented Interfaces:

java.lang.Iterable<GHThread>

public class GHNotificationStream
extends java.lang.Object
implements java.lang.Iterable<GHThread>

Listens to GitHub notification stream.

This class supports two modes of retrieving notifications that can be controlled via nonBlocking(boolean).

In the blocking mode, which is the default, iterator will be infinite. The call to Iterator.next() will block until a new notification arrives. This is useful for application that runs perpetually and reacts to notifications.

In the non-blocking mode, the iterator will only report the set of notifications initially retrieved from GitHub, then quit. This is useful for a batch application to process the current set of notifications.

Author:

Kohsuke Kawaguchi

See Also:

GitHub.listNotifications(), GHRepository.listNotifications()

Method Summary

Modifier and Type	Method and Description
java.util.Iterator<GHThread>	iterator() Returns an infinite blocking Iterator that returns GHThread as notifications arrive.
void	markAsRead()
void	markAsRead(long timestamp) Marks all the notifications as read.
GHNotificationStream	nonBlocking(boolean v) If set to true, iterator() will stop iterating instead of blocking and waiting for the updates to arrive.
GHNotificationStream	participating(boolean v) Should the stream be restricted to notifications in which the user is directly participating or mentioned?
GHNotificationStream	read(boolean v) Should the stream include notifications that are already read?
GHNotificationStream	since(java.util.Date dt)
GHNotificationStream	since(long timestamp)

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Method Detail

read

public GHNotificationStream read(boolean v)

Should the stream include notifications that are already read?

participating

public GHNotificationStream participating(boolean v)

Should the stream be restricted to notifications in which the user is directly participating or mentioned?

since

public GHNotificationStream since(long timestamp)

since

public GHNotificationStream since(java.util.Date dt)

nonBlocking

public GHNotificationStream nonBlocking(boolean v)

If set to true, iterator() will stop iterating instead of blocking and waiting for the updates to arrive.

iterator

public java.util.Iterator<GHThread> iterator()

Returns an infinite blocking Iterator that returns GHThread as notifications arrive.

Specified by:

iterator in interface java.lang.Iterable<GHThread>

markAsRead

public void markAsRead()
                throws java.io.IOException

Throws:

java.io.IOException

markAsRead

public void markAsRead(long timestamp)
                throws java.io.IOException

Marks all the notifications as read.

Throws:

java.io.IOException