com.aquenos.epics.jackie.common.value

Interface ChannelAccessControlsFloat

All Superinterfaces:

ChannelAccessAlarmFloat, ChannelAccessAlarmValue<java.lang.Float>, ChannelAccessControlsValue<java.lang.Float>, ChannelAccessFloat, ChannelAccessFloatingPointControlsValue<java.lang.Float>, ChannelAccessFloatingPointGraphicsValue<java.lang.Float>, ChannelAccessGettableValue<java.lang.Float>, ChannelAccessGraphicsFloat, ChannelAccessGraphicsValue<java.lang.Float>, ChannelAccessNumericControlsValue<java.lang.Float>, ChannelAccessNumericGraphicsValue<java.lang.Float>, ChannelAccessValue<java.lang.Float>, java.lang.Cloneable, java.lang.Iterable<java.lang.Float>

public interface ChannelAccessControlsFloat
extends ChannelAccessGraphicsFloat, ChannelAccessFloatingPointControlsValue<java.lang.Float>

Channel Access values that represents the DBR_CTRL_FLOAT type. This type stores single-precision floating-point numbers and provides information about the alarm status, engineering units, display precision, and alarm, control, and display limits.

This interface should not be implemented by user-defined classes. Code that wants to create an instance implementing this interface should use the methods provided by ChannelAccessValueFactory instead.

Author:

Sebatian Marsching

Method Summary

Modifier and Type	Method and Description
ChannelAccessControlsFloat	asReadOnlyValue() Returns a read-only version of this value.
ChannelAccessControlsFloat	clone() Creates and returns a copy of this object.
float	getLowerControlLimit() Returns the lower control limit.
float	getUpperControlLimit() Returns the upper control limit.
void	setLowerControlLimit(float lowerControlLimit) Sets the lower control limit.
void	setUpperControlLimit(float upperControlLimit) Sets the upper control limit.

Methods inherited from interface com.aquenos.epics.jackie.common.value.ChannelAccessGraphicsFloat

getLowerAlarmLimit, getLowerDisplayLimit, getLowerWarningLimit, getUpperAlarmLimit, getUpperDisplayLimit, getUpperWarningLimit, setLowerAlarmLimit, setLowerDisplayLimit, setLowerWarningLimit, setUpperAlarmLimit, setUpperDisplayLimit, setUpperWarningLimit

Methods inherited from interface com.aquenos.epics.jackie.common.value.ChannelAccessFloat

getValue, setValue

Methods inherited from interface com.aquenos.epics.jackie.common.value.ChannelAccessFloatingPointGraphicsValue

getPrecision, setPrecision

Methods inherited from interface com.aquenos.epics.jackie.common.value.ChannelAccessNumericControlsValue

getGenericLowerControlLimit, getGenericUpperControlLimit

Methods inherited from interface com.aquenos.epics.jackie.common.value.ChannelAccessNumericGraphicsValue

getGenericLowerAlarmLimit, getGenericLowerDisplayLimit, getGenericLowerWarningLimit, getGenericUpperAlarmLimit, getGenericUpperDisplayLimit, getGenericUpperWarningLimit, getRawUnits, getUnits, setRawUnits, setUnits

Methods inherited from interface com.aquenos.epics.jackie.common.value.ChannelAccessGraphicsValue

getCharset

Methods inherited from interface com.aquenos.epics.jackie.common.value.ChannelAccessAlarmValue

getAlarmSeverity, getAlarmStatus, setAlarmSeverity, setAlarmStatus

Methods inherited from interface com.aquenos.epics.jackie.common.value.ChannelAccessValue

equals, getGenericValueElement, getType, getValueSize, hashCode, isReadOnly, iterator, toString

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Method Detail

getUpperControlLimit

float getUpperControlLimit()

Returns the upper control limit. The upper control limit is the upper limit that the server enforces on values. Typically, this means that the process variable cannot be set to a value that is greater than this limit. A value of zero typically indicates that the limit has not been configured and thus should not be used.

Returns:

upper control limit.

setUpperControlLimit

void setUpperControlLimit(float upperControlLimit)

Sets the upper control limit. The upper control limit is the upper limit that the server enforces on values. Typically, this means that the process variable cannot be set to a value that is greater than this limit. A value of zero typically indicates that the limit has not been configured and thus should not be used.

Parameters:

upperControlLimit - upper control limit.

Throws:

java.lang.UnsupportedOperationException - if this value is read-only (ChannelAccessValue.isReadOnly() returns true).

getLowerControlLimit

float getLowerControlLimit()

Returns the lower control limit. The lower control limit is the lower limit that the server enforces on values. Typically, this means that the process variable cannot be set to a value that is less than this limit. A value of zero typically indicates that the limit has not been configured and thus should not be used.

Returns:

lower control limit.

setLowerControlLimit

void setLowerControlLimit(float lowerControlLimit)

Sets the lower control limit. The lower control limit is the lower limit that the server enforces on values. Typically, this means that the process variable cannot be set to a value that is less than this limit. A value of zero typically indicates that the limit has not been configured and thus should not be used.

Parameters:

lowerControlLimit - lower control limit.

Throws:

java.lang.UnsupportedOperationException - if this value is read-only (ChannelAccessValue.isReadOnly() returns true).

asReadOnlyValue

ChannelAccessControlsFloat asReadOnlyValue()

Returns a read-only version of this value. If the value is read-only, this value is returned. Otherwise, a wrapped version of this value, that does not allow modifications is returned.

Please note that the read-only value is not a copy of this value, but just a wrapper around it. This means, that modifications of the wrapped value will result in modifications of the read-only value. Therefore it is bad practice to modify a value that has been used as the base for a read-only value, because code that still has a reference to the read-only value might not expect this change and thus fail unexpectedly.

Specified by:

asReadOnlyValue in interface ChannelAccessAlarmFloat

Specified by:

asReadOnlyValue in interface ChannelAccessAlarmValue<java.lang.Float>

Specified by:

asReadOnlyValue in interface ChannelAccessControlsValue<java.lang.Float>

Specified by:

asReadOnlyValue in interface ChannelAccessFloat

Specified by:

asReadOnlyValue in interface ChannelAccessFloatingPointControlsValue<java.lang.Float>

Specified by:

asReadOnlyValue in interface ChannelAccessFloatingPointGraphicsValue<java.lang.Float>

Specified by:

asReadOnlyValue in interface ChannelAccessGettableValue<java.lang.Float>

Specified by:

asReadOnlyValue in interface ChannelAccessGraphicsFloat

Specified by:

asReadOnlyValue in interface ChannelAccessGraphicsValue<java.lang.Float>

Specified by:

asReadOnlyValue in interface ChannelAccessNumericControlsValue<java.lang.Float>

Specified by:

asReadOnlyValue in interface ChannelAccessNumericGraphicsValue<java.lang.Float>

Specified by:

asReadOnlyValue in interface ChannelAccessValue<java.lang.Float>

Returns:

read-only version of this value (never null).

clone

ChannelAccessControlsFloat clone()

Creates and returns a copy of this object. The object returned is completely independent from this object. This means that modifications to this object will not affect the returned object and vice-versa.

The object returned is guaranteed to be completely identical to this object, including its type. This means that x.clone().equals(x) and x.clone().getClass() == x.getClass() are always true.

The returned value is guaranteed to allow write access, even if this value is read-only. This means that cloning a read-only value is a good way to get a writable copy.

Specified by:

clone in interface ChannelAccessAlarmFloat

Specified by:

clone in interface ChannelAccessAlarmValue<java.lang.Float>

Specified by:

clone in interface ChannelAccessControlsValue<java.lang.Float>

Specified by:

clone in interface ChannelAccessFloat

Specified by:

clone in interface ChannelAccessFloatingPointControlsValue<java.lang.Float>

Specified by:

clone in interface ChannelAccessFloatingPointGraphicsValue<java.lang.Float>

Specified by:

clone in interface ChannelAccessGettableValue<java.lang.Float>

Specified by:

clone in interface ChannelAccessGraphicsFloat

Specified by:

clone in interface ChannelAccessGraphicsValue<java.lang.Float>

Specified by:

clone in interface ChannelAccessNumericControlsValue<java.lang.Float>

Specified by:

clone in interface ChannelAccessNumericGraphicsValue<java.lang.Float>

Specified by:

clone in interface ChannelAccessValue<java.lang.Float>

Returns:

a clone of this instance.