pvDatabaseCPP  4.5.3-dev
Public Member Functions | Static Public Member Functions | Protected Member Functions | Friends | List of all members
epics::pvDatabase::PVRecord Class Reference

Base interface for a PVRecord. More...

#include <pvDatabase.h>

Inheritance diagram for epics::pvDatabase::PVRecord:
epics::pvCopy::PVCopyTraverseMasterCallback epics::pvDatabase::AddRecord epics::pvDatabase::ProcessRecord epics::pvDatabase::RemoveRecord epics::pvDatabase::TraceRecord

Public Member Functions

 POINTER_DEFINITIONS (PVRecord)
 
virtual ~PVRecord ()
 
virtual bool init ()
 Optional initialization method. More...
 
virtual void start ()
 Optional method for derived class. More...
 
virtual void process ()
 Optional method for derived class. More...
 
virtual void destroy ()
 DEPRECATED. More...
 
virtual void remove ()
 remove record from database. More...
 
virtual epics::pvAccess::RPCServiceAsync::shared_pointer getService (epics::pvData::PVStructurePtr const &pvRequest)
 Optional method for derived class. More...
 
std::string getRecordName () const
 Get the name of the record. More...
 
PVRecordStructurePtr getPVRecordStructure () const
 Get the top level PVRecordStructure. More...
 
epics::pvData::PVStructurePtr getPVStructure () const
 Get the top level PVStructure. More...
 
PVRecordFieldPtr findPVRecordField (epics::pvData::PVFieldPtr const &pvField)
 Find the PVRecordField for the PVField. More...
 
void lock ()
 Lock the record. More...
 
void unlock ()
 Unlock the record. More...
 
bool tryLock ()
 Try to lock the record. More...
 
void lockOtherRecord (PVRecordPtr const &otherRecord)
 Lock another record. More...
 
bool addPVRecordClient (PVRecordClientPtr const &pvRecordClient)
 Add a client that wants to access the record. More...
 
bool addListener (PVListenerPtr const &pvListener, epics::pvCopy::PVCopyPtr const &pvCopy)
 Add a PVListener. More...
 
void nextMasterPVField (epics::pvData::PVFieldPtr const &pvField)
 PVCopyTraverseMasterCallback method. More...
 
bool removeListener (PVListenerPtr const &pvListener, epics::pvCopy::PVCopyPtr const &pvCopy)
 Remove a listener. More...
 
void beginGroupPut ()
 Begins a group of puts. More...
 
void endGroupPut ()
 Ends a group of puts. More...
 
int getTraceLevel ()
 get trace level (0,1,2) means (nothing,lifetime,process) More...
 
void setTraceLevel (int level)
 set trace level (0,1,2) means (nothing,lifetime,process) More...
 
 POINTER_DEFINITIONS (PVCopyTraverseMasterCallback)
 

Static Public Member Functions

static PVRecordPtr create (std::string const &recordName, epics::pvData::PVStructurePtr const &pvStructure)
 Creates a soft record. More...
 

Protected Member Functions

 PVRecord (std::string const &recordName, epics::pvData::PVStructurePtr const &pvStructure)
 Constructor. More...
 
void initPVRecord ()
 Initializes the base class. More...
 

Friends

class PVDatabase
 

Detailed Description

Base interface for a PVRecord.

It is also a complete implementation for soft records. A soft record is a record where method process sets an optional top level timeStamp field to the current time and does nothing else.

Author
mrk
Date
2012.11.20

Definition at line 56 of file pvDatabase.h.

Constructor & Destructor Documentation

◆ ~PVRecord()

epics::pvDatabase::PVRecord::~PVRecord ( )
virtual

The Destructor.

Definition at line 61 of file pvRecord.cpp.

◆ PVRecord()

epics::pvDatabase::PVRecord::PVRecord ( std::string const &  recordName,
epics::pvData::PVStructurePtr const &  pvStructure 
)
protected

Constructor.

Parameters
recordNameThe name of the record
pvStructureThe top level PVStructutre

Definition at line 50 of file pvRecord.cpp.

Member Function Documentation

◆ addListener()

bool epics::pvDatabase::PVRecord::addListener ( PVListenerPtr const &  pvListener,
epics::pvCopy::PVCopyPtr const &  pvCopy 
)

Add a PVListener.

This must be called before calling pvRecordField.addListener.

Parameters
pvListenerThe listener.
pvCopyThe pvStructure that has the client fields.
Returns
true if the listener was added.

Definition at line 230 of file pvRecord.cpp.

◆ addPVRecordClient()

bool epics::pvDatabase::PVRecord::addPVRecordClient ( PVRecordClientPtr const &  pvRecordClient)

Add a client that wants to access the record.

Every client that accesses the record must call this so that the client can be notified when the record is deleted.

Parameters
pvRecordClientThe client.
Returns
true if the client is added.

Definition at line 199 of file pvRecord.cpp.

◆ beginGroupPut()

void epics::pvDatabase::PVRecord::beginGroupPut ( )

Begins a group of puts.

Definition at line 283 of file pvRecord.cpp.

◆ create()

PVRecordPtr epics::pvDatabase::PVRecord::create ( std::string const &  recordName,
epics::pvData::PVStructurePtr const &  pvStructure 
)
static

Creates a soft record.

Parameters
recordNameThe name of the record, which is also the channelName.
pvStructureThe top level structure.
Returns
A shared pointer to the newly created record.

Definition at line 38 of file pvRecord.cpp.

◆ destroy()

virtual void epics::pvDatabase::PVRecord::destroy ( )
inlinevirtual

DEPRECATED.

Definition at line 92 of file pvDatabase.h.

◆ endGroupPut()

void epics::pvDatabase::PVRecord::endGroupPut ( )

Ends a group of puts.

Definition at line 298 of file pvRecord.cpp.

◆ findPVRecordField()

PVRecordFieldPtr epics::pvDatabase::PVRecord::findPVRecordField ( epics::pvData::PVFieldPtr const &  pvField)

Find the PVRecordField for the PVField.

This is called by the pvCopy facility.

Parameters
pvFieldThe PVField.
Returns
The shared pointer to the PVRecordField.

Referenced by nextMasterPVField(), and process().

◆ getPVRecordStructure()

PVRecordStructurePtr epics::pvDatabase::PVRecord::getPVRecordStructure ( ) const
inline

Get the top level PVRecordStructure.

Returns
The shared pointer.

Definition at line 135 of file pvDatabase.h.

Referenced by epics::pvDatabase::operator<<().

◆ getPVStructure()

epics::pvData::PVStructurePtr epics::pvDatabase::PVRecord::getPVStructure ( ) const
inline

Get the top level PVStructure.

Returns
The top level PVStructure.

Definition at line 141 of file pvDatabase.h.

◆ getRecordName()

std::string epics::pvDatabase::PVRecord::getRecordName ( ) const
inline

Get the name of the record.

Returns
The name.

Definition at line 129 of file pvDatabase.h.

Referenced by epics::pvDatabase::operator<<().

◆ getService()

virtual epics::pvAccess::RPCServiceAsync::shared_pointer epics::pvDatabase::PVRecord::getService ( epics::pvData::PVStructurePtr const &  pvRequest)
inlinevirtual

Optional method for derived class.

Return a service corresponding to the specified request PVStructure.

Parameters
pvRequestThe request PVStructure
Returns
The corresponding service

Definition at line 109 of file pvDatabase.h.

◆ getTraceLevel()

int epics::pvDatabase::PVRecord::getTraceLevel ( )
inline

get trace level (0,1,2) means (nothing,lifetime,process)

Returns
the level

Definition at line 233 of file pvDatabase.h.

◆ init()

virtual bool epics::pvDatabase::PVRecord::init ( )
inlinevirtual

Optional initialization method.

A derived method Must call initPVRecord.

Returns
true for success and false for failure.

Reimplemented in epics::pvDatabase::ProcessRecord, epics::pvDatabase::TraceRecord, epics::pvDatabase::AddRecord, and epics::pvDatabase::RemoveRecord.

Definition at line 72 of file pvDatabase.h.

◆ initPVRecord()

void epics::pvDatabase::PVRecord::initPVRecord ( )
protected

Initializes the base class.

Must be called by derived classes.

Definition at line 110 of file pvRecord.cpp.

◆ lock()

void epics::pvDatabase::PVRecord::lock ( )

Lock the record.

Any code must lock while accessing a record.

Definition at line 164 of file pvRecord.cpp.

Referenced by lockOtherRecord().

◆ lockOtherRecord()

void epics::pvDatabase::PVRecord::lockOtherRecord ( PVRecordPtr const &  otherRecord)

Lock another record.

A client that holds the lock for one record can lock one other record. A client must not call this if the client already has the lock for more then one record.

Parameters
otherRecordThe other record to lock.

Definition at line 185 of file pvRecord.cpp.

References lock(), and unlock().

◆ nextMasterPVField()

void epics::pvDatabase::PVRecord::nextMasterPVField ( epics::pvData::PVFieldPtr const &  pvField)
virtual

PVCopyTraverseMasterCallback method.

Parameters
pvFieldThe next client field.

Implements epics::pvCopy::PVCopyTraverseMasterCallback.

Definition at line 246 of file pvRecord.cpp.

References findPVRecordField().

◆ POINTER_DEFINITIONS() [1/2]

epics::pvCopy::PVCopyTraverseMasterCallback::POINTER_DEFINITIONS ( PVCopyTraverseMasterCallback  )
inherited

◆ POINTER_DEFINITIONS() [2/2]

epics::pvDatabase::PVRecord::POINTER_DEFINITIONS ( PVRecord  )

◆ process()

void epics::pvDatabase::PVRecord::process ( )
virtual

Optional method for derived class.

It is the method that makes a record smart. If it encounters errors it should raise alarms and/or call the message method provided by the base class. If the pvStructure has a top level timeStamp, the base class sets the timeStamp to the current time.

Reimplemented in epics::pvDatabase::ProcessRecord, epics::pvDatabase::TraceRecord, epics::pvDatabase::AddRecord, and epics::pvDatabase::RemoveRecord.

Definition at line 120 of file pvRecord.cpp.

References findPVRecordField().

◆ remove()

void epics::pvDatabase::PVRecord::remove ( )
virtual

remove record from database.

Remove the PVRecord. Release any resources used and get rid of listeners and requesters. If derived class overrides this then it must call PVRecord::remove() after it has destroyed any resorces it uses.

Definition at line 98 of file pvRecord.cpp.

References epics::pvDatabase::PVDatabase::getMaster().

◆ removeListener()

bool epics::pvDatabase::PVRecord::removeListener ( PVListenerPtr const &  pvListener,
epics::pvCopy::PVCopyPtr const &  pvCopy 
)

Remove a listener.

Parameters
pvListenerThe listener.
pvCopyThe pvStructure that has the client fields.
Returns
true if the listener was removed.

Definition at line 258 of file pvRecord.cpp.

◆ setTraceLevel()

void epics::pvDatabase::PVRecord::setTraceLevel ( int  level)
inline

set trace level (0,1,2) means (nothing,lifetime,process)

Parameters
levelThe level

Definition at line 238 of file pvDatabase.h.

◆ start()

virtual void epics::pvDatabase::PVRecord::start ( )
inlinevirtual

Optional method for derived class.

It is called before record is added to database.

Definition at line 78 of file pvDatabase.h.

◆ tryLock()

bool epics::pvDatabase::PVRecord::tryLock ( )

Try to lock the record.

If true then just like lock. If falseclient can not access record. Code can try to simultaneously hold the lock for more than two records by calling this method but must be willing to accept failure.

Returns
true if the record is locked.

Definition at line 178 of file pvRecord.cpp.

◆ unlock()

void epics::pvDatabase::PVRecord::unlock ( )

Unlock the record.

The code that calls lock must unlock when done accessing the record.

Definition at line 171 of file pvRecord.cpp.

Referenced by lockOtherRecord().

Friends And Related Function Documentation

◆ PVDatabase

friend class PVDatabase
friend

Definition at line 255 of file pvDatabase.h.


The documentation for this class was generated from the following files: