org.pentaho.reporting.engine.classic.core
Class GroupList

java.lang.Object
  org.pentaho.reporting.engine.classic.core.GroupList

All Implemented Interfaces:

Serializable, Cloneable

Deprecated. The group-list is a legacy class and should not be used outside the legacy handling.

public class GroupList
extends Object
implements Cloneable, Serializable

The group list is used to store groups in a ordered way. The less specific groups are guaranteed to be listed before the more specific subgroups.

Groups are ordered by comparing the declared fieldnames for the groups. A subgroup of an group must contain all fields from its parent plus at least one new field.

This implementation is not synchronized.

The group list cannot be empty. JFreeReport needs at least one group instance to work as expected. By default, this default instance does not define any fields (and therefore contains the complete report) and has no Bands defined (rendering it invisible). You cannot remove that group. Every attempt to remove the last group will recreates a new default group.

As of version 0.8.10, this list only exists for the support for the legacy parsing.

Author:

Thomas Morgner

See Also:

Serialized Form

Field Summary

static String

DEFAULT_GROUP_NAME Deprecated. The name of the automaticly created default group.

Constructor Summary

GroupList()
Deprecated. Constructs a new group list, with only a default group inside.

Method Summary

void	add(RelationalGroup o) Deprecated. Adds a group to the list.
void	addAll(Collection c) Deprecated. Adds all groups of the collection to this group list.
void	clear() Deprecated. Clears the list.
Object	clone() Deprecated. Clones the group list and all contained groups.
Group	constructRootGroup() Deprecated. Creates a hierarchical group structure and moves the data group body to the inner most group.
Group	get(int i) Deprecated. Returns the group at a given position in the list.
Group	getGroupByName(String name) Deprecated. Searches a group by its defined name.
Iterator	iterator() Deprecated. Returns an iterator for the groups of the list.
boolean	remove(RelationalGroup o) Deprecated. Removes an group from the list.
int	size() Deprecated. Returns the number of groups in the list.
String	toString() Deprecated. Returns a string representation of the list (useful for debugging).

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_GROUP_NAME

public static final String DEFAULT_GROUP_NAME

Deprecated.

The name of the automaticly created default group.

See Also:

Constant Field Values

Constructor Detail

GroupList

public GroupList()

Deprecated.

Constructs a new group list, with only a default group inside.

Method Detail

get

public Group get(int i)

Deprecated.

Returns the group at a given position in the list.

Parameters:

i - the position index (zero-based).

Returns:

the report group.

remove

public boolean remove(RelationalGroup o)

Deprecated.

Removes an group from the list.

Parameters:

o - the group that should be removed.

Returns:

a boolean indicating whether or not the object was removed.

Throws:

NullPointerException - if the given group object is null.

clear

public void clear()

Deprecated.

Clears the list.

add

public void add(RelationalGroup o)

Deprecated.

Adds a group to the list.

Parameters:

o - the group object.

addAll

public void addAll(Collection c)

Deprecated.

Adds all groups of the collection to this group list. This method will result in a ClassCastException if the collection does not contain Group objects.

Parameters:

c - the collection that contains the groups.

Throws:

NullPointerException - if the given collection is null.

ClassCastException - if the collection does not contain groups.

clone

public Object clone()
             throws CloneNotSupportedException

Deprecated.

Clones the group list and all contained groups.

Overrides:

clone in class Object

Returns:

a clone of this list.

Throws:

CloneNotSupportedException - if cloning the element failed.

See Also:

Cloneable

iterator

public Iterator iterator()

Deprecated.

Returns an iterator for the groups of the list.

Returns:

An iterator over all groups of the list.

size

public int size()

Deprecated.

Returns the number of groups in the list.

Returns:

The number of groups in the list.

toString

public String toString()

Deprecated.

Returns a string representation of the list (useful for debugging).

Overrides:

toString in class Object

Returns:

A string.

getGroupByName

public Group getGroupByName(String name)

Deprecated.

Searches a group by its defined name. This method returns null, if the group was not found.

Parameters:

name - the name of the group.

Returns:

the group or null if not found.

constructRootGroup

public Group constructRootGroup()

Deprecated.

Creates a hierarchical group structure and moves the data group body to the inner most group. This method is only guaranteed to work correctly if there is exactly one data-group.

Returns:

the constructed group.