ingo@142: /* ingo@142: * Copyright (c) 2011 by Intevation GmbH ingo@142: * ingo@142: * This program is free software under the LGPL (>=v2.1) ingo@142: * Read the file LGPL.txt coming with the software for details ingo@142: * or visit http://www.gnu.org/licenses/ if it does not exist. ingo@142: */ ingo@142: package de.intevation.artifactdatabase.rest; ingo@142: ingo@142: import de.intevation.artifacts.ArtifactDatabase; ingo@142: import de.intevation.artifacts.ArtifactDatabaseException; ingo@142: import de.intevation.artifacts.CallMeta; ingo@142: ingo@142: import de.intevation.artifacts.common.ArtifactNamespaceContext; ingo@142: import de.intevation.artifacts.common.utils.XMLUtils; ingo@142: ingo@142: import java.io.IOException; ingo@142: ingo@142: import org.apache.log4j.Logger; ingo@142: ingo@142: import org.restlet.data.MediaType; ingo@142: import org.restlet.data.Status; ingo@142: import org.restlet.ext.xml.DomRepresentation; ingo@142: import org.restlet.representation.EmptyRepresentation; ingo@142: import org.restlet.representation.Representation; ingo@142: import org.restlet.Request; ingo@142: import org.restlet.Response; ingo@142: ingo@142: import org.w3c.dom.Document; ingo@142: ingo@142: ingo@142: /** ingo@142: * @author Ingo Weinzierl ingo@142: */ ingo@142: public class CollectionResource ingo@142: extends BaseResource ingo@142: { ingo@142: /** The logger that is used in this class.*/ ingo@142: private static Logger logger = Logger.getLogger(CollectionResource.class); ingo@142: ingo@142: /** server URL where to reach the resource.*/ ingo@142: public static final String PATH = "/collection/{uuid}"; ingo@142: ingo@142: /** ingo@142: * XPath to figure out the type of action (feed, advance) via the ingo@142: * incoming POST request. ingo@142: */ ingo@142: public static final String XPATH_ACTION = "/art:action/art:type/@name"; ingo@142: ingo@142: /** ingo@142: * XPath to figure out the identifier of the artifact described in the ingo@142: * action. ingo@142: */ ingo@142: public static final String XPATH_ARTIFACT = ingo@142: "/art:action/art:type/art:artifact/@uuid"; ingo@142: ingo@142: /** Error message if no action was given.*/ ingo@142: public static final String NO_ACTION_MSG = "no action given"; ingo@142: ingo@142: /** Error message if a unknown action was given.*/ ingo@142: public static final String NO_SUCH_ACTION_MSG = "no such action"; ingo@142: ingo@142: /** Action name for deleting a collection.*/ ingo@142: public static final String ACTION_DELETE = "delete"; ingo@142: ingo@196: /** Action name for describing the collection.*/ ingo@196: public static final String ACTION_DESCRIBE = "describe"; ingo@196: ingo@142: /** Action name for retrieving the attributes of an artifact stored in the ingo@142: * collection.*/ ingo@142: public static final String ACTION_GET_ATTRIBUTE = "getattribute"; ingo@142: ingo@142: /** Action name for setting the attribute for an artifact stored in the ingo@142: * collection.*/ ingo@142: public static final String ACTION_SET_ATTRIBUTE = "setattribute"; ingo@142: ingo@142: /** Action name for adding a new artifact to the collection.*/ ingo@142: public static final String ACTION_ADD_ARTIFACT = "addartifact"; ingo@142: ingo@142: /** Action name for removing an artifact from the collection.*/ ingo@142: public static final String ACTION_REMOVE_ARTIFACT = "removeartifact"; ingo@142: ingo@142: /** Action name for listing the artifacts of the collection.*/ ingo@142: public static final String ACTION_LIST_ARTIFACTS = "listartifacts"; ingo@142: ingo@142: ingo@142: /** ingo@142: * Method to figure out which POST action was triggered and perform this ingo@142: * operation on the collection specified by 'identifier' and found in the ingo@142: * artifact database 'db'. ingo@142: * ingo@142: * @param identifier The identifier of the collection. ingo@142: * @param action The action to be performed. ingo@142: * @param source The input document to further parameterize the operation. ingo@142: * @param db The artifact database where to find the collection. ingo@142: * ingo@142: * @return The representation produced by the performed action. ingo@142: */ ingo@142: protected Representation dispatch( ingo@142: String identifier, ingo@142: String action, ingo@142: Document source, ingo@142: ArtifactDatabase db ingo@142: ) { ingo@142: Document out = null; ingo@142: ingo@142: try { ingo@142: CallMeta meta = getCallMeta(); ingo@142: ingo@142: if (action.equals(ACTION_DELETE)) { ingo@142: logger.info("Delete collection '" + identifier + "'"); ingo@142: out = db.deleteCollection(identifier, getCallMeta()); ingo@142: } ingo@196: else if (action.equals(ACTION_DESCRIBE)) { ingo@196: logger.info("Describe collection '" + identifier + "'"); ingo@196: ingo@196: out = db.describeCollection(identifier, meta); ingo@196: } ingo@142: else if (action.equals(ACTION_ADD_ARTIFACT)) { ingo@142: String art = getArtifactIdentifier(source); ingo@142: ingo@142: logger.info("Add artifact '" + art + "' to collection."); ingo@189: out = db.addCollectionArtifact(identifier, art, source, meta); ingo@142: } ingo@142: else if (action.equals(ACTION_REMOVE_ARTIFACT)) { ingo@142: String art = getArtifactIdentifier(source); ingo@142: ingo@142: logger.info("Remove artifact '" + art + "' from collection."); ingo@142: out = db.removeCollectionArtifact(identifier, art, meta); ingo@142: } ingo@142: else if (action.equals(ACTION_LIST_ARTIFACTS)) { ingo@142: logger.info("List artifacts of collection '" + identifier +"'"); ingo@142: out = db.listCollectionArtifacts(identifier, meta); ingo@142: } ingo@142: else if (action.equals(ACTION_SET_ATTRIBUTE)) { ingo@142: String art = getArtifactIdentifier(source); ingo@142: ingo@142: logger.info("Set attribute for artifact '" + art + "'"); ingo@142: out = db.setCollectionAttribute(identifier, art, source, meta); ingo@142: } ingo@142: else if (action.equals(ACTION_GET_ATTRIBUTE)) { ingo@142: String art = getArtifactIdentifier(source); ingo@142: ingo@142: logger.info("Retrieve attribute of artifact '" + art + "'"); ingo@142: out = db.getCollectionAttribute(identifier, art, meta); ingo@142: } ingo@142: else { ingo@142: throw new ArtifactDatabaseException(NO_SUCH_ACTION_MSG); ingo@142: } ingo@142: } ingo@142: catch (ArtifactDatabaseException adbe) { ingo@142: logger.warn(adbe.getLocalizedMessage(), adbe); ingo@142: ingo@142: Response response = getResponse(); ingo@142: response.setStatus( ingo@142: Status.CLIENT_ERROR_BAD_REQUEST, adbe.getMessage()); ingo@142: return new EmptyRepresentation(); ingo@142: } ingo@142: ingo@142: return new DomRepresentation(MediaType.APPLICATION_XML, out); ingo@142: } ingo@142: ingo@142: ingo@142: @Override ingo@142: protected Representation innerPost(Representation requestRepr) { ingo@142: Document input = null; ingo@142: try { ingo@142: DomRepresentation in = new DomRepresentation(requestRepr); ingo@142: in.setNamespaceAware(true); ingo@142: input = in.getDocument(); ingo@142: } ingo@142: catch (IOException ioe) { ingo@142: logger.error(ioe.getLocalizedMessage(), ioe); ingo@142: ingo@142: Response response = getResponse(); ingo@142: response.setStatus(Status.CLIENT_ERROR_BAD_REQUEST, ioe); ingo@142: return new EmptyRepresentation(); ingo@142: } ingo@142: ingo@142: String action = XMLUtils.xpathString( ingo@142: input, XPATH_ACTION, ArtifactNamespaceContext.INSTANCE); ingo@142: ingo@142: if (action == null || action.length() == 0) { ingo@142: Response response = getResponse(); ingo@142: response.setStatus( ingo@142: Status.CLIENT_ERROR_BAD_REQUEST, NO_ACTION_MSG); ingo@142: return new EmptyRepresentation(); ingo@142: } ingo@142: ingo@142: Request request = getRequest(); ingo@142: ingo@142: String identifier = (String) request.getAttributes().get("uuid"); ingo@142: ingo@142: ArtifactDatabase db = getArtifactDatabase(); ingo@142: ingo@142: return dispatch(identifier, action, input, db); ingo@142: } ingo@142: ingo@142: ingo@142: /** ingo@142: * Retrieves the identifier of the artifact used in the action. ingo@142: * ingo@142: * @param source The incoming document that describes the operation. ingo@142: * ingo@142: * @return the uuid of the artifact described in the document. ingo@142: */ ingo@142: protected String getArtifactIdentifier(Document source) { ingo@142: return XMLUtils.xpathString( ingo@142: source, XPATH_ARTIFACT, ArtifactNamespaceContext.INSTANCE); ingo@142: } ingo@142: }