org.opencms.setup.xml.v8.CmsXmlAddCollectors Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of opencms-test Show documentation
OpenCms is an enterprise-ready, easy to use website content management system based on Java and XML technology. Offering a complete set of features, OpenCms helps content managers worldwide to create and maintain beautiful websites fast and efficiently.
There is a newer version: 18.0
Show newest version
/*
 * This library is part of OpenCms -
 * the Open Source Content Management System
 *
 * Copyright (c) Alkacon Software GmbH & Co. KG (http://www.alkacon.com)
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 * Lesser General Public License for more details.
 *
 * For further information about Alkacon Software GmbH & Co. KG, please see the
 * company website: http://www.alkacon.com
 *
 * For further information about OpenCms, please see the
 * project website: http://www.opencms.org
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */

package org.opencms.setup.xml.v8;

import org.opencms.configuration.CmsConfigurationManager;
import org.opencms.configuration.CmsVfsConfiguration;
import org.opencms.configuration.I_CmsXmlConfiguration;
import org.opencms.setup.CmsSetupBean;
import org.opencms.setup.xml.A_CmsXmlVfs;
import org.opencms.setup.xml.CmsSetupXmlHelper;
import org.opencms.util.CmsStringUtil;

import java.util.ArrayList;
import java.util.List;

import org.dom4j.Document;

/**
 * Add new explorer types.
 *
 * @since 8.0.0
 */
public class CmsXmlAddCollectors extends A_CmsXmlVfs {

    /** List of xpaths to update. */
    private List m_xpaths;

    /**
     * The new widget definition data.

     */
    private String[][] m_collectors = {
        {"org.opencms.file.collectors.CmsSubscriptionCollector", "150"},
        {"org.opencms.file.collectors.CmsChangedResourceCollector", "160"}};

    /**
     * @see org.opencms.setup.xml.I_CmsSetupXmlUpdate#getName()
     */
    public String getName() {

        return "Add new content collectors";
    }

    /**
     * @see org.opencms.setup.xml.I_CmsSetupXmlUpdate#validate(org.opencms.setup.CmsSetupBean)
     */
    @Override
    public boolean validate(CmsSetupBean setupBean) throws Exception {

        return CmsStringUtil.isNotEmptyOrWhitespaceOnly(getCodeToChange(setupBean));
    }

    /**
     * @see org.opencms.setup.xml.A_CmsSetupXmlUpdate#executeUpdate(org.dom4j.Document, java.lang.String, boolean)
     */
    @Override
    protected boolean executeUpdate(Document document, String xpath, boolean forReal) {

        for (int i = 0; i < m_collectors.length; i++) {
            if (xpath.equals(getXPathsToUpdate().get(i))) {
                if (document.selectSingleNode(xpath) != null) {
                    return false;
                }
                CmsSetupXmlHelper.setValue(document, xpathForOrder(m_collectors[i][0]), m_collectors[i][1]);
                return true;
            }
        }
        return false;
    }

    /**
     * @see org.opencms.setup.xml.A_CmsSetupXmlUpdate#getCommonPath()
     */
    @Override
    protected String getCommonPath() {

        return xpathForCollectors();
    }

    /**
     * @see org.opencms.setup.xml.A_CmsSetupXmlUpdate#getXPathsToUpdate()
     */
    @Override
    protected List getXPathsToUpdate() {

        if (m_xpaths == null) {
            m_xpaths = new ArrayList();
            for (int i = 0; i < m_collectors.length; i++) {
                m_xpaths.add(xpathForCollectorByClass(m_collectors[i][0]));
            }
        }
        return m_xpaths;
    }

    /**
     * Returns the xpath for the order of a collector node with a given class name.

     *
     * @param className the class name
     *
     * @return the xpath of the collector node's alias attribute
     */
    protected String xpathForOrder(String className) {

        return xpathForCollectorByClass(className) + "/@" + I_CmsXmlConfiguration.A_ORDER;
    }

    /**
     * Returns the xpath for a collector node with a given class attribute.

     *
     * @param className the class name
     *
     * @return the xpath for the collector with the given class name attribute
     */
    protected String xpathForCollectorByClass(String className) {

        return xpathForCollectors()
            + "/"
            + CmsVfsConfiguration.N_COLLECTOR
            + "[@"
            + I_CmsXmlConfiguration.A_CLASS
            + "='"
            + className
            + "']";
    }

    /**
     * Returns the xpath for the collectors node.
     *
     * @return the xpath for the collectors node
     */
    protected String xpathForCollectors() {

        return "/"
            + CmsConfigurationManager.N_ROOT
            + "/"
            + CmsVfsConfiguration.N_VFS
            + "/"
            + CmsVfsConfiguration.N_RESOURCES
            + "/"
            + CmsVfsConfiguration.N_COLLECTORS;
    }
}