Source code: com/opencms/core/CmsShellCommands.java

   /*
   * File   : $Source: /usr/local/cvs/opencms/src/com/opencms/core/Attic/CmsShellCommands.java,v $
   * Date   : $Date: 2003/03/19 08:43:10 $
   * Version: $Revision: 1.67 $
   *
   * 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.core;
  
  import com.opencms.file.*;
  import com.opencms.report.CmsShellReport;
  
  import java.io.File;
  import java.io.FileInputStream;
  import java.lang.reflect.Method;
  import java.lang.reflect.Modifier;
  import java.util.Enumeration;
  import java.util.HashMap;
  import java.util.Hashtable;
  import java.util.Iterator;
  import java.util.Map;
  import java.util.StringTokenizer;
  import java.util.Vector;
  
  /**
   * This class is a commad line interface to OpenCms which 
   * can be used for the initial setup and to test the system.<p>
   *
   * @author Andreas Schouten
   * @author Anders Fugmann
   * 
   * @version $Revision: 1.67 $ $Date: 2003/03/19 08:43:10 $
   * 
   * @see com.opencms.file.CmsObject
   */
  class CmsShellCommands implements I_CmsConstants {
  
      /**
       * The CmsObject object which provides access to the VFS..
       */
      private CmsObject m_cms;
  
      /**
       * The wrapped OpenCms object which provides the system environment.
       */
      private OpenCms m_openCms;
  
      /**
       * Generate a new instance of CmsShellCommands.<p>
       * 
       * @param openCms an initialized OpenCms object (i.e. "operating system")
       * @param cms an initialized CmsObject (i.e. "command shell")
       */
      public CmsShellCommands(OpenCms openCms, CmsObject cms) throws Exception {
          m_openCms = openCms;
          m_cms = cms;
          m_openCms.initUser(m_cms, null, null, C_USER_GUEST, C_GROUP_GUEST, C_PROJECT_ONLINE_ID, null);
  
          // print the version-string
          version();
          copyright();
          printHelpText();
      }
  
      /**
       * Accept a task from the Cms.
       *
       * @param taskid the id of the task to accept.
       */
      public void acceptTask(String taskId) {
          try {
              int id = Integer.parseInt(taskId);
              m_cms.acceptTask(id);
          }
          catch(Exception exc) {
              CmsShell.printException(exc);
          }
      }
 
     /**
      * Checks, if the user may create this resource.
      *
      * @param resource the resource to check.
      */
     public void accessCreate(String resource) {
         try {
 
             //System.out.println(m_cms.accessCreate(m_cms.readFileHeader(resource)));
             // ednfal: resource is read later in resourcebroker
             System.out.println(m_cms.accessCreate(resource));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Checks, if the user may lock this resource.
      *
      * @param resource the resource to check.
      */
     public void accessLock(String resource) {
         try {
 
             //System.out.println(m_cms.accessLock(m_cms.readFileHeader(resource)));
             // ednfal: resource is read later in resourcebroker
             System.out.println(m_cms.accessLock(resource));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Tests if the user can access the project.
      *
      * @param id the id of the project.
      */
     public void accessProject(String id) {
         try {
             int projectId = Integer.parseInt(id);
             System.out.println(m_cms.accessProject(projectId));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Checks, if the user may read this resource.
      *
      * @param resource The resource to check.
      */
     public void accessRead(String resource) {
         try {
 
             //System.out.println(m_cms.accessRead(m_cms.readFileHeader(resource)));
             // ednfal: resource is read later in resourcebroker
             System.out.println(m_cms.accessRead(resource));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Tests if the user can write the resource.
      *
      * @param resource the name of the resource.
      */
     public void accessWrite(String resource) {
         try {
 
             //CmsResource res = m_cms.readFileHeader(resource);
             //System.out.println( m_cms.accessWrite(res) );
             // ednfal: resource is read later in resourcebroker
             System.out.println(m_cms.accessWrite(resource));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * adds a file extension.
      * @param extension a file extension, e.g. 'html'
      * @param resourceType, name of a resource type like 'page'
      */
     public void addFileExtension(String extension, String resourceType) {
         try {
             m_cms.addFileExtension(extension, resourceType);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Adds a Group to the cms.
      *
      * @param name The name of the new group.
      * @param description The description for the new group.
      */
     public void addGroup(String name, String description) {
         try {
             m_cms.addGroup(name, description, C_FLAG_ENABLED, null);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Adds a Group to the cms.
      *
      * @param name The name of the new group.
      * @param description The description for the new group.
      * @param flags The flags for the new group.
      * @param name The name of the parent group (or null).
      */
     public void addGroup(String name, String description, String flags, String parent) {
         try {
             m_cms.addGroup(name, description, Integer.parseInt(flags), parent);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Adds a user to the cms.
      *
      * @param name The new name for the user.
      * @param password The new password for the user.
      * @param group The default groupname for the user.
      * @param description The description for the user.
      */
     public void addUser(String name, String password, String group, String description) {
         try {
             System.out.println(m_cms.addUser(name, password, group, description, new Hashtable(), C_FLAG_ENABLED));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Adds a user to the cms.
      *
      * @param name The new name for the user.
      * @param password The new password for the user.
      * @param group The default groupname for the user.
      * @param description The description for the user.
      * @param flags The flags for the user.
      */
     public void addUser(String name, String password, String group, String description, String flags) {
         try {
             System.out.println(m_cms.addUser(name, password, group, description, new Hashtable(), Integer.parseInt(flags)));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Adds a user to the cms.
      *
      * @param name The new name for the user.
      * @param password The new password for the user.
      * @param group The default groupname for the user.
      * @param description The description for the user.
      * @param flags The flags for the user.
      */
     public void addUser(String name, String password, String group, String description, String firstname, String lastname, String email) {
         try {
             CmsUser user = m_cms.addUser(name, password, group, description, new Hashtable(), C_FLAG_ENABLED);
             user.setEmail(email);
             user.setFirstname(firstname);
             user.setLastname(lastname);
             m_cms.writeUser(user);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Adds a user to a group.
      *
      * @param username The name of the user that is to be added to the group.
      * @param groupname The name of the group.
      */
     public void addUserToGroup(String username, String groupname) {
         try {
             m_cms.addUserToGroup(username, groupname);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Adds a web user to the Cms.
      * <br>
      * A web user has no access to the workplace but is able to access personalized
      * functions controlled by the OpenCms.
      *
      * @param name the new name for the user.
      * @param password the new password for the user.
      * @param group the default groupname for the user.
      * @param description the description for the user.
      * @param flags the flags for a user (e.g. C_FLAG_ENABLED)
      *
      */
     public void addWebUser(String name, String password, String group, String description, String flags) {
         try {
             int intFlags = Integer.parseInt(flags);
             System.out.println(m_cms.addWebUser(name, password, group, description, new Hashtable(), intFlags));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Adds a web user to the Cms.
      * <br>
      * A web user has no access to the workplace but is able to access personalized
      * functions controlled by the OpenCms.
      *
      * @param name the new name for the user.
      * @param password the new password for the user.
      * @param group the default groupname for the user.
      * @param additionalGroup the additional group for the user.
      * @param description the description for the user.
      * @param flags the flags for a user (e.g. C_FLAG_ENABLED)
      *
      */
     public void addWebUser(String name, String password, String group, String additionalGroup, String description, String flags) {
         try {
             int intFlags = Integer.parseInt(flags);
             System.out.println(m_cms.addWebUser(name, password, group, additionalGroup, description, new Hashtable(), intFlags));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Returns the anonymous user object.
      *
      * @return a <code>CmsUser</code> object representing the anonymous user.
      */
     public void anonymousUser() {
         try {
             System.out.println(m_cms.anonymousUser());
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Changes the group for this resource<BR/>
      *
      * The user may change this, if he is admin of the resource.
      *
      * @param filename The complete path to the resource.
      * @param newGroup The new of the new group for this resource.
      */
     public void chgrp(String filename, String newGroup) {
         try {
             m_cms.chgrp(filename, newGroup);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Changes the flags for this resource<BR/>
      *
      * The user may change the flags, if he is admin of the resource.
      *
      * @param filename The complete path to the resource.
      * @param flags The new flags for the resource.
      */
     public void chmod(String filename, String flags) {
         try {
             m_cms.chmod(filename, Integer.parseInt(flags));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Changes the owner for this resource<BR/>
      *
      * The user may change this, if he is admin of the resource.
      *
      * @param filename The complete path to the resource.
      * @param newOwner The name of the new owner for this resource.
      */
     public void chown(String filename, String newOwner) {
         try {
             m_cms.chown(filename, newOwner);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Changes the resourcetype for this resource<BR/>
      *
      * The user may change this, if he is admin of the resource.
      *
      * @param filename The complete path to the resource.
      * @param newType The name of the new resourcetype for this resource.
      */
     public void chtype(String filename, String newType) {
         try {
             m_cms.chtype(filename, newType);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Clears all internal DB-Caches.
      */
     public void clearcache() {
         try {
             m_cms.clearcache();
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Copies the file.
      *
      * @param source The complete path of the sourcefile.
      * @param destination The complete path of the destination.
      *
      * @throws CmsException will be thrown, if the file couldn't be copied.
      * The CmsException will also be thrown, if the user has not the rights
      * for this resource.
      */
     public void copyFile(String source, String destination) {
         try {
             m_cms.copyResource(source, destination);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Copies a folder.
      *
      * @param source the complete path of the sourcefolder.
      * @param destination the complete path of the destinationfolder.
      */
     public void copyFolder(String source, String destination) {
         try {
             // copy the folder with keeping the flags
             m_cms.copyResource(source, destination, true);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Copies a resource.
      *
      * @param source the complete path of the sourcefolder.
      * @param destination the complete path of the destinationfolder.
      */
     public void copyResource(String source, String destination) {
         try {
             m_cms.copyResource(source, destination);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Copies a resource from the online project to a new, specified project.<br>
      * Copying a resource will copy the file header or folder into the specified
      * offline project and set its state to UNCHANGED.
      *
      * @param resource The name of the resource.
      */
     public void copyResourceToProject(String resource) {
         try {
             m_cms.copyResourceToProject(resource);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Returns a copyright-string for this OpenCms.
      */
     public void copyright() {
         String[] copy = C_COPYRIGHT;
         for(int i = 0;i < copy.length;i++) {
             System.out.println(copy[i]);
         }
     }
 
     /**
      * Counts the locked resources in a project.
      *
      * @param id the id of the project
      */
     public void countLockedResources(String id) {
         try {
             int intId = Integer.parseInt(id);
             System.out.println(m_cms.countLockedResources(intId));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Creates a new folder.
      *
      * @param folder The complete path to the folder in which the new folder
      * will be created.
      * @param newFolderName The name of the new folder (No pathinformation allowed).
      */
     public void createFolder(String folder, String newFolderName) {
         try {
             System.out.println((CmsFolder)m_cms.createResource(folder, newFolderName, C_TYPE_FOLDER_NAME));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * This method creates a new module in the repository.
      *
      * @param String modulename the name of the module.
      * @param String niceModulename another name of the module.
      * @param String description the description of the module.
      * @param String author the name of the author.
      * @param String createDate the creation date of the module
      * @param String version the version number of the module.
      */
     public void createModule(String modulename, String niceModulename, String description, String author, String type, String createDate, String version) {
 
         // create the module
         try {
             I_CmsRegistry reg = m_cms.getRegistry();
             int ver = Integer.parseInt(version);
             long date = Long.parseLong(createDate);
             reg.createModule(modulename, niceModulename, description, author, type, new HashMap(), date, ver);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Creates a project.
      *
      * @param name The name of the project to create
      * @param description The description for the new project
      * @param groupname the name of the group to be set
      */
     public void createProject(String name, String description, String groupname, String managergroupname) {
         try {
             System.out.println(m_cms.createProject(name, description, groupname, managergroupname));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Creates a project.
      *
      * @param name The name of the project to create
      * @param description The description for the new project
      * @param groupname the name of the group to be set
      */
     public void createProject(String name, String description, String groupname, String managergroupname, String projecttype) {
         try {
             System.out.println(m_cms.createProject(name, description, groupname, managergroupname, Integer.parseInt(projecttype)));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Creates a default cms project.
      * This default project has the following properties:<ul>
      * <li>The users groups is "Users"
      * <li>The project managers group is "Projectmanager"
      * <li>All resources are contained in the project
      * <li>The project will remain after publishing</ul>
      * 
      * @param name The name of the project to create
      * @param description The description for the new project
      * 
      */    
     public void createDefaultProject(String name, String description) {              
         try {
             CmsProject project = m_cms.createProject(name, description, C_GROUP_USERS, C_GROUP_PROJECTLEADER, C_PROJECT_TYPE_NORMAL);
             int id = project.getId();
             m_cms.getRequestContext().setCurrentProject(id);
             // copy the VFS folders to the project
             m_cms.copyResourceToProject(C_ROOT);
             // copy the COS channels to the project
             m_cms.setContextToCos();
             m_cms.copyResourceToProject(C_ROOT);
             m_cms.setContextToVfs();            
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }    
     
     /**
      * Creates a new project for the temporary files.
      *
      * @throws CmsException if operation was not successful.
      */
     public void createTempfileProject() throws CmsException
     {
         try {
             System.out.println(m_cms.createTempfileProject());
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Creates the propertydefinition for the resource type.<BR/>
      *
      * @param name The name of the propertydefinition to overwrite.
      * @param resourcetype The name of the resource-type for the propertydefinition.
      *
      * @throws CmsException Throws CmsException if something goes wrong.
      */
     public void createPropertydefinition(String name, String resourcetype) throws CmsException {
         try {
             System.out.println(m_cms.createPropertydefinition(name, resourcetype));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Creates a new task.
      * <p>
      * <B>Security:</B>
      * All users can create a new task.
      * @param agent the User who will edit the task.
      * @param role a Usergroup for the task.
      * @param taskname the name of the task.
      * @param taskcomment a description of the task.
      * @param timeout the time when the task must finished.
      * @param priority the Id for the priority of the task.
      */
     public void createTask(String agentName, String roleName, String taskname, String taskcomment, String timeout, String priority) {
         try {
             int intPriority = Integer.parseInt(priority);
             long longTimeout = Long.parseLong(timeout);
             System.out.println(m_cms.createTask(agentName, roleName, taskname, taskcomment, longTimeout, intPriority));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Creates a new task.
      * <p>
      * <B>Security:</B>
      * All users can create a new task.
      *
      * @param projectid the Id of the current project task of the user.
      * @param agentname the User who will edit the task.
      * @param rolename a Usergroup for the task.
      * @param taskname a Name of the task.
      * @param tasktype the type of the task.
      * @param taskcomment a description of the task.
      * @param timeout the time when the task must finished.
      * @param priority the Id for the priority of the task.
      */
     public void createTask(String projectid, String agentName, String roleName,
             String taskname, String taskcomment, String tasktype, String timeout, String priority) {
         try {
             System.out.println(m_cms.createTask(Integer.parseInt(projectid), agentName, roleName, taskname, taskcomment,
                     Integer.parseInt(tasktype), Long.parseLong(timeout), Integer.parseInt(priority)));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Deletes all propertyinformation for a file or folder.
      *
      * @param resource The name of the resource of which the propertyinformations
      * have to be deleted.
      */
     public void deleteAllProperties(String resource) {
         try {
             m_cms.deleteAllProperties(resource);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Deletes the file.
      *
      * @param filename The complete path of the file.
      */
     public void deleteFile(String filename) {
         try {
             m_cms.deleteResource(filename);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Deletes the folder.
      *
      * @param foldername The complete path of the folder.
      */
     public void deleteFolder(String foldername) {
         try {
             m_cms.deleteResource(foldername);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Deletes a Resource.
      *
      * @param filename the complete path of the sourcefolder.
      */
     public void deleteResource(String filename) {
         try {
             m_cms.deleteResource(filename);
         } catch (Exception exc) {
             CmsShell.printException(exc);
         }
     }
     /**
      * Undeletes the resource.
      *
      * @param resourcename The complete path of the resource.
      */
     public void undeleteResource(String resourcename) {
         try {
             m_cms.undeleteResource(resourcename);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Delete a group from the Cms.<BR/>
      *
      * @param delgroup The name of the group that is to be deleted.
      */
     public void deleteGroup(String delgroup) {
         try {
             m_cms.deleteGroup(delgroup);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Deletes a module from the cms.
      *
      * @param module The name of module to delete.
      */
     public void deleteModule(String module) {
         try {
             I_CmsRegistry reg = m_cms.getRegistry();
             reg.deleteModule(module, new Vector(), false, new CmsShellReport());
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * This method deletes the view for an module.
      *
      * @param String the name of the module.
      */
     public void deleteModuleView(String modulename) {
         try {
             I_CmsRegistry reg = m_cms.getRegistry();
             reg.deleteModuleView(modulename);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Deletes a project.
      *
      * @param id The id of the project to delete.
      */
     public void deleteProject(String id) {
         try {
             m_cms.deleteProject(Integer.parseInt(id));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Deletes a propertyinformation for a file or folder.
      *
      * @param resourcename The resource-name of which the propertyinformation has to be delteted.
      * @param property The propertydefinition-name of which the propertyinformation has to be set.
      */
     public void deleteProperty(String resourcename, String property) {
         try {
             m_cms.deleteProperty(resourcename, property);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Delete the propertydefinition for the resource type.<BR/>
      *
      * @param name The name of the propertydefinition to overwrite.
      * @param resourcetype The name of the resource-type for the propertydefinition.
      */
     public void deletepropertydefinition(String name, String resourcetype) {
         try {
             m_cms.deletePropertydefinition(name, resourcetype);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Deletes a user from the Cms.
      *
      * @param name The name of the user to be deleted.
      */
     public void deleteUser(String name) {
         try {
             m_cms.deleteUser(name);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Deletes a web user from the Cms.
      *
      * @param name the id of the user to be deleted.
      */
     public void deleteWebUser(String userId) {
         try {
             m_cms.deleteWebUser(Integer.parseInt(userId));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Echos the input to output.
      *
      * @param echo The echo to be written to output.
      */
     public void echo(String echo) {
         if(echo.toLowerCase().equals("on")) {
             CmsShell.m_echo = true;
         }
         else {
             if(echo.toLowerCase().equals("off")) {
                 CmsShell.m_echo = false;
             }
             else {
                 System.out.println(echo);
             }
         }
     }
 
     /**
      * Ends a task of the Cms.
      *
      * @param taskid the ID of the task to end.
      */
     public void endTask(String taskid) {
         try {
             m_cms.endTask(Integer.parseInt(taskid));
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Exits the commandline-interface
      */
     public void exit() {
         try {
             m_openCms.destroy();
         }
         catch(CmsException e) {
             e.printStackTrace();
         }
         CmsShell.m_exitCalled = true;
     }
 
     /**
      * Exports cms-resources to zip. In the zip-file the system - path will be included.
      *
      * @param exportFile the name (absolute Path) of the export resource (zip)
      *
      * @throws Throws CmsException if something goes wrong.
      */
     public void exportAllResources(String exportFile) throws CmsException {
 
         // export the resources
         String[] exportPaths =  {
             C_ROOT
         };
         try {
             m_cms.exportResources(exportFile, exportPaths, false, false);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Exports cms-resources to zip. In the zip-file the system - path will be included.
      * Unchanged resources will be ignored.
      *
      * @param exportFile the name (absolute Path) of the export resource (zip)
      *
      * @throws Throws CmsException if something goes wrong.
      */
     public void exportAllResourcesOnlyChanged(String exportFile) throws CmsException {
 
         // export the resources
         String[] exportPaths =  {
             C_ROOT
         };
         try {
             m_cms.exportResources(exportFile, exportPaths, false, true);
         }
         catch(Exception exc) {
             CmsShell.printException(exc);
         }
     }
 
     /**
      * Exports a module.
      *
      * @param modulename the name of the module to export
      * @param resource the folder to export.
      * @param filename the name of the file to export to.
      */
     public void exportModule(String modulename, String resource, String filename) {
         try {
            String[] resources =  {
                resource
            };
            I_CmsRegistry reg = m_cms.getRegistry();
            reg.exportModule(modulename, resources, filename, new CmsShellReport());
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * Exports cms-resources to zip.
     *
     * @param exportFile the name (absolute Path) of the export resource (zip)
     * @param pathList the names (absolute Path) of folders from which should be exported
     *          separated by semicolons
     *
     * @throws Throws CmsException if something goes wrong.
     */
    public void exportResources(String exportFile, String pathList) throws CmsException {

        // export the resources
        StringTokenizer tok = new StringTokenizer(pathList, ";");
        Vector paths = new Vector();
        while(tok.hasMoreTokens()) {
            paths.addElement(tok.nextToken());
        }
        String exportPaths[] = new String[paths.size()];
        for(int i = 0;i < paths.size();i++) {
            exportPaths[i] = (String)paths.elementAt(i);
        }
        boolean excludeSystem = true;
        if(pathList.startsWith("/system/") || (pathList.indexOf(";/system/") > -1)) {
            excludeSystem = false;
        }
        try {
            m_cms.exportResources(exportFile, exportPaths, excludeSystem, false);
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * Exports cms-resources to zip.
     *
     * @param exportFile the name (absolute Path) of the export resource (zip)
     * @param pathList the names (absolute Path) of folders from which should be exported
     *          separated by semicolons
     *
     * @throws Throws CmsException if something goes wrong.
     */
    public void exportResourcesAndUserdata(String exportFile, String pathList) throws CmsException {

        // export the resources
        StringTokenizer tok = new StringTokenizer(pathList, ";");
        Vector paths = new Vector();
        while(tok.hasMoreTokens()) {
            paths.addElement(tok.nextToken());
        }
        String exportPaths[] = new String[paths.size()];
        for(int i = 0;i < paths.size();i++) {
            exportPaths[i] = (String)paths.elementAt(i);
        }
        boolean excludeSystem = true;
        if(pathList.startsWith("/system/") || (pathList.indexOf(";/system/") > -1)) {
            excludeSystem = false;
        }
        try {
            m_cms.exportResources(exportFile, exportPaths, excludeSystem, false, true);
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * Exports cms-resources to zip.
     * Unchanged resources will be ignored.
     *
     * @param exportFile the name (absolute Path) of the export resource (zip)
     * @param pathList the names (absolute Path) of folders from which should be exported
     *          separated by semicolons
     *
     * @throws Throws CmsException if something goes wrong.
     */
    public void exportResourcesOnlyChanged(String exportFile, String pathList) throws CmsException {

        // export the resources
        StringTokenizer tok = new StringTokenizer(pathList, ";");
        Vector paths = new Vector();
        while(tok.hasMoreTokens()) {
            paths.addElement(tok.nextToken());
        }
        String exportPaths[] = new String[paths.size()];
        for(int i = 0;i < paths.size();i++) {
            exportPaths[i] = (String)paths.elementAt(i);
        }
        boolean excludeSystem = true;
        if(pathList.startsWith("/system/") || (pathList.indexOf(";/system/") > -1)) {
            excludeSystem = false;
        }
        try {
            m_cms.exportResources(exportFile, exportPaths, excludeSystem, true);
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * Forwards a task to a new user.
     *
     * @param taskid the id of the task which will be forwarded.
     * @param newRole the new group for the task.
     * @param newUser the new user who gets the task.
     */
    public void forwardTask(String taskid, String newRoleName, String newUserName) {
        try {
            m_cms.forwardTask(Integer.parseInt(taskid), newRoleName, newUserName);
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * Returns all projects, which the user may access.
     *
     * @return a Vector of projects.
     */
    public void getAllAccessibleProjects() {
        try {
            Vector projects = m_cms.getAllAccessibleProjects();
            for(int i = 0;i < projects.size();i++) {
                System.out.println((CmsProject)projects.elementAt(i));
            }
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * Returns all projects which are owned by the current user or which are manageable
     * for the group of the user.
     */
    public void getAllManageableProjects() {
        try {
            Vector projects = m_cms.getAllManageableProjects();
            for(int i = 0;i < projects.size();i++) {
                CmsProject project = (CmsProject)projects.elementAt(i);
                System.out.println(project);
            }
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * Returns  all I_CmsResourceTypes.
     */
    public void getAllResourceTypes() {
        try {
            Hashtable resourceTypes = m_cms.getAllResourceTypes();
            Enumeration keys = resourceTypes.keys();
            while(keys.hasMoreElements()) {
                System.out.println(resourceTypes.get(keys.nextElement()));
            }
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * Gets information about the cache size.
     * <br>
     * The size of the following caching areas is returned:
     * <ul>
     *  <li>GroupCache</li>
     *  <li>UserGroupCache</li>
     *  <li>ResourceCache</li>
     *  <li>SubResourceCache</li>
     *  <li>ProjectCache</li>
     *  <li>PropertyCache</li>
     *  <li>PropertyDefinitionCache</li>
     *  <li>PropertyDefinitionVectorCache</li>
     * </ul>
     */
    public void getCacheInfo() {
        try {
            Hashtable cacheInfo = m_cms.getCacheInfo();
            Enumeration keys = cacheInfo.keys();
            while(keys.hasMoreElements()) {
                String key = (String)keys.nextElement();
                String info = (String)cacheInfo.get(key);
                System.out.println("\t" + key + ": " + info);
            }
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * Returns all child groups of a group<P/>
     *
     * @param groupname The name of the group.
     */
    public void getChild(String groupname) {
        try {
            Vector groups = m_cms.getChild(groupname);
            for(int i = 0;i < groups.size();i++) {
                System.out.println((CmsGroup)groups.elementAt(i));
            }
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * Returns all child groups of a group<P/>
     * This method also returns all sub-child groups of the current group.
     *
     * @param groupname The name of the group.
     */
    public void getChilds(String groupname) {
        try {
            Vector groups = m_cms.getChilds(groupname);
            for(int i = 0;i < groups.size();i++) {
                System.out.println((CmsGroup)groups.elementAt(i));
            }
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * Returns the current project for the user.
     */
    public void getCurrentProject() {
        System.out.println(m_cms.getRequestContext().currentProject().toString());
    }

    /**
     * Gets all groups to which a given user directly belongs.
     *
     * @param username the name of the user to get all groups for.
     * @return a Vector of all groups of a user.
     */
    public void getDirectGroupsOfUser(String username) {
        try {
            Vector groups = m_cms.getDirectGroupsOfUser(username);
            for(int i = 0;i < groups.size();i++) {
                System.out.println((CmsGroup)groups.elementAt(i));
            }
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * Returns a Vector with all subfiles.<BR/>
     *
     * @param foldername the complete path to the folder.
     *
     * @return subfiles A Vector with all subfiles for the overgiven folder.
     *
     * @throws CmsException will be thrown, if the user has not the rights
     * for this resource.
     */
    public void getFilesInFolder(String foldername) {
        try {
            Vector files = m_cms.getFilesInFolder(foldername);
            for(int i = 0;i < files.size();i++) {
                System.out.println((CmsFile)files.elementAt(i));
            }
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * Returns a Vector with all resource-names of the resources that have set the given property to the given value.
     *
     * @param propertydef the name of the property-definition to check.
     * @param property the value of the property for the resource.
     */
    public void getFilesWithProperty(String propertyDefinition, String propertyValue) {
        try {
            Vector files = m_cms.getFilesWithProperty(propertyDefinition, propertyValue);
            for(int i = 0;i < files.size();i++) {
                System.out.println((CmsFile)files.elementAt(i));
            }
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * This method can be called, to determine if the file-system was changed
     * in the past. A module can compare its previosly stored number with this
     * returned number. If they differ, a change was made.
     *
     * @return the number of file-system-changes.
     */
    public void getFileSystemChanges() {
        System.out.println(m_cms.getFileSystemChanges());
    }

    /**
     * Returns a Vector with the complete folder-tree for this project.<br>
     *
     * Subfolders can be read from an offline project and the online project. <br>
     */
    public void getFolderTree() {
        try {
            Vector folders = m_cms.getFolderTree();
            for(int i = 0;i < folders.size();i++) {
                System.out.println((CmsFolder)folders.elementAt(i));
            }
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * Returns all users of the cms.
     */
    public void getGroups() {
        try {
            Vector groups = m_cms.getGroups();
            for(int i = 0;i < groups.size();i++) {
                System.out.println((CmsGroup)groups.elementAt(i));
            }
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * Returns all groups of a user.
     *
     * @param username The name of the user.
     */
    public void getGroupsOfUser(String username) {
        try {
            Vector groups = m_cms.getGroupsOfUser(username);
            for(int i = 0;i < groups.size();i++) {
                System.out.println((CmsGroup)groups.elementAt(i));
            }
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * Prints out all files for a module.
     *
     * @param moduleZip The file-name of module to import.
     */
    public void getModuleFiles(String name) {
        try {
            I_CmsRegistry reg = m_cms.getRegistry();
            Vector names = new Vector();
            Vector codes = new Vector();
            reg.getModuleFiles(name, names, codes);
            for(int i = 0;i < names.size();i++) {
                System.out.print(names.elementAt(i));
                System.out.print(" -> ");
                System.out.println(codes.elementAt(i));
            }
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * Imports a module into the cms.
     *
     * @param moduleZip The file-name of module to import.
     */
    public void getModuleInfo() {
        try {
            I_CmsRegistry reg = m_cms.getRegistry();
            java.util.Enumeration names = reg.getModuleNames();

            // print out the available modules
            while(names.hasMoreElements()) {
                String name = (String)names.nextElement();
                getModuleInfo(name);
            }
            System.out.println("\ngeneral stuff");
            System.out.println("\tall repositories: ");
            String[] repositories = reg.getRepositories();
            for(int i = 0;i < repositories.length;i++) {
                System.out.println("\t\t" + repositories[i]);
            }
            System.out.println("\tall views: ");
            java.util.Vector views = new java.util.Vector();
            java.util.Vector urls = new java.util.Vector();
            int max = reg.getViews(views, urls);
            for(int i = 0;i < max;i++) {
                System.out.println("\t\t" + views.elementAt(i) + " -> " + urls.elementAt(i));
            }
        }
        catch(Exception exc) {
            CmsShell.printException(exc);
        }
    }

    /**
     * Prints out informations about a module.
     *
     * @param String module the name of the module to get infos about.
     */
    public void getModuleInfo(String name) {
        try {
            I_CmsRegistry reg = m_cms.getRegistry();
            if(reg.moduleExists(name)) {
                System.out.println("\nModule: " + name + " v" + reg.getModuleVersion(name));
                System.out.println("\tNice Name: " + reg.getModuleNiceName(name));
                System.out.println("\tDescription: " + reg.getModuleDescription(name));
                System.out.println("\tAuthor: " + reg.getModuleAuthor(name));
                System.out.println("\tUploaded by: " + reg.getModuleUploadedBy(name));
                System.out.println("\tEmail: " + reg.getModuleAuthorEmail(name));
                System.out.println("\tCreationdate: " + new java.util.Date(reg.getModuleCreateDate(name)));
                System.out.println("\tUploaddate: " + new java.util.Date(reg.getModuleUploadDate(name)));
                System.out.println("\tDocumentationPath: " + reg.getModuleDocumentPath(name));
                String[] repositories = reg.getModuleRepositories(name);
                System.out.println("\trepositories: ");
                if(repositories != null) {
                    for(int i = 0;i < repositories.length;i++) {
                        System.out.println("\t\t" + repositories[i]);
                    }
                }
                String[] parameters = reg.getModuleParameterNames(name);
                System.out.println("\tparameters: ");
                if(parameters != null) {
                    for(int i = 0;i < parameters.length;i++) {
                        System.out.print("\t\t" + parameters[i]);
                        System.out.print(" = " + reg.getModuleParameter(name, parameters[i]));
                        System.out.print(" is " + reg.getModuleParameterType(name, parameters[i]));
                        System.out.println("  (" + reg.getModuleParameterDescription(name, parameters[i]) + ")");
                    }
                }
                System.out.println("\tWiew name: "<