org.openide.loaders

Class FolderLookup

java.lang.Object

org.openide.util.Task

org.openide.loaders.FolderInstance

org.openide.loaders.FolderLookup

All Implemented Interfaces:

Runnable, InstanceCookie, Node.Cookie

Deprecated.

use Lookups.forPath(java.lang.String) instead.

@Deprecated
public class FolderLookup
extends FolderInstance

Implements a lookup, that scans a content of a folder for its data objects and asks them for instance cookie, the created objects are then used to for the content of the lookup.

Any instances which are in fact instances of Lookup will be proxied to, permitting one file to generate many instances in the lookup system easily.

Since:

1.11

Nested Class Summary

Nested classes/interfaces inherited from interface org.openide.cookies.InstanceCookie

InstanceCookie.Of

Field Summary

Fields inherited from class org.openide.loaders.FolderInstance

folder

Fields inherited from class org.openide.util.Task

EMPTY

Constructor Summary

Constructors

Constructor and Description
FolderLookup(DataObject.Container df) Deprecated. Constructs the FolderLookup for given container.
FolderLookup(DataObject.Container df, String prefix) Deprecated. Constructs the FolderLookup for given container.

Method Summary

Modifier and Type	Method and Description
protected InstanceCookie	acceptContainer(DataObject.Container df) Deprecated. Container is recognized as underlying FolderLookup which passes its items to parent FolderLookup.
protected InstanceCookie	acceptFolder(DataFolder df) Deprecated. Folder is recognized as underlying FolderLookup which passes its items to parent FolderLookup.
protected Object	createInstance(InstanceCookie[] cookies) Deprecated. Updates the content of the lookup.
Lookup	getLookup() Deprecated. Getter for the lookup that should be used.
Class<?>	instanceClass() Deprecated. The correct class that this folder recognizes.
protected Object	instanceForCookie(DataObject dobj, InstanceCookie cookie) Deprecated. Overrides superclass method.
protected Task	postCreationTask(Runnable run) Deprecated. Starts the creation of the object in the Folder recognizer thread.

Methods inherited from class org.openide.loaders.FolderInstance

acceptCookie, acceptDataObject, instanceCreate, instanceFinished, instanceName, recreate, run, toString, waitFinished

Methods inherited from class org.openide.util.Task

addTaskListener, isFinished, notifyFinished, notifyRunning, removeTaskListener, waitFinished

Methods inherited from class java.lang.Object

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

Constructor Detail

FolderLookup

public FolderLookup(DataObject.Container df)

Deprecated.

Constructs the FolderLookup for given container. A default ID prefix is used for identification of located items.

Parameters:

df - container (or folder) to work on

FolderLookup

public FolderLookup(DataObject.Container df,
                    String prefix)

Deprecated.

Constructs the FolderLookup for given container.

Parameters:

df - container (or folder) to work on

prefix - the prefix to use

Method Detail

instanceClass

public final Class<?> instanceClass()

Deprecated.

The correct class that this folder recognizes.

Specified by:

instanceClass in interface InstanceCookie

Overrides:

instanceClass in class FolderInstance

Returns:

Proxy.Lkp class.

getLookup

public final Lookup getLookup()

Deprecated.

Getter for the lookup that should be used.

Serializable since 3.27.

Returns:

a lookup

createInstance

protected final Object createInstance(InstanceCookie[] cookies)
                               throws IOException,
                                      ClassNotFoundException

Deprecated.

Updates the content of the lookup.

Specified by:

createInstance in class FolderInstance

Parameters:

cookies - updated array of instance cookies for the folder

Returns:

object to represent these cookies

Throws:

IOException - an I/O error occured

ClassNotFoundException - a class has not been found

instanceForCookie

protected Object instanceForCookie(DataObject dobj,
                                   InstanceCookie cookie)
                            throws IOException,
                                   ClassNotFoundException

Deprecated.

Overrides superclass method. It returns instance for DataObject&InstanceCookie 'pair'. If the instance is of FolderLookup.Lkp class it is created otherwise new Lkp.ICItem created and returned.

Overrides:

instanceForCookie in class FolderInstance

Parameters:

dobj - the data object that is the source of the cookie

cookie - the instance cookie to read the instance from

Throws:

IOException - when there I/O error

ClassNotFoundException - if the class cannot be found

acceptFolder

protected InstanceCookie acceptFolder(DataFolder df)

Deprecated.

Folder is recognized as underlying FolderLookup which passes its items to parent FolderLookup.

Overrides:

acceptFolder in class FolderInstance

Parameters:

df - the folder found

Returns:

new FolderLookup

acceptContainer

protected InstanceCookie acceptContainer(DataObject.Container df)

Deprecated.

Container is recognized as underlying FolderLookup which passes its items to parent FolderLookup.

Overrides:

acceptContainer in class FolderInstance

Parameters:

df - the container found

Returns:

new FolderLookup

postCreationTask

protected final Task postCreationTask(Runnable run)

Deprecated.

Starts the creation of the object in the Folder recognizer thread. Doing all the lookup stuff in one thread should prevent deadlocks, but because we call unknown data loaders, they obviously must be implemented in correct way.

Overrides:

postCreationTask in class FolderInstance

Parameters:

run - runable to start

Returns:

null, because the runnable is started immediatelly