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
|
/*
* 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.node;
import java.lang.reflect.Constructor;
import org.osoa.sca.ServiceRuntimeException;
/**
* A factory for SCA processing nodes. An SCA processing node can be loaded
* with an SCA composite and the SCA contributions required by the composite.
*
* @version $Rev$ $Date$
*/
public abstract class SCANode2Factory {
/**
* Returns a new SCA node factory instance.
*
* @return a new SCA node factory
*/
public static SCANode2Factory newInstance() {
SCANode2Factory scaNodeFactory = null;
try {
final ClassLoader classLoader = Thread.currentThread().getContextClassLoader();
String className = "org.apache.tuscany.sca.node.impl.NodeFactoryImpl";
Class<?> cls = Class.forName(className, true, classLoader);
Constructor<?> constructor = null;
try {
constructor = cls.getConstructor();
} catch (NoSuchMethodException e) {
// ignore
}
if (constructor != null) {
scaNodeFactory = (SCANode2Factory)constructor.newInstance();
}
return scaNodeFactory;
} catch (Exception e) {
throw new ServiceRuntimeException(e);
}
}
/**
* Create a SCA node based on the discovery of the contribution on the classpath for the
* given classloader. This method should be treated a convinient shortcut with the following
* assumptions:
* <ul>
* <li>This is a standalone application and there is a deployable composite file on the classpath.
* <li>There is only one contribution which contains the deployable composite file physically in its packaging hierarchy.
* </ul>
* @param compositeURI The URI of the composite file relative to the root of the enclosing contribution
* @param classLoader The ClassLoader used to load the composite file as a resource. If the value is null,
* then thread context classloader will be used
* @return A newly created SCA node
*/
public abstract SCANode2 createSCANodeFromClassLoader(String compositeURI, ClassLoader classLoader);
/**
* Creates a new SCA node from the configuration URL
*
* @param configurationURL the URL of the node configuration which is the ATOM feed
* that contains the URI of the composite and a collection of URLs for the contributions
*
* @return a new SCA node.
*/
public abstract SCANode2 createSCANodeFromURL(String configurationURL);
/**
* Creates a new SCA node.
*
* @param compositeURI the URI of the composite to use
* @param contributions the URI of the contributions that provides the composites and related
* artifacts. If the list is empty, then we will use the thread context classloader to discover
* the contribution on the classpath
*
* @return a new SCA node.
*/
public abstract SCANode2 createSCANode(String compositeURI, SCAContribution... contributions);
/**
* Creates a new SCA node.
*
* @param compositeURI the URI of the composite to use
* @param compositeContent the XML content of the composite to use
* @param contributions the URI of the contributions that provides the composites and related artifacts
* @return a new SCA node.
*/
public abstract SCANode2 createSCANode(String compositeURI, String compositeContent, SCAContribution... contributions);
}
|
