ElementType
- type of the actual value elements. For primitives, this is the
boxed variant.public interface ChannelAccessPuttableValue<ElementType> extends ChannelAccessValue<ElementType>
Channel Access value that may be sent from a client to a server. Typically,
such a value is sent to update a value on the server with a client-supplied
value. This interface serves as a marker and is implemented by values
implementing ChannelAccessSimpleOnlyValue
,
ChannelAccessAcknowledgeAlarm
, or
ChannelAccessConfigureAcknowledgeTransientAlarms
.
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.
Modifier and Type | Method and Description |
---|---|
ChannelAccessPuttableValue<ElementType> |
asReadOnlyValue()
Returns a read-only version of this value.
|
ChannelAccessPuttableValue<ElementType> |
clone()
Creates and returns a copy of this object.
|
equals, getGenericValueElement, getType, getValueSize, hashCode, isReadOnly, iterator, toString
forEach, spliterator
ChannelAccessPuttableValue<ElementType> 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.
asReadOnlyValue
in interface ChannelAccessValue<ElementType>
null
).ChannelAccessPuttableValue<ElementType> 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.
clone
in interface ChannelAccessValue<ElementType>
Copyright © 2014–2016 aquenos GmbH. All rights reserved.