Package com.inductiveautomation.ignition.designer.db.namedquery

Class NamedQuerySearchProvider

java.lang.Object

com.inductiveautomation.ignition.designer.findreplace.AbstractSearchProvider

com.inductiveautomation.ignition.designer.db.namedquery.NamedQuerySearchProvider

All Implemented Interfaces:

SearchProvider

public class NamedQuerySearchProvider
extends AbstractSearchProvider

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	NamedQuerySearchProvider.Categories
static enum	NamedQuerySearchProvider.WhichQueries

Nested classes/interfaces inherited from interface com.inductiveautomation.ignition.designer.findreplace.SearchProvider

SearchProvider.SelectedObjectsHandler

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ID

Constructor Summary

Constructors

Constructor	Description
NamedQuerySearchProvider(NamedQueryWorkspace workspace)

Method Summary

Modifier and Type	Method	Description
List<Object>	getCategories()	Returns a list of "categories", or sub-selectable units, supported by this search provider.
String	getId()	Returns an ID for this search provider.
String	getName()	Returns the name of the search provider, which will be used in the gateway and a UI to uniquely identify the provider.
protected List<ResourcePath>	getPaths(NamedQuerySearchProvider.WhichQueries which)
protected String	getSelectableObjectBaseKey()	Returns a key that will be used with BundleUtil to get various descriptions of the selectable objects.
boolean	hasSelectableObjects()	Whether or not the set of objects searched by this provider is selectable- for examples, which groups or windows are to be searched.
Iterator<SearchObject>	retrieveSearchableObjects(Collection<Object> categories, List<Object> searchObjects, TaskProgressListener progress)	Returns an iterator that provides all of the objects described by the parameters.
String	selectedObjectsToString(List<Object> selectedObjects)	Formats the list of selected objects as a brief string.
void	selectObjects(SearchProvider.SelectedObjectsHandler handler)	Instructs the SearchProvider to show a dialog in order to select the objects to search.

Methods inherited from class com.inductiveautomation.ignition.designer.findreplace.AbstractSearchProvider

notifySearchClosed, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.inductiveautomation.ignition.designer.findreplace.SearchProvider

addAsyncReplaceListener, getExecutor

Field Details

ID

public static final String ID

See Also:

• Constant Field Values

Constructor Details

NamedQuerySearchProvider

public NamedQuerySearchProvider(NamedQueryWorkspace workspace)

Method Details

getName

public String getName()

Description copied from interface: SearchProvider

Returns the name of the search provider, which will be used in the gateway and a UI to uniquely identify the provider. It is expected to be in the current session's language.

getId

public String getId()

Description copied from interface: SearchProvider

Returns an ID for this search provider. Should be globally unique (e.g. a module ID) and static regardless of locale.

getCategories

public List<Object> getCategories()

Description copied from interface: SearchProvider

Returns a list of "categories", or sub-selectable units, supported by this search provider. The actual objects will be passed back in to retrieveSearchableObjects when the search is executed.

hasSelectableObjects

public boolean hasSelectableObjects()

Description copied from interface: SearchProvider

Whether or not the set of objects searched by this provider is selectable- for examples, which groups or windows are to be searched.

selectObjects

public void selectObjects(SearchProvider.SelectedObjectsHandler handler)

Description copied from interface: SearchProvider

Instructs the SearchProvider to show a dialog in order to select the objects to search. The object are returned through the passed in handler, and will later be passed into executeSearch.

getSelectableObjectBaseKey

protected String getSelectableObjectBaseKey()

Description copied from class: AbstractSearchProvider

Returns a key that will be used with BundleUtil to get various descriptions of the selectable objects. It is expected that the following keys exist:
'{Key}.One' - "%d object"
'{Key}.Many' - "%d objects"
'{Key}.Default' - what will be searched if no objects are selected. For example, "All groups" or "Default provider"

Specified by:

getSelectableObjectBaseKey in class AbstractSearchProvider

Returns:

a BundleUtil key corresponding to a description for a selectable object.

selectedObjectsToString

public String selectedObjectsToString(List<Object> selectedObjects)

Description copied from interface: SearchProvider

Formats the list of selected objects as a brief string.

Specified by:

selectedObjectsToString in interface SearchProvider

Overrides:

selectedObjectsToString in class AbstractSearchProvider

getPaths

protected List<ResourcePath> getPaths(NamedQuerySearchProvider.WhichQueries which)

retrieveSearchableObjects

public Iterator<SearchObject> retrieveSearchableObjects(Collection<Object> categories,
 List<Object> searchObjects,
 TaskProgressListener progress)

Description copied from interface: SearchProvider

Returns an iterator that provides all of the objects described by the parameters. The iterator will generally stream the results, calculating the next object on each call to hasNext().

The provided ProgressListener can be used to provide progress information as the Iterator is processed. Some providers may not be able to calculate progress, in which case they should call setIndeterminate(true), but the provider implementors are encouraged to provide anything they can, even if it's very coarse.

Parameters:

categories - indicates the user selection (if applicable) of which categories should be searched.

searchObjects - the user selected objects (if applicable) to be searched.

progress - a progress listener for this provider, which can be updated as the returned Iterator is used. If not supported, the provider should call setIndeterminate(true).