Source code: org/mitre/cvw/CVWObject.java

   /*
    * Copyright (c) 1996-2000. The MITRE Corporation (http://www.mitre.org/).
    * All rights reserved.
    * CVW comes with ABSOLUTELY NO WARRANTY. See license for details.
    */
   
   package org.mitre.cvw;
   
   import java.util.*;
  import java.io.Serializable;
  import java.awt.Frame;
  import java.awt.Image;
  import java.awt.Window;
  import javax.swing.*;
  
  /**************************************************************
   ********************* CVW Object Info ************************
   **************************************************************/
  /**
   * The base class for all CVW objects
   * @version 
   * @author Deb Ercolini
   */
  public class CVWObject extends Observable implements ObjectValues, Serializable {
    public String name;
    String icon;
    public CVWObjNum objNum;                //"#xxxx"
    String type;
    int typeValue;                   // the enumeration type
    CVWObjNum owner;                 //#xxxx
    Date createdOn;
    Date lastModifiedOn;
    CVWObjNum lastModifiedBy;
    boolean cached = true;
  
  /* 4/15/99 dage - These are transient because they may be null values and 
   * when an object is serializable the values to be written cannot be null
   * or so it seems.
   */
    transient CVWObjNum location;              //"#xxxx"
    transient CVWObjNum owners[];              //array of #xxxx
    transient String desc;
    transient CVWCoordinator jcvw = CVWCoordinator.getInstance();
  
  /**
   * If an object is sessile, it cannot be moved. 
   * <br>  <code>true</code>,(1 on the CVW server) means cant be moved
   * <br>  <code>false</code>, (0  on the CVW server) means can be moved.
   */
    boolean sessile;
  
  /**
   * This variable is set when the user does a &quot;Information&quot;, 
   * &quot;Permissions&quot;, &quot;Members&quot;, or &quot;Access&quot;
   * When the CVW server sends the cvw-object-detail MCP it will open the
   * get info dialog to the correct tab.
   *
   * @see #setMetaDataType
   * @see #getMetaDataType
   */
    int metaDataType;
  
    public static final int GETINFO = 0;
    public static final int ACCESS = 1;
  //future for when acl/members is third tab of get info for 
  //groups/rooms
    public static final int ACL = 2;     
    public static final int MEMBERS = 2;
   
  
  /* 11/21/96 dage/dee - need to define shortcuts as types
   */
    public static Hashtable ObjectTypes = null;
  /* 12/22/98 dage - moved to static values to ObjectValues class
   */
    
  /***********************************************
   *********** Class methods *********************
   ***********************************************/
  
  /**
   * this method is called the when the first obj is instantiated
   * it maps the enumerated type to the CVW server string
   * dage
   */
    public static void initObjectTypes() {
      System.err.println("initializing object types");
      ObjectTypes = new Hashtable(20);
      ObjectTypes.put((new Integer(UNKNOWN)), "Unknown");
      ObjectTypes.put((new Integer(USER)), "User");
      ObjectTypes.put((new Integer(PROXY)), "Proxy");
      ObjectTypes.put((new Integer(DOC)), "Document");
      ObjectTypes.put((new Integer(DOC_SC)), "SC to Document");
      ObjectTypes.put((new Integer(URL)), "URL");
      ObjectTypes.put((new Integer(URL_SC)), "SC to URL");
      ObjectTypes.put((new Integer(NOTE)), "Note");
      ObjectTypes.put((new Integer(NOTE_SC)), "SC to Note");
      ObjectTypes.put((new Integer(WHITEBOARD)), "Whiteboard");
      ObjectTypes.put((new Integer(WHITEBOARD_SC)), "SC to Whiteboard");
     ObjectTypes.put((new Integer(FOLDER)), "Folder");
     ObjectTypes.put((new Integer(FOLDER_SC)), "SC to Folder");
     ObjectTypes.put((new Integer(GROUP)), "Group");
     ObjectTypes.put((new Integer(BALLOT)), "Ballot");
     ObjectTypes.put((new Integer(RECORDER)), "Recorder");
     ObjectTypes.put((new Integer(ROOM)), "Room");
     ObjectTypes.put((new Integer(FLOOR)), "Floor");
     ObjectTypes.put((new Integer(FORM)), "Form");
     ObjectTypes.put((new Integer(ROOMKEY)), "Room Key");
     ObjectTypes.put((new Integer(FORMFOLDER)), "Form Folder");
    }
 
 /**
  * Returns the CVW server string given the integer value
  * dage 
  * 
  * @param i the integer of the type you are looking for
  * @return  the string known by the CVW server
  */
   public static String getStringFromType(int i) {
      return (String)ObjectTypes.get(new Integer(i));
    }
 
 /**
  * Returns the CVW server string given the Integer value
  * dage 
  *
  * @param i the Integer of the type you are looking for
  * @return  the string known by the CVW server
  */
   public static String getStringFromType(Integer i) {
      return (String)ObjectTypes.get(i);
    }
 
 /**
  * Returns the integer value given the CVW server string 
  * dage 
  *
  * @param str the string known by the CVW server
  * @return the integer of the type you are looking for
  */
   public static int getTypeFromString(String str) {
     for (Enumeration e = ObjectTypes.keys() ; e.hasMoreElements() ;) {
        Integer key = (Integer) e.nextElement();
        String value = (String)ObjectTypes.get(key);
       //System.err.println(key + " " + value);
        if (value.equals(str)) 
    return key.intValue();
         }
     return -1;
    }
 
 /**
  * Returns a long value representing the date given a string.
  * java dates are stored in milliseconds and the CVW server measures
  * in seconds so we append "000"
  * Dee Goepel
  *
  * @param str the date from the CVW server to be converted
  * @return a long integeter representing the date
   public static long convertDateFromServer(String str) {
 System.err.println("in old code cvwObject::convertDateFromServer");
     return DateUtils.convertDateFromServer(str);
   }
  */
 
 /* dage - these methods return the enumerated types and the CVW server 
  *    strings.
  */
 /**
  * Returns the keys of object types as an Enumeration
  *
  * @return the keys of object types  
  */
   public static Enumeration getObjectTypes() {
      return ObjectTypes.keys();
    }
 
 /**
  * Returns the string values of object types as an Enumeration
  * @return the string values of object types as an Enumeration
  */
   public static Enumeration getObjectTypeStrings() {
      return ObjectTypes.elements();
    }
 
 /**
  * Checks the user quota before creating an object
  *
  * @return boolean returns true if user can create an object
  */
   public static boolean checkQuota() {
       boolean ok =  (CVWUser.getCurrentUser().getQuota() > 0);
       if (!ok) {
        System.err.println("Quota limit exceded");
        CVWCoordinator.getInstance().displayError("You cannot create any more items.  Please contact your administrator for help.", "User Quota Exceded", false);
       }
       return ok;
      }
 /**
 
 /**
  * Starts the creation of a CVWObject
  *
  * @param type the type of CVWObject to be created
  */
   public static void newCommand(String type) {
       if (!checkQuota())
    return;
 
     CVWObject cvwObj;
     if(type.equals("Folder")) {
       cvwObj = new CVWFolder();
     } else if(type.equals("Note")) {
       cvwObj = new CVWNote();
     } else if(type.equals("URL") || type.equals("Web Reference")) {
       cvwObj = new CVWURL();
     } else if(type.equals("Whiteboard")) {
       cvwObj = new CVWWhiteboard();
     } else if(type.equals("Group")) {
       cvwObj = new CVWGroup();
     } else if(type.equals("Document")) {
       cvwObj = new CVWDocument();
     } else {
        FileNew newDiag = new FileNew(CVWCoordinator.getInstance(), "CVW - New", true);
   newDiag.pack();
       newDiag.setVisible(true);
   return;
     }
     cvwObj.create();
   }
 
 /***********************************************
  *********** End Class methods *****************
  ***********************************************/
 
 /**
  * Constructor
  */
   public CVWObject() {
 
     }
 
 /**
  * Constructor
  *
  * @param type the type of this object as defined by ObjectValues
  */
   public CVWObject(int t) {
      typeValue = t;
      type = getStringFromType(t);
     }
 
 /**
  * Constructor
  *
  * @param type the type of this object as a String as defined by the CVW server 
  */
   public CVWObject(String t) {
      type = t;
      typeValue = getTypeFromString(t);
      if (typeValue == -1) 
   typeValue = UNKNOWN;
     }
 
 /**
  * Returns whether this object is a shortcut.  
  * @return <code>true</true> if the object is a shortcut
  */
   public boolean isShortcut() {
     //return false;
     if (type.startsWith("SC to"))
   return true;
     else 
   return false;
    }
 
 /**
  * Sets the basic values, the object number and the name of the object.
  * @param oNum the object number of the object
  * @param n the name of the object
  */
   public void setValues(CVWObjNum oNum, String n) {
       objNum = oNum;
       name = n;
     }
 
 /**
  * Sets the all the values of the object when received from the CVW server.
  * 3/2/98 - dage added
  * <br> MCP receive cvw-object-info
  *
  * @param oNum object number of this object
  * @param n name from the get info dialog box
  * @param i icon file on CVW server
  * @param own object number of the user who created this object
  * @param mdate date of the last modification of this object
  * @param mby object number of the user who last modified this object
  * @param cdate date this object was created
  * @param sess sessile value from the get info dialog box
  *
  * @see CVWServerComm
  * @see CVWCache#cacheObject
  */
   public void setValues(CVWObjNum oNum, String n, String i, CVWObjNum own,
             Date mdate, CVWObjNum mby, Date cdate, boolean sess) {
       objNum = oNum;
       name = n;
       icon = i;
       owner = own;
       lastModifiedOn = mdate;
       lastModifiedBy = mby;
       createdOn = cdate;
       sessile = sess;
     }
 
 /* 1/5/98 - dage added
  */
 /**
  * Changes the name of the object on the CVW server
  * <br> MCP send cvw-modify-metadata
  * @param newName
  */
   public void setName(String newName) {
     String n;
     n = prepTextForServer(newName);
     CVWServerComm.sendMCPCmdToServer("#$#cvw-modify-metadata",
           "object: " + objNum.strValue() +
           " name: " + n);
    }
 
 /**
  * Returns the name of this object.
  * @return name of this object
  */
   public String getName() {
   return name;
    }
    
 /**
  * Returns the server unique name of this object.  This is just name for 
  * objects on the local server or name@serverid for remote objects/users.
  * This resides on the generic object because it may get called on non-user
  * objects (groups, etc).  Although we currently only support a server field
  * for users, it will probably expand to groups and other objects later.
  * 
  * @return federated name of this object
  */
   public String getFederatedName() {
       if (this instanceof CVWUser) {
     CVWUser user = (CVWUser)this;
     CVWServer serv = user.getServer();
     if (serv != jcvw.localServer)
         return name+CVWServer.delimiter+serv.getID();
       }
       return name;
    }
    
 /** 
  * Returns the cvw base name:
  * if the cvw object is a shortcut the default cvw name is:
  * "SC to <name>";  This will return the <name> only part.
  *
  * @return the base name 
  */
   public String getBaseName() {
      if (isShortcut() && name.startsWith("SC to ")) 
   return name.substring(6);
      else
   return name;
    }
 
 /**
  * Returns the object number.
  * @return the object number
  */
   public CVWObjNum getObjNum() {
     return objNum;
    }
 
 /**
  * Returns the object number as a string.
  * @return the object number as a string
  */
   public String getObjNumStr() {
     return objNum.strValue();
    }
 
 /**
  * Returns the icon of object with &quot;.gif&quot; appended to it.
  * @return  the icon of object with &quot;.gif&quot; appended to it.
  */
   public String getIcon() {
     return icon + ".gif";
    }
 
 /**
  * Returns the image of this object.
  * @return the image of this object
  */
    public Image getImage() {
      return null;
     }
 
 /**
  * Returns the type of object as known by the CVW server.
  * @return the type of object 
  * 
  * @see #getBaseType
  */
   public String getType() {
   return type;
    }
    
 /** 
  * Returns the cvw base type. 
  * If the cvw object is a shortcut the cvw server sends down the type as:
  * "SC to <type>".  This will return the <type> only part.
  * @return String the base type 
  * 
  * @see #getType
  */
   public String getBaseType() {
      if (isShortcut()) 
   return type.substring(6);
      else
   return type;
    }
 
 /**
  * Returns whether this object is in the cache or not
  * @return whether this object is in the cache or not
  */
    public boolean isCached() {
   return cached;
      }
 
 /**
  * Sets whether this object is in the cache or not
  * @param b whether this object is in the cache or not
  */
    public void setCached(boolean b) {
   cached = b;
      }
 
 /**
  * Returns the detail name for display. 
  * For most objects this is the description, subclasses should over ride it.
  *
  * @return the detail name for display
  *
  * @see #getRawDetailName
  */
   public String getDetailName() {
   return desc;
    }
  
 /**
  * Returns the actual detail name as defined by each subclass.
  *
  * @return 
  *
  * @see #getDetailName
  */
   public String getRawDetailName() {
      if (desc != null)
   return desc;
      else
   return new String();
    }
  
 /**
  * Sets the detail name for this object
  * @param detailName any additional info for this object
  */
   public void setRawDetailName(String detailName) {
   desc = detailName;
    }
  
 /**
  * Returns the name of the owner of this object, 
  * returns &quot;---&quot; instead of &quot;Unknown&quot;
  * 2/2/98 dage 
  * @return the name of the owner of this object
  */
   public String getOwnerName() {
      CVWObject obj = (CVWObject)(CVWCache.getInstance().get(owner));
      if (obj != null)
   return obj.name;
      else 
   return "---";
    }
 
 /**
  * Returns the name of the user who modified this object, 
  * returns &quot;---&quot;" instead of "&quot;Unknown&quot;"
  * 2/2/98 dage 
  * @return the name of the user who modified this object
  */
   public String getModifiedByName() {
      CVWUser user = getModifiedBy();
      if (user != null)
   return user.name;
      else 
   return "---";
    }
 
 /* 2/25/98 dage - return the CVWUser
  */
 /**
  * Returns the user who modified this object
  * @return the user who modified this object
  */
   public CVWUser getModifiedBy() {
      CVWUser user = (CVWUser)(CVWCache.getInstance().get(lastModifiedBy));
      return user;
   }
 
 /* 2/2/98 dage - return "---" if date is base start date
  *    returns just the date (not the time)
  */
 /**
  * Returns the date this object was created as a string.
  * @return the date this object was created as a string
  *
  * @see #getDateForDisplay
  */
   public String getCreatedDateForDisplay() {
   return getDateForDisplay(createdOn);
    }
 
 /* 2/2/98 dage - return "---" if date is base start date
  *    returns just the date (not the time)
  */
 /**
  * Returns the date this object was modified as a string.
  * @return the date this object was modified as a string
  *
  * @see #getDateForDisplay
  */
   public String getModifiedDateForDisplay() {
   return getDateForDisplay(lastModifiedOn);
    }
 
 /**
  * Returns the desired string format of the date passed in.
  * @param d the date to be converted
  * @return the date in the desired string for display
  */
   public String getDateForDisplay(Date d) {
     if (d.equals(DateUtils.dateZero))
   return "---";
     return DateUtils.formatDate(d);
    }
 
 /**
  * Returns the desired string format of the date passed in.
  * @param d the date to be converted
  * @return the date in the desired string for display
  */
   public String getDateForDetailDisplay(Date d) {
     if (d.equals(DateUtils.dateZero))
   return "---";
     return DateUtils.formatDateTime(d);
    }
 
 /* 10/3/96 dage - list of owners may change, this method needs to
  *   be allowed to be called from outside.
  * 1/8/99 dage - yes, the concept of public vs. private was considered ;-)
  */
 /**
  * Sets the owners of the object.  Owners has been defined as other users
  * who have been given permission to edit this object.
  * @param owns a space delimited list of object numbers
  */
   public void setOwners(String owns) {
     StringTokenizer ownST = new StringTokenizer(owns, " ");
     owners = new CVWObjNum[ownST.countTokens()];
     int i = 0;
     while (ownST.hasMoreTokens()) {
           owners[i] = new CVWObjNum((String)ownST.nextElement());
           //System.err.println(i + " " + owners[i].toString());
           i++;
          }
     setChanged();
     notifyObservers("owners");
    }
 
 /**
  * Returns a vector of CVWObjects built from owners.
  * 8/28/97 dage 
  *
  * @return vector of CVWObjects
  */
   public Vector getOwners() {
     Vector v = new Vector(owners.length);
     CVWCache cache = CVWCache.getInstance();
     CVWObject obj;
 /* 9/10/97 dage - dont include the owner of the object.
     obj = cache.get(owner);
     if (obj != null) //should never happen
        v.addElement(obj);
  */
     for(int i = 0; i<owners.length;i++) {
       obj = cache.get(owners[i]);
       //System.err.println(i + " " + obj);
       if (obj != null)
         v.addElement(obj);
      }
     return v;
   }
 
 /* 5/19/98 dage - added to get to top environment location 
  *   either user or room
  * 5/19/98 dage - we dont cache locations of users
  */
 /**
  * Returns the CVWRoom or CVWUser that this object is located in.
 
  * BTW, we don't cache the location of users (they move to much).
  *
  * @return the top environment location, either user or room
  */
   public CVWObject getTopLocation() {
   if (this instanceof CVWRoom || this instanceof CVWUser)
     return this;
   if (location == null)
     return this;
   CVWCache cache = CVWCache.getInstance();
   CVWObject loc = cache.get(location);
   if (loc == null)
     return this;
   if (loc instanceof CVWRoom || loc instanceof CVWUser)
     return loc;
   else
     return loc.getTopLocation();
     }
   
 /**
  * Sets the metaDataType variable when the user does a &quot;Information&quot;, 
  * &quot;Permissions&quot;, &quot;Members&quot;, or &quot;Access&quot;
  * so that when the CVW server sends the cvw-object-detail MCP it will open the
  * get info dialog to the correct tab.
  * <br> MCP send cvw-object-detail-request
  * @param type <code>GETINFO</code> or <code>ACCESS</code>
  *
  * @see #getMetaDataType
  * @see #startInfoDialog
  */
 
   public void setMetaDataType(int type) {
     metaDataType = type;
    }
 
 /**
  * Gets the metaDataType value.
  * @return the metaDataType value
  *
  * @see #setMetaDataType
  */
   public int getMetaDataType() {
     return metaDataType;
    }
 
 /**
  * Returns a string which is preprocessed for the communications to the CVW server
  * @param oldStr the string to be processed
  * @return  the processed string 
  *
  * @see CVWServerComm#prepTextForServer
  */
   public String prepTextForServer(String oldStr) {
     return CVWServerComm.prepTextForServer(oldStr);
    }
 
 /**
  * Converts a boolean to the string needed by the CVW server
  * 11/20/96
  * @param bool the boolean to be converted
  * @return the CVW server string
  */
   public String convertBooleanToIntString(boolean bool) {
     if (bool)
       return "1";
     return "0";
   }
 
 /**
  * Builds the MCP parameter list for notifying the CVW server of any changes to
  * the information for this object. Only those values which had changed in the 
  * &quot;Get Info&quote; dialog box
  *
  * @param newName name from the get info dialog box
  * @param newMove sessile value from the get info dialog box
  * @param newDesc description from the get info dialog box
  * @return the subclass/instance specific values to be sent to the server
  */
 
   public String getObjectModifyMCP(String newName, boolean newMove, String newDesc) {
  
     String param = "";
  
       if (!desc.equals(newDesc))
         param = " description: " + prepTextForServer(newDesc);
       if (!newName.equals(name))
         param = param + " name: " +  prepTextForServer(newName);
     if (newMove != sessile) {
       sessile = newMove;
       param = param + " sessile: " +  convertBooleanToIntString(sessile);
      }
     return param;
   }
 
 /**
  * Starts building the MCP for notifying the server of any change to the information
  * of this object
  *
  * @param newName name from the get info dialog box
  * @param newMove sessile value from the get info dialog box
  * @param newDesc description from the get info dialog box
  */
   public void objectModify(String newName, boolean newMove, String newDesc) {
     String param = getObjectModifyMCP(newName, newMove, newDesc);
     objectModify(param);
    }
  
 /**
  * Sends the MCP to the CVW server
  * <br> MCP send cvw-modify-metadata
  * @param param the subclass/instance specific values to be sent to the server
  */
   public void objectModify(String param) {
     if (param.length() != 0) {
     // If no problems, then set the CVW server.
     CVWServerComm.sendMCPCmdToServer("#$#cvw-modify-metadata",
                                 "object: " +  objNum.strValue() + param);
  
     }
   }
 
 /* 7/22/98 dage - objects know how to create themselves!!!
  */
 /**
  * Opens a blank &quot;Get Info&quote; dialog box for the user to create an instance
  * of this object on the CVW server.  When creating an object the use is only presented
  * with the first tab, &quot;Description&quot;
  */
   public void create() {
     FolderDialog dialog = new FolderDialog("CVW - New " + getType());
     ObjectPanel pan = getObjectPanel(dialog);
     dialog.addTab("Description", pan);
     dialog.pack();
     dialog.setVisible(true);
     pan.nameField.requestFocus();
   }
 
 /**
  * Returns a MCP string representing the values to be sent to the CVW server when
  * creating an object
  * <br> MCP send cvw-object-create
  *
  * @param name name from the get info dialog box
  * @param sessile sessile value from the get info dialog box
  * @param desc description from the get info dialog box
  * @return the subclass/instance specific values to be sent to the server
  */
   public String getObjectCreateMCP(String name, boolean sessile, String desc) {
      return " type: " + getStringFromType(typeValue) +
                       " name: " + prepTextForServer(name) +
                       " description: " + prepTextForServer(desc) +
                       " sessile: " + convertBooleanToIntString(sessile);
    }
  
 /**
  * Starts the process of building the MCP to be sent to the CVW server when 
  * the user creates a new object.
  *
  * @param name name from the get info dialog box
  * @param sessile sessile value from the get info dialog box
  * @param desc description from the get info dialog box
  */
   public void objectCreate(String name, boolean sessile, String desc) {
     String cmd = getObjectCreateMCP(name, sessile, desc);
     objectCreate(cmd);
   }
 
 /**
  * Builds the MCP parameter list for creating the object on the CVW server.
  * <br> MCP send cvw-object-create
  *
  * @param param the subclass/instance specific values to be sent to the server
  */
   public void objectCreate(String param) {
     CVWServerComm.sendMCPCmdToServer("#$#cvw-object-create ", param);
   }
 
 /*  12/30/97 dage - if creating a group, request an update of groups
  */
 /**
  * The results of creating an object on the CVW server. Display the
  * success or failure of the create in the scrollback.  Try to auto
  * open the object.
  *
  * @param mcpCmd The mcp sent from the server.
  *  HEARTBURN -- objectCreateResults
  * @see #autoOpenObject
  * @see MCPCommand
  */
   public void objectCreateResult(MCPCommand mcpCmd) {
       String loc = "your Carrying folder.";
       if (typeValue == GROUP) {
         loc = "the Group Manager.";
         GroupManager.getInstance().requestSystemGroups();
        }
       jcvw.displayPrvSysMsg("\"" + name +
         "\" successfully created.  It now resides in " + loc);
       autoOpenObject();
    }
 
 /**** special case scenario
    talk to cvw server, it says yes
    talk to doc server, it creates new document
    talk to cvw server, now there is an error,
    need to delete the new document from the doc server with a token
    This is for create doc, copy doc, create wb from doc, create wb
  *****/
 
   public static void objectCreateError(MCPCommand mcpCmd) {
       CVWCoordinator.getInstance().displayError( "An error occurred while creating your " +
                         mcpCmd.get("type") + " named \"" +
                         mcpCmd.get("name") +
                         "\" (" + mcpCmd.get("error_msg") + ").");
     }
 
 
 /**
  * Upon creating an object, open it for the user automatically.
  *
  * @see #objectCreateResult
  * @see CVWNote
  * @see CVWGroup
  */
   public void autoOpenObject() {
   //most objects do nothing
   }
 
 
   public void startOpen() {
       CVWServerComm.sendMCPCmdToServer("#$#cvw-object-open",
        "object: " + objNum.strValue());
    }
 
 /**
  * Starts the process of opening a get info dialog box. Sets the metaDataType
  * to <code>GETINFO</code>.
  * <br> MCP send cvw-object-detail-request
  *
  * @see #startInfoDialog(int type)
  */
   public void startInfoDialog () {
   startInfoDialog(GETINFO);
    }
 
 
 /**
  * Starts the process of opening a get info dialog box. Sets the metaDataType
  * so that when the CVW server sends MCP the correct tabbed panel will be in focus.
  * <br> MCP send cvw-object-detail-request
  *
  * @param type metaDataType to denote which tabbed panel should be opened
  *
  * @see #getInfo
  */
   public void startInfoDialog (int type) {
     /* 12/18/96 dage - check first to see if get info on obj is ready open */
     Window win = WindowMgr.getInstance().getObjectWindow("org.mitre.cvw.FolderDialog", objNum);
     if (win != null) {
         ((FolderDialog)win).toFront(type);
         return;    // dont open a new one
       }
 
     //if (WindowMgr.getWindowMgr().objectWindowExists("org.mitre.cvw.FolderDialog", objNum))
         //return;
 
     metaDataType = type;
     CVWServerComm.sendMCPCmdToServer("#$#cvw-object-detail-request", 
               "object: " + objNum.strValue());
   }
 
 /**
  * Opens the Get Info window for this object. All objects have the Description and
  * Permissions tabs.  CVWGroups and CVWRooms have a third panel representing their
  * members and users allowed in the room, respectively.
  * <br> MCP receive cvw-object-detail
  *
  * @param desc the description of this object
  * @param perms whether the user has permissions to edit this object
  * @param owners space delimited string of object numbers of the owners
  * 
  * @see #startInfoDialog
  * @see FolderDialog
  * @see ObjectPanel
  * @see ObjectOwnerPanel
  * 
  */
   public void getInfo(String desc, String perms, String owners) {
 
       this.desc = desc;
       if (this.desc == null)
          this.desc = "";
       
       if (type.indexOf("SC to") != -1) {
         perms = "shortcut";       // not editable regardless of ownership
        }
       //System.err.println("perms: " + perms+ "  type:"+type);
 
       FolderDialog dialog = new FolderDialog("Information About " + name);
       ObjectPanel objPan = getObjectPanel(dialog, perms);
       dialog.addTab("Description", objPan);
       ObjectOwnerPanel acl = new ObjectOwnerPanel(this, dialog, perms);
       dialog.addTab("Permissions", acl);
       String title = this.has3rdPanel();
       ObjectOwnerPanel tmp = null;
       if (title != null) {
         tmp = get3rdPanel(dialog, perms);
   dialog.addTab(title, tmp);
       }
 
 // 9/10/99
      dialog.folder.addChangeListener(acl);
      if (tmp != null)
        dialog.folder.addChangeListener(tmp);
  
      WindowMgr.getWindowMgr().addObjectWindow(WindowMgr.OBJECT, dialog, objNum);
       dialog.pack();
       dialog.setVisible(true);
       if (tmp != null && (tmp instanceof ObjectAccessPanel) &&
       (this instanceof CVWGroup)) {
   ((ObjectAccessPanel)tmp).setDroppable(true);
       }
       dialog.toFront(metaDataType);
      
 // do this afterwards because then the usergroupselection will be updated by
 //   the observable methods.
      this.setOwners(owners);
    }
 
 /**
  * Returns the instance of the object panel for this viewing/editing this object
  * @param diag the parent window
  * @param perms whether the current user has permissions to edit the object
  * @return instance of the object panel for general CVWObjects
  */
   public ObjectPanel getObjectPanel(FolderDialog diag, String perms) {
      return new ObjectPanel(this, diag, perms);
    }
 
 /* 7/22/98 dage - used when creating an object
  */
 /**
  * Returns an instance of the object panel for generic objects, used when creating an
  * object.
  * @param diag the parent window
  * @return instance of the object panel specifically for this object
  */
 
   public ObjectPanel getObjectPanel(FolderDialog diag) {
      return new ObjectPanel(this, diag);
    }
 
 /**
  * Returns the title of the third tabbed panel in the get info dialog box,
  * return null if no third panel. Most CVWObject descendents do not have a third panel.
  * @return <code>null</code>
  * @see CVWGroup#has3rdPanel
  * @see CVWRoom#has3rdPanel
  */
   public String has3rdPanel() {
   return null;
     }
 
 /**
  * Returns the instance of the third tabbed panel in the get info dialog box,
  * return null if no third panel. Most CVWObject descendents do not have a third panel.
  * @param diag the parent window the panel will go in
  * @param perms whether the current user has permissions to edit this group
  * @return the third tabbed panel in the get info dialog box
  * @return <code>null</code>
  * @see CVWGroup#get3rdPanel
  * @see CVWRoom#get3rdPanel
  */
   public ObjectOwnerPanel get3rdPanel(FolderDialog diag, String perms) {
   return null;
    }
 
 /**
  * Sets the detail information variables.
  * Currently not used.
  * @param descr the description of this object
  * @param perms whether the user has permissions to edit this object
 * @param owns a space delimited list of object numbers who are the owners of this object
 */
  public void updateDetailInfo(String descr, String perms, String owns) {
  setOwners(owns);
  desc = descr;
    }

/**
 * Returns a list of object numbers which represent the new object numbers contained 
 * in the new vector exluding those that are in the old array. 
 * This is to process contents or owners of an object. 
 * 5/30/98 dage
 *
 * @param oNums[] array of CVWObjNums
 * @param newV a vector of CVWObjNums as strings
 * @return a space delimited list of objects numbers 
 */
  public String newObjNumString(CVWObjNum oNums[], Vector newV) {
    String newONums = "";
    boolean changed = false;
    boolean contains = false;
    boolean check = true;
    if (newV.size() != oNums.length) {
      check = false;    //if different sizes, then send new, dont bother checking
      changed = true;
     }
    for (int i = 0; i< newV.size(); i++) {
        String oNum = (String)newV.elementAt(i);
        newONums += oNum + " ";
        if (check) {   //see if this obj num is contained in orig oNums list
          //System.err.println("checking" + oNum);
          contains = false;
          for (int j=0;j<oNums.length; j++) {
                //System.err.println("checking" + j + oNums[j]);
            if (oNums[j].equals(oNum)) {
               contains = true;
               break;    //break from for loop
             }
           }
          if (!contains) { 
            changed = true;
            check = false;   //stop checking
          }
         }
     }
    if (!changed) {
      //System.err.println("new oNums = old oNums");
      return null;
     }
    //System.err.println("new oNums: " + newONums);
    newONums = "\"" + newONums.trim() + "\"";
    return newONums;
   }

/**
 * Sends the owner access list to the CVW server when the user has changed
 * the permissions of this object.
 * <br> MCP send cvw-access-set-owners
 * 5/30/98
 * @param u vector of CVWObjects (CVWUsers)
 * @param g vector of CVWObjects (CVWGroups)
 */
  public void updateOwners(Vector u, Vector g) {
    //System.err.println("update owners: " + u.size() + " " + g.size());
    Vector newV = buildObjNumStrVector(u, g);
    String newOwners = newObjNumString(owners, newV);
    if (newOwners == null) return;
    //System.err.println("#$#cvw-access-set-owners " + 
    CVWServerComm.sendMCPCmdToServer("#$#cvw-access-set-owners",
            "object: " + objNum.strValue() +
            " owners: " + newOwners);
    }

/**
 * Processes the results of the setting the the owners of the object.
 * <br> MCP receive cvw-access-set-owners-result
 *
 * @param err the error code from the CVW server, 0 denotes no error
 * @param ownList space delimited list of object numbers sent to the CVW server
 * 
 * @see #updateOwners
 */
  public void updateOwnersResult(String err, String ownList) {
    if (!err.equals("0"))
  System.err.println("error in updateOwners: " + err);
    }


/**
 * Processes the results of the setting the the acl of the object.
 * This is currently only used by CVWRoom.
 * <br> MCP receive cvw-access-set-acl-result
 *
 * @param err the error code from the CVW server, 0 denotes no error
 * @param aclList space delimited list of object numbers sent to the CVW server
 * 
 * @see CVWRoom#updateACL
 */
  public void updateACLResult(String err, String aclList) {
    if (!err.equals("0"))
      System.err.println("error in updateACL: " + err);
    }

/**********   object delete methods      **************/
/**
 * Starts the process of deleting an object.
 *
 * The current mode of operation is
 * Check CVW server to see if permission to delete the object,
 * send cvw-object-delete with final = 0
 * <br>start of process if not a document
 * <br>if so, and not a document ask user if sure
 * <br>if yes, then send cvw-object-delete with final = 1
 * <br>end of process if not a document
 * <p>
 * <br>start of process if a document
 * <br>if so, check to see if the doc server can delete it
 * <br>if yes, ask the user if sure
 * <br>if yes, then send cvw-object-delete with final = 1
 * <br>CVW server will send cvw-document-delete
 * <br>try to delete on document server
 * <br>return to CVW server whether the delete on the doc server happened
 * <br>end of process if a document
 *
 * <br> MCP send cvw-object-delete
 * @param objNum the object number of the object to delete
 * @see #confirmDelete
 * @see CVWDocument#doDocDelete
 */
  public void startDeleteDialog() {
    CVWServerComm.sendMCPCmdToServer("#$#cvw-object-delete",
                        "object: " + objNum.strValue() + " final: 0");
   }

/** 3/5/97 dage - dont do doDocFunction for deletion of SC to Document
 *  12/30/97 dage - if deleting a group, request an update of groups
 * 6/3/98 dage - make the dialog modal to the appropriate frame
 */
/**
 * Either notifies the user that the object has been deleted or confirms the
 * delete of the object with the user because the CVW server has okayed
 * the user to delete the object (i.e. the suer has permissions)
 * <br> MCP receive cvw-object-delete-result
 * @param objNum the object number of the object to be deleted
 * @param name the name of the object to be deleted
 * @param finalTime if &quot;1&quot; then the object has been deleted, notify the user
 * if not, then ask the user if they really want to delete the object
 * @see CVWDocument#doDocFunction
 * @see CVWDocument#doDocDelete
 */
  public void confirmDelete(String name, int finalTime) {
    if (finalTime == 1) {
      jcvw.displayPrvSysMsg("\""+name+"\" has been deleted.");
      if (typeValue == CVWObject.GROUP)
        GroupManager.getInstance().requestSystemGroups();
      else if (typeValue == CVWObject.FOLDER) 
        ContentsCoordinator.getInstance().closeFolder(objNum); 
      return;
     }

        showDeleteDialog();
   }

   protected void showDeleteDialog() {
      String text = "Are you sure you want to delete \""+name+"\"?";
      JFrame frame = getObjectFrame();
      OkCancelDialog confDialog = new OkCancelDialog(frame, text, true, "Confirm Delete");
      confDialog.pack();
      confDialog.setVisible(true);
      if (!confDialog.cancel) {
         CVWServerComm.sendMCPCmdToServer("#$#cvw-object-delete",
                                          "object: " + objNum.strValue() + " final: 1");
        }
    }


/* 6/3/98 dage - moved this code from CVWServerComm 
 *  shortcuts are handled int handleShortcutError
 */
/**
 * The CVW server denyed the user the ability to delete an object
 * Hint: the item # and the object # will be different in the following situation:
 * you are deleting a folder which has a note in it .. you cannot delete the note.
 * the object # is that of the folder, the item # is that of the note.
 * <br> MCP receieve cvw-object-delete-result
 *
 * @param item the object number of the item which had a problem being deleted
 * @param error the error message
 * @param name the name of the object to be deleted
 * @see #handleShortcutError
 */
   public void deleteResultError(String item, String error) {
      CVWObject iObj;
      String iName = "";
      boolean folderDelete = false;
      if (item != null && !objNum.equals(item)) {
        folderDelete = true;
        iObj = CVWCache.getInstance().get(item);
        if (iObj != null)
          iName = iObj.name;
       }

      JFrame frame = getObjectFrame();
      if (error.equals("permission")) {
        String msg = "You don't have permission to delete \""+name+"\".";
        if (folderDelete)
           msg = "\""+name+"\" cannot be deleted.  It contains \"" + iName +
                                "\" which you do not have pemission to delete.";
        jcvw.displayError(frame, msg, "Delete Error");
      } else // if (error.equals("unknown"))
        jcvw.displayError(frame, "An unknown error occured while trying to delete \""+name+"\".  ", "Delete Error");

    }

/**
 * User has asked to delete an object that has shortcuts, this will confirm to
 * delete the original object and *ALL* shortcuts to it, regardless of who owns them, this
 * will show the user all shortcuts and who owns them.
 * <br>
 * Hint: the item # and the object # will be different in the following situation:
 * you are deleting a folder which has a note in it .. the note has a shortcut.
 * the object # is that of the folder, the item # is that of the note.
 * <br> MCP receieve cvw-object-delete-result
 * 
 * @param object the object number of the object to be deleted
 * @param item the item which is having the problem being deleted
 * @param shortcuts a space delimited list of object numbers of the shortcuts
 */
  public void handleShortcutError(String item, String shortcuts) {
    String toPrint;
    String scs = "";
    StringTokenizer existing = new StringTokenizer(shortcuts, " ");

    boolean folderDelete = false;
    CVWObject folder;
    String folderName = "";

    CVWObject problem = (CVWObject)(CVWCache.getInstance().get(item));
    String iName = item;
    JFrame frame = getObjectFrame();
    if (problem != null)  {
        iName = problem.name;
        frame = problem.getObjectFrame();
      }
     if (item != null && !objNum.equals(item)) {
        folderDelete = true;
        folder = this;
        folderName = name;
      }

    while(existing.hasMoreTokens()) {
      String objnum = existing.nextToken();
      CVWObject shortcut = CVWCache.getInstance().get(objnum);
      if (shortcut != null) {
        CVWUser owner = (CVWUser)(CVWCache.getInstance().get(shortcut.owner));
        if (owner != null)
            toPrint = "\""+shortcut.name + "\" (owned by "+owner.name+
                                        ", created on "+
                                        shortcut.getCreatedDateForDisplay() +
                                        ")";
        else
            toPrint = "\""+shortcut.name+"\"";
      } else toPrint = objnum;

      scs += toPrint + "\n";
    }
    String msg = "Are you sure you want to delete\"" + name +"\"?  It";
    if (folderDelete)
      msg = "Are you sure you want to delete\"" + folderName + "\"?  It contains \"" + iName + "\" which";
    msg += " has shortcuts, all of which will be deleted.  Below are the shortcuts:";
    OkCancelTextDialog ok = new OkCancelTextDialog(frame, msg, true, "Confirm Delete", OkCancelDialog.WARNING, scs);
    ok.pack();
    ok.setVisible(true);
    if (!ok.cancel)
       CVWServerComm.sendMCPCmdToServer("#$#cvw-object-delete-shortcuts",
                                                        "object: " + objNum.strValue() +
                                                        " item: " + item);
 }
/**********  end object delete methods      **************/

/********** object copy methods      **************/

/* 1/5/98 dage - cleaned up code
 * 4/10/98 dage - moved DSI code to DSIController
 */
/**
 * Copy or create Shortcut of the object.
 * User selected Copy or Shortcut from the object menu.
 *
 * @param type the type of copy either <code>Copy</code> or <code>Shortcut</code>
 */
  public void objectCopy(String type) {
System.err.println("in CVWObject::copy");
    CVWServerComm.sendMCPCmdToServer("#$#cvw-object-copy", 
            "object: " + objNum.strValue() + " copytype: " + type);
  }

/**
 * Display the results of the object copy from the server.
 * 0 denotes no error, otherwise display the message from the server.
 * <br> MCP receive cvw-object-copy-result
 *
 * @param mcpCmd
 *
 * @see MCPCommand
 */
  public void objectCopyResult(MCPCommand mcpCmd) {
    if (mcpCmd.get("error").equals("0")) {
      jcvw.displayPrvSysMsg("\"" + name + "\"  successfully copied.  " +
                        "A " + mcpCmd.get("copytype") +
                        " now resides in your Carrying folder.");
     }
    else
      jcvw.displayError("(" + mcpCmd.get("error_msg") +
                        ") occurred while copying your " +
                        mcpCmd.get("copytype")+ ".");
   }
/********** end object copy methods      **************/

/**********   object move methods      **************/
/**
 * Processes a drop or a take on a CVW object by sending the appropriate command
 * to the CVW server.
 * <br> MCP send cvw-move
 * @param action either &quot;Drop&quot; or &quot;Take&quot;
 * @param object the object to be moved
 */
  public void doDropTake(String action) {

    if (action.startsWith("Drop"))
  moveObject(jcvw.getCurrentRoom());
     else
  moveObject(jcvw.getCurrentUser());
  }

/**
 * Moves this object to another object.
 * @param toObj the destination object
 */
   public void moveObject(CVWObject toObj) {
      moveObject(toObj, null);
    }

/**
 * Moves this object to another object.
 * <br> MCP send cvw-move
 * @param toObj the destination object
 * @param frame the window that this object is currently in so that errors
 * displayed in dialog box is associated with that frame
 */
   public void moveObject(CVWObject toObj, JFrame frame) {
    String fromString = "";
    String toString = toObj.objNum.strValue();
    if (location != null) {
        fromString = location.strValue();
        if (fromString.equals(toString)) {
          String msg = "\"" + name + "\"";
          if (frame == null)
            frame = getObjectFrame();
          if (//!(frame instanceof CVWFolderWindow) && 
    location.equals(jcvw.getCurrentUser().objNum))
             msg = "You already have " + msg;
          else
             msg = msg + " is already there.";
          jcvw.displayError(frame,  msg, "Move Error");
          return;
         }
        fromString = " from: " + fromString;
     }
    toString = " to: " + toString;

    CVWServerComm.sendMCPCmdToServer("#$#cvw-move", "object: " + objNum.strValue() +
                                 toString + fromString);
    }

/* 6/5/98 dage - added code to make error dialog modal to the object window
 * 11/10/98 dage - moveObjectResult, differentiated between moving within private
 *   folders and taking from room and public/private give to user/move to room
 * 2/3/99 dage - moved from CVWCoordinator
 */
/**
 * Processes the results of an error.
 * <br> MCP receive cvw-move-result
 * @param error either &quot;1&quot; or &quot;0&quot;
 * @param msg the error message from the CVW server
 * @param receiver the object number of the destination object
 * @param origin the object number of the origination object
 */
  public void moveResult(String error, String msg, String receiver, String origin) {

    JFrame frame = getObjectFrame();
    String n = "\""+name+"\"";

    if (error.equals("1")) {
       if (msg.indexOf("locked down") != -1)
         jcvw.displayError(frame, n+" is locked down and cannot be moved.", "Move Error");
       else if (msg.indexOf("currently checked out") != -1)
         jcvw.displayError(frame, n+" is currently checked out.  Documents cannot be moved while you are working on them.", "Move Error");
       else if (msg.indexOf("currently being edited") != -1)
         jcvw.displayError(frame, n+" is currently being edited.  Documents cannot be moved until the changes have been saved or discarded.", "Move Error");
       else
         jcvw.displayError(frame, msg);
        //if (waitingForTakeResult.equals(object))
          //displayError(frame, n+" cannot be opened for editing.");
  return;
     } 

      //if (this instanceof CVWGroup && groupManager.groupViewerIsOpen())
                //GroupManager.getInstance().requestSystemGroups();

      boolean pub = true;
      CVWObject currentUser = jcvw.getCurrentUser();
      if (currentUser.objNum.equals(receiver)) {
        CVWObject orig = CVWCache.getInstance().get(origin);
        if (orig != null) {
           CVWObject oTop = orig.getTopLocation();
           if (oTop == currentUser)
             pub = false;
         }
        if (pub)
           jcvw.displayPubSysMsg("You take " + n + ".");
        else
           jcvw.displayPrvSysMsg("You move " + n + " to your Carrying Folder.");
        //if (waitingForTakeResult.equals(object))
          //sendMCPCmdToServer("#$#cvw-document-checkout-request","object: " + object);
  return;
       } 
      CVWObject room = jcvw.getCurrentRoom();
      if (room.objNum.equals(receiver)) { //SHOULD Check!!!
          jcvw.displayPubSysMsg("You drop " + n + " in " + room.name + ".");
          return;
   }

      pub = false;
      String verb = "move ";
      CVWObject dest = CVWCache.getInstance().get(receiver);
      String