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

int	countDrafts(String creatorName)
List<Draft>	findAll() Returns all drafts stored in the data store.
List<Draft>	findByCreatorName(String creatorName) Returns the drafts stored against the given username.
List<Draft>	getAllDraftsForSpace(String spaceKey)
Draft	getDraft(long draftId) Returns the draft with the given ID, or null if no draft is found with that ID.
Draft	getDraft(Long pageId, String owner, String type, String spaceKey) Finds and returns a draft object with all the specified properties or null if none is found.
Draft	getDraft(String pageId, String owner, String type, String spaceKey) 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,
               String spaceKey)

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()

spaceKey - space key, if relevant for the draft. This is used to enable NEW page drafts across multiple spaces

Returns:

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

getDraft

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

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()

spaceKey - space key, if relevant for the draft. This is used to enable NEW page drafts across multiple spaces

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.

getAllDraftsForSpace

List<Draft> getAllDraftsForSpace(String spaceKey)

Parameters:

spaceKey -

Returns:

all the drafts in the space identified.

countDrafts

int countDrafts(String creatorName)

Returns:

count of number of drafts for this daos owner