diff options
Diffstat (limited to 'sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java')
7 files changed, 599 insertions, 0 deletions
diff --git a/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/DefaultSCABindingMapper.java b/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/DefaultSCABindingMapper.java new file mode 100644 index 0000000000..4d08ea1104 --- /dev/null +++ b/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/DefaultSCABindingMapper.java @@ -0,0 +1,195 @@ +/* + * 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.binding.sca.provider; + +import java.io.StringReader; +import java.util.Map; +import java.util.logging.Logger; + +import javax.xml.namespace.QName; +import javax.xml.stream.XMLStreamException; +import javax.xml.stream.XMLStreamReader; + +import org.apache.tuscany.sca.assembly.Base; +import org.apache.tuscany.sca.assembly.Binding; +import org.apache.tuscany.sca.assembly.builder.BindingBuilder; +import org.apache.tuscany.sca.assembly.builder.BuilderContext; +import org.apache.tuscany.sca.assembly.builder.BuilderExtensionPoint; +import org.apache.tuscany.sca.common.xml.stax.StAXHelper; +import org.apache.tuscany.sca.contribution.processor.ContributionReadException; +import org.apache.tuscany.sca.contribution.processor.ProcessorContext; +import org.apache.tuscany.sca.contribution.processor.StAXArtifactProcessor; +import org.apache.tuscany.sca.contribution.processor.StAXArtifactProcessorExtensionPoint; +import org.apache.tuscany.sca.core.ExtensionPointRegistry; +import org.apache.tuscany.sca.extensibility.ServiceDeclarationParser; +import org.apache.tuscany.sca.policy.PolicySubject; +import org.apache.tuscany.sca.provider.ProviderFactory; +import org.apache.tuscany.sca.provider.ProviderFactoryExtensionPoint; +import org.apache.tuscany.sca.runtime.RuntimeEndpoint; +import org.apache.tuscany.sca.runtime.RuntimeEndpointReference; +import org.oasisopen.sca.ServiceRuntimeException; + +/** + * Default implementation of SCABindingMapper + */ +public class DefaultSCABindingMapper implements SCABindingMapper { + private final static Logger logger = Logger.getLogger(DefaultSCABindingMapper.class.getName()); + protected ExtensionPointRegistry registry; + protected ProviderFactoryExtensionPoint providerFactories; + protected StAXArtifactProcessor<?> processor; + protected BindingBuilder builder; + protected QName mappedBinding; + private Binding bindingTemplate; + + public DefaultSCABindingMapper(ExtensionPointRegistry registry, Map<String, String> attributes) { + this.registry = registry; + if (attributes != null) { + String qname = attributes.get("mappedBinding"); + if (qname != null) { + mappedBinding = ServiceDeclarationParser.getQName(qname); + } + } + if (mappedBinding == null) { + String qname = + System.getProperty("org.apache.tuscany.sca.binding.sca.provider.SCABindingMapper.mappedBinding"); + if (qname != null) { + mappedBinding = ServiceDeclarationParser.getQName(qname); + } else { + // By default, mapping to binding.ws or if thats not available then binding.rmi + mappedBinding = new QName(Base.SCA11_TUSCANY_NS, "binding.hazelcast"); + if (registry.getExtensionPoint(StAXArtifactProcessorExtensionPoint.class).getProcessor(mappedBinding) == null) { + mappedBinding = new QName(Base.SCA11_NS, "binding.ws"); + if (registry.getExtensionPoint(StAXArtifactProcessorExtensionPoint.class).getProcessor(mappedBinding) == null) { + mappedBinding = new QName(Base.SCA11_TUSCANY_NS, "binding.rmi"); + } + } + } + } + + providerFactories = registry.getExtensionPoint(ProviderFactoryExtensionPoint.class); + StAXArtifactProcessorExtensionPoint processors = + registry.getExtensionPoint(StAXArtifactProcessorExtensionPoint.class); + processor = processors.getProcessor(mappedBinding); + if (processor == null) { + logger.warning("Mapped binding for binding.sca is not supported: " + mappedBinding); + } + + try { + if (processor != null) { + bindingTemplate = createDelegatingBinding(); + ProviderFactory providerFactory = providerFactories.getProviderFactory(bindingTemplate.getClass()); + if (providerFactory == null) { + logger.warning("Mapped binding for binding.sca is not supported: " + mappedBinding); + processor = null; + } + } + } catch (Throwable e) { + throw new ServiceRuntimeException(e); + } + BuilderExtensionPoint builders = registry.getExtensionPoint(BuilderExtensionPoint.class); + builder = builders.getBindingBuilder(mappedBinding); + } + + public RuntimeEndpoint map(RuntimeEndpoint endpoint) { + if (processor == null) { + return null; + } + // create a copy of the endpoint but with the web service binding in + RuntimeEndpoint ep = null; + try { + ep = (RuntimeEndpoint)endpoint.clone(); + } catch (Exception ex) { + // we know we can clone endpoint references + } + + Binding binding = map(endpoint.getBinding()); + ep.setBinding(binding); + if (builder != null) { + builder.build(ep.getComponent(), ep.getService(), binding, new BuilderContext(registry), false); + } + return ep; + } + + public RuntimeEndpointReference map(RuntimeEndpointReference endpointReference) { + if (processor == null) { + return null; + } + // create a copy of the endpoint but with the web service binding in + RuntimeEndpointReference epr = null; + try { + epr = (RuntimeEndpointReference)endpointReference.clone(); + } catch (Exception ex) { + // we know we can clone endpoint references + } + + Binding binding = map(endpointReference.getBinding()); + epr.setBinding(binding); + + // epr.setTargetEndpoint(map((RuntimeEndpoint)epr.getTargetEndpoint())); + + if (builder != null) { + builder.build(epr.getComponent(), epr.getReference(), binding, new BuilderContext(registry), false); + } + + return epr; + } + + protected Binding map(Binding scaBinding) { + try { + Binding binding = createDelegatingBinding(); + binding.setName(scaBinding.getName()); + binding.setURI(scaBinding.getURI()); + binding.setOperationSelector(scaBinding.getOperationSelector()); + binding.setRequestWireFormat(scaBinding.getRequestWireFormat()); + binding.setResponseWireFormat(scaBinding.getResponseWireFormat()); + if (binding instanceof PolicySubject && scaBinding instanceof PolicySubject) { + PolicySubject subject1 = (PolicySubject)binding; + PolicySubject subject2 = (PolicySubject)scaBinding; + subject1.getPolicySets().addAll(subject2.getPolicySets()); + subject1.getRequiredIntents().addAll(subject2.getRequiredIntents()); + } + return binding; + } catch (Throwable e) { + throw new ServiceRuntimeException(e); + } + + } + + private Binding createDelegatingBinding() throws XMLStreamException, ContributionReadException { + if (bindingTemplate != null) { + try { + return (Binding)bindingTemplate.clone(); + } catch (CloneNotSupportedException e) { + // Ignore + } + } + // This is a hack to create an instance of the binding using the XML QName + StringBuffer xml = new StringBuffer(); + xml.append("<").append(mappedBinding.getLocalPart()).append(" xmlns:b=\"").append(mappedBinding + .getNamespaceURI()).append("\"/>"); + + StAXHelper staxHelper = StAXHelper.getInstance(registry); + XMLStreamReader reader = staxHelper.createXMLStreamReader(new StringReader(xml.toString())); + reader.nextTag(); + Binding binding = (Binding)processor.read(reader, new ProcessorContext(registry)); + return binding; + } + +} diff --git a/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/DelegatingSCAReferenceBindingProvider.java b/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/DelegatingSCAReferenceBindingProvider.java new file mode 100644 index 0000000000..a8fec07f5c --- /dev/null +++ b/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/DelegatingSCAReferenceBindingProvider.java @@ -0,0 +1,69 @@ +/* + * 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.binding.sca.provider; + +import org.apache.tuscany.sca.interfacedef.InterfaceContract; +import org.apache.tuscany.sca.interfacedef.Operation; +import org.apache.tuscany.sca.invocation.Invoker; +import org.apache.tuscany.sca.provider.EndpointReferenceProvider; +import org.apache.tuscany.sca.provider.ReferenceBindingProvider; +import org.apache.tuscany.sca.runtime.RuntimeEndpointReference; + +/** + * The reference binding provider for the remote sca binding implementation. + */ +public class DelegatingSCAReferenceBindingProvider implements EndpointReferenceProvider { + + private ReferenceBindingProvider provider; + + public DelegatingSCAReferenceBindingProvider(RuntimeEndpointReference endpointReference, + SCABindingMapper mapper) { + RuntimeEndpointReference epr = mapper.map(endpointReference); + if (epr != null) { + provider = epr.getBindingProvider(); + } + } + + public InterfaceContract getBindingInterfaceContract() { + return provider.getBindingInterfaceContract(); + } + + public boolean supportsOneWayInvocation() { + return provider.supportsOneWayInvocation(); + } + + public Invoker createInvoker(Operation operation) { + return provider.createInvoker(operation); + } + + public void start() { + provider.start(); + } + + public void stop() { + provider.stop(); + } + + public void configure() { + if (provider instanceof EndpointReferenceProvider) { + ((EndpointReferenceProvider)provider).configure(); + } + } +} diff --git a/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/DelegatingSCAServiceBindingProvider.java b/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/DelegatingSCAServiceBindingProvider.java new file mode 100644 index 0000000000..ca90878633 --- /dev/null +++ b/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/DelegatingSCAServiceBindingProvider.java @@ -0,0 +1,82 @@ +/* + * 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.binding.sca.provider; + +import java.util.logging.Logger; + +import org.apache.tuscany.sca.interfacedef.InterfaceContract; +import org.apache.tuscany.sca.provider.ServiceBindingProvider; +import org.apache.tuscany.sca.runtime.RuntimeEndpoint; + +/** + * The service binding provider for the remote sca binding implementation. Relies on the + * binding-ws-axis implementation for providing a remote message endpoint + * + * @version $Rev$ $Date$ + */ +public class DelegatingSCAServiceBindingProvider implements ServiceBindingProvider { + + private static final Logger logger = Logger.getLogger(DelegatingSCAServiceBindingProvider.class.getName()); + + private ServiceBindingProvider provider; + private RuntimeEndpoint endpoint; + private RuntimeEndpoint mappedEndpoint; + private boolean started = false; + + public DelegatingSCAServiceBindingProvider(RuntimeEndpoint endpoint, SCABindingMapper mapper) { + this.endpoint = endpoint; + this.mappedEndpoint = mapper.map(endpoint); + if (mappedEndpoint != null) { + provider = mappedEndpoint.getBindingProvider(); + } + + } + + public InterfaceContract getBindingInterfaceContract() { + return provider.getBindingInterfaceContract(); + } + + public boolean supportsOneWayInvocation() { + return provider.supportsOneWayInvocation(); + } + + public void start() { + if (started) { + return; + } else { + provider.start(); + // Set the resolved binding URI back to the binding.sca + endpoint.getBinding().setURI(mappedEndpoint.getBinding().getURI()); + started = true; + } + } + + public void stop() { + if (!started) { + return; + } + try { + provider.stop(); + } finally { + started = false; + } + } + +} diff --git a/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/RuntimeSCABindingProviderFactory.java b/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/RuntimeSCABindingProviderFactory.java new file mode 100644 index 0000000000..bcf8d7b02e --- /dev/null +++ b/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/RuntimeSCABindingProviderFactory.java @@ -0,0 +1,52 @@ +/* + * 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.binding.sca.provider; + +import org.apache.tuscany.sca.assembly.SCABinding; +import org.apache.tuscany.sca.core.ExtensionPointRegistry; +import org.apache.tuscany.sca.provider.BindingProviderFactory; +import org.apache.tuscany.sca.provider.ReferenceBindingProvider; +import org.apache.tuscany.sca.provider.ServiceBindingProvider; +import org.apache.tuscany.sca.runtime.RuntimeEndpoint; +import org.apache.tuscany.sca.runtime.RuntimeEndpointReference; + +/** + * The factory for creating SCA Binding providers + */ +public class RuntimeSCABindingProviderFactory implements BindingProviderFactory<SCABinding> { + + private ExtensionPointRegistry extensionPoints; + + public RuntimeSCABindingProviderFactory(ExtensionPointRegistry extensionPoints) { + this.extensionPoints = extensionPoints; + } + + public ReferenceBindingProvider createReferenceBindingProvider(RuntimeEndpointReference endpointReference) { + return new RuntimeSCAReferenceBindingProvider(extensionPoints, endpointReference); + } + + public ServiceBindingProvider createServiceBindingProvider(RuntimeEndpoint endpoint) { + return new RuntimeSCAServiceBindingProvider(extensionPoints, endpoint); + } + + public Class<SCABinding> getModelType() { + return SCABinding.class; + } +} diff --git a/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/RuntimeSCAReferenceBindingProvider.java b/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/RuntimeSCAReferenceBindingProvider.java new file mode 100644 index 0000000000..64861d7f42 --- /dev/null +++ b/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/RuntimeSCAReferenceBindingProvider.java @@ -0,0 +1,93 @@ +/* + * 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.binding.sca.provider; + +import org.apache.tuscany.sca.core.ExtensionPointRegistry; +import org.apache.tuscany.sca.core.UtilityExtensionPoint; +import org.apache.tuscany.sca.interfacedef.InterfaceContract; +import org.apache.tuscany.sca.interfacedef.Operation; +import org.apache.tuscany.sca.invocation.Invoker; +import org.apache.tuscany.sca.provider.EndpointReferenceProvider; +import org.apache.tuscany.sca.provider.ReferenceBindingProvider; +import org.apache.tuscany.sca.runtime.RuntimeEndpointReference; + +/** + * The sca reference binding provider mediates between the twin requirements of + * local sca bindings and remote sca bindings. In the local case is does + * very little. When the sca binding model is set as being remote (because a + * reference target can't be resolved in the current model) this binding will + * try and create a remote connection to it + * + * @version $Rev$ $Date$ + */ +public class RuntimeSCAReferenceBindingProvider implements EndpointReferenceProvider { + + private boolean started = false; + + private ReferenceBindingProvider distributedProvider; + private SCABindingMapper scaBindingMapper; + + public RuntimeSCAReferenceBindingProvider(ExtensionPointRegistry extensionPoints, + RuntimeEndpointReference endpointReference) { + + UtilityExtensionPoint utilities = extensionPoints.getExtensionPoint(UtilityExtensionPoint.class); + this.scaBindingMapper = utilities.getUtility(SCABindingMapper.class); + this.distributedProvider = new DelegatingSCAReferenceBindingProvider(endpointReference, scaBindingMapper); + } + + public InterfaceContract getBindingInterfaceContract() { + return distributedProvider.getBindingInterfaceContract(); + } + + public boolean supportsOneWayInvocation() { + return distributedProvider.supportsOneWayInvocation(); + } + + public Invoker createInvoker(Operation operation) { + return distributedProvider.createInvoker(operation); + } + + public void start() { + if (started) { + return; + } + distributedProvider.start(); + started = true; + } + + public void stop() { + if (!started) { + return; + } + + try { + distributedProvider.stop(); + } finally { + started = false; + } + } + + public void configure() { + if (distributedProvider instanceof EndpointReferenceProvider) { + ((EndpointReferenceProvider)distributedProvider).configure(); + } + } + +} diff --git a/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/RuntimeSCAServiceBindingProvider.java b/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/RuntimeSCAServiceBindingProvider.java new file mode 100644 index 0000000000..3c09661f25 --- /dev/null +++ b/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/RuntimeSCAServiceBindingProvider.java @@ -0,0 +1,64 @@ +/* + * 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.binding.sca.provider; + +import org.apache.tuscany.sca.core.ExtensionPointRegistry; +import org.apache.tuscany.sca.core.UtilityExtensionPoint; +import org.apache.tuscany.sca.interfacedef.InterfaceContract; +import org.apache.tuscany.sca.provider.ServiceBindingProvider; +import org.apache.tuscany.sca.runtime.RuntimeEndpoint; + +/** + * The sca service binding provider mediates between the twin requirements of + * local sca bindings and remote sca bindings. In the local case is does + * very little. When the sca binding model is set as being remote this binding will + * try and create a remote service endpoint for remote references to connect to + * + * @version $Rev$ $Date$ + */ +public class RuntimeSCAServiceBindingProvider implements ServiceBindingProvider { + + private ServiceBindingProvider distributedProvider; + private SCABindingMapper scaBindingMapper; + + public RuntimeSCAServiceBindingProvider(ExtensionPointRegistry extensionPoints, RuntimeEndpoint endpoint) { + UtilityExtensionPoint utilities = extensionPoints.getExtensionPoint(UtilityExtensionPoint.class); + this.scaBindingMapper = utilities.getUtility(SCABindingMapper.class); + + this.distributedProvider = new DelegatingSCAServiceBindingProvider(endpoint, scaBindingMapper); + } + + public InterfaceContract getBindingInterfaceContract() { + return distributedProvider.getBindingInterfaceContract(); + } + + public boolean supportsOneWayInvocation() { + return distributedProvider.supportsOneWayInvocation(); + } + + public void start() { + distributedProvider.start(); + } + + public void stop() { + distributedProvider.stop(); + } + +} diff --git a/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/SCABindingMapper.java b/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/SCABindingMapper.java new file mode 100644 index 0000000000..8b3fbc10ce --- /dev/null +++ b/sca-java-2.x/tags/2.0.1-RC1/modules/binding-sca-runtime2/src/main/java/org/apache/tuscany/sca/binding/sca/provider/SCABindingMapper.java @@ -0,0 +1,44 @@ +/* + * 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.binding.sca.provider; + +import org.apache.tuscany.sca.runtime.RuntimeEndpoint; +import org.apache.tuscany.sca.runtime.RuntimeEndpointReference; + +/** + * SCABindingMapper allows us to map binding.sca to any of the bindings available to the runtime + */ +public interface SCABindingMapper { + + /** + * Map an endpoint with binding.sca to an endpoint + * @param endpoint The endpoint for binding.sca + * @return The endpoint for the mapped binding + */ + public RuntimeEndpoint map(RuntimeEndpoint endpoint); + + /** + * Map an endpoint reference with binding.sca to an endpoint reference with the mapped binding + * @param endpointReference + * @return The endpoint reference for the mapped binding + */ + public RuntimeEndpointReference map(RuntimeEndpointReference endpointReference); + +} |