/**
   * Checks whether the given assocation is valid for registration.
   *
   * <PRE>
   * 1. The file extension list and mime type can't all be null
   * 2. If any of the fileds: description, iconFile, actionList is not null,
   *    then fileExtensionList should not be empty
   * </PRE>
   *
   * @param assoc a given Association object.
   * @throws IllegalArgumentException if the given association is not valid for registration.
   */
  public void checkAssociationValidForRegistration(Association assoc)
      throws IllegalArgumentException {
    boolean isActionListEmpty = true;
    boolean isFileExtensionEmpty = true;
    boolean isValid = false;

    // Check if actionlist is empty
    if (assoc.getActionList() != null) {
      isActionListEmpty = assoc.getActionList().isEmpty();
    }
    // Check if file extension list is empty
    if (assoc.getFileExtList() != null) {
      isFileExtensionEmpty = assoc.getFileExtList().isEmpty();
    }

    if (isFileExtensionEmpty && (assoc.getMimeType() == null)) {
      isValid = false;
    } else if ((assoc.getDescription() != null)
        || (assoc.getIconFileName() != null)
        || (!isActionListEmpty)) {
      isValid = !isFileExtensionEmpty;
    } else {
      isValid = true;
    }

    if (!isValid) {
      throw new IllegalArgumentException(
          "The given association is invalid. It should "
              + "specify both the mimeType and fileExtensionList fields to perform this operation.");
    }
  }
  /**
   * Registers the given association info in the specified level.
   *
   * <PRE>
   *
   * The register process will following the rules below
   * 1. mimetype == null && fileExt != null
   *    Since fileExt does not exist in this case
   *    1.1 adds the fileExt
   *    1.2 adds description, icon file and action list for this fileExt
   * 2. mimetype != null && fileExt == null
   *    Since mimetype does not exist in this case
   *    just adds the mimetype in the reg table
   * 3. mimetype != null && fileExt != null
   *    3.1 Adds the mime type into the reg table if necessary
   *    3.2 Adds the file extension into the reg table if necessary
   *    3.3 Adds the description, icon file and action list for the fileExt
   *    3.4 Sets the mutual reference of the mime type and file extension
   * </PRE>
   *
   * @param assoc given association (not null)
   * @param regLevel given registry level
   * @throws RegisterFailedException if the operation fails.
   */
  public void registerAssociation(Association assoc, int regLevel) throws RegisterFailedException {
    // LOCAL_MACHINE. Association, in this case, should only be written into LOCAL_MACHINE rather
    // than the CURRENT_USER.
    boolean isOldWindows = false;
    String osName = System.getProperty("os.name").toLowerCase();
    if ((osName.indexOf("98") != -1)
        || (osName.indexOf("me") != -1)
        || (osName.indexOf("nt") != -1)) {
      isOldWindows = true;
    }
    if (isOldWindows) {
      regLevel = AppConstants.SYSTEM_LEVEL;
    }
    BackupAssociation backupAssoc = new BackupAssociation(assoc, regLevel);
    String curMimeType = backupAssoc.getCurMimeType();
    String curFileExt = backupAssoc.getCurFileExt();
    String curDescription = assoc.getDescription();
    String curIconFileName = assoc.getIconFileName();
    List<Action> curActionList = assoc.getActionList();
    boolean curMimeTypeExisted = backupAssoc.getCurMimeTypeExisted();
    boolean curFileExtExisted = backupAssoc.getCurFileExtExisted();

    try {
      if ((curMimeType == null) && (curFileExt != null)) {
        WinRegistryUtil.addFileExt(curFileExt, regLevel);
        if (curDescription != null) {
          WinRegistryUtil.setDescriptionByFileExt(curDescription, curFileExt, regLevel);
        }
        if (curIconFileName != null) {
          WinRegistryUtil.setIconFileNameByFileExt(curIconFileName, curFileExt, regLevel);
        }
        if (curActionList != null) {
          WinRegistryUtil.setActionListByFileExt(curActionList, curFileExt, regLevel);
        }
        // Mark the classID generator field
        WinRegistryUtil.markGeneratorByFileExt(curFileExt, regLevel);
      } else if ((curMimeType != null) && (curFileExt == null)) {
        WinRegistryUtil.addMimeType(curMimeType, regLevel);
      } else if ((curMimeType != null) && (curFileExt != null)) {
        if (!curMimeTypeExisted) {
          WinRegistryUtil.addMimeType(curMimeType, regLevel);
        }
        if (!curFileExtExisted) {
          WinRegistryUtil.addFileExt(curFileExt, regLevel);
        }
        if (curDescription != null) {
          WinRegistryUtil.setDescriptionByFileExt(curDescription, curFileExt, regLevel);
        }
        if (curIconFileName != null) {
          WinRegistryUtil.setIconFileNameByFileExt(curIconFileName, curFileExt, regLevel);
        }
        if (curActionList != null) {
          WinRegistryUtil.setActionListByFileExt(curActionList, curFileExt, regLevel);
        }
        // Mark the classID generator field.
        WinRegistryUtil.markGeneratorByFileExt(curFileExt, regLevel);
        WinRegistryUtil.setMutualRef(curFileExt, curMimeType, regLevel);
      }
    } catch (RegisterFailedException e) {
      restoreAssociationRegistration(backupAssoc, regLevel);

      throw e;
    }
  }