blob: f6954f473c58f1c2754700c3c2c9d52caa64c63a (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
/*******************************************************************************
* Copyright (c) 2009, 2010 Oracle. All rights reserved.
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v1.0, which accompanies this distribution
* and is available at http://www.eclipse.org/legal/epl-v10.html.
*
* Contributors:
* Oracle - initial API and implementation
******************************************************************************/
package org.eclipse.jpt.utility.synchronizers;
import java.io.Serializable;
import java.util.EventListener;
/**
* Extend {@link Synchronizer} to notify listeners
* when a synchronization "cycle" is complete; i.e. the synchronization has,
* for the moment, quiesced.
*/
public interface CallbackSynchronizer
extends Synchronizer
{
/**
* Add the specified listener to be notified whenever the synchronizer has
* quiesced.
* @see #removeListener(Listener)
*/
void addListener(Listener listener);
/**
* Remove the specified listener.
* @see #addListener(Listener)
*/
void removeListener(Listener listener);
// ********** listener **********
/**
* Interface implemented by listeners to be notified whenever the
* synchronizer has quiesced.
*/
public interface Listener
extends EventListener
{
/**
* The specified synchronizer has quiesced.
*/
void synchronizationQuiesced(CallbackSynchronizer synchronizer);
}
/**
* Singleton implementation of the {@link CallbackSynchronizer} interface that will do
* nothing.
*/
final class Null implements CallbackSynchronizer, Serializable {
public static final CallbackSynchronizer INSTANCE = new Null();
public static CallbackSynchronizer instance() {
return INSTANCE;
}
// ensure single instance
private Null() {
super();
}
public void start() {
// do nothing
}
public void synchronize() {
// do nothing
}
public void stop() {
// do nothing
}
public void addListener(Listener listener) {
// do nothing
}
public void removeListener(Listener listener) {
// do nothing
}
@Override
public String toString() {
return "CallbackSynchronizer.Null"; //$NON-NLS-1$
}
private static final long serialVersionUID = 1L;
private Object readResolve() {
// replace this object with the singleton
return INSTANCE;
}
}
}
|