X-Git-Url: http://wamblee.org/gitweb/?a=blobdiff_plain;f=system%2Fgeneral%2Fsrc%2Fmain%2Fjava%2Forg%2Fwamblee%2Fsystem%2Fgraph%2Fcomponent%2FCheckRequiredProvidedMultiplicityVisitor.java;h=86c13ca39f738b0cc160c7f01bbcb06b2a785b34;hb=ddd261f331280640c5b53c7128230b629ebcd268;hp=58cd2cf5d0fbe8123e8785d3c6ddb2399b75b49b;hpb=92e23e5ecf9614f2ab770a8cdedc0b21ddf1e127;p=utils

diff --git a/system/general/src/main/java/org/wamblee/system/graph/component/CheckRequiredProvidedMultiplicityVisitor.java b/system/general/src/main/java/org/wamblee/system/graph/component/CheckRequiredProvidedMultiplicityVisitor.java
index 58cd2cf5..86c13ca3 100644
--- a/system/general/src/main/java/org/wamblee/system/graph/component/CheckRequiredProvidedMultiplicityVisitor.java
+++ b/system/general/src/main/java/org/wamblee/system/graph/component/CheckRequiredProvidedMultiplicityVisitor.java
@@ -1,12 +1,12 @@
 /*
  * Copyright 2008 the original author or authors.
- * 
+ *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -15,72 +15,103 @@
  */
 package org.wamblee.system.graph.component;
 
-import java.util.List;
-
 import org.wamblee.system.core.SystemAssemblyException;
 import org.wamblee.system.graph.Edge;
 import org.wamblee.system.graph.Graph;
 import org.wamblee.system.graph.Node;
 import org.wamblee.system.graph.Visitor;
 
+import java.util.List;
+
+
 /**
  * Visitor that checks whether required and provided interfaces are matched
  * appropriately:
- * <ul>
- * <li>Each required interface is connected to at most one provided interface
- * </li>
- * <li>Required interfaces that are not optional must be connected to precisely
- * one provided interface</li>
- * </ul>
- * 
+ *  <ul>
+ *      <li>Each required interface is connected to at most one
+ *      provided interface</li>
+ *      <li>Required interfaces that are not optional must be connected
+ *      to precisely one provided interface</li>
+ *  </ul>
+ *
  * @author Erik Brakkee
- * 
  */
 public class CheckRequiredProvidedMultiplicityVisitor implements Visitor {
-
+    /**
+     * DOCUMENT ME!
+     */
     private Graph graph;
 
+    /**
+     * Creates a new CheckRequiredProvidedMultiplicityVisitor object.
+     *
+     * @param aGraph DOCUMENT ME!
+     */
     public CheckRequiredProvidedMultiplicityVisitor(Graph aGraph) {
         graph = aGraph;
     }
 
+    /**
+     * DOCUMENT ME!
+     *
+     * @param aEdge DOCUMENT ME!
+     */
     @Override
     public void visitEdge(Edge aEdge) {
         // Empty
     }
 
+    /**
+     * DOCUMENT ME!
+     *
+     * @param aNode DOCUMENT ME!
+     */
     @Override
     public void visitNode(Node aNode) {
         if (aNode instanceof RequiredInterfaceNode) {
             RequiredInterfaceNode required = (RequiredInterfaceNode) aNode;
-            List<Edge> edges = graph.findOutgoing(aNode);
+            List<Edge>            edges    = graph.findOutgoing(aNode);
+
             if (edges.size() > 1) {
-                createDuplicateException("Multiple providers of required interface found", aNode, edges);
+                createDuplicateException("Multiple providers of required interface found",
+                    aNode, edges);
             }
-            if (edges.size() == 0 && !required.getRequired().isOptional()) {
-                throw new SystemAssemblyException(
-                        aNode
-                                + ": mandatpory required interface not provided by other components started earlier");
+
+            if ((edges.size() == 0) && !required.getRequired().isOptional()) {
+                throw new SystemAssemblyException(aNode
+                    + ": mandatpory required interface not provided by other components started earlier");
             }
-        } else if ( aNode instanceof ExternalProvidedInterfaceNode) { 
-            List<Edge> edges = graph.findOutgoing(aNode); 
-            if ( edges.size() > 1) { 
-                createDuplicateException("multiple internal matches for externally provided interface", aNode, edges);
+        } else if (aNode instanceof ExternalProvidedInterfaceNode) {
+            List<Edge> edges = graph.findOutgoing(aNode);
+
+            if (edges.size() > 1) {
+                createDuplicateException("multiple internal matches for externally provided interface",
+                    aNode, edges);
             }
-            if ( edges.size() == 0 ) { 
-                throw new SystemAssemblyException(aNode + ": external provided interface is not provided internally");
+
+            if (edges.size() == 0) {
+                throw new SystemAssemblyException(aNode
+                    + ": external provided interface is not provided internally");
             }
         }
     }
 
-    private void createDuplicateException(String aMsg, Node aNode, List<Edge> edges) {
+    /**
+     * DOCUMENT ME!
+     *
+     * @param aMsg DOCUMENT ME!
+     * @param aNode DOCUMENT ME!
+     * @param edges DOCUMENT ME!
+     */
+    private void createDuplicateException(String aMsg, Node aNode,
+        List<Edge> edges) {
         StringBuffer buf = new StringBuffer();
-        buf.append(aNode
-                + ": " + aMsg + ": ");
+        buf.append(aNode + ": " + aMsg + ": ");
+
         for (Edge edge : edges) {
             buf.append(edge.getTo() + "/ ");
         }
+
         throw new SystemAssemblyException(buf.toString());
     }
-
 }