Package jmri

Class Category

java.lang.Object

jmri.Category

All Implemented Interfaces:

Comparable<Category>

Direct Known Subclasses:

Category.Other, LogixNG_Category

public abstract class Category
extends Object
implements Comparable<Category>

A category of something.

Category was created for LogixNG actions and expressions but it can be used for everything in JMRI that needs "extendable enums".

This class is intended to be an Enum, but implemented as an abstract class to allow adding more categories later without needing to change this class. For example, external programs using JMRI as a lib might want to add their own categories.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	Category.Other

Field Summary

Fields

Modifier and Type	Field	Description
static final Category.Other	OTHER	Other things.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Category(String name, String description, int order)

Method Summary

Modifier and Type	Method	Description
final int	compareTo(Category c)
final boolean	equals(Object o)
final int	hashCode()
final String	name()
final int	order()
static Category	registerCategory(Category category)	Register a category.
final String	toString()
static List<Category>	values()	Get all the registered Categories

Methods inherited from class java.lang.Object

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

Field Details

OTHER

public static final Category.Other OTHER

Other things.

Constructor Details

Category

protected Category(String name,
 String description,
 int order)

Method Details

values

public static List<Category> values()

Get all the registered Categories

Returns:

a list of categories

registerCategory

public static Category registerCategory(Category category)
                                 throws IllegalArgumentException

Register a category. There must not exist any category with either the name or the description of this category. Otherwise an IllegalArgumentException will be thrown.

Parameters:

category - the category

Returns:

the new category

Throws:

IllegalArgumentException - if the category already is registered.

name

public final String name()

toString

public final String toString()

Overrides:

toString in class Object

order

public final int order()

equals

public final boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public final int hashCode()

Overrides:

hashCode in class Object

compareTo

public final int compareTo(Category c)

Specified by:

compareTo in interface Comparable<Category>