bes Updated for version 3.20.13
BESPlugin< M > Class Template Reference

#include <BESPlugin.h>

Collaboration diagram for BESPlugin< M >:
Collaboration graph

Public Member Functions

 BESPlugin (const std::string &filename)
 
virtual void dump (std::ostream &strm) const
 dump the contents of this object to the specified ostream
 
M * instantiate () throw (NoSuchLibrary, NoSuchObject)
 
virtual ~BESPlugin ()
 

Detailed Description

template<typename M>
class BESPlugin< M >

BESPlugin provides a mechanism that can load C++ classes at runtime. Classes are compiled and stored in shareable-object libraries. This class binds the name of that class (which is used by Plugin's client) to the name of the library.

Each class/library must contain at least one function. The function must have the name and type signature ‘extern "C" M* maker()’ and must return a pointer to a new instance of the class M. Note that M is the parameter of the Plugin template. Suppose you have a base class Base and a collection of specializations S1, S2, ..., Sn. You would use N instances of BESPlugin<Base> to provide access to the implementations in those
N shareable-object libraries. The exectuable that loads the libraries must have been compiled and linked with Base.

External symbols defined in the library will be made available to subsequently loaded libraries.

Author
James Gallagher

Definition at line 92 of file BESPlugin.h.

Constructor & Destructor Documentation

◆ BESPlugin()

template<typename M >
BESPlugin< M >::BESPlugin ( const std::string &  filename)
inline

Create a new BESPlugin.

Parameters
filenameThe name of the sharable object library that holds the class' implementation.

Definition at line 145 of file BESPlugin.h.

◆ ~BESPlugin()

template<typename M >
virtual BESPlugin< M >::~BESPlugin ( )
inlinevirtual

The destructor closes the library.

Definition at line 152 of file BESPlugin.h.

Member Function Documentation

◆ dump()

template<typename M >
virtual void BESPlugin< M >::dump ( std::ostream &  strm) const
inlinevirtual

dump the contents of this object to the specified ostream

This method is implemented by all derived classes to dump their contents, in other words, any state they might have, private variables, etc...

The inline function below can be used to dump the contents of an OPeNDAPObj object. For example, the object Animal is derived from BESObj. A user could do the following:

Animal *a = new dog( "Sparky" ) ; cout << a << endl ;

And the dump method for dog could display the name passed into the constructor, the (this) pointer of the object, etc...

Parameters
strmC++ i/o stream to dump the object to

Implements BESObj.

Definition at line 183 of file BESPlugin.h.

◆ instantiate()

template<typename M >
M * BESPlugin< M >::instantiate ( )
throw (NoSuchLibrary,
NoSuchObject
)
inline

Instantiate the object. Using the maker function found in the shreable-object library, create a new instance of class M where M was the template parameter of BESPlugin.

Returns
A pointer to the new instance.

Definition at line 169 of file BESPlugin.h.


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