cmsresourcetypefolder.java

java 编写的程序

/*
* File   : $Source: /usr/local/cvs/opencms/src/com/opencms/file/CmsResourceTypeFolder.java,v $
* Date   : $Date: 2001/12/20 08:32:13 $
* Version: $Revision: 1.25 $
*
* This library is part of OpenCms -
* the Open Source Content Mananagement System
*
* Copyright (C) 2001  The OpenCms Group
*
* 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 OpenCms, please see the
* OpenCms 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 com.opencms.file;

import com.opencms.core.*;
import java.util.*;

import java.io.*;
import com.opencms.file.genericSql.*;

/**
 * Access class for resources of the type "Folder".
 *
 * @author
 * @version 1.0
 */

public class CmsResourceTypeFolder implements I_CmsResourceType, I_CmsConstants, Serializable, com.opencms.workplace.I_CmsWpConstants {

     /**
      * The id of resource type.
      */
    private int m_resourceType;

    /**
     * The id of the launcher used by this resource.
     */
    private int m_launcherType;

    /**
     * The resource type name.
     */
    private String m_resourceTypeName;

    /**
     * The class name of the Java class launched by the launcher.
     */
    private String m_launcherClass;


    /**
     * init a new CmsResourceType object.
     *
     * @param resourceType The id of the resource type.
     * @param launcherType The id of the required launcher.
     * @param resourceTypeName The printable name of the resource type.
     * @param launcherClass The Java class that should be invoked by the launcher.
     * This value is <b> null </b> if the default invokation class should be used.
     */
    public void init(int resourceType, int launcherType,
                           String resourceTypeName, String launcherClass){

        m_resourceType=resourceType;
        m_launcherType=launcherType;
        m_resourceTypeName=resourceTypeName;
        m_launcherClass=launcherClass;
    }
     /**
     * Returns the name of the Java class loaded by the launcher.
     * This method returns <b>null</b> if the default class for this type is used.
     *
     * @return the name of the Java class.
     */
     public String getLauncherClass() {
         if ((m_launcherClass == null) || (m_launcherClass.length()<1)) {
            return C_UNKNOWN_LAUNCHER;
         } else {
            return m_launcherClass;
         }
     }
     /**
     * Returns the launcher type needed for this resource-type.
     *
     * @return the launcher type for this resource-type.
     */
     public int getLauncherType() {
         return m_launcherType;
     }
    /**
     * Returns the name for this resource-type.
     *
     * @return the name for this resource-type.
     */
     public String getResourceTypeName() {
         return m_resourceTypeName;
     }
    /**
     * Returns the type of this resource-type.
     *
     * @return the type of this resource-type.
     */
    public int getResourceType() {
         return m_resourceType;
     }
    /**
     * Returns a string-representation for this object.
     * This can be used for debugging.
     *
     * @return string-representation for this object.
     */
     public String toString() {
        StringBuffer output=new StringBuffer();
        output.append("[ResourceType]:");
        output.append(m_resourceTypeName);
        output.append(" , Id=");
        output.append(m_resourceType);
        output.append(" , launcherType=");
        output.append(m_launcherType);
        output.append(" , launcherClass=");
        output.append(m_launcherClass);
        return output.toString();
      }

    /**
    * Changes the group of a resource.
    * <br>
    * Only the group of a resource in an offline project can be changed. The state
    * of the resource is set to CHANGED (1).
    * If the content of this resource is not existing in the offline project already,
    * it is read from the online project and written into the offline project.
    * <p>
    * <B>Security:</B>
    * Access is granted, if:
    * <ul>
    * <li>the user has access to the project</li>
    * <li>the user is owner of the resource or is admin</li>
    * <li>the resource is locked by the callingUser</li>
    * </ul>
    *
    * @param filename the complete path to the resource.
    * @param newGroup the name of the new group for this resource.
    * @param chRekursive shows if the subResources (of a folder) should be changed too.
    *
    * @exception CmsException if operation was not successful.
    */
    public void chgrp(CmsObject cms, String filename, String newGroup, boolean chRekursive) throws CmsException{

        CmsFolder folder = cms.readFolder(filename);
        // check if the current user has the right to change the group of the
        // resource. Only the owner of a file and the admin are allowed to do this.
        if((cms.getRequestContext().currentUser().equals(cms.readOwner(folder)))
                || (cms.userInGroup(cms.getRequestContext().currentUser().getName(),
                C_GROUP_ADMIN))) {
            cms.doChgrp(filename, newGroup);
            // now change the bodyfolder if exists
            String bodyFolder = C_CONTENTBODYPATH.substring(0,
                    C_CONTENTBODYPATH.lastIndexOf("/")) + folder.getAbsolutePath();
            try {
                cms.readFolder(bodyFolder);
                cms.doChgrp(bodyFolder, newGroup);
            }
            catch(CmsException ex) {
            // no folder is there, so do nothing
            }
            // the rekursive flag was set do a recursive chown on all files and subfolders
            if(chRekursive) {
                // get all subfolders and files
                Vector allFolders = new Vector();
                Vector allFiles = new Vector();
                getAllResources(cms, filename, allFiles, allFolders);
                // now modify all subfolders
                for(int i = 0;i < allFolders.size();i++) {
                    CmsFolder curfolder = (CmsFolder)allFolders.elementAt(i);
                    if(curfolder.getState() != C_STATE_DELETED) {
                        cms.doChgrp(curfolder.getAbsolutePath(), newGroup);
                        // check if there is a corresponding directory in the content body folder
                        bodyFolder = C_CONTENTBODYPATH.substring(0,
                                C_CONTENTBODYPATH.lastIndexOf("/")) + curfolder.getAbsolutePath();
                        try {
                            cms.readFolder(bodyFolder);
                            cms.doChgrp(bodyFolder, newGroup);
                        }
                        catch(CmsException ex) {
                        // no folder is there, so do nothing
                        }
                    }
                }
                // now modify all files in the subfolders
                for(int i = 0;i < allFiles.size();i++) {
                    CmsFile newfile = (CmsFile)allFiles.elementAt(i);
                    if(newfile.getState() != C_STATE_DELETED) {
                        try{
                            cms.chgrp(newfile.getAbsolutePath(), newGroup);
                        } catch (CmsException e){
                            if(I_CmsLogChannels.C_PREPROCESSOR_IS_LOGGING && A_OpenCms.isLogging()) {
                                A_OpenCms.log(A_OpenCms.C_OPENCMS_CRITICAL, "["+this.getClass().getName()+"] "+newfile.getAbsolutePath()+": "+e.getStackTraceAsString());
                            }
                        }
                    }
                }
            }
        }else{
            throw new CmsException("[" + this.getClass().getName() + "] " + filename,
                                    CmsException.C_NO_ACCESS);
        }
    }

    /**
    * Changes the flags of a resource.
    * <br>
    * Only the flags of a resource in an offline project can be changed. The state
    * of the resource is set to CHANGED (1).
    * If the content of this resource is not existing in the offline project already,
    * it is read from the online project and written into the offline project.
    * The user may change the flags, if he is admin of the resource.
    * <p>
    * <B>Security:</B>
    * Access is granted, if:
    * <ul>
    * <li>the user has access to the project</li>
    * <li>the user can write the resource</li>
    * <li>the resource is locked by the callingUser</li>
    * </ul>
    *
    * @param filename the complete path to the resource.
    * @param flags the new flags for the resource.
    * @param chRekursive shows if the subResources (of a folder) should be changed too.
    *
    * @exception CmsException if operation was not successful.
    * for this resource.
    */
    public void chmod(CmsObject cms, String filename, int flags, boolean chRekursive) throws CmsException{

        CmsFolder folder = cms.readFolder(filename);
        // check if the current user has the right to change the group of the
        // resource. Only the owner of a file and the admin are allowed to do this.
        if((cms.getRequestContext().currentUser().equals(cms.readOwner(folder)))
            || (cms.userInGroup(cms.getRequestContext().currentUser().getName(),
            C_GROUP_ADMIN))) {
             // modify the access flags
            cms.doChmod(filename, flags);
            // now change the bodyfolder if exists
            String bodyFolder = C_CONTENTBODYPATH.substring(0,
                    C_CONTENTBODYPATH.lastIndexOf("/")) + folder.getAbsolutePath();
            try {
                cms.readFolder(bodyFolder);
                cms.doChmod(bodyFolder, flags);
            }
            catch(CmsException ex) {
            // no folder is there, so do nothing
            }
            // the rekursive flag was set do a recursive chmod on all files and subfolders
            if(chRekursive) {
                // get all subfolders and files
                Vector allFolders = new Vector();
                Vector allFiles = new Vector();
                getAllResources(cms, filename, allFiles, allFolders);
                // now modify all subfolders
                for(int i = 0;i < allFolders.size();i++) {
                    CmsFolder curfolder = (CmsFolder)allFolders.elementAt(i);
                    if(curfolder.getState() != C_STATE_DELETED) {
                        cms.doChmod(curfolder.getAbsolutePath(), flags);
                        // check if there is a corresponding directory in the content body folder
                        bodyFolder = C_CONTENTBODYPATH.substring(0,
                                C_CONTENTBODYPATH.lastIndexOf("/")) + curfolder.getAbsolutePath();
                        try {
                            cms.readFolder(bodyFolder);
                            cms.doChmod(bodyFolder, flags);
                        }catch(CmsException ex) {
                        // no folder is there, so do nothing
                        }
                    }
                }
                // now modify all files in the subfolders
                for(int i = 0;i < allFiles.size();i++) {
                    CmsFile newfile = (CmsFile)allFiles.elementAt(i);
                    if(newfile.getState() != C_STATE_DELETED) {
                        try{
                            cms.chmod(newfile.getAbsolutePath(), flags);
                        } catch (CmsException e){
                            if(I_CmsLogChannels.C_PREPROCESSOR_IS_LOGGING && A_OpenCms.isLogging()) {
                                A_OpenCms.log(A_OpenCms.C_OPENCMS_CRITICAL, "["+this.getClass().getName()+"] "+newfile.getAbsolutePath()+": "+e.getStackTraceAsString());
                            }
                        }
                    }
                }
            }
        }else{
            throw new CmsException("[" + this.getClass().getName() + "] " + filename,
                                    CmsException.C_NO_ACCESS);
        }
    }

    /**
    * Changes the owner of a resource.
    * <br>
    * Only the owner of a resource in an offline project can be changed. The state
    * of the resource is set to CHANGED (1).
    * If the content of this resource is not existing in the offline project already,
    * it is read from the online project and written into the offline project.
    * The user may change this, if he is admin of the resource.
    * <p>
    * <B>Security:</B>
    * Access is cranted, if:
    * <ul>
    * <li>the user has access to the project</li>
    * <li>the user is owner of the resource or the user is admin</li>
    * <li>the resource is locked by the callingUser</li>
    * </ul>
    *
    * @param filename the complete path to the resource.
    * @param newOwner the name of the new owner for this resource.
    * @param chRekursive shows if the subResources (of a folder) should be changed too.
    *
    * @exception CmsException if operation was not successful.
    */
    public void chown(CmsObject cms, String filename, String newOwner, boolean chRekursive) throws CmsException{

        CmsFolder folder = cms.readFolder(filename);
        // check if the current user has the right to change the owner of the
        // resource. Only the owner of a file and the admin are allowed to do this.
        if((cms.getRequestContext().currentUser().equals(cms.readOwner(folder)))
                || (cms.userInGroup(cms.getRequestContext().currentUser().getName(), C_GROUP_ADMIN))) {
            // change the owner
            cms.doChown(filename, newOwner);