org.epics.pvmanager.loc

Class LocalDataSource

java.lang.Object

org.epics.pvmanager.DataSource

org.epics.pvmanager.loc.LocalDataSource

public class LocalDataSource
extends DataSource

Data source for locally written data. Each instance of this data source will have its own separate channels and values.

Author:

carcassi

Constructor Summary

Constructors

Constructor and Description
LocalDataSource() Creates a new data source.
LocalDataSource(boolean zeroInitialization) Deprecated. do not use zero initialization of local variable: does not work for non numeric variables

Method Summary

Methods

Modifier and Type	Method and Description
protected String	channelHandlerLookupName(String channelName) Returns the lookup name to use to find the channel handler in the cache.
void	connectRead(ReadRecipe readRecipe) Connects to a set of channels based on the given recipe.
void	connectWrite(WriteRecipe writeRecipe) Prepares the channels defined in the write recipe for writes.
protected ChannelHandler	createChannel(String channelName) Creates a channel handler for the given name.

Methods inherited from class org.epics.pvmanager.DataSource

channelHandlerRegisterName, close, 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

LocalDataSource

public LocalDataSource()

Creates a new data source.

LocalDataSource

@Deprecated
public LocalDataSource(boolean zeroInitialization)

Deprecated. do not use zero initialization of local variable: does not work for non numeric variables

Zero initialization is deprecated. Will be removed in a future release.

Parameters:

zeroInitialization - whether to initialize variable to 0

Method Detail

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

channelHandlerLookupName

protected String channelHandlerLookupName(String channelName)

Description copied from class: DataSource

Returns the lookup name to use to find the channel handler in the cache. By default, it returns the channel name itself. If a datasource needs multiple different channel names to be the same channel handler (e.g. parts of the channel name are initialization parameters) then it can override this method to change the lookup.

Overrides:

channelHandlerLookupName in class DataSource

Parameters:

channelName - the channel name

Returns:

the channel handler to look up in the cache

connectRead

public void connectRead(ReadRecipe readRecipe)

Description copied from class: DataSource

Connects to a set of channels based on the given recipe.

The data source must update the value caches relative to each channel. Before updating any cache, it must lock the collector relative to that cache and after any update it must notify the collector.

Overrides:

connectRead in class DataSource

Parameters:

readRecipe - the instructions for the data connection

connectWrite

public void connectWrite(WriteRecipe writeRecipe)

Description copied from class: DataSource

Prepares the channels defined in the write recipe for writes.

If these are channels over the network, it will create the network connections with the underlying libraries.

Overrides:

connectWrite in class DataSource

Parameters:

writeRecipe - the recipe that will contain the write data