Java tutorial
/* * Copyright (c) 2005-2010, WSO2 Inc. (http://www.wso2.org) All Rights Reserved. * * WSO2 Inc. 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.synapse.deployers; import java.io.File; import java.io.IOException; import java.util.Collection; import java.util.Properties; import org.apache.axiom.om.OMElement; import org.apache.axis2.deployment.DeploymentException; import org.apache.axis2.deployment.repository.util.DeploymentFileData; import org.apache.commons.io.FilenameUtils; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; import org.apache.synapse.libraries.imports.SynapseImport; import org.apache.synapse.libraries.model.Library; import org.apache.synapse.libraries.util.LibDeployerUtils; public class LibraryArtifactDeployer extends AbstractSynapseArtifactDeployer { private static final Log log = LogFactory.getLog(LibraryArtifactDeployer.class); public void deploy(DeploymentFileData deploymentFileData) throws DeploymentException { String libFilePath = FilenameUtils.normalize(deploymentFileData.getAbsolutePath()); if (log.isDebugEnabled()) { log.debug("Deployment of the synapse library artifact from file : " + libFilePath + " : STARTED"); } // if (getServerContextInformation().getServerState() != // ServerState.STARTED) { // // synapse server has not yet being started // if (log.isDebugEnabled()) { // log.debug("Skipped the library artifact deployment (since the Synapse " // + // "server doesn't seem to be started yet), from file : " // + deploymentFileData.getAbsolutePath()); // } // return; // } try { SynapseArtifactDeploymentStore deploymentStore = getSynapseConfiguration().getArtifactDeploymentStore(); Library lib = LibDeployerUtils.createSynapseLibrary(libFilePath); String libArtifactName = lib.getQName().toString(); if (this.getSynapseConfiguration().getSynapseLibraries().get(lib.getQName().toString()) != null) { log.warn("Hot deployment thread picked up an already deployed synapse library - Ignoring"); } else { if (log.isDebugEnabled()) { log.debug("Created the Synapse Library : " + libArtifactName + " from : " + libFilePath); } if (deploymentStore.isUpdatingArtifact(libFilePath)) { if (log.isDebugEnabled()) { log.debug("Updating Library artifact detected with filename : " + libFilePath); } // this is an hot-update case String existingArtifactName = deploymentStore.getUpdatingArtifactWithFileName(libFilePath); deploymentStore.removeUpdatingArtifact(libFilePath); undeploySynapseArtifact(existingArtifactName); // deploy from beginning // add the library to synapse Config completeDeployment(lib, libArtifactName); } else { // new artifact hot-deployment case try { // add the library to synapse Config completeDeployment(lib, libArtifactName); } catch (SynapseArtifactDeploymentException sade) { log.error("Deployment of the Synapse Artifact from file : " + libFilePath + " : Failed!", sade); /* * log.info("The file has been backed up into : " + * backupFile(deploymentFileData.getFile())); */ } } if (libArtifactName != null) { deploymentStore.addArtifact(libFilePath, libArtifactName); } log.info("Synapse Library named '" + lib.toString() + "' has been deployed from file : " + libFilePath); } } catch (IOException ex) { handleDeploymentError( "Deployment of synapse artifact failed. Error reading " + libFilePath + " : " + ex.getMessage(), ex); } catch (Exception ex) { handleDeploymentError("Deployment of synapse artifact failed for synapse libray at : " + libFilePath + " : " + ex.getMessage(), ex); } if (log.isDebugEnabled()) { log.debug("Deployment of the synapse artifact from file : " + libFilePath + " : COMPLETED"); } } private void completeDeployment(Library lib, String libArtifactName) throws DeploymentException { getSynapseConfiguration().addSynapseLibrary(lib.getQName().toString(), lib); if (log.isDebugEnabled()) { log.debug("Synapse Library Deployment for lib: " + libArtifactName + " Completed"); } // each time a library is deployed we check with available imports and // if necessary (ie:- relevant import is available) load the libraries SynapseImport synImport = getSynapseConfiguration().getSynapseImports().get(libArtifactName); if (synImport != null && synImport.isStatus()) { LibDeployerUtils.loadLibArtifacts(synImport, lib); if (log.isDebugEnabled()) { log.debug("Loading Synapse Library: " + libArtifactName + " into memory for Import"); } LibDeployerUtils.deployingLocalEntries(lib, getSynapseConfiguration()); } } public void undeploy(String fileName) throws DeploymentException { fileName = FilenameUtils.normalize(fileName); if (log.isDebugEnabled()) { log.debug("UnDeployment of the synapse library from file : " + fileName + " : STARTED"); } SynapseArtifactDeploymentStore deploymentStore = getSynapseConfiguration().getArtifactDeploymentStore(); if (deploymentStore.containsFileName(fileName)) { File undeployingFile = new File(fileName); if (fileName.contains(File.separator + "tmp" + File.separator + "carbonapps" + File.separator) && fileName.endsWith(".zip")) { undeployingFile.delete(); } // axis2 treats Hot-Update as (Undeployment + deployment), where // synapse needs to differentiate the Hot-Update from the above two, since it needs // some validations for a real undeployment. Also this makes sure a zero downtime of the // synapse artifacts which are being Hot-deployed if (undeployingFile.exists()) { if (log.isDebugEnabled()) { log.debug("Marking artifact as updating from file : " + fileName); } // if the file exists, which means it has been updated and is a // Hot-Update case if (!deploymentStore.isRestoredFile(fileName)) { deploymentStore.addUpdatingArtifact(fileName, deploymentStore.getArtifactNameForFile(fileName)); deploymentStore.removeArtifactWithFileName(fileName); } } else { // if the file doesn't exists then it is an actual undeployment String artifactName = deploymentStore.getArtifactNameForFile(fileName); try { // CarbonApplication instance to delete Library currentMediationLib = null; // undeploying the local entries Collection<Library> appList = getSynapseConfiguration().getSynapseLibraries().values(); for (Library mediationLib : appList) { if (artifactName.equals(mediationLib.getQName().toString())) { currentMediationLib = mediationLib; } } if (currentMediationLib != null) { for (String localEntry : currentMediationLib.getLocalEntries()) { getSynapseConfiguration().removeEntry(localEntry); } } // do un-deployment undeploySynapseArtifact(artifactName); deploymentStore.removeArtifactWithFileName(fileName); log.info("Synapse Library named '" + artifactName + "' has been undeployed"); } catch (SynapseArtifactDeploymentException sade) { log.error("Unable to undeploy the synapse library artifact from file : " + fileName, sade); } } } else { String msg = "Artifact representing the filename " + fileName + " is not deployed on Synapse"; log.error(msg); throw new DeploymentException(msg); } if (log.isDebugEnabled()) { log.debug("UnDeployment of the synapse library artifact from file : " + fileName + " : COMPLETED"); } } public void undeploySynapseArtifact(String artifactName) { // get Old Lib config Library existingLib = null; try { existingLib = getSynapseConfiguration().getSynapseLibraries().get(artifactName); existingLib.unLoadLibrary(); getSynapseConfiguration().removeSynapseImport(artifactName); getSynapseConfiguration().removeSynapseLibrary(artifactName); } catch (DeploymentException e) { handleDeploymentError(e.getMessage(), e); } } private void handleDeploymentError(String msg, Exception e) { log.error(msg, e); } // avoid implementing any of the below methods since these are unusable in // this library deployment // scenario . we just want to inherit some of the methods from // AbstractSynapseArtifactDeployer public void setDirectory(String directory) { } public void setExtension(String extension) { } public String deploySynapseArtifact(OMElement artifactConfig, String fileName, Properties properties) { return null; } public String updateSynapseArtifact(OMElement artifactConfig, String fileName, String existingArtifactName, Properties properties) { return null; } public void restoreSynapseArtifact(String artifactName) { } }