org.eclipse.xtext.formatting2

Interface IFormattableDocument

All Known Subinterfaces:

IFormattableSubDocument

All Known Implementing Classes:

FilteredSubDocument, FormattableDocument, MaxLineWidthDocument, RootDocument, SubDocument

public interface IFormattableDocument

A FormattableDocument is a stateful object that holds a list of replacers. Each replacer is responsible for a text region inside this document. The document can be populated with replacers in any order. However, it is not possible and not intended to register two or more replacers for the same or overlapping region.

Eventually, all replacers are invoked from the beginning of the document to the end of the document. Each replacer produces text replacements for their region. A ITextReplacerContext is passed on from replacer to replacer and holds state such as the current indentation level.

Besides this, a formattable document

• offers convenience API to define formatting for HiddenRegions. See ITextRegionAccess for a definition of HiddenRegions and IHiddenRegionFormatter for how they can be formatted.
• supports conditional formatting. For example, it can try to format a region into the current line and. if that doesn't work, apply an alternative strategy.

Since:

2.8

Author:

Moritz Eysholdt - Initial contribution and API

Method Summary

Methods

Modifier and Type	Method and Description
void	addReplacer(ITextReplacer replacer) Add a new replacer to the document.
ISemanticRegion	append(ISemanticRegion appendAfter, Procedures.Procedure1<? super IHiddenRegionFormatter> initializer) Create a new IHiddenRegionFormatting, initialize it, and add it behind the given semanticRegion.
<T extends org.eclipse.emf.ecore.EObject> T	append(T appendAfter, Procedures.Procedure1<? super IHiddenRegionFormatter> initializer) Create a new IHiddenRegionFormatting, initialize it, and add it behind the given semantic object.
<T> T	format(T obj)
void	formatConditionally(org.eclipse.emf.ecore.EObject owner, ISubFormatter... formatters) Apply the formatting of the first sub formatter that can successfully format the given owner's region.
void	formatConditionally(int offset, int length, ISubFormatter... formatters) Apply the formatting of the first sub formatter that can successfully format the given region.
AbstractFormatter2	getFormatter() Returns the formatter that is being used.
ITextSegment	getRegion() Returns the region this formattable document is responsible for.
FormatterRequest	getRequest() Returns the current formatting request.
<T1 extends ISemanticRegion,T2 extends ISemanticRegion> Pair<T1,T2>	interior(Pair<T1,T2> pair, Procedures.Procedure1<? super IHiddenRegionFormatter> init)
<T1 extends ISemanticRegion,T2 extends ISemanticRegion> Pair<T1,T2>	interior(T1 first, T2 second, Procedures.Procedure1<? super IHiddenRegionFormatter> init)
<T extends org.eclipse.emf.ecore.EObject> T	interior(T object, Procedures.Procedure1<? super IHiddenRegionFormatter> init)
ISemanticRegion	prepend(ISemanticRegion prependBefore, Procedures.Procedure1<? super IHiddenRegionFormatter> initializer) Create a new IHiddenRegionFormatting, initialize it, and add it before the given semanticRegion.
<T extends org.eclipse.emf.ecore.EObject> T	prepend(T prependBefore, Procedures.Procedure1<? super IHiddenRegionFormatter> initializer) Create a new IHiddenRegionFormatting, initialize it, and add it before the given semantic object.
List<ITextReplacement>	renderToTextReplacements() Render the document.
Pair<IHiddenRegion,IHiddenRegion>	set(IHiddenRegion first, IHiddenRegion second, Procedures.Procedure1<? super IHiddenRegionFormatter> init)
IHiddenRegion	set(IHiddenRegion hiddenRegion, Procedures.Procedure1<? super IHiddenRegionFormatter> init) Create a new IHiddenRegionFormatting, initialize it, and add it for the given hidden region.
ISemanticRegion	surround(ISemanticRegion semanticRegion, Procedures.Procedure1<? super IHiddenRegionFormatter> beforeAndAfter) Create a new IHiddenRegionFormatting, initialize it, and add it before and after the given semantic region.
<T extends org.eclipse.emf.ecore.EObject> T	surround(T owner, Procedures.Procedure1<? super IHiddenRegionFormatter> beforeAndAfter) Create a new IHiddenRegionFormatting, initialize it, and add it before and after the given semantic object.
IFormattableDocument	withReplacerFilter(com.google.common.base.Predicate<? super ITextReplacer> filter) Creates a new formattable document to which only replacers can be added for which the provided predicate yields true.

Method Detail

withReplacerFilter

IFormattableDocument withReplacerFilter(com.google.common.base.Predicate<? super ITextReplacer> filter)

Creates a new formattable document to which only replacers can be added for which the provided predicate yields true.

getRegion

ITextSegment getRegion()

Returns the region this formattable document is responsible for.

getFormatter

AbstractFormatter2 getFormatter()

Returns the formatter that is being used.

getRequest

FormatterRequest getRequest()

Returns the current formatting request.

addReplacer

void addReplacer(ITextReplacer replacer)

Add a new replacer to the document.

renderToTextReplacements

List<ITextReplacement> renderToTextReplacements()

Render the document. This executes all contained replacers and returns the text replacements created by them.

append

ISemanticRegion append(ISemanticRegion appendAfter,
                     Procedures.Procedure1<? super IHiddenRegionFormatter> initializer)

Create a new IHiddenRegionFormatting, initialize it, and add it behind the given semanticRegion. Returns the given semantic region.

append

<T extends org.eclipse.emf.ecore.EObject> T append(T appendAfter,
                                                 Procedures.Procedure1<? super IHiddenRegionFormatter> initializer)

Create a new IHiddenRegionFormatting, initialize it, and add it behind the given semantic object. Returns the given semantic object.

prepend

ISemanticRegion prepend(ISemanticRegion prependBefore,
                      Procedures.Procedure1<? super IHiddenRegionFormatter> initializer)

Create a new IHiddenRegionFormatting, initialize it, and add it before the given semanticRegion. Returns the given semantic region.

prepend

<T extends org.eclipse.emf.ecore.EObject> T prepend(T prependBefore,
                                                  Procedures.Procedure1<? super IHiddenRegionFormatter> initializer)

Create a new IHiddenRegionFormatting, initialize it, and add it before the given semantic object. Returns the given semantic object.

surround

ISemanticRegion surround(ISemanticRegion semanticRegion,
                       Procedures.Procedure1<? super IHiddenRegionFormatter> beforeAndAfter)

Create a new IHiddenRegionFormatting, initialize it, and add it before and after the given semantic region. Returns the given semantic region.

surround

<T extends org.eclipse.emf.ecore.EObject> T surround(T owner,
                                                   Procedures.Procedure1<? super IHiddenRegionFormatter> beforeAndAfter)

Create a new IHiddenRegionFormatting, initialize it, and add it before and after the given semantic object. Returns the given semantic object.

formatConditionally

void formatConditionally(org.eclipse.emf.ecore.EObject owner,
                       ISubFormatter... formatters)
                         throws FormattingNotApplicableException

Apply the formatting of the first sub formatter that can successfully format the given owner's region. A sub formatters execution is considered successful if it didn't throw an FormattingNotApplicableException.

Throws:

FormattingNotApplicableException

formatConditionally

void formatConditionally(int offset,
                       int length,
                       ISubFormatter... formatters)
                         throws FormattingNotApplicableException

Apply the formatting of the first sub formatter that can successfully format the given region. A sub formatters execution is considered successful if it didn't throw an FormattingNotApplicableException.

Throws:

FormattingNotApplicableException

set

IHiddenRegion set(IHiddenRegion hiddenRegion,
                Procedures.Procedure1<? super IHiddenRegionFormatter> init)

Create a new IHiddenRegionFormatting, initialize it, and add it for the given hidden region. Returns the given hidden region.

set

Pair<IHiddenRegion,IHiddenRegion> set(IHiddenRegion first,
                                    IHiddenRegion second,
                                    Procedures.Procedure1<? super IHiddenRegionFormatter> init)

interior

<T1 extends ISemanticRegion,T2 extends ISemanticRegion> Pair<T1,T2> interior(T1 first,
                                                                           T2 second,
                                                                           Procedures.Procedure1<? super IHiddenRegionFormatter> init)

interior

<T1 extends ISemanticRegion,T2 extends ISemanticRegion> Pair<T1,T2> interior(Pair<T1,T2> pair,
                                                                           Procedures.Procedure1<? super IHiddenRegionFormatter> init)

interior

<T extends org.eclipse.emf.ecore.EObject> T interior(T object,
                                                   Procedures.Procedure1<? super IHiddenRegionFormatter> init)

format

<T> T format(T obj)