CompletionTask (NetBeans Editor Code Completion SPI) - NetBeans API Javadoc 5.0.0

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.netbeans.spi.editor.completion
Interface CompletionTask

All Known Implementing Classes:: AsyncCompletionTask

public interface CompletionTask

The inteface of a task performing a code completion query.
The support class AsyncCompletionTask can be used for convenience when the task requires an asynchronous evaluation.

See Also:: CompletionProvider

Method Summary

void cancel()
          Called by the code completion infrastructure to cancel the task.

void query(CompletionResultSet resultSet)
          Called by the code completion infrastructure to ask the task to do a query and return the results through the given completion listener.

void refresh(CompletionResultSet resultSet)
          Called by the code completion infrastructure to inform the task about changes in the corresponding document.

Method Detail

query

public void query(CompletionResultSet resultSet)

Called by the code completion infrastructure to ask the task to do a query and return the results through the given completion listener.
This method is called only once during the lifetime of the completion task object.

This method is always called in AWT thread but it may reschedule its processing into another thread and fire the given listener once the computing is finished.

Parameters:: resultSet - non-null result set to which the results of the query must be added.

refresh

public void refresh(CompletionResultSet resultSet)

Called by the code completion infrastructure to inform the task about changes in the corresponding document. The task should reflect these changes while creating the query result.
This method can be called multiple times on a single task instance.
Typically it is called AFTER the query() was invoked but it may also be invoked BEFORE the query() in case the user types even before the query() was called by the infrastructure. In such case the resultSet parameter will be null.
It is guaranteed that this method will not be invoked in case the document instance set in the component would change since the last invocation of either the query() or refresh().