Package com.atlassian.confluence.rest.client

Interface RemoteContentTrashService

All Known Implementing Classes:

RemoteContentTrashServiceImpl

@ExperimentalApi
public interface RemoteContentTrashService

ContentTrashService implementation that communicates with Confluence remotely using the Confluence REST API.

Provides Promise-returning equivalents for the methods in ContentTrashService.

Method Summary

Modifier and Type	Method	Description
com.atlassian.util.concurrent.Promise<Void>	purge(Content content)	Deprecated. since 7.0.1.
CompletionStage<Void>	purgeCompletionStage(Content content)	Permanently delete a piece of content.
com.atlassian.util.concurrent.Promise<Content>	restore(Content content)	Deprecated. since 7.0.1.
CompletionStage<Content>	restoreCompletionStage(Content content)	Restore a trashed piece of content.
com.atlassian.util.concurrent.Promise<Void>	trash(Content content)	Deprecated. since 7.0.1.
CompletionStage<Void>	trashCompletionStage(Content content)	Trash a piece of content.

Method Detail

trash

@Deprecated
com.atlassian.util.concurrent.Promise<Void> trash(Content content)

Deprecated.

since 7.0.1. Use trashCompletionStage(Content) instead.

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

Returns:

the content after being trashed

restore

@Deprecated
com.atlassian.util.concurrent.Promise<Content> restore(Content content)

Deprecated.

since 7.0.1. Use restoreCompletionStage(Content) instead.

Restore a trashed piece of content.

Parameters:

content - the content to be restored

Returns:

the content after being restored

purge

@Deprecated
com.atlassian.util.concurrent.Promise<Void> purge(Content content)

Deprecated.

since 7.0.1. Use purgeCompletionStage(Content) instead.

Permanently delete a piece of content.

There are two main cases:

• Trashable content (e.g. Pages, BlogPosts) must have status "trashed" to be purged.
• Non-trashable content (e.g. Comments, Attachment) can be purged with status "current".

Parameters:

content - the content to be purged

trashCompletionStage

CompletionStage<Void> trashCompletionStage(Content content)

Trash a piece of content.

The purgeCompletionStage(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

Returns:

the content after being trashed

Since:

7.0.1

restoreCompletionStage

CompletionStage<Content> restoreCompletionStage(Content content)

Restore a trashed piece of content.

Parameters:

content - the content to be restored

Returns:

the content after being restored

Since:

7.0.1

purgeCompletionStage

CompletionStage<Void> purgeCompletionStage(Content content)

Permanently delete a piece of content.

There are two main cases:

• Trashable content (e.g. Pages, BlogPosts) must have status "trashed" to be purged.
• Non-trashable content (e.g. Comments, Attachment) can be purged with status "current".

Parameters:

content - the content to be purged

Since:

7.0.1