com.day.cq.wcm.api.msm.LiveRelationship Maven / Gradle / Ivy

Go to download
/*
 * Copyright 1997-2008 Day Management AG
 * Barfuesserplatz 6, 4001 Basel, Switzerland
 * All Rights Reserved.
 *
 * This software is the confidential and proprietary information of
 * Day Management AG, ("Confidential Information"). You shall not
 * disclose such Confidential Information and shall use it only in
 * accordance with the terms of the license agreement you entered into
 * with Day.
 */
package com.day.cq.wcm.api.msm;

import java.util.Set;

import com.day.cq.commons.JSONItem;

/**
 * Defines a live relationship of a synced resource between its blueprint and
 * livecopy. for example, if a site (blueprint) "/content/geometrixx"
 * has a livecopy in "/content/copy", then the resource of "/content/geometrixx/en/jcr:content"
 * and "/content/copy/en/jcr:content" form a relationship.
 *
 * This is also extensible for components within a page, for example the
 * "/content/geometrixx/en/jcr:content/par/title" and
 * "/content/copy/en/jcr:content/par/title" can form a relationship.
 *
 * In contrast to the {@link LiveCopy} the LiveRelationship defines the "dynamic"
 * relation between a source and a synced target. where as the former only
 * defines its configuration.
 *
 * Please note that its not possible to have different relative paths from the
 * roots to the source/target resources. This could happen if a source or
 * target resource are moved or renamed. Having trees that are not in sync
 * hirarchy wise will probably end in chaos sooner or later. Such operations
 * need to be prohibited or the respective changes need to be rolledout to
 * all targets.
 * @deprecated since 5.3 use {@link com.day.cq.wcm.msm.api.RolloutManager} instead 
 */
@Deprecated
public interface LiveRelationship extends JSONItem {

    /**
     * Returns the Live Copy configuration of this relationship
     * @return the Live Copy
     */
    LiveCopy getLiveCopy();

    /**
     * Returns the relative path of this relationship from the sync roots to
     * the actual resources.
     *
     * for example:
     * "/en/jcr:content/par/title" for a paragraph relationship,
     * or "/en/jcr:content" for a page relationship
     *
     * @return the relative path
     */
    String getSyncPath();

    /**
     * Returns the absolute path of the source resource of this relationship.
     * This is a convenience method for
     * lr.getLiveCopy().getBlueprintPath() + lr.getSyncPath()
     *  
     * @return the source path
     */
    String getSourcePath();

    /**
     * Returns the ansolute path of the live sync resource.
     * This is a convenience method for
     * lr.getLiveCopy().getPath() + lr.getSyncPath()
     *
     * @return the target path
     */
    String getTargetPath();

    /**
     * Returns the status of this relationship
     * @return the status
     */
    LiveStatus getStatus();

    /**
     * Returns the actions config of this relationship defined on the blueprint
     * @return the actions config defined on the blueprint
     */
    Set getBlueprintActions();

    /**
     * Returns the computed actions config of this relationship (blueprint actions + live copy actions)
     * @return the computed actions config
     */
    Set getActions();
}