summaryrefslogtreecommitdiffstats
path: root/tags/cpp-0.1.incubating-M1-RC3a/sca/runtime/core/src/tuscany/sca/model/Module.h
blob: f73f1d36bcca54e7b53b2d3dc53fee8031397817 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
/*
 *
 *  Copyright 2005 The Apache Software Foundation or its licensors, as applicable.
 *
 *  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.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 */

/* $Rev$ $Date: 2005/12/22 11:33:21 $ */

#ifndef tuscany_sca_model_module_h
#define tuscany_sca_model_module_h

#include <string>
using std::string;

#include <map>
using std::map;
#include <vector>
using std::vector;

#include "commonj/sdo/SDO.h"


#include "tuscany/sca/model/Component.h"
#include "tuscany/sca/model/ExternalService.h"
#include "tuscany/sca/model/EntryPoint.h"
#include "tuscany/sca/model/Wire.h"
#include "tuscany/sca/model/Wsdl.h"


namespace tuscany
{
    namespace sca
    {

        namespace model
        {
            /**
             * Information about a module.
             */
            class Module
            {
            public:
                /**
                 * Constructor.
                 * @param name the name of the module.
                 */
                Module(const std::string& name);

                /**
                 * Destructor.
                 */
                virtual ~Module();

                /**
                 * Set the root directory of the module information.
                 * @param rootDirectory The root of the module in the file system.
                 */
                void setRoot(const std::string& rootDirectory);

                /**
                 * Get the root directory of the module.
                 * @return The root of the module in the file system.
                 */
                const std::string& getRoot() {return moduleRoot;}
                
                /**
                 * Return the name of the module.
                 * @return Name of the module.
                 */
                const std::string& getName() {return name;}

                /**
                 * Add a new component to the module.
                 * @param componentName The name of the new component.
                 * @return The Component added to the module.
                 */
                Component* addComponent(const std::string& componentName);

                /**
                 * Add a new entry point to the module.
                 * @param name The name of the new entry point.
                 * @return The entry point added to the module.
                 */
                EntryPoint* addEntryPoint(const std::string& name);

                /**
                 * Find an entry point by name.
                 * @param name The name of the entry point to be found.
                 * @return The entry point that was found, or 0 if not found.
                 */
                EntryPoint* findEntryPoint(const std::string& name);
                
                /**
                 * Add a new external service to the module.
                 * @param name The name of the new external service.
                 * @return The external service added to the module.
                 */
                ExternalService* addExternalService(const std::string& name);

                /**
                 * Add a wire to the model.
                 * @param source The source location. Either the source component and
                 * reference (optional), or an entry point.
                 * @param target The target location. Either the target component and
                 * service (optional), or an external service.
                 */
                void addWire(const std::string& source, const std::string& target);
 
                /**
                 * Find a component by name.
                 * @param componentName The name of the component to be found.
                 * @return The component that was found, or 0 if not found.
                 */
                Component* findComponent(const std::string& componentName);

                /**
                 * Find a component and service by name.
                 * @param componentServiceName A string of the form 
                 * "componentName"/"serviceName" where the service name is optional
                 * if there is only one service on the component.
                 * @return The Service that was found, or 0 if not found.
                 */
                Service* findComponentService(const std::string& componentServiceName);

                /**
                 * Find an external service by name.
                 * @param serviceName The name of the external service to be found.
                 * @return The external service that was found, or 0 if not found.
                 */
                ExternalService* findExternalService(const std::string& serviceName);

                /**
                 * Add a WSDL definition to the module.
                 * @param wsdlModel A data object holding all the information about 
                 * the WSDL definition from a WSDL file.
                 */
                void addWsdl(commonj::sdo::DataObjectPtr wsdlModel);

                /**
                 * Find a WSDL definition by target namespace.
                 * @param wsdlNamespace The namespace of the WSDL definitions to find.
                 */
                Wsdl* findWsdl(const std::string& wsdlNamespace);

                /**
                 * Return a cached SDO XSDHelper.
                 */
                commonj::sdo::XSDHelperPtr getXSDHelper(void);

                /**
                 * Return a cached SDO XMLHelper.
                 */
                commonj::sdo::XMLHelperPtr getXMLHelper(void);

                /**
                 * Return a data factory which has all the types defined in XSDs and
                 * WSDL files configured for this module.
                 * @return The data factory for this module.
                 */
                commonj::sdo::DataFactoryPtr getDataFactory(void);

                /**
                 * Work through the list of wires and connect the source and target uris.
                 */
                void resolveWires();
 
            private:
                /**
                 * Name of the module.
                 */
                string name;

                /**
                 * Directory of the root of the module.
                 */
                string moduleRoot;

                /**
                 * Cached XSDHelper.
                 */
                commonj::sdo::XSDHelperPtr xsdHelper;

                /**
                 * Cached XMLHelper.
                 */
                commonj::sdo::XMLHelperPtr xmlHelper;

                typedef map<std::string, Component*> COMPONENT_MAP;
                /**
                 * Map (by name) of all the components in this module.
                 */
                COMPONENT_MAP components;

                typedef map<std::string, ExternalService*> EXTERNALSERVICE_MAP;
                /**
                 * Map (by name) of all the external services in this module.
                 */
                EXTERNALSERVICE_MAP externalServices;

                typedef map<std::string, EntryPoint*> ENTRYPOINT_MAP;
                /**
                 * Map (by name) of all the entry points in this module.
                 */
                ENTRYPOINT_MAP entryPoints;

                typedef vector<Wire> WIRES;
                /**
                 * Vector of all the wires in this module.
                 */
                WIRES wires;

                typedef map<std::string, Wsdl*> WSDL_MAP;
                /**
                 * Map by namespace of all the wsdl definitions in this module.
                 */
                WSDL_MAP wsdls;
            };

        } // End namespace model
    } // End namespace sca
} // End namespace tuscany

#endif // SCA_ModuleComponent_h