cc2007ff7d47c992ec85cd8c1078e02b2183565a
[utils] / system / general / src / main / java / org / wamblee / system / graph / component / LinkVisitor.java
1 /*
2  * Copyright 2008 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.DefaultEdge;
21 import org.wamblee.system.graph.Edge;
22 import org.wamblee.system.graph.Node;
23 import org.wamblee.system.graph.Visitor;
24
25 /**
26  * Visitor that creates links between required and provided interfaces as
27  * described by the edges in the graph.
28  * 
29  * Specically it links together (1) required and provided interfaces of internal component 
30  * of a container and (2) the providers of externally required interfaces and internal required
31  * interfaces. 
32  * 
33  * @author Erik Brakkee
34  * 
35  */
36 public class LinkVisitor implements Visitor {
37
38     @Override
39     public void visitEdge(Edge aEdge) {
40         Node from = aEdge.getFrom();
41         Node to = aEdge.getTo();
42         if (from instanceof RequiredInterfaceNode) {
43             RequiredInterfaceNode required = (RequiredInterfaceNode) from;
44             if (to instanceof ProvidedInterfaceNode) {
45
46                 ProvidedInterfaceNode provided = (ProvidedInterfaceNode) to;
47                 required.getRequired().setProvider(provided.getProvided());
48
49             } else if (to instanceof ExternalRequiredInterfaceNode) {
50                 ExternalRequiredInterfaceNode external = (ExternalRequiredInterfaceNode) to;
51                 ProvidedInterface provider = external.getRequired()
52                         .getProvider();
53                 if (provider == null && !required.getRequired().isOptional()) {
54                     throw new SystemAssemblyException("Mandatory interface '"
55                             + from + "' is not provided.");
56                 }
57                 if ( provider != null ) { 
58                     required.getRequired().setProvider(provider);
59                 }
60             }
61         } else if (from instanceof ProvidedInterfaceNode) {
62             // Provided interfaces can only be published after the system has
63             // started.
64         }
65     }
66
67     @Override
68     public void visitNode(Node aNode) {
69         // Empty.
70     }
71
72 }