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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
|
/*******************************************************************************
* Copyright (c) 2004-2008 Gabor Bergmann and Daniel Varro
* Copyright (c) 2023 The Refinery Authors <https://refinery.tools>
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v. 2.0 which is available at
* http://www.eclipse.org/legal/epl-v20.html.
*
* SPDX-License-Identifier: EPL-2.0
*******************************************************************************/
package tools.refinery.interpreter.rete.network;
import tools.refinery.interpreter.rete.network.communication.Timestamp;
import tools.refinery.interpreter.rete.network.mailbox.Mailbox;
import tools.refinery.interpreter.rete.traceability.TraceInfo;
import tools.refinery.interpreter.matchers.tuple.Tuple;
import tools.refinery.interpreter.matchers.tuple.TupleMask;
import tools.refinery.interpreter.matchers.util.CollectionsFactory;
import tools.refinery.interpreter.matchers.util.Direction;
import tools.refinery.interpreter.rete.index.GenericProjectionIndexer;
import tools.refinery.interpreter.rete.index.ProjectionIndexer;
import java.util.Collection;
import java.util.HashSet;
import java.util.List;
import java.util.Set;
/**
* Base implementation for a supplier node.
*
* @author Gabor Bergmann
*
*/
public abstract class StandardNode extends BaseNode implements Supplier, NetworkStructureChangeSensitiveNode {
protected final List<Receiver> children = CollectionsFactory.createObserverList();
/**
* @since 2.2
*/
protected final List<Mailbox> childMailboxes = CollectionsFactory.createObserverList();
public StandardNode(final ReteContainer reteContainer) {
super(reteContainer);
}
/**
* @since 2.4
*/
protected void propagateUpdate(final Direction direction, final Tuple updateElement, final Timestamp timestamp) {
reteContainer.checkCancelled();
for (final Mailbox childMailbox : childMailboxes) {
childMailbox.postMessage(direction, updateElement, timestamp);
}
}
@Override
public void appendChild(final Receiver receiver) {
children.add(receiver);
childMailboxes.add(this.getCommunicationTracker().proxifyMailbox(this, receiver.getMailbox()));
}
@Override
public void removeChild(final Receiver receiver) {
children.remove(receiver);
Mailbox mailboxToRemove = null;
for (final Mailbox mailbox : childMailboxes) {
if (mailbox.getReceiver() == receiver) {
mailboxToRemove = mailbox;
break;
}
}
assert mailboxToRemove != null;
childMailboxes.remove(mailboxToRemove);
}
@Override
public void networkStructureChanged() {
childMailboxes.clear();
for (final Receiver receiver : children) {
childMailboxes.add(this.getCommunicationTracker().proxifyMailbox(this, receiver.getMailbox()));
}
}
@Override
public Collection<Receiver> getReceivers() {
return children;
}
/**
* @since 2.2
*/
public Collection<Mailbox> getChildMailboxes() {
return this.childMailboxes;
}
@Override
public Set<Tuple> getPulledContents(final boolean flush) {
final HashSet<Tuple> results = new HashSet<Tuple>();
pullInto(results, flush);
return results;
}
@Override
public ProjectionIndexer constructIndex(final TupleMask mask, final TraceInfo... traces) {
final GenericProjectionIndexer indexer = new GenericProjectionIndexer(reteContainer, mask);
for (final TraceInfo traceInfo : traces) {
indexer.assignTraceInfo(traceInfo);
}
reteContainer.connectAndSynchronize(this, indexer);
return indexer;
}
/**
* @since 1.6
*/
protected void issueError(final String message, final Exception ex) {
if (ex == null) {
this.reteContainer.getNetwork().getEngine().getLogger().error(message);
} else {
this.reteContainer.getNetwork().getEngine().getLogger().error(message, ex);
}
}
}
|