01: /*
02: * Copyright (c) 2007, intarsys consulting GmbH
03: *
04: * Redistribution and use in source and binary forms, with or without
05: * modification, are permitted provided that the following conditions are met:
06: *
07: * - Redistributions of source code must retain the above copyright notice,
08: * this list of conditions and the following disclaimer.
09: *
10: * - Redistributions in binary form must reproduce the above copyright notice,
11: * this list of conditions and the following disclaimer in the documentation
12: * and/or other materials provided with the distribution.
13: *
14: * - Neither the name of intarsys nor the names of its contributors may be used
15: * to endorse or promote products derived from this software without specific
16: * prior written permission.
17: *
18: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19: * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21: * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
22: * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23: * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24: * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25: * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26: * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27: * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28: * POSSIBILITY OF SUCH DAMAGE.
29: */
30: package de.intarsys.pdf.cos;
31:
32: /**
33: * A listener for changes in a {@link COSObject}.
34: *
35: */
36: public interface ICOSObjectListener {
37: /**
38: * A COSObject has changed its internal state. For any {@link COSObject}
39: * this may be a change in containement (slot == COSObject.SLOT_CONTAINER).
40: * <p>
41: * For containers itself, this may be a change in the collection of
42: * contained objects. For dictionaries, slot will be the {@link COSName} of
43: * the changed entry, for arrays slot will be the {@link Integer} key. A
44: * stream may indicate a change in its byte content using (slot ==
45: * COSStream.SLOT_BYTES).
46: * <p>
47: * A slot value of <code> null</code> may indicate a "changed all" event.
48: * For example you can expect for a <code>clear</code> operation on an
49: * array only a single "changed all" event.
50: *
51: * @param object
52: * The object that has changed
53: * @param slot
54: * The slot in the object that has changed (or null for
55: * unspecified change).
56: * @param oldValue
57: * The old value of the slot if known.
58: * @param newValue
59: * The new value of the slot if known.
60: */
61: public void changed(COSObject object, Object slot, Object oldValue,
62: Object newValue);
63: }
|