Package ro.sync.ecss.extensions.commons.sort

Class DocbookListSortOperation

java.lang.Object

ro.sync.ecss.extensions.commons.sort.SortOperation

ro.sync.ecss.extensions.commons.sort.DocbookListSortOperation

All Implemented Interfaces:

AuthorOperation, Extension

@API(type=INTERNAL,
     src=PUBLIC)
public class DocbookListSortOperation
extends SortOperation

Class for Docbook 'Sort list' operation.

Field Summary

Fields inherited from class ro.sync.ecss.extensions.commons.sort.SortOperation

authorAccess, COLUMN

Fields inherited from interface ro.sync.ecss.extensions.api.AuthorOperation

NAMESPACE_ARGUMENT, NAMESPACE_ARGUMENT_DESCRIPTOR, SCHEMA_AWARE_ARGUMENT, SCHEMA_AWARE_ARGUMENT_DESCRIPTOR

Constructor Summary

Constructors

Constructor	Description
DocbookListSortOperation()	Constructor.

Method Summary

Modifier and Type	Method	Description
void	canBeSorted(AuthorElement parent, int[] selectedNonIgnoredChildrenInterval)	Check if the parent element selected children can be sorted.
protected String	getHelpPageID()	Get the ID of the help page which will be called by the end user.
List<CriterionInformation>	getSortCriteria(AuthorElement parent)	Obtain the sort criterion.
String[]	getSortKeysValues(AuthorNode node, SortCriteriaInformation sortInfo)	Obtain the values of the keys that can be used for sorting.
AuthorElement	getSortParent(int offset, AuthorAccess authorAccess)	Obtain the parent node of all the nodes which will be sorted.
boolean	isIgnored(AuthorNode node)	Checks if a given node is ignored when sorting.

Methods inherited from class ro.sync.ecss.extensions.commons.sort.SortOperation

doOperation, forceSortAll, getArguments, getDescription, getNonIgnoredChildren, getSelectedNonIgnoredChildrenInterval, getTextContentToSort

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DocbookListSortOperation

public DocbookListSortOperation()

Constructor.

Method Details

getSortParent

public AuthorElement getSortParent(int offset,
 AuthorAccess authorAccess)
                            throws AuthorOperationException

Description copied from class: SortOperation

Obtain the parent node of all the nodes which will be sorted.

Specified by:

getSortParent in class SortOperation

Parameters:

offset - The offset where the operation was invoked.

authorAccess - The AuthorAccess.

Returns:

The parent node of the nodes which will be sorted.

Throws:

AuthorOperationException - When the offset is negative or greater than the content length.

See Also:

• SortOperation.getSortParent(int, ro.sync.ecss.extensions.api.AuthorAccess)

isIgnored

public boolean isIgnored(AuthorNode node)

Description copied from class: SortOperation

Checks if a given node is ignored when sorting.

Specified by:

isIgnored in class SortOperation

Parameters:

node - The node to be checked.

Returns:

true if the given node is ignored when sorting.

See Also:

• SortOperation.isIgnored(ro.sync.ecss.extensions.api.node.AuthorNode)

canBeSorted

public void canBeSorted(AuthorElement parent,
 int[] selectedNonIgnoredChildrenInterval)
                 throws AuthorOperationException

Description copied from class: SortOperation

Check if the parent element selected children can be sorted. For example a table row containing a cell with rowspan cannot be sorted and stops the operation.

Specified by:

canBeSorted in class SortOperation

Parameters:

parent - The parent of the elements which will be sorted.

selectedNonIgnoredChildrenInterval - The interval of selected children indices.

Throws:

AuthorOperationException - When the given node is not sortable. For example a table row containing a cell with multiple rowspan stops the operation.

See Also:

• SortOperation.canBeSorted(ro.sync.ecss.extensions.api.node.AuthorElement, int[])

getSortKeysValues

public String[] getSortKeysValues(AuthorNode node,
 SortCriteriaInformation sortInfo)
                           throws AuthorOperationException

Description copied from class: SortOperation

Obtain the values of the keys that can be used for sorting.

Specified by:

getSortKeysValues in class SortOperation

Parameters:

node - The element which will be sorted.

sortInfo - The sort information corresponding to the user choice.

Returns:

an array containing the values of the keys which can be used for sorting.

Throws:

AuthorOperationException - If the text content cannot be obtained.

See Also:

• SortOperation.getSortKeysValues(ro.sync.ecss.extensions.api.node.AuthorNode, ro.sync.ecss.extensions.commons.sort.SortCriteriaInformation)

getSortCriteria

public List<CriterionInformation> getSortCriteria(AuthorElement parent)
                                           throws AuthorOperationException

Description copied from class: SortOperation

Obtain the sort criterion.

Specified by:

getSortCriteria in class SortOperation

Parameters:

parent - The parent node of the nodes which will be sorted.

Returns:

A SortCriteriaInformation containing the CriterionInformation objects.

Throws:

AuthorOperationException

See Also:

• SortOperation.getSortCriteria(ro.sync.ecss.extensions.api.node.AuthorElement)

getHelpPageID

protected String getHelpPageID()

Description copied from class: SortOperation

Get the ID of the help page which will be called by the end user.

Overrides:

getHelpPageID in class SortOperation

Returns:

the ID of the help page which will be called by the end user or null.

See Also:

• SortOperation.getHelpPageID()