Oracle Fusion Middleware Java API Reference for Oracle Extension SDK
11g Release 2 (11.1.2.1.0)

E17493-02

oracle.javatools.editor.language
Class AbstractLanguageSupport

java.lang.Object
  extended by oracle.javatools.editor.language.AbstractLanguageSupport
All Implemented Interfaces:
LanguageSupport

public abstract class AbstractLanguageSupport
extends java.lang.Object
implements LanguageSupport

An AbstractLanguageSupport is the base class for all LanguageSupports provided with this editor component. It takes care of implementing common functionality.


Field Summary
 
Fields inherited from interface oracle.javatools.editor.language.LanguageSupport
PROPERTY_LINE_COMMENT_START
 
Constructor Summary
AbstractLanguageSupport()
           
 
Method Summary
protected  BraceProvider createBraceProvider()
          Creates a new BraceProvider for performing brace matching for this document.
protected abstract  DocumentRenderer createDocumentRenderer()
          Creates the DocumentRenderer for rendering the given document.
protected  OffsetDescriptionProvider createOffsetDescriptionProvider()
          Creates a new OffsetDescriptionProvider for translating text buffer offsets into language specific user readable descriptions of the location.
protected  SmartIndentProvider createSmartIndentProvider()
          Creates a new SmartIndentProvider for performing smart indentation for this language.
protected  WordLocator createWordLocator()
          Creates a new WordLocator for defining word boundaries that make sense for a given language.
 void deinstall()
          Disassociates this instance from a specific document.
 BraceProvider getBraceProvider()
          Fetches the BraceProvider for performing brace matching for this document.
 BasicDocument getDocument()
          Fetches the document associated with this LanguageSupport instance.
 DocumentRenderer getDocumentRenderer()
          Fetches the DocumentRenderer for rendering the given document.
 OffsetDescriptionProvider getOffsetDescriptionProvider()
          Fetches the OffsetDescriptionProvider to use to translate offsets to language specific user readible Strings.
 java.lang.Object getProperty(java.lang.String key)
          Gets language-specific properties.
protected  java.lang.Object getPropertyImpl(java.lang.String key)
          Fetch the language-specific properties.
 SmartIndentProvider getSmartIndentProvider()
          Fetches the SmartIndentProvider to use for performing smart indentation.
 WordLocator getWordLocator()
          Fetches the WordLocator to use for locating word boundaries for word-based navigator.
 void install(BasicDocument document)
          Associates this LanguageSupport instance with a specific document.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

AbstractLanguageSupport

public AbstractLanguageSupport()
Method Detail

install

public void install(BasicDocument document)
Associates this LanguageSupport instance with a specific document. This is useful for example if there are caches maintained for this document.

Specified by:
install in interface LanguageSupport
Parameters:
document - the document

deinstall

public void deinstall()
Disassociates this instance from a specific document. This is called for example, when a client requests a different language mode for editing a given document. It may also be called when the document is being disposed of to clear up dangling references.

Specified by:
deinstall in interface LanguageSupport

getDocument

public final BasicDocument getDocument()
Fetches the document associated with this LanguageSupport instance.

Specified by:
getDocument in interface LanguageSupport
Returns:
the document

getProperty

public final java.lang.Object getProperty(java.lang.String key)
Gets language-specific properties. This allows languages to have a chance to define their own custom properties.

Specified by:
getProperty in interface LanguageSupport
Parameters:
key - a non-null property
Returns:
the property (if found)

getPropertyImpl

protected java.lang.Object getPropertyImpl(java.lang.String key)
Fetch the language-specific properties. Subclasses should override this if they have language-specific properties.

Parameters:
key - a non-null property
Returns:
the property (if found)

getDocumentRenderer

public final DocumentRenderer getDocumentRenderer()
Fetches the DocumentRenderer for rendering the given document. Note that all implementations are required to provide a DocumentRenderer.

Specified by:
getDocumentRenderer in interface LanguageSupport
Returns:
the DocumentRenderer that will be used for rendering (syntax-highlighting) the given document content

getBraceProvider

public final BraceProvider getBraceProvider()
Fetches the BraceProvider for performing brace matching for this document.

Specified by:
getBraceProvider in interface LanguageSupport
Returns:
a new BraceProvider for brace matching, or null if brace matching is not supported for this language.

getWordLocator

public WordLocator getWordLocator()
Fetches the WordLocator to use for locating word boundaries for word-based navigator. Implementations may override this to use their own custom word locator instead of the default one based on the natural language word locator based on the JDK's word break iterator.

Specified by:
getWordLocator in interface LanguageSupport
Returns:
the WordLocator

getSmartIndentProvider

public SmartIndentProvider getSmartIndentProvider()
Fetches the SmartIndentProvider to use for performing smart indentation.

Specified by:
getSmartIndentProvider in interface LanguageSupport
Returns:
the SmartIndentProvider for this language

getOffsetDescriptionProvider

public OffsetDescriptionProvider getOffsetDescriptionProvider()
Fetches the OffsetDescriptionProvider to use to translate offsets to language specific user readible Strings.

Returns:
the OffsetDescriptionProvider for this language, or null if one does not exisit.

createDocumentRenderer

protected abstract DocumentRenderer createDocumentRenderer()
Creates the DocumentRenderer for rendering the given document. Note that all implementations are required to provide a DocumentRenderer.

Returns:
the DocumentRenderer that will be used for rendering (syntax-highlighting) the given document content

createBraceProvider

protected BraceProvider createBraceProvider()
Creates a new BraceProvider for performing brace matching for this document.

Returns:
a new BraceProvider for brace matching, or null if brace matching is not supported for this language.

createWordLocator

protected WordLocator createWordLocator()
Creates a new WordLocator for defining word boundaries that make sense for a given language. The default one uses the JDK's break iterator for natural word boundaries.

Returns:
a new WordLocator for locating word boundaries

createSmartIndentProvider

protected SmartIndentProvider createSmartIndentProvider()
Creates a new SmartIndentProvider for performing smart indentation for this language.

Returns:
a new SmartIndentProvider, or null if this language does not support smart indentation

createOffsetDescriptionProvider

protected OffsetDescriptionProvider createOffsetDescriptionProvider()
Creates a new OffsetDescriptionProvider for translating text buffer offsets into language specific user readable descriptions of the location.

Returns:
a language specific OffsetDescriptionProvider or null if this language does not support offset descriptions

Oracle Fusion Middleware Java API Reference for Oracle Extension SDK
11g Release 2 (11.1.2.1.0)

E17493-02

Copyright © 1997, 2011, Oracle. All rights reserved.