stella.globals

Class RankProvider

java.lang.Object

util.PropertyContainer

util.PropertyResources

globals.parameter.AbstractParameter

stella.globals.AbstractTargetParameter

stella.globals.AbstractTargetValue

stella.globals.RankProvider

All Implemented Interfaces:

Parameter, TargetDependingParameter, Value, Cloneable, ErrorDependingParameter, TargetDependingValue, TargetDepending, ExitCleaning, Initializable, PropertySupplying, ResourceSupplying

public class RankProvider
extends AbstractTargetValue
implements ErrorDependingParameter

A frame provider is a parameter that defines a certain rectangluar areas, normally depending on target picked and/or error received. This frame could be a read-out frasme on a CCD, but also a frame defining a useful area or a frame defining a moments-area.

Nested Class Summary

Nested classes/interfaces inherited from class util.PropertyResources

PropertyResources.Load, PropertyResources.URLResource

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFNAME Default name of this parameter.
private Integer	defrank This is the default frame size or null if undefined.
private Map<Object,Map<Class<? extends ErrorEvent>,Integer>>	errors This lookup-table links target types to lookups of error to frames .
static String	KEY_DEFAULTRANK This is the default frame, prior to target registering.
static String	KEY_LISTENFOR We ignore all errors not in this list.
static String	KEY_MESSAGETABLE This keys links the combined target type plus error to frames .
static String	KEY_TARGETTABLE This key links target types to frame entries.
private Class<? extends ErrorEvent>	lasterror Last error event recorded after target registering.
private Object	lasttype Last target type registered.
private List<Class<? extends ErrorEvent>>	listen We only listen to these errors.
private Map<Object,Integer>	targets This lookup-table links target types to frames.
static char	TYPEERRORSEPARATOR This char separates the target type from the error class name in prop.

Fields inherited from class stella.globals.AbstractTargetParameter

KEY_INDEX

Fields inherited from class globals.parameter.AbstractParameter

KEY_FORMAT, KEY_NAME, KEY_PRESERVE, UNKNOWN

Fields inherited from class util.PropertyResources

KEY_NOINITONCREATE, POSTFIX_ALPHABET, POSTFIX_BYTES, POSTFIX_DIR, POSTFIX_EXT, POSTFIX_FILE, POSTFIX_LIST, POSTFIX_MODTIME, POSTFIX_URL

Fields inherited from class util.PropertyContainer

KEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATOR

Fields inherited from interface stella.ErrorDependingParameter

NAMING_EXTENSION

Fields inherited from interface util.PropertySupplying

CONFIG, KEY_CLASS

Fields inherited from interface util.ResourceSupplying

KEY_URLRESOURCES, KEY_URLUSECONFIG, KEY_URLUSECURRENT, KEY_URLUSEHOME

Constructor Summary

Constructors

Constructor and Description
RankProvider(Map<String,String> prop) We start by constructing all the lookup-tables in the init section.

Method Summary

Modifier and Type	Method and Description
Number	getForError(ErrorEvent ee) Returns the sub-frame of the currently registered target that would be active on the specified error.
Number	getForTarget(TargetDefinition td) Returns the frame that would be used with the stated target, no error class can be specified.
private Integer	getRank(Object type, Class<? extends ErrorEvent> ee) Returns the subframe for a given target type and a specified errror.
Number	getValue() After registering of targets and possible erros, we can produce a frame.
void	init() On init, we parse the default rectangle and try to construct all the lookup tables.
private Map<String,Integer>	parseToInteger(String s) We parse a properties mapping to a string-to-rectangle mapping.
void	registerError(ErrorEvent ee) Registers the error.
void	registerTarget(TargetDefinition td) Registers the target, clears the error received.
Number	setValue(Number o) Not allowed.

Methods inherited from class stella.globals.AbstractTargetValue

get, set

Methods inherited from class stella.globals.AbstractTargetParameter

getAsStar, getConstant, getFormattedFor, getSetup

Methods inherited from class globals.parameter.AbstractParameter

createParameter, delivers, exit, getFormatted, getFormatted, getName, getPreserveFile, getString, getString, overrideDefaultName, register, rescanned, setName, toString

Methods inherited from class util.PropertyResources

clone, createFrom, createFrom, createFrom, createInstance, getApplet, getAsResources, getLocate, getPropertiesToKey, getPropertiesToKey, getResource, getResourceAsStream, getResourceFromKey, getResources, hasLocalURLs, initProperties, keyCreate, keyCreate, reload, setApplet

Methods inherited from class util.PropertyContainer

augment, augment, augment, augment, augment, defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsEnums, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, isNew, parseObject, parseObject, reload, removeProperty, requires, setObject, setProperties, setProperty, stringProperties

Methods inherited from class java.lang.Object

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

Methods inherited from interface globals.Parameter

get, getFormatted, getName, getString, set

Methods inherited from interface util.PropertySupplying

defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, parseObject, removeProperty, setObject, setProperty, stringProperties

Methods inherited from interface globals.TargetDependingParameter

getFormattedFor

Field Detail

TYPEERRORSEPARATOR

public static final char TYPEERRORSEPARATOR

This char separates the target type from the error class name in prop.

See Also:

Constant Field Values

KEY_LISTENFOR

public static final String KEY_LISTENFOR

We ignore all errors not in this list.

See Also:

Constant Field Values

KEY_DEFAULTRANK

public static final String KEY_DEFAULTRANK

This is the default frame, prior to target registering.

See Also:

Constant Field Values

KEY_TARGETTABLE

public static final String KEY_TARGETTABLE

This key links target types to frame entries.

See Also:

Constant Field Values

KEY_MESSAGETABLE

public static final String KEY_MESSAGETABLE

This keys links the combined target type plus error to frames .

See Also:

Constant Field Values

DEFNAME

public static final String DEFNAME

Default name of this parameter.

See Also:

Constant Field Values

defrank

private Integer defrank

This is the default frame size or null if undefined.

targets

private Map<Object,Integer> targets

This lookup-table links target types to frames.

errors

private Map<Object,Map<Class<? extends ErrorEvent>,Integer>> errors

This lookup-table links target types to lookups of error to frames .

lasttype

private Object lasttype

Last target type registered.

lasterror

private Class<? extends ErrorEvent> lasterror

Last error event recorded after target registering.

listen

private List<Class<? extends ErrorEvent>> listen

We only listen to these errors.

Constructor Detail

RankProvider

public RankProvider(Map<String,String> prop)

We start by constructing all the lookup-tables in the init section.

Method Detail

init

public void init()
          throws InitException

On init, we parse the default rectangle and try to construct all the lookup tables.

Specified by:

init in interface Initializable

Overrides:

init in class AbstractParameter

Throws:

InitException

registerTarget

public void registerTarget(TargetDefinition td)

Registers the target, clears the error received.

Specified by:

registerTarget in interface TargetDepending

registerError

public void registerError(ErrorEvent ee)

Registers the error.

Specified by:

registerError in interface ErrorDependingParameter

getForTarget

public Number getForTarget(TargetDefinition td)

Returns the frame that would be used with the stated target, no error class can be specified.

Specified by:

getForTarget in interface TargetDependingParameter

Specified by:

getForTarget in interface TargetDependingValue

getForError

public Number getForError(ErrorEvent ee)

Returns the sub-frame of the currently registered target that would be active on the specified error.

Specified by:

getForError in interface ErrorDependingParameter

getValue

public Number getValue()

After registering of targets and possible erros, we can produce a frame.

Specified by:

getValue in interface Value

setValue

public Number setValue(Number o)

Not allowed.

Specified by:

setValue in interface Value

parseToInteger

private Map<String,Integer> parseToInteger(String s)

We parse a properties mapping to a string-to-rectangle mapping.

getRank

private Integer getRank(Object type,
                        Class<? extends ErrorEvent> ee)

Returns the subframe for a given target type and a specified errror. First, the specific look-up table errors is scanned, if that does not produce a hit, the targets table is scanned. If again without hit, the default frame is returned, which still might be null.