/*
* <License>
* The Apache Software License
*
* Copyright (c) 2002 lenya. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* 1. Redistributions of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright notice, this
* list of conditions and the following disclaimer in the documentation and/or
* other materials provided with the distribution.
*
* 3. All advertising materials mentioning features or use of this software must
* display the following acknowledgment: "This product includes software developed
* by lenya (http://www.lenya.org)"
*
* 4. The name "lenya" must not be used to endorse or promote products derived from
* this software without prior written permission. For written permission, please
* contact contact@lenya.org
*
* 5. Products derived from this software may not be called "lenya" nor may "lenya"
* appear in their names without prior written permission of lenya.
*
* 6. Redistributions of any form whatsoever must retain the following acknowledgment:
* "This product includes software developed by lenya (http://www.lenya.org)"
*
* THIS SOFTWARE IS PROVIDED BY lenya "AS IS" WITHOUT ANY WARRANTY EXPRESS OR IMPLIED,
* INCLUDING THE WARRANTY OF NON-INFRINGEMENT AND THE IMPLIED WARRANTIES OF MERCHANTI-
* BILITY AND FITNESS FOR A PARTICULAR PURPOSE. lenya WILL NOT BE LIABLE FOR ANY DAMAGES
* SUFFERED BY YOU AS A RESULT OF USING THIS SOFTWARE. IN NO EVENT WILL lenya BE LIABLE
* FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR LOST PROFITS EVEN IF lenya HAS
* BEEN ADVISED OF THE POSSIBILITY OF THEIR OCCURRENCE. lenya WILL NOT BE LIABLE FOR ANY
* THIRD PARTY CLAIMS AGAINST YOU.
*
* Lenya includes software developed by the Apache Software Foundation, W3C,
* DOM4J Project, BitfluxEditor and Xopus.
* </License>
*/
package ch.unizh.lenya.cms.task;
import java.io.IOException;
import org.apache.avalon.framework.parameters.ParameterException;
import org.apache.cocoon.ProcessingException;
import org.apache.lenya.cms.publication.Document;
import org.apache.lenya.cms.publication.DocumentBuildException;
import org.apache.lenya.cms.publication.DocumentBuilder;
import org.apache.lenya.cms.publication.DocumentException;
import org.apache.lenya.cms.publication.DocumentHelper;
import org.apache.lenya.cms.publication.Publication;
import org.apache.lenya.cms.publication.PublicationException;
import org.apache.lenya.cms.publication.SiteTree;
import org.apache.lenya.cms.publication.SiteTreeException;
import org.apache.lenya.cms.publication.SiteTreeNode;
import org.apache.lenya.cms.publication.task.PublicationTask;
import org.apache.lenya.cms.task.ExecutionException;
import org.apache.lenya.workflow.WorkflowException;
import org.apache.log4j.Category;
/**
* Publish a document.
*
* @author <a href="mailto:andreas@apache.org">Andreas Hartmann</a>
*/
public class Publish extends PublicationTask {
private static final Category log = Category.getInstance(Publish.class);
public static final String PARAMETER_DOCUMENT_ID = "document-id";
public static final String PARAMETER_DOCUMENT_LANGUAGE = "document-language";
/**
* @see org.apache.lenya.cms.task.Task#execute(java.lang.String)
*/
public void execute(String servletContextPath) throws ExecutionException {
if (log.isDebugEnabled()) {
log.debug("Starting publishing");
}
try {
Document authoringDocument = getAuthoringDocument();
if (!checkPreconditions(authoringDocument)) {
setResult(FAILURE);
} else {
if (log.isDebugEnabled()) {
log.debug("Can execute task: parent is published.");
}
publish(authoringDocument);
setResult(SUCCESS);
}
} catch (ExecutionException e) {
throw e;
} catch (Exception e) {
throw new ExecutionException(e);
}
}
/**
* Checks if the preconditions are complied.
* @param document The document to publish.
* @return
* @throws PublicationException
* @throws ExecutionException
* @throws DocumentException
*/
protected boolean checkPreconditions(Document document)
throws
PublicationException,
DocumentException,
ProcessingException,
SiteTreeException,
ExecutionException {
boolean OK = true;
if (!canWorkflowFire(document)) {
OK = false;
if (log.isDebugEnabled()) {
log.debug("Cannot execute task: workflow event not supported.");
}
}
Document liveDocument = getPublication().getAreaVersion(document, Publication.LIVE_AREA);
Document liveParent = DocumentHelper.getParentDocument(liveDocument);
if (liveParent != null) {
SiteTree liveTree = getPublication().getSiteTree(Publication.LIVE_AREA);
SiteTreeNode liveParentNode = liveTree.getNode(liveParent.getId());
if (liveParentNode == null) {
if (log.isDebugEnabled()) {
log.debug("Cannot execute task: live parent node does not exist.");
}
OK = false;
}
}
return OK;
}
/**
* Publishes a document.
* @param authoringDocument The authoring document.
*/
protected void publish(Document authoringDocument)
throws
PublicationException,
ExecutionException,
IOException,
ParameterException,
WorkflowException {
getPublication().copyDocumentToArea(authoringDocument, Publication.LIVE_AREA);
Document liveDocument =
getPublication().getAreaVersion(authoringDocument, Publication.LIVE_AREA);
copyResources(authoringDocument, liveDocument);
triggerWorkflow(authoringDocument);
}
/**
* Returns the authoring document to apply this task on.
* @return A document.
* @throws ParameterException when something went wrong.
* @throws DocumentBuildException when something went wrong.
* @throws ExecutionException when something went wrong.
*/
protected Document getAuthoringDocument()
throws ParameterException, DocumentBuildException, ExecutionException {
String id = getParameters().getParameter(PARAMETER_DOCUMENT_ID);
String language = getParameters().getParameter(PARAMETER_DOCUMENT_LANGUAGE);
DocumentBuilder builder = getPublication().getDocumentBuilder();
String url =
builder.buildCanonicalUrl(getPublication(), Publication.AUTHORING_AREA, id, language);
Document document = builder.buildDocument(getPublication(), url);
return document;
}
}