com.atlassian.confluence.pages.persistence.dao
Interface DraftDao

All Known Implementing Classes:

HibernateDraftDao, SessionDraftDao

public interface DraftDao

Stores Confluence drafts in a data store.

Method Summary

List<Draft>	findAll() Returns all drafts stored in the data store.
List<Draft>	findByCreatorName(String creatorName) Returns the drafts stored against the given username.
Draft	getDraft(long draftId) Returns the draft with the given ID, or null if no draft is found with that ID.
Draft	getDraft(String pageId, String owner, String type) Finds and returns a draft object with all the specified properties or null if none is found.
void	remove(Draft draft) Removes a draft based on its page ID, owner and type.
void	remove(long id) Remove a draft based on its ID.
void	removeAll() Removes all drafts in the data store.
void	saveOrUpdate(Draft draft) Saves the draft.
void	updateSpaceKey(String newSpaceKey, String oldSpaceKey) Changes all drafts with a space key of oldSpaceKey to have newSpaceKey.

Method Detail

saveOrUpdate

void saveOrUpdate(Draft draft)
                  throws IllegalArgumentException

Saves the draft.

Throws:

IllegalArgumentException - if the draft has no page ID, owner or type.

getDraft

Draft getDraft(String pageId,
               String owner,
               String type)

Finds and returns a draft object with all the specified properties or null if none is found.

Parameters:

pageId - the id of the page which this draft is associated with

owner - the owner of the draft

type - the type of draft, which is usually the result of calling ContentEntityObject.getType()

Returns:

a draft object with all the specified properties or null if no valid draft could be found

getDraft

Draft getDraft(long draftId)

Returns the draft with the given ID, or null if no draft is found with that ID.

remove

void remove(Draft draft)

Removes a draft based on its page ID, owner and type. Does nothing if such a draft is not found in the data store.

See Also:

for a faster way to remove a draft when you know its ID

remove

void remove(long id)

Remove a draft based on its ID. Does nothing if such a draft is not found in the data store.

findByCreatorName

List<Draft> findByCreatorName(String creatorName)

Returns the drafts stored against the given username.

updateSpaceKey

void updateSpaceKey(String newSpaceKey,
                    String oldSpaceKey)

Changes all drafts with a space key of oldSpaceKey to have newSpaceKey.

Parameters:

newSpaceKey - the new space key

oldSpaceKey - the old space key

removeAll

void removeAll()

Removes all drafts in the data store.

findAll

List<Draft> findAll()

Returns all drafts stored in the data store.