Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
/*
* 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.deployment;
import java.io.Reader;
import java.io.Writer;
import java.net.URI;
import java.net.URL;
import java.util.List;
import java.util.Map;
import javax.xml.namespace.QName;
import javax.xml.stream.XMLStreamException;
import javax.xml.stream.XMLStreamReader;
import javax.xml.stream.XMLStreamWriter;
import org.apache.tuscany.sca.assembly.Composite;
import org.apache.tuscany.sca.assembly.builder.BuilderContext;
import org.apache.tuscany.sca.assembly.builder.CompositeBuilderException;
import org.apache.tuscany.sca.contribution.Artifact;
import org.apache.tuscany.sca.contribution.Contribution;
import org.apache.tuscany.sca.contribution.ContributionMetadata;
import org.apache.tuscany.sca.contribution.processor.ContributionReadException;
import org.apache.tuscany.sca.contribution.processor.ContributionResolveException;
import org.apache.tuscany.sca.contribution.processor.ContributionWriteException;
import org.apache.tuscany.sca.contribution.processor.ProcessorContext;
import org.apache.tuscany.sca.core.ExtensionPointRegistry;
import org.apache.tuscany.sca.core.LifeCycleListener;
import org.apache.tuscany.sca.definitions.Definitions;
import org.apache.tuscany.sca.monitor.Monitor;
import org.apache.tuscany.sca.monitor.ValidationException;
/**
* A utility that provides system functions to handle Tuscany SCA application deployment
*/
public interface Deployer extends LifeCycleListener {
/**
* Check if Schema Validation for XML Documents is enabled
* @return
*/
boolean isSchemaValidationEnabled();
/**
* Sets Schema Validation for XML Documents flag
* @param schemaValidationEnabled
*/
void setSchemaValidationEnabled(boolean schemaValidationEnabled);
/**
* Attach a deployment composite to the given contribution
* @param contribution The target contribution
* @param composite The deployment composite
* @param appending A flag to indicate if existing deployable composites in the contribution should be appended or replaced
* @return uri of attached composite
*/
String attachDeploymentComposite(Contribution contribution, Composite composite, boolean appending);
/**
* Configure a list of contributions to create a composite representing a view of the domain
* @param contributions
* @param allContributions
* @param bindingBaseURIs
* @param monitor
* @return
* @throws ContributionResolveException
* @throws CompositeBuilderException
*/
Composite build(List contributions, List allContributions, Map> bindingBaseURIs, Monitor monitor)
throws ContributionResolveException, CompositeBuilderException;
Composite build(List contributions, List allContributions, Contribution systemContribution, Map> bindingBaseURIs, Monitor monitor)
throws ContributionResolveException, CompositeBuilderException;
/**
* Load an artifact from the given location
* @param uri
* @param location
* @param monitor
* @return
* @throws ContributionReadException
*/
Artifact loadArtifact(URI uri, URL location, Monitor monitor) throws ContributionReadException;
/**
* Load a contribution from the given location
* @param uri
* @param location
* @param monitor
* @return
* @throws ContributionReadException
*/
Contribution loadContribution(URI uri, URL location, Monitor monitor) throws ContributionReadException;
/**
* @param
* @param uri
* @param location
* @param monitor
* @return
* @throws ContributionReadException
*/
T loadDocument(URI uri, URL location, Monitor monitor) throws ContributionReadException;
/**
* @param
* @param reader
* @param monitor
* @return
* @throws XMLStreamException
* @throws ContributionReadException
*/
T loadXMLDocument(Reader reader, Monitor monitor) throws XMLStreamException, ContributionReadException;
/**
* @param
* @param reader
* @return
* @throws XMLStreamException
* @throws ContributionReadException
* @throws ValidationException
*/
T loadXMLDocument(Reader reader) throws XMLStreamException, ContributionReadException, ValidationException;
/**
* @param
* @param location
* @param monitor
* @return
* @throws XMLStreamException
* @throws ContributionReadException
*/
T loadXMLDocument(URL location, Monitor monitor) throws XMLStreamException, ContributionReadException;
/**
* @param
* @param reader
* @param monitor
* @return
* @throws ContributionReadException
* @throws XMLStreamException
*/
T loadXMLElement(XMLStreamReader reader, Monitor monitor) throws ContributionReadException, XMLStreamException;
/**
* Save the model as XML
* @param model
* @param writer
* @param monitor
* @throws XMLStreamException
* @throws ContributionWriteException
*/
void saveXMLDocument(Object model, Writer writer, Monitor monitor) throws XMLStreamException,
ContributionWriteException;
/**
* Save the model as XML
* @param model
* @param writer
* @param monitor
* @throws XMLStreamException
* @throws ContributionWriteException
*/
void saveXMLElement(Object model, XMLStreamWriter writer, Monitor monitor) throws XMLStreamException,
ContributionWriteException;
/**
*
* @return
*/
Monitor createMonitor();
/**
* Create an instance of {@link BuilderContext}
* @return
*/
BuilderContext createBuilderContext();
/**
* Create an instance of {@link ProcessorContext}
* @return
*/
ProcessorContext createProcessorContext();
/**
* Get the {@link ExtensionPointRegistry}
* @return
*/
ExtensionPointRegistry getExtensionPointRegistry();
/**
* Get the system definitions
*/
Definitions getSystemDefinitions();
/**
* Resolve a contributions dependencies
*
* @param c
* @param allContributions
* @param monitor
* @throws ContributionResolveException
* @throws CompositeBuilderException
*/
void resolve(Contribution c, List dependentContributions, Monitor monitor) throws ContributionResolveException, CompositeBuilderException;
public Contribution cloneSystemContribution(Monitor monitor);
/**
* Get a contributions dependencies from meta data without having to load a Contribution
* @param possibles a Map with key contributionURI and value the contribution metaData
* @param targetURI the contributionURI to find the dependencies of
* @param monitor
* @return the list of contribution URIs
*/
public List getDependencies(Map possibles, String targetURI, Monitor monitor);
}
