org.objectweb.fractal.mind.adl.anonymous.AnonymousDefinitionLoader 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.anonymous;

import static org.objectweb.fractal.mind.BindingControllerImplHelper.checkItfName;
import static org.objectweb.fractal.mind.BindingControllerImplHelper.listFcHelper;

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.ContextLocal;
import org.objectweb.fractal.adl.Definition;
import org.objectweb.fractal.api.NoSuchInterfaceException;
import org.objectweb.fractal.api.control.IllegalBindingException;
import org.objectweb.fractal.mind.adl.ADLErrors;
import org.objectweb.fractal.mind.adl.anonymous.ast.AnonymousDefinitionContainer;
import org.objectweb.fractal.mind.adl.ast.Component;
import org.objectweb.fractal.mind.adl.ast.ComponentContainer;

/**
 * Delegating loader that {@link AnonymousDefinitionExtractor resolves}
 * anonymous definitions contained by the sub-components of the loaded
 * definition. This loader keep extracted anonymous definitions in a cache. So
 * when these definitions are loaded (when definition references of
 * sub-components are resolved), this loader is able to intercept the loading
 * operation and return them.
 */
public class AnonymousDefinitionLoader extends AbstractLoader {

  protected ContextLocal> contextualAnonymousDefinitions = new ContextLocal>();

  // ---------------------------------------------------------------------------
  // Client interfaces
  // ---------------------------------------------------------------------------

  /** The {@link AnonymousDefinitionExtractor} interface. */
  public AnonymousDefinitionExtractor             anonymousDefinitionExtractorItf;

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

  public Definition load(final String name, final Map context)
      throws ADLException {
    // looks if it is a known anonymous definition.
    final Map anonymousDefinitions = contextualAnonymousDefinitions
        .get(context);
    if (anonymousDefinitions != null) {
      final Definition anonymousDefinition = anonymousDefinitions.remove(name);
      if (anonymousDefinition != null) {
        // An anonymous definition with the corresponding name has been found in
        // local cache. Return it.
        return anonymousDefinition;
      }
    }

    // The definition to load is not an anonymous definition.
    // delegates loading of definition to client loader.
    final Definition d = clientLoader.load(name, context);

    // If loaded definition contains component nodes, it may contains anonymous
    // definitions
    if (d instanceof ComponentContainer) {
      replaceAnonymousDefinitions((ComponentContainer) d, d, context);
    }

    return d;
  }

  protected void replaceAnonymousDefinitions(
      final ComponentContainer container, final Definition topLevel,
      final Map context) throws ADLException {
    // for each sub-component
    for (final Component subComp : container.getComponents()) {
      if ((subComp instanceof AnonymousDefinitionContainer)
          && ((AnonymousDefinitionContainer) subComp).getAnonymousDefinition() != null) {
        // The sub-component is defined as an instance of an anonymous
        // definition.

        if (subComp.getDefinitionReference() != null) {
          // this cannot happen if input definition has been read from
          // STCFParser. but it may happen if it has been read from an XML
          // parser.
          throw new ADLException(ADLErrors.INVALID_SUB_COMPONENT, subComp);
        }

        // resolve it.
        final Definition anonymousDefinition = anonymousDefinitionExtractorItf
            .extractAnonymousDefinition(subComp, topLevel, context);

        // put resolved definition in cache
        addAnonymousDefinition(anonymousDefinition, context);

        // The anonymous definition may contain itself sub-component with
        // anonymous definitions, replace recursively sub anonymous definitions
        if (anonymousDefinition instanceof ComponentContainer) {
          replaceAnonymousDefinitions((ComponentContainer) anonymousDefinition,
              topLevel, context);
        }
      }
    }
  }

  protected void addAnonymousDefinition(final Definition anonymousDefinition,
      final Map context) {
    Map anonymousDefinitions = contextualAnonymousDefinitions
        .get(context);

    if (anonymousDefinitions == null) {
      anonymousDefinitions = new HashMap();
      contextualAnonymousDefinitions.set(context, anonymousDefinitions);
    }

    anonymousDefinitions
        .put(anonymousDefinition.getName(), anonymousDefinition);
  }

  // ---------------------------------------------------------------------------
  // Overridden BindingController methods
  // ---------------------------------------------------------------------------

  @Override
  public void bindFc(final String itfName, final Object value)
      throws NoSuchInterfaceException, IllegalBindingException {
    checkItfName(itfName);

    if (itfName.equals(AnonymousDefinitionExtractor.ITF_NAME)) {
      anonymousDefinitionExtractorItf = (AnonymousDefinitionExtractor) value;
    } else {
      super.bindFc(itfName, value);
    }

  }

  @Override
  public String[] listFc() {
    return listFcHelper(super.listFc(), AnonymousDefinitionExtractor.ITF_NAME);
  }

  @Override
  public Object lookupFc(final String itfName) throws NoSuchInterfaceException {
    checkItfName(itfName);

    if (itfName.equals(AnonymousDefinitionExtractor.ITF_NAME)) {
      return anonymousDefinitionExtractorItf;
    } else {
      return super.lookupFc(itfName);
    }
  }

  @Override
  public void unbindFc(final String itfName) throws NoSuchInterfaceException,
      IllegalBindingException {
    checkItfName(itfName);

    if (itfName.equals(AnonymousDefinitionExtractor.ITF_NAME)) {
      anonymousDefinitionExtractorItf = null;
    } else {
      super.unbindFc(itfName);
    }
  }
}