2 * Copyright (c) 2015, 2016 Cisco Systems, Inc. and others. All rights reserved.
4 * This program and the accompanying materials are made available under the
5 * terms of the Eclipse Public License v1.0 which accompanies this distribution,
6 * and is available at http://www.eclipse.org/legal/epl-v10.html
8 package org.opendaylight.yangtools.yang.parser.stmt.reactor;
10 import static com.google.common.base.Preconditions.checkArgument;
11 import static com.google.common.base.Preconditions.checkState;
12 import static java.util.Objects.requireNonNull;
13 import static org.opendaylight.yangtools.yang.parser.spi.meta.ModelProcessingPhase.EFFECTIVE_MODEL;
14 import static org.opendaylight.yangtools.yang.parser.spi.meta.ModelProcessingPhase.FULL_DECLARATION;
16 import com.google.common.base.MoreObjects;
17 import com.google.common.base.MoreObjects.ToStringHelper;
18 import java.util.HashSet;
19 import java.util.Iterator;
21 import java.util.function.Function;
22 import javax.annotation.Nonnull;
23 import org.opendaylight.yangtools.yang.model.api.meta.DeclaredStatement;
24 import org.opendaylight.yangtools.yang.model.api.meta.EffectiveStatement;
25 import org.opendaylight.yangtools.yang.model.api.meta.IdentifierNamespace;
26 import org.opendaylight.yangtools.yang.parser.spi.meta.ModelActionBuilder;
27 import org.opendaylight.yangtools.yang.parser.spi.meta.ModelProcessingPhase;
28 import org.opendaylight.yangtools.yang.parser.spi.meta.NamespaceKeyCriterion;
29 import org.opendaylight.yangtools.yang.parser.spi.meta.StatementNamespace;
30 import org.opendaylight.yangtools.yang.parser.spi.meta.StmtContext;
31 import org.opendaylight.yangtools.yang.parser.spi.meta.StmtContext.Mutable;
32 import org.opendaylight.yangtools.yang.parser.stmt.reactor.StatementContextBase.ContextMutation;
33 import org.opendaylight.yangtools.yang.parser.stmt.reactor.StatementContextBase.OnNamespaceItemAdded;
34 import org.opendaylight.yangtools.yang.parser.stmt.reactor.StatementContextBase.OnPhaseFinished;
35 import org.slf4j.Logger;
36 import org.slf4j.LoggerFactory;
38 final class ModifierImpl implements ModelActionBuilder {
39 private static final Logger LOG = LoggerFactory.getLogger(ModifierImpl.class);
41 private final InferenceContext ctx = new InferenceContext() { };
43 private final Set<AbstractPrerequisite<?>> unsatisfied = new HashSet<>(1);
44 private final Set<AbstractPrerequisite<?>> mutations = new HashSet<>(1);
46 private InferenceAction action;
47 private boolean actionApplied = false;
49 private <D> AbstractPrerequisite<D> addReq(final AbstractPrerequisite<D> prereq) {
50 LOG.trace("Modifier {} adding prerequisite {}", this, prereq);
51 unsatisfied.add(prereq);
55 private <T> AbstractPrerequisite<T> addMutation(final AbstractPrerequisite<T> mutation) {
56 LOG.trace("Modifier {} adding mutation {}", this, mutation);
57 mutations.add(mutation);
61 private void checkNotRegistered() {
62 checkState(action == null, "Action was already registered.");
65 private boolean removeSatisfied() {
66 final Iterator<AbstractPrerequisite<?>> it = unsatisfied.iterator();
67 while (it.hasNext()) {
68 final AbstractPrerequisite<?> prereq = it.next();
69 if (prereq.isDone()) {
70 // We are removing current prerequisite from list.
71 LOG.trace("Modifier {} prerequisite {} satisfied", this, prereq);
75 return unsatisfied.isEmpty();
84 action.prerequisiteFailed(unsatisfied);
88 private void applyAction() {
89 checkState(!actionApplied);
94 private <K, C extends StmtContext<?, ?, ?>, N extends StatementNamespace<K, ?, ?>> AbstractPrerequisite<C>
95 requiresCtxImpl(final StmtContext<?, ?, ?> context, final Class<N> namespace, final K key,
96 final ModelProcessingPhase phase) {
99 AddedToNamespace<C> addedToNs = new AddedToNamespace<>(phase);
101 contextImpl(context).onNamespaceItemAddedAction(namespace, key, addedToNs);
105 private <K, C extends StmtContext<?, ?, ?>, N extends StatementNamespace<K, ?, ?>> AbstractPrerequisite<C>
106 requiresCtxImpl(final StmtContext<?, ?, ?> context, final Class<N> namespace,
107 final NamespaceKeyCriterion<K> criterion, final ModelProcessingPhase phase) {
108 checkNotRegistered();
110 AddedToNamespace<C> addedToNs = new AddedToNamespace<>(phase);
112 contextImpl(context).onNamespaceItemAddedAction(namespace, phase, criterion, addedToNs);
116 private <C extends StmtContext<?, ?, ?>> AbstractPrerequisite<C> requiresCtxImpl(final C context,
117 final ModelProcessingPhase phase) {
118 checkNotRegistered();
120 PhaseFinished<C> phaseFin = new PhaseFinished<>();
122 contextImpl(context).addPhaseCompletedListener(phase, phaseFin);
126 @SuppressWarnings({ "rawtypes", "unchecked" })
127 private <K, C extends Mutable<?, ?, ?>, N extends IdentifierNamespace<K, ? extends StmtContext<?, ?, ?>>>
128 AbstractPrerequisite<C> mutatesCtxImpl(final StmtContext<?, ?, ?> context, final Class<N> namespace,
129 final K key, final ModelProcessingPhase phase) {
130 checkNotRegistered();
132 final PhaseModificationInNamespace<C> mod = new PhaseModificationInNamespace<>(EFFECTIVE_MODEL);
135 contextImpl(context).onNamespaceItemAddedAction((Class) namespace, key, mod);
139 private static StatementContextBase<?, ?, ?> contextImpl(final Object value) {
140 checkArgument(value instanceof StatementContextBase, "Supplied context %s is not provided by this reactor.",
142 return StatementContextBase.class.cast(value);
146 checkState(action != null, "Action was not defined yet.");
148 if (removeSatisfied()) {
157 public <C extends Mutable<?, ?, ?>, T extends C> Prerequisite<C> mutatesCtx(final T context,
158 final ModelProcessingPhase phase) {
159 return addMutation(new PhaseMutation<>(contextImpl(context), phase));
164 public <A,D extends DeclaredStatement<A>,E extends EffectiveStatement<A, D>>
165 AbstractPrerequisite<StmtContext<A, D, E>> requiresCtx(final StmtContext<A, D, E> context,
166 final ModelProcessingPhase phase) {
167 return requiresCtxImpl(context, phase);
173 public <K, N extends StatementNamespace<K, ?, ?>> Prerequisite<StmtContext<?, ?, ?>> requiresCtx(
174 final StmtContext<?, ?, ?> context, final Class<N> namespace, final K key,
175 final ModelProcessingPhase phase) {
176 return requiresCtxImpl(context, namespace, key, phase);
181 public <K, N extends StatementNamespace<K, ?, ?>> Prerequisite<StmtContext<?, ?, ?>> requiresCtx(
182 final StmtContext<?, ?, ?> context, final Class<N> namespace, final NamespaceKeyCriterion<K> criterion,
183 final ModelProcessingPhase phase) {
184 return requiresCtxImpl(context, namespace, criterion, phase);
189 public <D extends DeclaredStatement<?>> Prerequisite<D> requiresDeclared(
190 final StmtContext<?, ? extends D, ?> context) {
191 return requiresCtxImpl(context, FULL_DECLARATION).transform(StmtContext::buildDeclared);
196 public <K, D extends DeclaredStatement<?>, N extends StatementNamespace<K, ? extends D, ?>> Prerequisite<D>
197 requiresDeclared(final StmtContext<?, ?, ?> context, final Class<N> namespace, final K key) {
198 final AbstractPrerequisite<StmtContext<?, D, ?>> rawContext = requiresCtxImpl(context, namespace, key,
200 return rawContext.transform(StmtContext::buildDeclared);
205 public <K, D extends DeclaredStatement<?>, N extends StatementNamespace<K, ? extends D, ?>>
206 AbstractPrerequisite<StmtContext<?, D, ?>> requiresDeclaredCtx(final StmtContext<?, ?, ?> context,
207 final Class<N> namespace, final K key) {
208 return requiresCtxImpl(context, namespace, key, FULL_DECLARATION);
213 public <E extends EffectiveStatement<?, ?>> Prerequisite<E> requiresEffective(
214 final StmtContext<?, ?, ? extends E> stmt) {
215 return requiresCtxImpl(stmt, EFFECTIVE_MODEL).transform(StmtContext::buildEffective);
220 public <K, E extends EffectiveStatement<?, ?>, N extends StatementNamespace<K, ?, ? extends E>> Prerequisite<E>
221 requiresEffective(final StmtContext<?, ?, ?> context, final Class<N> namespace, final K key) {
222 final AbstractPrerequisite<StmtContext<?, ?, E>> rawContext = requiresCtxImpl(context, namespace, key,
224 return rawContext.transform(StmtContext::buildEffective);
229 public <K, E extends EffectiveStatement<?, ?>, N extends StatementNamespace<K, ?, ? extends E>>
230 AbstractPrerequisite<StmtContext<?, ?, E>> requiresEffectiveCtx(final StmtContext<?, ?, ?> context,
231 final Class<N> namespace, final K key) {
232 return requiresCtxImpl(contextImpl(context), namespace, key, EFFECTIVE_MODEL);
237 public <N extends IdentifierNamespace<?, ?>> Prerequisite<Mutable<?, ?, ?>> mutatesNs(
238 final Mutable<?, ?, ?> context, final Class<N> namespace) {
239 return addMutation(new NamespaceMutation<>(contextImpl(context), namespace));
244 public <K, E extends EffectiveStatement<?, ?>, N extends IdentifierNamespace<K, ? extends StmtContext<?, ?, ?>>>
245 AbstractPrerequisite<Mutable<?, ?, E>> mutatesEffectiveCtx(final StmtContext<?, ?, ?> context,
246 final Class<N> namespace, final K key) {
247 return mutatesCtxImpl(context, namespace, key, EFFECTIVE_MODEL);
252 @SuppressWarnings({ "rawtypes", "unchecked" })
253 public <K, E extends EffectiveStatement<?, ?>, N extends IdentifierNamespace<K, ? extends StmtContext<?, ?, ?>>>
254 AbstractPrerequisite<Mutable<?, ?, E>> mutatesEffectiveCtxPath(final StmtContext<?, ?, ?> context,
255 final Class<N> namespace, final Iterable<K> keys) {
256 checkNotRegistered();
258 final PhaseModificationInNamespacePath<Mutable<?, ?, E>, K, N> ret = new PhaseModificationInNamespacePath<>(
259 EFFECTIVE_MODEL, namespace, keys);
263 contextImpl(context).onNamespaceItemAddedAction((Class) namespace, ret.nextKey(), ret);
268 @SuppressWarnings("checkstyle:hiddenField")
269 public void apply(final InferenceAction action) {
270 checkState(this.action == null, "Action already defined to %s", this.action);
271 this.action = requireNonNull(action);
274 private abstract class AbstractPrerequisite<T> implements Prerequisite<T> {
275 private boolean done = false;
279 @SuppressWarnings("checkstyle:hiddenField")
280 public final T resolve(final InferenceContext ctx) {
282 checkArgument(ctx == ModifierImpl.this.ctx);
286 final boolean isDone() {
290 @SuppressWarnings("checkstyle:hiddenField")
291 final boolean resolvePrereq(final T value) {
297 final <O> Prerequisite<O> transform(final Function<? super T, O> transformation) {
298 return context -> transformation.apply(resolve(context));
302 public final String toString() {
303 return addToStringAttributes(MoreObjects.toStringHelper(this).omitNullValues()).toString();
306 ToStringHelper addToStringAttributes(final ToStringHelper toStringHelper) {
307 return toStringHelper.add("value", value);
311 private final class PhaseMutation<C> extends AbstractPrerequisite<C> implements ContextMutation {
312 @SuppressWarnings("unchecked")
313 PhaseMutation(final StatementContextBase<?, ?, ?> context, final ModelProcessingPhase phase) {
314 context.addMutation(phase, this);
315 resolvePrereq((C) context);
319 public boolean isFinished() {
324 private final class PhaseFinished<C extends StmtContext<?, ?, ?>> extends AbstractPrerequisite<C>
325 implements OnPhaseFinished {
326 @SuppressWarnings("unchecked")
328 public boolean phaseFinished(final StatementContextBase<?, ?, ?> context,
329 final ModelProcessingPhase finishedPhase) {
330 return resolvePrereq((C) context);
334 private final class NamespaceMutation<N extends IdentifierNamespace<?, ?>>
335 extends AbstractPrerequisite<Mutable<?, ?, ?>> {
336 NamespaceMutation(final StatementContextBase<?, ?, ?> ctx, final Class<N> namespace) {
341 private final class AddedToNamespace<C extends StmtContext<?, ?, ?>> extends AbstractPrerequisite<C>
342 implements OnNamespaceItemAdded, OnPhaseFinished {
343 private final ModelProcessingPhase phase;
345 AddedToNamespace(final ModelProcessingPhase phase) {
346 this.phase = requireNonNull(phase);
350 public void namespaceItemAdded(final StatementContextBase<?, ?, ?> context, final Class<?> namespace,
351 final Object key, final Object value) {
352 ((StatementContextBase<?, ?, ?>) value).addPhaseCompletedListener(phase, this);
355 @SuppressWarnings("unchecked")
357 public boolean phaseFinished(final StatementContextBase<?, ?, ?> context,
358 final ModelProcessingPhase finishedPhase) {
359 return resolvePrereq((C) context);
363 ToStringHelper addToStringAttributes(final ToStringHelper toStringHelper) {
364 return super.addToStringAttributes(toStringHelper).add("phase", phase);
368 private final class PhaseModificationInNamespace<C extends Mutable<?, ?, ?>> extends AbstractPrerequisite<C>
369 implements OnNamespaceItemAdded, ContextMutation {
370 private final ModelProcessingPhase modPhase;
372 PhaseModificationInNamespace(final ModelProcessingPhase phase) {
373 checkArgument(phase != null, "Model processing phase must not be null");
374 this.modPhase = phase;
377 @SuppressWarnings("unchecked")
379 public void namespaceItemAdded(final StatementContextBase<?, ?, ?> context, final Class<?> namespace,
380 final Object key, final Object value) {
381 StatementContextBase<?, ?, ?> targetCtx = contextImpl(value);
382 targetCtx.addMutation(modPhase, this);
383 resolvePrereq((C) targetCtx);
387 public boolean isFinished() {
392 private final class PhaseModificationInNamespacePath<C extends Mutable<?, ?, ?>, K,
393 N extends IdentifierNamespace<K, ? extends StmtContext<?, ?, ?>>> extends AbstractPrerequisite<C>
394 implements OnNamespaceItemAdded, ContextMutation {
395 private final ModelProcessingPhase modPhase;
396 private final Iterable<K> keys;
397 private final Iterator<K> it;
399 PhaseModificationInNamespacePath(final ModelProcessingPhase phase, final Class<N> namespace,
400 final Iterable<K> keys) {
401 this.modPhase = requireNonNull(phase);
402 this.keys = requireNonNull(keys);
403 it = keys.iterator();
404 checkArgument(it.hasNext(), "Namespace %s keys may not be empty", namespace);
412 public boolean isFinished() {
417 public void namespaceItemAdded(final StatementContextBase<?, ?, ?> context, final Class<?> namespace,
418 final Object key, final Object value) {
419 LOG.debug("Action for {} got key {}", keys, key);
421 resolvePrereq((C) value);
425 final K next = nextKey();
426 contextImpl(value).onNamespaceItemAddedAction((Class) namespace, next, this);