diff options
Diffstat (limited to 'sca-java-1.x/tags/java-M1-final/java/sca/core/src/main/java/org/apache/tuscany/core/builder/system/PolicyBuilderRegistry.java')
-rw-r--r-- | sca-java-1.x/tags/java-M1-final/java/sca/core/src/main/java/org/apache/tuscany/core/builder/system/PolicyBuilderRegistry.java | 92 |
1 files changed, 92 insertions, 0 deletions
diff --git a/sca-java-1.x/tags/java-M1-final/java/sca/core/src/main/java/org/apache/tuscany/core/builder/system/PolicyBuilderRegistry.java b/sca-java-1.x/tags/java-M1-final/java/sca/core/src/main/java/org/apache/tuscany/core/builder/system/PolicyBuilderRegistry.java new file mode 100644 index 0000000000..fb9b0b25db --- /dev/null +++ b/sca-java-1.x/tags/java-M1-final/java/sca/core/src/main/java/org/apache/tuscany/core/builder/system/PolicyBuilderRegistry.java @@ -0,0 +1,92 @@ +/** + * + * 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. + */ +package org.apache.tuscany.core.builder.system; + +import org.apache.tuscany.core.builder.BuilderException; +import org.apache.tuscany.core.builder.SourcePolicyBuilder; +import org.apache.tuscany.core.builder.TargetPolicyBuilder; +import org.apache.tuscany.core.wire.WireSourceConfiguration; +import org.apache.tuscany.core.wire.WireTargetConfiguration; +import org.apache.tuscany.model.assembly.ConfiguredReference; +import org.apache.tuscany.model.assembly.ConfiguredService; + +import java.util.List; + +/** + * A System registry for {@link org.apache.tuscany.core.builder.PolicyBuilder}s. <code>PolicyBuilder</code>s will be invoked when + * a {@link org.apache.tuscany.core.wire.WireFactory} is constructed by the {@link org.apache.tuscany.core.wire.WireFactory} + * service. + * <p/> + * <code>PolicyBuilder</code>s operate on either a source- or target-side wire and typically are registered by runtime extensions + * through {@link #registerTargetBuilder} or {@link #registerSourceBuilder} + * + * @version $Rev$ $Date$ + */ +public interface PolicyBuilderRegistry { + + /** + * Registers a target-side policy builder. Called by extensions to register their builders. + * + * @param builder the builder to register + */ + public void registerTargetBuilder(TargetPolicyBuilder builder); + + /** + * De-registers a target-side builder. Called by extensions to register their builders. + * + * @param builder the builder to register + */ + public void unregisterTargetBuilder(TargetPolicyBuilder builder); + + /** + * Registers a source-side policy builder. Called by extensions to register their builders. + * + * @param builder the builder to register + */ + public void registerSourceBuilder(SourcePolicyBuilder builder); + + /** + * De-registers a source-side builder. Called by extensions to register their builders. + * + * @param builder the builder to register + */ + public void unregisterSourceBuilder(SourcePolicyBuilder builder); + + /** + * Returns the list of registered target-side builders + */ + public List<TargetPolicyBuilder> getTargetBuilders(); + + /** + * Returns the list of registered source-side builders + */ + public List<SourcePolicyBuilder> getSourceBuilders(); + + /** + * Evaluates source-side policy metadata for configured reference and updates the curresponding collection of wire configurations + * + * @throws BuilderException + */ + public void buildSource(ConfiguredReference reference, List<WireSourceConfiguration> configurations) throws BuilderException; + + /** + * Evaluates target-side policy metadata for configured reference and updates the curresponding collection of wire configurations + * + * @throws BuilderException + */ + public void buildTarget(ConfiguredService service, WireTargetConfiguration configuration) throws BuilderException; +} |