Removed DOCUMENT ME comments that were generated and applied source code
[utils] / system / general / src / main / java / org / wamblee / system / graph / component / LinkVisitor.java
index 088f05856ffdc1d28c90198651345ef55614fd84..437bf21eba0da7edc1fd0f55f82d0ea8c4824495 100644 (file)
@@ -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.
@@ -24,33 +24,36 @@ import org.wamblee.system.graph.Visitor;
 
 /**
  * Visitor that creates links between required and provided interfaces as
- * described by the edges in the graph.
+ * described by the edges in the graph. Specically it links together (1)
+ * required and provided interfaces of internal component of a container and (2)
+ * the providers of externally required interfaces and internal required
+ * interfaces.
  * 
  * @author Erik Brakkee
- * 
  */
 public class LinkVisitor implements Visitor {
-
     @Override
     public void visitEdge(Edge aEdge) {
         Node from = aEdge.getFrom();
         Node to = aEdge.getTo();
+
         if (from instanceof RequiredInterfaceNode) {
             RequiredInterfaceNode required = (RequiredInterfaceNode) from;
-            if (to instanceof ProvidedInterfaceNode) {
 
+            if (to instanceof ProvidedInterfaceNode) {
                 ProvidedInterfaceNode provided = (ProvidedInterfaceNode) to;
                 required.getRequired().setProvider(provided.getProvided());
-
             } else if (to instanceof ExternalRequiredInterfaceNode) {
                 ExternalRequiredInterfaceNode external = (ExternalRequiredInterfaceNode) to;
                 ProvidedInterface provider = external.getRequired()
-                        .getProvider();
-                if (provider == null && !required.getRequired().isOptional()) {
-                    throw new SystemAssemblyException("Mandatory interface '"
-                            + from + "' is not provided.");
+                    .getProvider();
+
+                if ((provider == null) && !required.getRequired().isOptional()) {
+                    throw new SystemAssemblyException("Mandatory interface '" +
+                        from + "' is not provided.");
                 }
-                if ( provider != null ) { 
+
+                if (provider != null) {
                     required.getRequired().setProvider(provider);
                 }
             }
@@ -64,5 +67,4 @@ public class LinkVisitor implements Visitor {
     public void visitNode(Node aNode) {
         // Empty.
     }
-
 }