org.xwiki.sheet

Interface SheetManager

@Role
public interface SheetManager

Interface used to retrieve the list of sheets available for a given document.

Since:

3.2M3

Version:

$Id: 562a5637c01f1d3e2d0707379013e885e9f3d766 $

Method Summary

Methods

Modifier and Type	Method and Description
List<DocumentReference>	getSheets(DocumentModelBridge document, String action) Returns the list of sheets available for a given XWiki document in the current execution context.

Method Detail

getSheets

List<DocumentReference> getSheets(DocumentModelBridge document,
                                String action)

Returns the list of sheets available for a given XWiki document in the current execution context.

Note: We can't use a document reference because the document might have unsaved objects. The create forms usually display an unsaved document that has some objects attached.

If this method fails for some reason to retrieve the sheets it shound't throw an exception but return an empty list and log an appropriate warning message instead.

Parameters:

document - a XWiki document

action - the action for which to retrieve the list of sheets ('view', 'edit' etc.); you can pass null or an empty string as a substitute for any action

Returns:

the list of sheets available for the given document and the specified action; these are sheets designed to be displayed when the specified action is performed on the given document (e.g. view sheets, edit sheets etc.)