org.openide.src
Interface SourceElement.Impl

All Superinterfaces:

Element.Impl, Serializable

Enclosing class:

SourceElement

public static interface SourceElement.Impl

extends Element.Impl

Pluggable behaviour for source elements.

See Also:

SourceElement

Field Summary

static int	ADD Add some top-level classes.
static int	REMOVE Remove some top-level classes.
static long	serialVersionUID
static int	SET Set the top-classes.

Method Summary

void	changeClasses(ClassElement[] elems, int action) Change the set of top-level classes.
void	changeImports(Import[] elems, int action) Change the set of imports.
ClassElement[]	getAllClasses() Get all classes recursively, both top-level and inner.
ClassElement	getClass(Identifier name) Find a top-level class by name.
ClassElement[]	getClasses() Get all top-level classes.
Import[]	getImports() Get all imports.
Identifier	getPackage() Get the package of this source file.
int	getStatus() Get the parsing status of the element.
Task	prepare() Begin parsing this source element.
void	runAtomic(Runnable run) Lock the underlaing document to have exclusive access to it and could make changes on this SourceElement.
void	runAtomicAsUser(Runnable run) Executes given runnable in "user mode" does not allowing any modifications to parts of text marked as guarded.
void	setPackage(Identifier id) Set the package of this source file.

Methods inherited from interface org.openide.src.Element.Impl

addPropertyChangeListener, attachedToElement, getCookie, markCurrent, readResolve, removePropertyChangeListener

Field Detail

ADD

public static final int ADD

Add some top-level classes.

REMOVE

public static final int REMOVE

Remove some top-level classes.

SET

public static final int SET

Set the top-classes.

serialVersionUID

public static final long serialVersionUID

Method Detail

getStatus

public int getStatus()

Get the parsing status of the element. This is a non-blocking operation.

Returns:

one of SourceElement.STATUS_NOT, SourceElement.STATUS_ERROR, SourceElement.STATUS_PARTIAL, or SourceElement.STATUS_OK

prepare

public Task prepare()

Begin parsing this source element. This method is non-blocking; it only returns a task that can be used to control the ongoing parse. Initially the getStatus() should be SourceElement.STATUS_NOT, and change to one of the other three when parsing is complete, according to whether or not errors were encountered, and their severity.

Returns:

a task to control the preparation of the element

setPackage

public void setPackage(Identifier id)
                throws SourceException

Set the package of this source file.

Parameters:

id - the package name, or null to use the default package

Throws:

SourceException - if the operation cannot proceed

getPackage

public Identifier getPackage()

Get the package of this source file.

Returns:

the package name, or null if this source file is in the default package

getImports

public Import[] getImports()

Get all imports.

Returns:

the imports

changeImports

public void changeImports(Import[] elems,
                          int action)
                   throws SourceException

Change the set of imports.

Parameters:

elems - the imports to change

action - one of ADD, REMOVE, or SET

Throws:

SourceException - if the action cannot be handled

changeClasses

public void changeClasses(ClassElement[] elems,
                          int action)
                   throws SourceException

Change the set of top-level classes.

Parameters:

elems - the classes to change

action - one of ADD, REMOVE, or SET

Throws:

SourceException - if the action cannot be handled

getClasses

public ClassElement[] getClasses()

Get all top-level classes.

Returns:

the classes

getClass

public ClassElement getClass(Identifier name)

Find a top-level class by name.

Parameters:

name - the name to look for

Returns:

the class, or null if it does not exist

getAllClasses

public ClassElement[] getAllClasses()

Get all classes recursively, both top-level and inner.

Returns:

all classes

runAtomic

public void runAtomic(Runnable run)

Lock the underlaing document to have exclusive access to it and could make changes on this SourceElement.

Parameters:

run - the action to run

runAtomicAsUser

public void runAtomicAsUser(Runnable run)
                     throws SourceException

Executes given runnable in "user mode" does not allowing any modifications to parts of text marked as guarded. The actions should be run as "atomic" so either happen all at once or none at all (if a guarded block should be modified).

Parameters:

run - the action to run

Throws:

SourceException - if a modification of guarded text occured and that is why no changes to the document has been done.