oracle.jdeveloper.library
Class JProjectLibraryList

java.lang.Object
  oracle.javatools.data.HashStructureAdapter
      oracle.jdeveloper.library.JProjectLibraryList

All Implemented Interfaces:

Displayable, LibraryList, MutableLibraryList

public final class JProjectLibraryList
extends HashStructureAdapter
implements MutableLibraryList

The JProjectLibraryList class is used to contain Library instances that are defined within the context of a JProject.

Since:

9.0.3

Field Summary

Fields inherited from class oracle.javatools.data.HashStructureAdapter

_hash

Fields inherited from interface oracle.jdeveloper.library.LibraryList

JDK_LIST_PROPERTY, LIB_LIST_PROPERTY, LISTNAME_PROPERTY, TRANSIENT_PROPERTY

Constructor Summary

JProjectLibraryList(HashStructure hash)

Method Summary

JDK	addJDK(java.lang.String name, java.net.URL exeURL) Add a JDK using the given name and based upon the given executble.
JLibrary	addLibrary(java.lang.String name) Add a JLibrary using the given name.
java.lang.Object	createIDFromName(java.lang.String name, boolean isJDK) Create an ID based upon the given name.
JDK	findJDK(java.lang.Object id) Finds the JDK definition that matches the specified name.
JLibrary	findLibrary(java.lang.Object id) Finds the JLibrary that matches the specified id.
javax.swing.Icon	getDefaultIcon() Get the default Icon used for newly created Library instances.
javax.swing.Icon	getIcon() Returns an Icon that can be shown in association with this Displayable.
static JProjectLibraryList	getInstance(HashStructure hash)
java.util.List	getJdkList() Retrieves a List of JDK definitions contained in this LibraryList.
java.util.List	getLibraryList() Retrieves a List of JLibrary definitions contained in this LibraryList.
java.lang.String	getListName() Retrieves the name of this LibraryList.
java.lang.String	getLongLabel() Returns a long label that can be displayed to the user.
java.lang.String	getShortLabel() Returns a short label that can be displayed to the user.
java.lang.String	getToolTipText() Returns the tool tip text to show when the mouse pointer pauses over a UI component that represents this Displayable.
boolean	isTransient() Whether this list is transient (not-persistent).
boolean	remove(Library library) Remove a JDK or JLibrary from the respective list.
void	setJdkList(java.util.List list) Sets a List of JDK definitions contained in this LibraryList.
void	setLibraryList(java.util.List list) Sets a List of JLibrary definitions contained in this LibraryList.
void	setListName(java.lang.String name) Sets the name of this LibraryList.
java.lang.String	toString() Returns the Short Label displayed to a user.

Methods inherited from class oracle.javatools.data.HashStructureAdapter

addStructureChangeListener, containsKey, copyTo, copyToImpl, equals, equalsImpl, findOrCreate, forcedCopyTo, getHashStructure, removeStructureChangeListener, useObjectEquals

Methods inherited from class java.lang.Object

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

Constructor Detail

JProjectLibraryList

public JProjectLibraryList(HashStructure hash)

Method Detail

getInstance

public static JProjectLibraryList getInstance(HashStructure hash)

findJDK

public JDK findJDK(java.lang.Object id)

Description copied from interface: LibraryList

Finds the JDK definition that matches the specified name.

Specified by:

findJDK in interface LibraryList

Parameters:

id - the id of the JDK definition

Returns:

the JDK representing the JDK definition.

findLibrary

public JLibrary findLibrary(java.lang.Object id)

Description copied from interface: LibraryList

Finds the JLibrary that matches the specified id.

Specified by:

findLibrary in interface LibraryList

getJdkList

public java.util.List getJdkList()

Description copied from interface: LibraryList

Retrieves a List of JDK definitions contained in this LibraryList.

Specified by:

getJdkList in interface LibraryList

setJdkList

public void setJdkList(java.util.List list)

Description copied from interface: MutableLibraryList

Sets a List of JDK definitions contained in this LibraryList.

Specified by:

setJdkList in interface MutableLibraryList

getLibraryList

public java.util.List getLibraryList()

Description copied from interface: LibraryList

Retrieves a List of JLibrary definitions contained in this LibraryList.

Specified by:

getLibraryList in interface LibraryList

setLibraryList

public void setLibraryList(java.util.List list)

Description copied from interface: MutableLibraryList

Sets a List of JLibrary definitions contained in this LibraryList.

Specified by:

setLibraryList in interface MutableLibraryList

getListName

public java.lang.String getListName()

Description copied from interface: LibraryList

Retrieves the name of this LibraryList.

Specified by:

getListName in interface LibraryList

setListName

public void setListName(java.lang.String name)

Description copied from interface: MutableLibraryList

Sets the name of this LibraryList.

Specified by:

setListName in interface MutableLibraryList

isTransient

public boolean isTransient()

Description copied from interface: LibraryList

Whether this list is transient (not-persistent). Transient lists cannot have new children created by the user

Specified by:

isTransient in interface LibraryList

addLibrary

public JLibrary addLibrary(java.lang.String name)

Description copied from interface: MutableLibraryList

Add a JLibrary using the given name. If a JLibrary of the same name already exists within the list, the list is left unmodified and null is returned. If a value of null is provided for the name argument, a unique name relative to the list will be generated.

Specified by:

addLibrary in interface MutableLibraryList

Parameters:

name - the name to use for the JLibrary, or null to generate a unique name.

Returns:

a new JLibrary or null if a name collision has resulted.

addJDK

public JDK addJDK(java.lang.String name,
                  java.net.URL exeURL)

Description copied from interface: MutableLibraryList

Add a JDK using the given name and based upon the given executble. If a JDK of the same name already exists within the list, the list is left unmodified and null is returned. If a value of null is provided for the name argument, a unique name relative to the list will be generated.

Specified by:

addJDK in interface MutableLibraryList

Parameters:

name - the name to use for the JDK, or null to generate a unique name.

exeURL - the location of the JDK executable.

Returns:

a new JDK or null if a name collision has resulted.

remove

public boolean remove(Library library)

Description copied from interface: MutableLibraryList

Remove a JDK or JLibrary from the respective list.

Specified by:

remove in interface MutableLibraryList

Parameters:

library - the library to remove.

Returns:

true if the library was contained in the list.

createIDFromName

public java.lang.Object createIDFromName(java.lang.String name,
                                         boolean isJDK)

Description copied from interface: MutableLibraryList

Create an ID based upon the given name. The ID is not necessarily unique.

Specified by:

createIDFromName in interface MutableLibraryList

Parameters:

name - seed from which to produce the ID.

isJDK - true if the ID should apply to a JDK.

Returns:

a library ID.

getShortLabel

public java.lang.String getShortLabel()

Description copied from interface: Displayable

Returns a short label that can be displayed to the user. Generally, the value of the returned String is considered translatable and should therefore be placed in an appropriate resource file. When possible, the returned label should be reasonably short enough to show in the navigator or explorer windows but long enough to clearly identify and distinguish the Displayable.

Specified by:

getShortLabel in interface Displayable

Returns:

a short descriptive label of the Displayable that can be shown to the user.

getLongLabel

public java.lang.String getLongLabel()

Description copied from interface: Displayable

Returns a long label that can be displayed to the user. Generally, the value of the returned String is considered translatable and should therefore be placed in an appropriate resource file. The long label differs from the short label essentially on length. Usually the long label will only be shown on-demand and in places where horizontal space is more available. Examples are the status bar and tooltips.

Specified by:

getLongLabel in interface Displayable

Returns:

a long descriptive label of the Displayable that can be shown to the user.

getIcon

public javax.swing.Icon getIcon()

Description copied from interface: Displayable

Returns an Icon that can be shown in association with this Displayable. Typically the icon will be used in a tree control or list control. Therefore the icon must fit naturally within the space normally given to items within those controls. Such icons are usually 16x16 in size or, if there is a one-pixel transparent padding around the edge, 18x18 in size. It is strongly recommended that icons returned by this method be either 16x16 or 18x18 in size. If null is returned, the control may show a default icon, or it may show no icon, whichever is appropriate.

Specified by:

getIcon in interface Displayable

Returns:

the Icon to be displayed for the Displayable.

getToolTipText

public java.lang.String getToolTipText()

Description copied from interface: Displayable

Returns the tool tip text to show when the mouse pointer pauses over a UI component that represents this Displayable. In many cases it may be appropriate for this method to return the same value as Displayable.getLongLabel().

Specified by:

getToolTipText in interface Displayable

Returns:

the tooltip to show when the mouse pointer pauses over a UI component that represents this Displayable.

toString

public java.lang.String toString()

Description copied from interface: Displayable

Returns the Short Label displayed to a user. This overrides the toString method in java.lang.Object.

Implementors of the Displayable interface should override this as appropriate. The default implementation is the same as getShortLabel

Specified by:

toString in interface Displayable

Overrides:

toString in class java.lang.Object

See Also:

Object.toString(), Displayable.getShortLabel()

getDefaultIcon

public javax.swing.Icon getDefaultIcon()

Description copied from interface: MutableLibraryList

Get the default Icon used for newly created Library instances.

Specified by:

getDefaultIcon in interface MutableLibraryList