org.pfsw.file.cfiles

Interface IContainer

All Superinterfaces:

INamedElement, IReleasable

All Known Subinterfaces:

IDirectory, ISubContainer

All Known Implementing Classes:

AbstractContainer, AbstractSubContainer, RootFolder, SubDirectory, WindowsDrive

public interface IContainer
extends INamedElement, IReleasable

A container that holds multiple items.

Method Summary

Modifier and Type	Method and Description
void	addItem(IItem... items) Adds one or more items to this container.
java.util.List<IItem>	getItems() Returns all items of this container.
boolean	isEmpty() Returns whether or not this container contains items.
void	removeItem(IItem... items) Removes one or more items from this container.
int	size() Returns the number of currently contained items;

Methods inherited from interface org.pfsw.file.cfiles.INamedElement

appendNameTo, getName

Methods inherited from interface org.pfsw.bif.lifecycle.IReleasable

release

Method Detail

addItem

void addItem(IItem... items)

Adds one or more items to this container. That implies that the container sets itself as the container of the item.

Parameters:

items - One or more items to be added.

removeItem

void removeItem(IItem... items)

Removes one or more items from this container. If a given item is not in the container, it will be silently ignored. Each item removed will also be detached from this container by calling its IReleasable.release() method.

Parameters:

items - One or more items to be removed.

getItems

java.util.List<IItem> getItems()

Returns all items of this container. This will always be a copy of any internal list representation. That is, manipulating the returned list has no impact on the container's list of elements.

Returns:

A list with all items (maybe empty). Never null.

size

int size()

Returns the number of currently contained items;

Returns:

The number of items in the range of 0 - MAX_INT.

isEmpty

boolean isEmpty()

Returns whether or not this container contains items.

Returns:

true if the container contains at least one item.