/**
* Moves the trash entry with the entity class name and primary key, restoring it to a new
* location identified by the destination container model ID.
*
* <p>This method throws a {@link TrashPermissionException} if the user did not have the
* permission to perform one of the necessary operations. The exception is created with a type
* specific to the operation:
*
* <ul>
* <li>{@link TrashPermissionException#MOVE} - if the user did not have permission to move the
* trash entry to the new destination
* <li>{@link TrashPermissionException#RESTORE} - if the user did not have permission to restore
* the trash entry
* </ul>
*
* @param className the class name of the entity
* @param classPK the primary key of the entity
* @param destinationContainerModelId the primary key of the new location
* @param serviceContext the service context to be applied (optionally <code>null</code>)
* @throws PortalException if a matching trash entry could not be found, if the user did not have
* permission to move the trash entry to the new location, if the user did not have permission
* to restore the trash entry, if a duplicate trash entry exists at the new location, or if a
* portal exception occurred
*/
@Override
public void moveEntry(
String className,
long classPK,
long destinationContainerModelId,
ServiceContext serviceContext)
throws PortalException {
PermissionChecker permissionChecker = getPermissionChecker();
long scopeGroupId = 0;
if (serviceContext != null) {
scopeGroupId = serviceContext.getScopeGroupId();
}
TrashHandler trashHandler = TrashHandlerRegistryUtil.getTrashHandler(className);
destinationContainerModelId =
trashHandler.getDestinationContainerModelId(classPK, destinationContainerModelId);
if (!trashHandler.hasTrashPermission(
permissionChecker, scopeGroupId, destinationContainerModelId, TrashActionKeys.MOVE)) {
throw new TrashPermissionException(TrashPermissionException.MOVE);
}
if (trashHandler.isInTrash(classPK)
&& !trashHandler.hasTrashPermission(
permissionChecker, 0, classPK, TrashActionKeys.RESTORE)) {
throw new TrashPermissionException(TrashPermissionException.RESTORE);
}
TrashEntry trashEntry = trashHandler.getTrashEntry(classPK);
if (trashEntry.isTrashEntry(className, classPK)) {
trashHandler.checkRestorableEntry(trashEntry, destinationContainerModelId, StringPool.BLANK);
} else {
trashHandler.checkRestorableEntry(classPK, destinationContainerModelId, StringPool.BLANK);
}
trashHandler.moveTrashEntry(getUserId(), classPK, destinationContainerModelId, serviceContext);
}
/**
* Restores the trash entry to its original location. In order to handle a duplicate trash entry
* already existing at the original location, either pass in the primary key of the existing trash
* entry's entity to overwrite or pass in a new name to give to the trash entry being restored.
*
* <p>This method throws a {@link TrashPermissionException} if the user did not have the
* permission to perform one of the necessary operations. The exception is created with a type
* specific to the operation:
*
* <ul>
* <li>{@link TrashPermissionException#RESTORE} - if the user did not have permission to restore
* the trash entry
* <li>{@link TrashPermissionException#RESTORE_OVERWRITE} - if the user did not have permission
* to delete the existing trash entry
* <li>{@link TrashPermissionException#RESTORE_RENAME} - if the user did not have permission to
* rename the trash entry
* </ul>
*
* @param entryId the primary key of the trash entry to restore
* @param overrideClassPK the primary key of the entity to overwrite (optionally <code>0</code>)
* @param name a new name to give to the trash entry being restored (optionally <code>null</code>)
* @return the restored trash entry
* @throws PortalException if a matching trash entry could not be found, if the user did not have
* permission to overwrite an existing trash entry, to rename the trash entry being restored,
* or to restore the trash entry in general
*/
@Override
public TrashEntry restoreEntry(long entryId, long overrideClassPK, String name)
throws PortalException {
PermissionChecker permissionChecker = getPermissionChecker();
TrashEntry entry = trashEntryPersistence.findByPrimaryKey(entryId);
TrashHandler trashHandler = TrashHandlerRegistryUtil.getTrashHandler(entry.getClassName());
if (!trashHandler.hasTrashPermission(
permissionChecker, 0, entry.getClassPK(), TrashActionKeys.RESTORE)) {
throw new TrashPermissionException(TrashPermissionException.RESTORE);
}
if (overrideClassPK > 0) {
if (!trashHandler.hasTrashPermission(
permissionChecker, 0, overrideClassPK, TrashActionKeys.OVERWRITE)) {
throw new TrashPermissionException(TrashPermissionException.RESTORE_OVERWRITE);
}
trashHandler.deleteTrashEntry(overrideClassPK);
trashHandler.checkRestorableEntry(entry, TrashEntryConstants.DEFAULT_CONTAINER_ID, null);
} else if (name != null) {
if (!trashHandler.hasTrashPermission(
permissionChecker, 0, entry.getClassPK(), TrashActionKeys.RENAME)) {
throw new TrashPermissionException(TrashPermissionException.RESTORE_RENAME);
}
trashHandler.checkRestorableEntry(entry, TrashEntryConstants.DEFAULT_CONTAINER_ID, name);
trashHandler.updateTitle(entry.getClassPK(), name);
}
trashHandler.restoreTrashEntry(getUserId(), entry.getClassPK());
return entry;
}
