Package ro.sync.ecss.extensions.tei

Class TEISchemaAwareEditingHandler

java.lang.Object

ro.sync.ecss.extensions.api.AuthorSchemaAwareEditingHandlerAdapter

ro.sync.ecss.extensions.tei.TEISchemaAwareEditingHandler

All Implemented Interfaces:

AuthorSchemaAwareEditingHandler

@API(type=INTERNAL,
     src=PUBLIC)
public class TEISchemaAwareEditingHandler
extends AuthorSchemaAwareEditingHandlerAdapter

Specific editing support for TEI documents. Handles typing and paste events inside list (a item with a para will be created and the typing/paste content be put inside it) and tables.

Nested Class Summary

Nested classes/interfaces inherited from class ro.sync.ecss.extensions.api.AuthorSchemaAwareEditingHandlerAdapter

AuthorSchemaAwareEditingHandlerAdapter.WrapInAncestorsOptions

Field Summary

Fields

Modifier and Type	Field	Description
protected final String	documentNamespace	For TEI P5 http://www.tei-c.org/ns/1.0, for TEI P4 an empty string.

Fields inherited from class ro.sync.ecss.extensions.api.AuthorSchemaAwareEditingHandlerAdapter

lastHandlerResult

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

ACTION_ID_BACKSPACE, ACTION_ID_CUT, ACTION_ID_DELETE, ACTION_ID_DND, ACTION_ID_INSERT_FRAGMENT, ACTION_ID_PASTE, ACTION_ID_TYPING, CREATE_FRAGMENT_PURPOSE_COPY, CREATE_FRAGMENT_PURPOSE_CUT, CREATE_FRAGMENT_PURPOSE_DND_COPY, CREATE_FRAGMENT_PURPOSE_DND_MOVE

Constructor Summary

Constructors

Constructor	Description
TEISchemaAwareEditingHandler(String documentNamespace)	Constructor.

Method Summary

Modifier and Type	Method	Description
boolean	changeElementsToMoveUpDown(List<AuthorNode> selectedElements)	Determine the elements that should be moved by the Move Up/Down operation.
boolean	handlePasteFragment(int offset, AuthorDocumentFragment[] fragmentsToInsert, int actionId, AuthorAccess authorAccess)	Handle an insert fragment event generated by: a Paste action.
boolean	handleTyping(int offset, char ch, AuthorAccess authorAccess)	Handle a typing event.
boolean	handleTypingFallback(int offset, char ch, AuthorAccess authorAccess)	Give a fallback solution for a typing event.
protected boolean	isElementWithNameAndNamespace(AuthorNode node, String elementLocalName)
protected void	pushContextElement(WhatElementsCanGoHereContext context, String elementName)	Derive the given context by adding the given element.

Methods inherited from class ro.sync.ecss.extensions.api.AuthorSchemaAwareEditingHandlerAdapter

canBeReplaced, getAncestorDetectionOptions, getLastResult, getPreferredElement, handleCreateDocumentFragment, handleDelete, handleDeleteElementTags, handleDeleteNodes, handleDeleteSelection, handleJoinElements

Methods inherited from class java.lang.Object

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

Methods inherited from interface ro.sync.ecss.extensions.api.AuthorSchemaAwareEditingHandler

handleCodePointTyping, handleCodePointTypingFallback

Field Details

documentNamespace

protected final String documentNamespace

For TEI P5 http://www.tei-c.org/ns/1.0, for TEI P4 an empty string.

Constructor Details

TEISchemaAwareEditingHandler

public TEISchemaAwareEditingHandler(String documentNamespace)

Constructor.

Parameters:

documentNamespace - The document namespace, for different versions of TEI.

Method Details

handleTyping

public boolean handleTyping(int offset,
 char ch,
 AuthorAccess authorAccess)
                     throws InvalidEditException

Description copied from interface: AuthorSchemaAwareEditingHandler

Handle a typing event. If the event is not handled, the default implementation of a handler will be given a chance to handle the event. If that fails to provide a solution, AuthorSchemaAwareEditingHandler.handleTypingFallback(int, char, AuthorAccess) will get called.

Specified by:

handleTyping in interface AuthorSchemaAwareEditingHandler

Overrides:

handleTyping in class AuthorSchemaAwareEditingHandlerAdapter

Parameters:

offset - Offset where the typing occurred.

ch - The typed character.

authorAccess - Access class to the author functions.

Returns:

true if the typing was handled.

Throws:

InvalidEditException - This is an invalid edit and must be rejected.

See Also:

• AuthorSchemaAwareEditingHandlerAdapter.handleTyping(int, char, ro.sync.ecss.extensions.api.AuthorAccess)

handleTypingFallback

public boolean handleTypingFallback(int offset,
 char ch,
 AuthorAccess authorAccess)
                             throws InvalidEditException

Description copied from interface: AuthorSchemaAwareEditingHandler

Give a fallback solution for a typing event. This call comes when this object's AuthorSchemaAwareEditingHandler.handleTyping(int, char, AuthorAccess) method did not handle the typing event and neither did the AuthorSchemaAwareEditingHandler.handleTyping(int, char, AuthorAccess) from the default implementation.

As a fallback solution, a paragraph can be inserted at the given offset (if allowed) and then the typed character can be inserted inside it.

Specified by:

handleTypingFallback in interface AuthorSchemaAwareEditingHandler

Overrides:

handleTypingFallback in class AuthorSchemaAwareEditingHandlerAdapter

Parameters:

offset - Offset where the typing occurred.

ch - The typed character.

authorAccess - Access class to the author functions.

Returns:

true if the typing was handled.

Throws:

InvalidEditException - This is an invalid edit and must be rejected.

See Also:

• AuthorSchemaAwareEditingHandlerAdapter.handleTypingFallback(int, char, ro.sync.ecss.extensions.api.AuthorAccess)

handlePasteFragment

public boolean handlePasteFragment(int offset,
 AuthorDocumentFragment[] fragmentsToInsert,
 int actionId,
 AuthorAccess authorAccess)
                            throws InvalidEditException

Description copied from interface: AuthorSchemaAwareEditingHandler

Handle an insert fragment event generated by:

• a Paste action. In this case, selection removal is handled before calling this method.
• a DND action. In this case source removal is handled after calling this method (unless an exception was thrown).
• an insert fragment event occurred as a result of an schema aware insert event, like AuthorDocumentController.insertXMLFragmentSchemaAware(String, int). Selection removal is handled before calling this method.

Specified by:

handlePasteFragment in interface AuthorSchemaAwareEditingHandler

Overrides:

handlePasteFragment in class AuthorSchemaAwareEditingHandlerAdapter

Parameters:

offset - Offset where the event occurred.

fragmentsToInsert - Fragments to be inserted.

actionId - ACTION_ID_PASTE if event was generated by paste action, ACTION_ID_DND if it was generated by a DND event or ACTION_ID_INSERT_FRAGMENT if the event was generated by an AuthorDocumentController schema aware insert method.

authorAccess - Access class to the author functions.

Returns:

true if the insertion was handled.

Throws:

InvalidEditException - This is an invalid edit and must be rejected.

See Also:

• AuthorSchemaAwareEditingHandlerAdapter.handlePasteFragment(int, ro.sync.ecss.extensions.api.node.AuthorDocumentFragment[], int, ro.sync.ecss.extensions.api.AuthorAccess)

pushContextElement

protected void pushContextElement(WhatElementsCanGoHereContext context,
 String elementName)

Derive the given context by adding the given element.

isElementWithNameAndNamespace

protected boolean isElementWithNameAndNamespace(AuthorNode node,
 String elementLocalName)

Returns:

true if the given node is an element with the given local name and from the TEI namespace.

changeElementsToMoveUpDown

public boolean changeElementsToMoveUpDown(List<AuthorNode> selectedElements)

Description copied from class: AuthorSchemaAwareEditingHandlerAdapter

Determine the elements that should be moved by the Move Up/Down operation. For example if the current selected element is a title then the element that should actually be moved is its parent (e.g. section for DocBook).

Overrides:

changeElementsToMoveUpDown in class AuthorSchemaAwareEditingHandlerAdapter

Parameters:

selectedElements - the selected elements in the author page. This list should be altered depending on the framework specific structure.
For example if the current selected element is a title then the element that should actually be present in this list is its parent (e.g. section for DocBook).

Returns:

true if the list of elements to be moved was altered by the framework specific handler.

See Also:

• AuthorSchemaAwareEditingHandlerAdapter.changeElementsToMoveUpDown(java.util.List)