/**
* Check a received value for basic problems before passing it on to the sample mechanism
*
* @param value Value as received from network layer
* @return Value to be used for archive
*/
private VType checkReceivedValue(VType value) {
if (value instanceof Time) {
try {
final Time time = (Time) value;
// Invoke time.getTimestamp() to detect RuntimeError in VType 2013/11/01
if (time.isTimeValid() && time.getTimestamp() != null) return value;
else {
trouble_sample_log.log("'" + getName() + "': Invalid time stamp ");
value = VTypeHelper.transformTimestamp(value, Timestamp.now());
}
} catch (RuntimeException ex) {
Logger.getLogger(getClass().getName())
.log(Level.WARNING, "'" + getName() + "': Exception getting time stamp", ex);
value = VTypeHelper.transformTimestamp(value, Timestamp.now());
}
} else trouble_sample_log.log("'" + getName() + "': Received no time information for " + value);
return value;
}
/**
* Represents the connection payload, which consists of the actual JCA Channel and the JCADataSource
* (which can be used to extract configuration parameters).
*
* @author carcassi
*/
public class JCAConnectionPayload {
private final JCADataSource jcaDataSource;
private final Channel channel;
private final boolean connected;
private final boolean longString;
private final DBRType fieldType;
private final Timestamp eventTime = Timestamp.now();
public JCAConnectionPayload(
JCAChannelHandler channleHandler, Channel channel, JCAConnectionPayload previousPayload) {
this.jcaDataSource = channleHandler.getJcaDataSource();
this.channel = channel;
this.connected =
channel != null && channel.getConnectionState() == Channel.ConnectionState.CONNECTED;
this.longString = channleHandler.isLongString();
if (channel.getFieldType().getClass() == null && previousPayload != null) {
// JNI sets the type to unknown on disconnect. We need
// to remember the type before the disconnection
this.fieldType = previousPayload.fieldType;
} else {
this.fieldType = channel.getFieldType();
}
}
/**
* The JCADataSource that is using the channel.
*
* @return the JCA data source
*/
public JCADataSource getJcaDataSource() {
return jcaDataSource;
}
/**
* The JCA channel.
*
* @return JCA channel
*/
public Channel getChannel() {
return channel;
}
public DBRType getFieldType() {
return fieldType;
}
/**
* True if the channel is not null and the connection state is connected.
*
* @return ture if channel exists and is connected
*/
public boolean isChannelConnected() {
return connected;
}
/**
* True if the channel is not null, connected, and can be written to.
*
* @return true if the channel is ready for write
*/
public boolean isWriteConnected() {
return isChannelConnected() && channel.getWriteAccess();
}
/**
* Whether the message payload should be handled as a long string.
*
* @return true if long string support should be used
*/
public boolean isLongString() {
return longString;
}
/**
* Returns the local time of the connection event.
*
* @return client connection/disconnection time
*/
public Timestamp getEventTime() {
return eventTime;
}
@Override
public String toString() {
return "JCAConnection [connected: "
+ isChannelConnected()
+ " writeConnected: "
+ isWriteConnected()
+ " channel: "
+ channel
+ "]";
}
}