tripleplay.util

Class DestroyableBag

java.lang.Object

tripleplay.util.DestroyableBag

public class DestroyableBag
extends Object

Maintains a bag of Destroyable instances which can all be cleared at once. This is useful for tracking connections and other managed resources on a screen and then clearing them all at once when the screen is hidden or removed.

Constructor Summary

Constructors

Constructor and Description
DestroyableBag()

Method Summary

Modifier and Type	Method and Description
DestroyableBag	add(react.Connection conn) Adds conn to this bag.
DestroyableBag	add(Connection conn) Adds conn to this bag.
DestroyableBag	add(Destroyable dable) Adds dable to this bag.
DestroyableBag	add(Layer layer) Adds layer to this bag.
void	clear() Destroys all destroyables in this bag and clears its contents.
boolean	remove(Destroyable dable) Removes, and does not destroy, dable from this bag.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DestroyableBag

public DestroyableBag()

Method Detail

add

public DestroyableBag add(Destroyable dable)

Adds dable to this bag. No check is made to see if dable is already in the bag. If you add something twice, it gets destroyed twice, so don't do that.

add

public DestroyableBag add(Layer layer)

Adds layer to this bag. Layer.destroy() will be called on destruction.

add

public DestroyableBag add(react.Connection conn)

Adds conn to this bag. disconnect will be called on destruction.

add

public DestroyableBag add(Connection conn)

Adds conn to this bag. disconnect will be called on destruction.

remove

public boolean remove(Destroyable dable)

Removes, and does not destroy, dable from this bag.

Returns:

true if dable was found and removed from the bag, false if it was not in the bag.

clear

public void clear()

Destroys all destroyables in this bag and clears its contents.

Throws:

react.MultiFailureException - containing one or more exceptions if any destroyable throws an exception while being destroyed. destroy will always be called on all destroyables regardless of whether any throw an exception.