org.objectweb.fractal.mind.adl.AbstractNormalizerLoader Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of adl-frontend Show documentation
Front-end components for the ADL language of the Mind programming model.
The newest version!
/**
 * Copyright (C) 2009 STMicroelectronics
 *
 * This file is part of "Mind Compiler" is free software: you can redistribute 
 * it and/or modify it under the terms of the GNU Lesser General Public License 
 * as published by the Free Software Foundation, either version 3 of the 
 * License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT 
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more
 * details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program.  If not, see .
 *
 * Contact: [email protected]
 *
 * Authors: Matthieu Leclercq
 * Contributors: 
 */

package org.objectweb.fractal.mind.adl;

import java.util.HashMap;
import java.util.Map;

import org.objectweb.fractal.adl.ADLException;
import org.objectweb.fractal.adl.AbstractLoader;
import org.objectweb.fractal.adl.Definition;
import org.objectweb.fractal.adl.Loader;
import org.objectweb.fractal.adl.Node;

/**
 * Generic abstract class that ease the implementation of {@link Loader} that
 * checks that sub-nodes of a given type of sub-nodes have a unique Id.
 * 
 * @param  The type of the sub-nodes to check.
 */
public abstract class AbstractNormalizerLoader
    extends
      AbstractLoader {

  // ---------------------------------------------------------------------------
  // Implementation of the Loader interface
  // ---------------------------------------------------------------------------

  public Definition load(final String name, final Map context)
      throws ADLException {
    final Definition d = clientLoader.load(name, context);
    normalize(d);

    return d;
  }

  protected void normalize(final Definition d) throws ADLException {
    final T[] subNodes = getSubNodes(d);
    if (subNodes == null) return;

    final Map nodeByIds = new HashMap();
    for (final T subNode : subNodes) {
      final Object id = getId(subNode);
      final T previousDeclaration = nodeByIds.put(id, subNode);
      if (previousDeclaration != null) {
        handleNameClash(previousDeclaration, subNode);
      }
    }
  }

  /**
   * Method calls when two sub-nodes with the same Id are found.
   * 
   * @param previousDeclaration The first node with the Id.
   * @param subNode The second node with the same Id.
   * @throws ADLException The exception thrown as a consequence of the error.
   */
  protected abstract void handleNameClash(T previousDeclaration, T subNode)
      throws ADLException;

  /**
   * Returns the array of sub nodes to check. May return null.
   * 
   * @param node the parent node.
   * @return the array of sub nodes to check. May return null.
   */
  protected abstract T[] getSubNodes(Node node);

  /**
   * Returns the Id of the given sub-node.
   * 
   * @param node a sub-node
   * @return the Id of the given sub-node.
   * @throws ADLException If an error occurs.
   */
  protected abstract Object getId(T node) throws ADLException;

}