01: /*
02: * Copyright 2006 Day Management AG, Switzerland. All rights reserved.
03: */
04: package javax.jcr.observation;
05:
06: import java.util.Calendar;
07:
08: /**
09: * An <code>EventJournal</code> is an extension of <code>EventIterator</code>
10: * that provides the additional method {@link #skipTo(Calendar)}:
11: *
12: * @since JCR 2.0
13: */
14: public interface EventJournal extends EventIterator {
15:
16: /**
17: * Skip all elements of the iterator earlier than <code>date</code>.
18: * <p/>
19: * If an attempt is made to skip past the last element of the iterator,
20: * no exception is thrown but the subsequent {@link #nextEvent()} will fail.
21: *
22: * @param date a <code>Calendar</code> object
23: */
24: public void skipTo(Calendar date);
25: }
|