com.alee.extended.tree.AsyncUniqueNode Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of weblaf-ui Show documentation
Show all versions of weblaf-ui Show documentation
WebLaf is a Java Swing Look and Feel and extended components library for cross-platform applications
/*
* This file is part of WebLookAndFeel library.
*
* WebLookAndFeel library is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* WebLookAndFeel library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with WebLookAndFeel library. If not, see failedStateIcons = new WeakHashMap ( 5 );
/**
* Default load icon type.
*/
public static LoadIconType loadIconType = LoadIconType.roller;
/**
* Current async node state.
*/
protected AsyncNodeState state = AsyncNodeState.waiting;
/**
* Load icon observer.
*/
protected ImageObserver observer = null;
/**
* Children load failure cause.
*/
protected Throwable failureCause = null;
/**
* Costructs default node.
*/
public AsyncUniqueNode ()
{
super ();
}
/**
* Constructs AsyncUniqueNode with a custom user object.
*
* @param userObject custom user object
*/
public AsyncUniqueNode ( final Object userObject )
{
super ( userObject );
}
/**
* Constructs AsyncUniqueNode with a custom user object and node ID.
*
* @param id node ID
* @param userObject custom user object
*/
public AsyncUniqueNode ( final String id, final Object userObject )
{
super ( id, userObject );
}
/**
* Returns async node state.
*
* @return async node state
*/
public AsyncNodeState getState ()
{
return state;
}
/**
* Returns whether node is in waiting state.
*
* @return true if node is in waiting state, false otherwise
*/
public boolean isWaiting ()
{
return state == AsyncNodeState.waiting;
}
/**
* Returns whether node children are being loaded or not.
*
* @return true if node children are being loaded, false otherwise
*/
public boolean isLoading ()
{
return state == AsyncNodeState.loading;
}
/**
* Returns whether node children are loaded or not.
*
* @return true if node children are loaded, false otherwise
*/
public boolean isLoaded ()
{
return state == AsyncNodeState.loaded;
}
/**
* Returns whether node children load failed or not.
*
* @return true if node children load failed, false otherwise
*/
public boolean isFailed ()
{
return state == AsyncNodeState.failed;
}
/**
* Sets async node state.
* Do not change this value on your own since that might break the tree.
*
* @param state new async node state
*/
public void setState ( final AsyncNodeState state )
{
this.state = state;
}
/**
* Returns children load failure cause.
*
* @return children load failure cause
*/
public Throwable getFailureCause ()
{
return failureCause;
}
/**
* Sets children load failure cause.
*
* @param failureCause children load failure cause
*/
public void setFailureCause ( final Throwable failureCause )
{
this.failureCause = failureCause;
}
@Override
public Icon getIcon ()
{
if ( isLoading () )
{
return getLoadIcon ();
}
else
{
final Icon icon = getNodeIcon ();
return icon != null && isFailed () ? getFailedStateIcon ( icon ) : icon;
}
}
/**
* Returns load icon for this node.
* This icon represents node loading state.
*
* @return load icon
*/
public Icon getLoadIcon ()
{
return loadIconType != null ? loadIconType.getIcon () : null;
}
/**
* Attaches node load icon observer to the specified async tree.
*
* @param tree async tree
*/
public void attachLoadIconObserver ( final WebAsyncTree tree )
{
final Icon icon = getLoadIcon ();
if ( icon != null && icon instanceof ImageIcon )
{
final ImageIcon imageIcon = ( ImageIcon ) icon;
final ImageObserver existing = imageIcon.getImageObserver ();
if ( existing == null )
{
imageIcon.setImageObserver ( new BroadcastImageObserver () );
}
else if ( existing instanceof BroadcastImageObserver )
{
if ( observer == null )
{
observer = new NodeImageObserver ( tree, this );
}
( ( BroadcastImageObserver ) existing ).addObserver ( observer );
}
}
}
/**
* Detaches node load icon observer.
*/
public void detachLoadIconObserver ()
{
if ( observer != null )
{
final Icon icon = getLoadIcon ();
if ( icon != null && icon instanceof ImageIcon )
{
final ImageIcon imageIcon = ( ImageIcon ) icon;
final ImageObserver existing = imageIcon.getImageObserver ();
if ( existing instanceof BroadcastImageObserver )
{
( ( BroadcastImageObserver ) existing ).removeObserver ( observer );
}
}
}
}
/**
* Returns specific icon for this node.
* This icon usually represents node content type or state.
*
* @return specific icon for this node
*/
public abstract Icon getNodeIcon ();
/**
* Returns failed state icon for this node.
*
* @param icon node icon
* @return failed state icon for this node
*/
public Icon getFailedStateIcon ( final Icon icon )
{
Icon failedIcon = failedStateIcons.get ( icon );
if ( failedIcon == null )
{
failedIcon = ImageUtils.mergeIcons ( icon, failedStateIcon );
failedStateIcons.put ( icon, failedIcon );
}
return failedIcon;
}
@Override
public AsyncUniqueNode getParent ()
{
return ( AsyncUniqueNode ) super.getParent ();
}
@Override
public AsyncUniqueNode getChildAt ( final int index )
{
return ( AsyncUniqueNode ) super.getChildAt ( index );
}
}