wamblee.org Git - utils/blob - system/general/src/main/java/org/wamblee/system/graph/component/LinkVisitor.java

   1 /*
   2  * Copyright 2005-2010 the original author or authors.
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *      http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16 package org.wamblee.system.graph.component;
  17
  18 import org.wamblee.system.core.ProvidedInterface;
  19 import org.wamblee.system.core.SystemAssemblyException;
  20 import org.wamblee.system.graph.Edge;
  21 import org.wamblee.system.graph.Node;
  22 import org.wamblee.system.graph.Visitor;
  23
  24 /**
  25  * Visitor that creates links between required and provided interfaces as
  26  * described by the edges in the graph. Specically it links together (1)
  27  * required and provided interfaces of internal component of a container and (2)
  28  * the providers of externally required interfaces and internal required
  29  * interfaces.
  30  *
  31  * @author Erik Brakkee
  32  */
  33 public class LinkVisitor implements Visitor {
  34     @Override
  35     public void visitEdge(Edge aEdge) {
  36         Node from = aEdge.getFrom();
  37         Node to = aEdge.getTo();
  38
  39         if (from instanceof RequiredInterfaceNode) {
  40             RequiredInterfaceNode required = (RequiredInterfaceNode) from;
  41
  42             if (to instanceof ProvidedInterfaceNode) {
  43                 ProvidedInterfaceNode provided = (ProvidedInterfaceNode) to;
  44                 required.getRequired().setProvider(provided.getProvided());
  45             } else if (to instanceof ExternalRequiredInterfaceNode) {
  46                 ExternalRequiredInterfaceNode external = (ExternalRequiredInterfaceNode) to;
  47                 ProvidedInterface provider = external.getRequired()
  48                     .getProvider();
  49
  50                 if ((provider == null) && !required.getRequired().isOptional()) {
  51                     throw new SystemAssemblyException("Mandatory interface '" +
  52                         from + "' is not provided.");
  53                 }
  54
  55                 if (provider != null) {
  56                     required.getRequired().setProvider(provider);
  57                 }
  58             }
  59         } else if (from instanceof ProvidedInterfaceNode) {
  60             // Provided interfaces can only be published after the system has
  61             // started.
  62         }
  63     }
  64
  65     @Override
  66     public void visitNode(Node aNode) {
  67         // Empty.
  68     }
  69 }