epics::pvDatabase::AddRecord Class Reference

Add another record in the same database. More...

#include "addRecord.h"

Inheritance diagram for epics::pvDatabase::AddRecord:

Collaboration diagram for epics::pvDatabase::AddRecord:

Public Member Functions
	POINTER_DEFINITIONS (AddRecord)
virtual bool	init ()
virtual void	process ()
	Add the record specified by recordName. More...
Public Member Functions inherited from epics::pvDatabase::PVRecord
	POINTER_DEFINITIONS (PVRecord)
virtual	~PVRecord ()
virtual void	start ()
	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...
Public Member Functions inherited from epics::pvCopy::PVCopyTraverseMasterCallback
	POINTER_DEFINITIONS (PVCopyTraverseMasterCallback)
virtual	~PVCopyTraverseMasterCallback ()

Static Public Member Functions
static AddRecordPtr	create (std::string const &recordName)
Static Public Member Functions inherited from epics::pvDatabase::PVRecord
static PVRecordPtr	create (std::string const &recordName, epics::pvData::PVStructurePtr const &pvStructure)
	Creates a soft record. More...

Additional Inherited Members
Protected Member Functions inherited from epics::pvDatabase::PVRecord
	PVRecord (std::string const &recordName, epics::pvData::PVStructurePtr const &pvStructure)
	Constructor. More...
void	initPVRecord ()
	Initializes the base class. More...

Detailed Description

Add another record in the same database.

A record to add another record It is meant to be used via a channelPutGet request. The argument has one field: recordName. The result has a field named status.

Definition at line 32 of file addRecord.h.

Member Function Documentation

AddRecordPtr epics::pvDatabase::AddRecord::create ( std::string const &  recordName )

static

Factory methods to create AddRecord.

Parameters

recordName

The name for the AddRecord.

Returns

A shared pointer to AddRecord..

Definition at line 42 of file addRecord.cpp.

{
    FieldCreatePtr fieldCreate = getFieldCreate();
    PVDataCreatePtr pvDataCreate = getPVDataCreate();
    StructureConstPtr  topStructure = fieldCreate->createFieldBuilder()->
        addNestedStructure("argument")->
            add("recordName",pvString)->
            addNestedUnion("union") ->
                endNested()->
            endNested()->
        addNestedStructure("result") ->
            add("status",pvString) ->
            endNested()->
        createStructure();
    PVStructurePtr pvStructure = pvDataCreate->createPVStructure(topStructure);
    AddRecordPtr pvRecord(
        new AddRecord(recordName,pvStructure));
    if(!pvRecord->init()) pvRecord.reset();
    return pvRecord;
}

bool epics::pvDatabase::AddRecord::init ( )

virtual

standard init method required by PVRecord

Returns

true unless record name already exists.

Reimplemented from epics::pvDatabase::PVRecord.

Definition at line 71 of file addRecord.cpp.

{
    initPVRecord();
    PVStructurePtr pvStructure = getPVStructure();
    pvRecordName = pvStructure->getSubField<PVString>("argument.recordName");
    if(!pvRecordName) return false;
    pvResult = pvStructure->getSubField<PVString>("result.status");
    if(!pvResult) return false;
    return true;
}

epics::pvDatabase::AddRecord::POINTER_DEFINITIONS

(

AddRecord

)

void epics::pvDatabase::AddRecord::process ( )

virtual

Add the record specified by recordName.

Reimplemented from epics::pvDatabase::PVRecord.

Definition at line 82 of file addRecord.cpp.

{
    PVDataCreatePtr pvDataCreate = getPVDataCreate();
    string name = pvRecordName->get();
    PVRecordPtr pvRecord = PVDatabase::getMaster()->findRecord(name);
    if(pvRecord) {
        pvResult->put(name + " already exists");
        return;
    }
    PVUnionPtr pvUnion = getPVStructure()->getSubField<PVUnion>("argument.union");
    if(!pvUnion) {
        pvResult->put(name + " argument.union is NULL");
        return;
    }
    PVFieldPtr pvField(pvUnion->get());
    if(!pvField) {
        pvResult->put(name + " union has no value");
        return;
    }
    if(pvField->getField()->getType()!=epics::pvData::structure) {
        pvResult->put(name + " union most be a structure");
        return;
    }
    StructureConstPtr st = static_pointer_cast<const Structure>(pvField->getField());
    PVStructurePtr pvStructure = pvDataCreate->createPVStructure(st);
    PVRecordPtr pvRec = PVRecord::create(name,pvStructure);
    bool result = PVDatabase::getMaster()->addRecord(pvRec);
    if(result) {
        pvResult->put("success");
    } else {
        pvResult->put("failure");
    }
}

---

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

• modules/pvDatabase/src/pv/addRecord.h
• modules/pvDatabase/src/special/addRecord.cpp