com.telestax.core

Class GenericObjectList

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.AbstractSequentialList<E>

java.util.LinkedList<GenericObject>

com.telestax.core.GenericObjectList

All Implemented Interfaces:

Serializable, Cloneable, Iterable<GenericObject>, Collection<GenericObject>, Deque<GenericObject>, List<GenericObject>, Queue<GenericObject>

Direct Known Subclasses:

NetObjectList, SDPObjectList, SIPObjectList

public abstract class GenericObjectList
extends LinkedList<GenericObject>
implements Serializable, Cloneable

Implements a homogenous consistent linked list. All the objects in the linked list must derive from the same root class. This is a useful constraint to place on our code as this property is invariant.The list is created with the superclass which can be specified as either a class name or a Class.

Version:

1.2

Author:

M. Ranganathan

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	AND
protected static String	AT
protected static String	COLON
protected static String	COMMA
protected static String	DOT
protected static String	DOUBLE_QUOTE
protected static String	EQUALS
protected static String	GREATER_THAN
protected static String	HT
protected int	indentation
protected static String	LESS_THAN
protected String	listName
protected static String	LPAREN
protected Class<?>	myClass
protected static String	NEWLINE
protected static String	PERCENT
protected static String	POUND
protected static String	QUESTION
protected static String	QUOTE
protected static String	RETURN
protected static String	RPAREN
protected static String	SEMICOLON
protected static String	SLASH
protected static String	SP
protected static String	STAR

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	GenericObjectList()
protected	GenericObjectList(String lname)
protected	GenericObjectList(String lname, Class objclass) A Constructor which takes a list name and a class (for assertion checking).
protected	GenericObjectList(String lname, String classname) A Constructor which takes a list name and a class name (for assertion checking).

Method Summary

Methods

Modifier and Type	Method and Description
void	addFirst(GenericObject objToAdd)
Object	clone() Makes a deep clone of this list.
protected void	concatenate(GenericObjectList objList) Concatenate two compatible header lists, adding the argument to the tail end of this list.
protected void	concatenate(GenericObjectList objList, boolean topFlag) Concatenate two compatible header lists, adding the argument either to the beginning or the tail end of this list.
String	debugDump() Convert this list of headers to a formatted string.
String	debugDump(int indent) Convert this list of headers to a string (for printing) with an indentation given.
String	encode() Encode the list in semicolon separated form.
boolean	equals(Object other) Equality checking predicate.
protected GenericObject	first() This is the default list iterator.This will not handle nested list traversal.
protected String	getIndentation()
int	hashCode() Hash code.
protected static boolean	isCloneable(Object obj) Return true if this supports reflection based cloning.
static boolean	isMySubclass(Class<?> other)
boolean	match(Object other) Match with a template (return true if we have a superset of the given template.
void	mergeObjects(GenericObjectList mergeList) Do a merge of the GenericObjects contained in this list with the GenericObjects in the mergeList.
protected GenericObject	next() Fetch the next object from the list based on the default list iterator
protected GenericObject	next(ListIterator iterator) Traverse the list given a list iterator
void	setMyClass(Class cl)
String	toString() Alias for the encode function above.

Methods inherited from class java.util.LinkedList

add, add, addAll, addAll, addLast, clear, contains, descendingIterator, element, get, getFirst, getLast, indexOf, lastIndexOf, listIterator, offer, offerFirst, offerLast, peek, peekFirst, peekLast, poll, pollFirst, pollLast, pop, push, remove, remove, remove, removeFirst, removeFirstOccurrence, removeLast, removeLastOccurrence, set, size, toArray, toArray

Methods inherited from class java.util.AbstractSequentialList

iterator

Methods inherited from class java.util.AbstractList

listIterator, removeRange, subList

Methods inherited from class java.util.AbstractCollection

containsAll, isEmpty, removeAll, retainAll

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.List

containsAll, isEmpty, iterator, listIterator, removeAll, retainAll, subList

Methods inherited from interface java.util.Deque

iterator

Field Detail

SEMICOLON

protected static final String SEMICOLON

See Also:

Constant Field Values

COLON

protected static final String COLON

See Also:

Constant Field Values

COMMA

protected static final String COMMA

See Also:

Constant Field Values

SLASH

protected static final String SLASH

See Also:

Constant Field Values

SP

protected static final String SP

See Also:

Constant Field Values

EQUALS

protected static final String EQUALS

See Also:

Constant Field Values

STAR

protected static final String STAR

See Also:

Constant Field Values

NEWLINE

protected static final String NEWLINE

See Also:

Constant Field Values

RETURN

protected static final String RETURN

See Also:

Constant Field Values

LESS_THAN

protected static final String LESS_THAN

See Also:

Constant Field Values

GREATER_THAN

protected static final String GREATER_THAN

See Also:

Constant Field Values

AT

protected static final String AT

See Also:

Constant Field Values

DOT

protected static final String DOT

See Also:

Constant Field Values

QUESTION

protected static final String QUESTION

See Also:

Constant Field Values

POUND

protected static final String POUND

See Also:

Constant Field Values

AND

protected static final String AND

See Also:

Constant Field Values

LPAREN

protected static final String LPAREN

See Also:

Constant Field Values

RPAREN

protected static final String RPAREN

See Also:

Constant Field Values

DOUBLE_QUOTE

protected static final String DOUBLE_QUOTE

See Also:

Constant Field Values

QUOTE

protected static final String QUOTE

See Also:

Constant Field Values

HT

protected static final String HT

See Also:

Constant Field Values

PERCENT

protected static final String PERCENT

See Also:

Constant Field Values

indentation

protected int indentation

listName

protected String listName

myClass

protected Class<?> myClass

Constructor Detail

GenericObjectList

protected GenericObjectList()

GenericObjectList

protected GenericObjectList(String lname)

GenericObjectList

protected GenericObjectList(String lname,
                 String classname)

A Constructor which takes a list name and a class name (for assertion checking).

GenericObjectList

protected GenericObjectList(String lname,
                 Class objclass)

A Constructor which takes a list name and a class (for assertion checking).

Method Detail

getIndentation

protected String getIndentation()

isCloneable

protected static boolean isCloneable(Object obj)

Return true if this supports reflection based cloning.

isMySubclass

public static boolean isMySubclass(Class<?> other)

clone

public Object clone()

Makes a deep clone of this list.

Overrides:

clone in class LinkedList<GenericObject>

setMyClass

public void setMyClass(Class cl)

next

protected GenericObject next(ListIterator iterator)

Traverse the list given a list iterator

first

protected GenericObject first()

This is the default list iterator.This will not handle nested list traversal.

next

protected GenericObject next()

Fetch the next object from the list based on the default list iterator

concatenate

protected void concatenate(GenericObjectList objList)

Concatenate two compatible header lists, adding the argument to the tail end of this list.

Type Parameters:

var - topFlag set to true to add items to top of list

concatenate

protected void concatenate(GenericObjectList objList,
               boolean topFlag)

Concatenate two compatible header lists, adding the argument either to the beginning or the tail end of this list. A type check is done before concatenation.

Type Parameters:

var - topFlag set to true to add items to top of list else add them to the tail end of the list.

debugDump

public String debugDump()

Convert this list of headers to a formatted string.

debugDump

public String debugDump(int indent)

Convert this list of headers to a string (for printing) with an indentation given.

addFirst

public void addFirst(GenericObject objToAdd)

Specified by:

addFirst in interface Deque<GenericObject>

Overrides:

addFirst in class LinkedList<GenericObject>

mergeObjects

public void mergeObjects(GenericObjectList mergeList)

Do a merge of the GenericObjects contained in this list with the GenericObjects in the mergeList. Note that this does an inplace modification of the given list. This does an object by object merge of the given objects.

Parameters:

mergeList - is the list of Generic objects that we want to do an object by object merge with. Note that no new objects are added to this list.

encode

public String encode()

Encode the list in semicolon separated form.

Returns:

an encoded string containing the objects in this list.

Since:

v1.0

toString

public String toString()

Alias for the encode function above.

Overrides:

toString in class AbstractCollection<GenericObject>

hashCode

public int hashCode()

Hash code. We never expect to put this in a hash table so return a constant.

Specified by:

hashCode in interface Collection<GenericObject>

Specified by:

hashCode in interface List<GenericObject>

Overrides:

hashCode in class AbstractList<GenericObject>

equals

public boolean equals(Object other)

Equality checking predicate.

Specified by:

equals in interface Collection<GenericObject>

Specified by:

equals in interface List<GenericObject>

Overrides:

equals in class AbstractList<GenericObject>

Parameters:

other - is the object to compare ourselves to.

Returns:

true if the objects are equal.

match

public boolean match(Object other)

Match with a template (return true if we have a superset of the given template. This can be used for partial match (template matching of SIP objects). Note -- this implementation is not unnecessarily efficient :-)

Parameters:

other - template object to compare against.