org.epics.pvmanager.jca

Class JCADataSource

java.lang.Object

org.epics.pvmanager.DataSource

org.epics.pvmanager.jca.JCADataSource

public class JCADataSource
extends DataSource

A data source that uses jca.

Type support can be configured by passing a custom JCATypeSupport to the constructor.

Author:

carcassi

Constructor Summary

Constructors

Modifier	Constructor and Description
	JCADataSource() Creates a new data source using pure Java implementation and all the defaults described in JCADataSourceBuilder.
	JCADataSource(gov.aps.jca.Context jcaContext, int monitorMask) Deprecated. use JCADataSourceBuilder
	JCADataSource(gov.aps.jca.Context jcaContext, int monitorMask, JCATypeSupport typeSupport) Deprecated. use JCADataSourceBuilder
	JCADataSource(gov.aps.jca.Context jcaContext, int monitorMask, JCATypeSupport typeSupport, boolean dbePropertySupported, boolean varArraySupported) Deprecated. use JCADataSourceBuilder
protected	JCADataSource(JCADataSourceBuilder builder)
	JCADataSource(String className, int monitorMask) Deprecated. use JCADataSourceBuilder

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Closes the DataSource and the resources associated with it.
protected ChannelHandler	createChannel(String channelName) Creates a channel handler for the given name.
gov.aps.jca.Context	getContext() The context used by the data source.
int	getMonitorMask() The monitor mask used for this data source.
boolean	isDbePropertySupported() Whether the metadata monitor should be established.
boolean	isHonorZeroPrecision() True if zero precision should be honored, or disregarded.
boolean	isRtypValueOnly() True if should only ask value for RTYP fields.
boolean	isVarArraySupported() True whether the context can use variable arrays (all array monitor request will have an element count of 0).
static boolean	isVarArraySupported(gov.aps.jca.Context context) Deprecated.

Methods inherited from class org.epics.pvmanager.DataSource

channelHandlerLookupName, channelHandlerRegisterName, connectRead, connectWrite, disconnectRead, disconnectWrite, getChannels, isWriteable, write

Methods inherited from class java.lang.Object

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

Constructor Detail

JCADataSource

public JCADataSource()

Creates a new data source using pure Java implementation and all the defaults described in JCADataSourceBuilder.

JCADataSource

@Deprecated
public JCADataSource(gov.aps.jca.Context jcaContext,
                        int monitorMask)

Deprecated. use JCADataSourceBuilder

Creates a new data source using the given context. The context will never be closed.

Parameters:

jcaContext - the context to be used

monitorMask - Monitor.VALUE, ...

JCADataSource

@Deprecated
public JCADataSource(String className,
                        int monitorMask)

Deprecated. use JCADataSourceBuilder

Creates a new data source using the className to create the context.

Parameters:

className - JCALibrary.CHANNEL_ACCESS_JAVA, JCALibrary.JNI_THREAD_SAFE, ...

monitorMask - Monitor.VALUE, ...

JCADataSource

@Deprecated
public JCADataSource(gov.aps.jca.Context jcaContext,
                        int monitorMask,
                        JCATypeSupport typeSupport)

Deprecated. use JCADataSourceBuilder

Creates a new data source using the given context. The context will never be closed. The type mapping con be configured with a custom type support.

Parameters:

jcaContext - the context to be used

monitorMask - Monitor.VALUE, ...

typeSupport - type support to be used

JCADataSource

@Deprecated
public JCADataSource(gov.aps.jca.Context jcaContext,
                        int monitorMask,
                        JCATypeSupport typeSupport,
                        boolean dbePropertySupported,
                        boolean varArraySupported)

Deprecated. use JCADataSourceBuilder

Creates a new data source using the given context. The context will never be closed. The type mapping con be configured with a custom type support.

Parameters:

jcaContext - the context to be used

monitorMask - Monitor.VALUE, ...

typeSupport - type support to be used

dbePropertySupported - whether metadata monitors should be used

varArraySupported - true if var array should be used

JCADataSource

protected JCADataSource(JCADataSourceBuilder builder)

Method Detail

close

public void close()

Description copied from class: DataSource

Closes the DataSource and the resources associated with it.

Overrides:

close in class DataSource

getContext

public gov.aps.jca.Context getContext()

The context used by the data source.

Returns:

the data source context

getMonitorMask

public int getMonitorMask()

The monitor mask used for this data source.

Returns:

the monitor mask

isDbePropertySupported

public boolean isDbePropertySupported()

Whether the metadata monitor should be established.

Returns:

true if using metadata monitors

createChannel

protected ChannelHandler createChannel(String channelName)

Description copied from class: DataSource

Creates a channel handler for the given name. In the simplest case, this is the only method a data source needs to implement.

Specified by:

createChannel in class DataSource

Parameters:

channelName - the name for a new channel

Returns:

a new handler

isVarArraySupported

public boolean isVarArraySupported()

True whether the context can use variable arrays (all array monitor request will have an element count of 0).

Returns:

true if variable size arrays are supported

isRtypValueOnly

public boolean isRtypValueOnly()

True if should only ask value for RTYP fields.

Returns:

true if asking for value only

isHonorZeroPrecision

public boolean isHonorZeroPrecision()

True if zero precision should be honored, or disregarded.

Returns:

true if zero precision setting is honored

isVarArraySupported

@Deprecated
public static boolean isVarArraySupported(gov.aps.jca.Context context)

Deprecated.

Determines whether the context supports variable arrays or not.

Parameters:

context - a JCA Context

Returns:

true if supports variable sized arrays