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
|
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package org.apache.tuscany.sca.something;
import java.io.Reader;
import java.util.List;
import javax.xml.namespace.QName;
import javax.xml.stream.XMLStreamException;
import org.apache.tuscany.sca.assembly.Composite;
import org.apache.tuscany.sca.contribution.processor.ContributionReadException;
import org.apache.tuscany.sca.runtime.ActivationException;
import org.oasisopen.sca.NoSuchServiceException;
public interface Section10 {
/**
* 4577 10.5.1 install Contribution & update Contribution
* 4578 Creates or updates an installed contribution with a supplied root contribution, and installed at a supplied
* 4579 base URI. A supplied dependent contribution list (<export/> elements) specifies the contributions that are
* 4580 used to resolve the dependencies of the root contribution and other dependent contributions. These
* 4581 override any dependent contributions explicitly listed via the @location attribute in the import statements
* 4582 of the contribution.
* 4583 SCA follows the simplifying assumption that the use of a contribution for resolving anything also means
* 4584 that all other exported artifacts can be used from that contribution. Because of this, the dependent
* 4585 contribution list is just a list of installed contribution URIs. There is no need to specify what is being used
* 4586 from each one.
* 4587 Each dependent contribution is also an installed contribution, with its own dependent contributions. By
* 4588 default these dependent contributions of the dependent contributions (which we will call indirect
* 4589 dependent contributions) are included as dependent contributions of the installed contribution. However,
* 4590 if a contribution in the dependent contribution list exports any conflicting definitions with an indirect
* 4591 dependent contribution, then the indirect dependent contribution is not included (i.e. the explicit list
* 4592 overrides the default inclusion of indirect dependent contributions). Also, if there is ever a conflict
* 4593 between two indirect dependent contributions, then the conflict MUST be resolved by an explicit entry in
* 4594 the dependent contribution list.
* 4595 [ASM12009]
* 4596 Note that in many cases, the dependent contribution list can be generated. In particular, if the creator of
* 4597 a Domain is careful to avoid creating duplicate definitions for the same qualified name, then it is easy for
* 4598 this list to be generated by tooling. *
* @param uri
* @param contributionURL
* @throws ContributionReadException
* @throws ActivationException
*/
void installContribution(String uri, String contributionURL, List<String> dependentContributionURIs) throws ContributionReadException, ActivationException;
/* and i'd expect short forms of that for when you don't care or have the others:*/
String installContribution(String contributionURL) throws ContributionReadException, ActivationException;
void installContribution(String uri, String contributionURL) throws ContributionReadException, ActivationException;
/* autoDeploy indicates whether or not to automatically deploy the deployables defined in sca-contribution.xml */
String installContribution(String contributionURL, boolean autoDeploy) throws ContributionReadException, ActivationException;
void installContribution(String uri, String contributionURL, List<String> dependentContributionURIs, boolean autoDeploy) throws ContributionReadException, ActivationException;
/**
* 4577 10.5.1 install Contribution & update Contribution
* 4578 Creates or updates an installed contribution with a supplied root contribution, and installed at a supplied
* 4579 base URI. A supplied dependent contribution list (<export/> elements) specifies the contributions that are
* 4580 used to resolve the dependencies of the root contribution and other dependent contributions. These
* 4581 override any dependent contributions explicitly listed via the @location attribute in the import statements
* 4582 of the contribution.
* 4583 SCA follows the simplifying assumption that the use of a contribution for resolving anything also means
* 4584 that all other exported artifacts can be used from that contribution. Because of this, the dependent
* 4585 contribution list is just a list of installed contribution URIs. There is no need to specify what is being used
* 4586 from each one.
* 4587 Each dependent contribution is also an installed contribution, with its own dependent contributions. By
* 4588 default these dependent contributions of the dependent contributions (which we will call indirect
* 4589 dependent contributions) are included as dependent contributions of the installed contribution. However,
* 4590 if a contribution in the dependent contribution list exports any conflicting definitions with an indirect
* 4591 dependent contribution, then the indirect dependent contribution is not included (i.e. the explicit list
* 4592 overrides the default inclusion of indirect dependent contributions). Also, if there is ever a conflict
* 4593 between two indirect dependent contributions, then the conflict MUST be resolved by an explicit entry in
* 4594 the dependent contribution list.
* 4595 [ASM12009]
* 4596 Note that in many cases, the dependent contribution list can be generated. In particular, if the creator of
* 4597 a Domain is careful to avoid creating duplicate definitions for the same qualified name, then it is easy for
* 4598 this list to be generated by tooling.
*
* @param uri
* @param contributionURL
*/
void updateContribution(String uri, String contributionURL);
/**
* 4599 10.5.2 add Deployment Composite & update Deployment Composite
* 4600 Adds or updates a deployment composite using a supplied composite ("composite by value" � a data
* 4601 structure, not an existing resource in the Domain) to the contribution identified by a supplied contribution
* 4602 URI. The added or updated deployment composite is given a relative URI that matches the @name
* 4603 attribute of the composite, with a �.composite� suffix. Since all composites run within the context of a
* 4604 installed contribution (any component implementations or other definitions are resolved within that
* 4605 contribution), this functionality makes it possible for the deployer to create a composite with final
* 4606 configuration and wiring decisions and add it to an installed contribution without having to modify the
* 4607 contents of the root contribution.
* 4608 Also, in some use cases, a contribution might include only implementation code (e.g. PHP scripts). It is
* 4609 then possible for those to be given component names by a (possibly generated) composite that is added
* 4610 into the installed contribution, without having to modify the packaging. *
*
* @param uri
* @param compositeXML
* @return
* @throws XMLStreamException
* @throws ContributionReadException
* @throws ActivationException
*/
String addDeploymentComposite(String contriubutionURI, Reader compositeXML) throws ContributionReadException, XMLStreamException, ActivationException;
/**
* 4599 10.5.2 add Deployment Composite & update Deployment Composite
* 4600 Adds or updates a deployment composite using a supplied composite ("composite by value" � a data
* 4601 structure, not an existing resource in the Domain) to the contribution identified by a supplied contribution
* 4602 URI. The added or updated deployment composite is given a relative URI that matches the @name
* 4603 attribute of the composite, with a �.composite� suffix. Since all composites run within the context of a
* 4604 installed contribution (any component implementations or other definitions are resolved within that
* 4605 contribution), this functionality makes it possible for the deployer to create a composite with final
* 4606 configuration and wiring decisions and add it to an installed contribution without having to modify the
* 4607 contents of the root contribution.
* 4608 Also, in some use cases, a contribution might include only implementation code (e.g. PHP scripts). It is
* 4609 then possible for those to be given component names by a (possibly generated) composite that is added
* 4610 into the installed contribution, without having to modify the packaging. *
*
* @param uri
* @param compositeXML
* @return
*/
String updateDeploymentComposite(String uri, Reader compositeXML);
/**
* 4611 11.4.310.5.3 remove Contribution
* 4612 Removes the deployed contribution identified by a supplied contribution URI.
*
* @param contributionURI
* @throws ActivationException
*/
void removeContribution(String contributionURI) throws ActivationException;
/**
* 4677 10.7.1 add To Domain-Level Composite
* 4678 This functionality adds the composite identified by a supplied URI to the Domain Level Composite. The
* 4679 supplied composite URI refers to a composite within an installed contribution. The composite's installed
* 4680 contribution determines how the composite�s artifacts are resolved (directly and indirectly). The supplied
* 4681 composite is added to the domain composite with semantics that correspond to the domain-level
* 4683 components become top-level components and the component services become externally visible
* 4684 services (eg. they would be present in a WSDL description of the Domain). The meaning of any promoted
* 4685 services and references in the supplied composite is not defined; since there is no composite scope
* 4686 outside the domain composite, the usual idea of promotion has no utility.
*
* @param compositeURI
* @throws ActivationException
*/
void addToDomainLevelComposite(String compositeURI) throws ActivationException;
/**
* 4687 10.7.2 remove From Domain-Level Composite
* 4688 Removes from the Domain Level composite the elements corresponding to the composite identified by a
* 4689 supplied composite URI. This means that the removal of the components, wires, services and references
* 4690 originally added to the domain level composite by the identified composite. *
* @param compositeURI
* @throws ActivationException
*/
void removeFromDomainLevelComposite(String compositeURI) throws ActivationException;
/**
* 10.7.3 get Domain-Level Composite
* Returns a <composite> definition that has an <include> line for each composite that had been added to
* the domain level composite. It is important to note that, in dereferencing the included composites, any
* referenced artifacts are resolved in terms of that installed composite.
*
* @return
*/
Composite getDomainLevelComposite();
/* that previous one returns a Composte object but not sure what would be most appropriate, and having one return a string seems convenient: */
String getDomainLevelCompositeAsString();
/**
* 4695 10.7.4 get QName Definition
* 4696 In order to make sense of the domain-level composite (as returned by get Domain-Level Composite), it
* 4697 needs to be possible to get the definitions for named artifacts in the included composites. This
* 4698 functionality takes the supplied URI of an installed contribution (which provides the context), a supplied
* 4699 qualified name of a definition to look up, and a supplied symbol space (as a QName, e.g.
* 4700 wsdl:PortTypeportType). The result is a single definition, in whatever form is appropriate for that
* 4701 definition type.
* 4702 Note that this, like all the other domain-level operations, is a conceptual operation. Its capabilities need to
* 4703 exist in some form, but not necessarily as a service operation with exactly this signature. *
* @param contributionURI
* @param definition
* @param symbolSpace
* @return
*/
Object getQNameDefinition(String contributionURI, QName definition, QName symbolSpace);
/**
* Probably want to be able to stop it all at once so a method called stop or shutdown or destroy
* though i guess it could be argued that this method may be somewhere else
*/
void shutdown();
/**
* Would also be convenient to get service proxys as from SCAClientFactory
*/
<T> T getService(Class<T> interfaze, String serviceURI) throws NoSuchServiceException;
/* do we also need these following ones that are mentioned only indirectly in the spec? */
List<String> getDeployedCompostes(String contributionURI);
List<String> getInstalledContributions();
}
|
