com.atlassian.confluence.api.service.content
Interface ContentTrashService

All Known Implementing Classes:
ContentTrashServiceImpl

public interface ContentTrashService

Controls trashing, restoring and purging Content from the instance.


Nested Class Summary
static interface ContentTrashService.Validator
          Provides methods for validating the trash, restore and purge methods.
 
Method Summary
 void purge(Content content)
          Permanently delete a piece of content.
 Content restore(Content content)
          Restore a trashed piece of content.
 void trash(Content content)
          Trash a piece of content.
 ContentTrashService.Validator validator()
          Get the validator view of this service.
 

Method Detail

trash

void trash(Content content)
Trash a piece of content.

The purge(Content) method can be used for content that doesn't support trashing. Currently, only content with types ContentType.PAGE and ContentType.BLOG_POST support trashing.

Parameters:
content - the content to be trashed
Throws:
NotFoundException - if no current content matches the supplied content. If the supplied content is already trashed, the purge(Content) should be used instead.
BadRequestException - if the supplied content is invalid
PermissionException - if the current user is not permitted to trash the content

restore

Content restore(Content content)
Restore a trashed piece of content.

Parameters:
content - the content to be restored
Returns:
the content after being restored
Throws:
NotFoundException - if no stored content matches the supplied content
BadRequestException - if the supplied content is invalid
PermissionException - if the current user is not permitted to restore the content

purge

void purge(Content content)
Permanently delete a piece of content.

There are two main cases:

Parameters:
content - the content to be purged
Throws:
NotFoundException - if no purgable content matches the supplied content. This can happen if no content matches the id, or if the content found is trashable but not trashed.
BadRequestException - if the supplied content is invalid
PermissionException - if the current user is not permitted to purge the content

validator

ContentTrashService.Validator validator()
Get the validator view of this service.

Returns:
a Validator that can be used to validate service requests.


Copyright © 2003–2015 Atlassian. All rights reserved.