Data structure of a ControlHost message. More...

Inheritance diagram for JNET::JDispatch:

Public Types
typedef JMalloc< char >	JMemory_t

Public Member Functions
	JDispatch ()
	Default constructor. More...

	JDispatch (const JPrefix_t &prefix, const char *data)
	Constructor. More...

	JDispatch (const JTag &tag, const std::string &message)
	Constructor. More...

	JDispatch (const JDispatch &message)
	Copy constructor. More...

	~JDispatch ()
	Destructor. More...

JDispatch &	operator= (const JDispatch &message)
	Assignment operator. More...

	operator JSocketOutputBuffer () const
	Type conversion operator. More...

int	size () const
	Get size. More...

const char *	data () const
	Get data. More...

int	getSize () const
	Get size. More...

void	setSize (const int length)
	Set size. More...

void	set (const JTag &tag, const int length)
	Set prefix. More...

const JTag &	getTag () const
	Get tag. More...

JTag &	getTag ()
	Get tag. More...

void	setTag (const JTag &tag)
	Set tag. More...

void	setTag (const std::string &tag)
	Set tag. More...

JTag_t	getID () const
	Get identifier. More...

bool	setID (const JTag_t id)
	Set identifier. More...

std::string	toString () const
	Convert tag to string. More...

	operator std::string () const
	Type conversion operators. More...

const char *	c_str () const
	C-string. More...

const char	operator[] (int i) const
	Get character. More...

void	initialise ()
	Initialise counter. More...

void	attach (const JSharedCounter &object)
	Attach this counter to given shared counter object. More...

bool	detach ()
	Detach. More...

Static Public Attributes
static long long int	MEMORY_TOTAL = 0
	Total size of data [Bytes]. More...

static long long int	MEMORY_LIMIT
	Limit size of data [Bytes]. More...

Protected Member Functions
void	create ()
	Allocate memory. More...

void	release ()
	Release memory. More...

Protected Attributes
char *	buffer

int	size

union {
char tag [TAGSIZE]

JTag_t id

};

int *	counter

Detailed Description

Data structure of a ControlHost message.

This data structure consists of a copy of the ControlHost prefix and an array of bytes (including the ControlHost prefix). A new array of bytes is created by the appropriate constructor. The allocated memory is released upon destruction of the last object of this class.

Definition at line 63 of file JLigier.cc.

Member Typedef Documentation

typedef JMalloc<char> JNET::JDispatch::JMemory_t

Definition at line 69 of file JLigier.cc.

Constructor & Destructor Documentation

JNET::JDispatch::JDispatch ( )

inline

Default constructor.

Definition at line 77 of file JLigier.cc.

                 :
       JPrefix_t(),
       JSharedCounter(),
       buffer(NULL)
     {}

JNET::JDispatch::JDispatch	(	const JPrefix_t &	prefix,
		const char *	data
	)

inline

Constructor.

Note that the input data should contain a copy of the prefix.

Parameters

prefix	prefix
data	data

Definition at line 91 of file JLigier.cc.

                                      :
       JPrefix_t(prefix),
       JSharedCounter()
     {
       create();
 
       memcpy(this->buffer, data, size());
     }

JNET::JDispatch::JDispatch	(	const JTag &	tag,
		const std::string &	message
	)

inline

Constructor.

Note that the given message is appended to a copy of the prefix.

Parameters

tag	tag
message	message

Definition at line 109 of file JLigier.cc.

                                         :
       JPrefix_t(tag, message.size()),
       JSharedCounter()
     {
       create();
       
       memcpy(this->buffer, static_cast<const JPrefix_t*>(this), sizeof(JPrefix_t));
 
       memcpy(this->buffer + sizeof(JPrefix_t), message.data(), message.size());
     }

JNET::JDispatch::JDispatch ( const JDispatch & message )

inline

Copy constructor.

Parameters

message message

Definition at line 127 of file JLigier.cc.

     {
       static_cast<JPrefix_t&>(*this) = message;
 
       buffer = message.buffer;
 
       attach(message);
     }

JNET::JDispatch::~JDispatch ( )

inline

Destructor.

Definition at line 140 of file JLigier.cc.

     {
       if (detach())
         release();
     }

Member Function Documentation

JDispatch& JNET::JDispatch::operator= ( const JDispatch & message )

inline

Assignment operator.

Parameters

message message

Returns: this JDispatch

Definition at line 153 of file JLigier.cc.

     {
       if (buffer != message.buffer) {
 
         if (detach()) {
           release();
         }
         
         buffer = message.buffer;
 
         attach(message);
       }
 
       return *this;
     }

JNET::JDispatch::operator JSocketOutputBuffer ( ) const

inline

Type conversion operator.

Returns: socket output buffer

Definition at line 175 of file JLigier.cc.

     {
       return JSocketOutputBuffer(this->data(), this->size());
     }

int JNET::JDispatch::size ( ) const

inline

Get size.

Returns: number of bytes

Definition at line 186 of file JLigier.cc.

     {
       return getSizeOfPacket(static_cast<const JPrefix_t&>(*this));
     }

const char* JNET::JDispatch::data ( ) const

inline

Get data.

Returns: pointer to data

Definition at line 197 of file JLigier.cc.

     {
       return buffer;
     }

void JNET::JDispatch::create ( )

inlineprotected

Allocate memory.

Definition at line 207 of file JLigier.cc.

     {
       buffer = JMemory_t::create(size());
         
       if (buffer != NULL) {
 
         JSharedCounter::initialise();
         
         MEMORY_TOTAL += size();
 
       } else {
 
         throw JMallocException("Not enough space in memory.");
       }
     }

void JNET::JDispatch::release ( )

inlineprotected

Release memory.

Definition at line 227 of file JLigier.cc.

     {
       JMemory_t::release(buffer);
 
       MEMORY_TOTAL -= size();
     }

int JNET::JPrefix::getSize ( ) const

inlineinherited

Get size.

Returns: number of bytes

Definition at line 63 of file JPrefix.hh.

     {
       return ntohl(size);
     }

void JNET::JPrefix::setSize ( const int length )

inlineinherited

Set size.

Parameters

length number of bytes

Definition at line 74 of file JPrefix.hh.

     {
       size = htonl(length);
     }

void JNET::JPrefix::set	(	const JTag &	tag,
		const int	length
	)

inlineinherited

Set prefix.

Parameters

tag	tag
length	number of bytes

Returns: true if OK; else false

Definition at line 87 of file JPrefix.hh.

     {
       setTag (tag);
       setSize(length);
     }

const JTag& JNET::JTag::getTag ( ) const

inlineinherited

Get tag.

Returns: tag

Definition at line 82 of file JTag.hh.

     {
       return static_cast<const JTag&>(*this);
     }

JTag& JNET::JTag::getTag ( )

inlineinherited

Get tag.

Returns: tag

Definition at line 93 of file JTag.hh.

     {
       return static_cast<JTag&>(*this);
     }

void JNET::JTag::setTag ( const JTag & tag )

inlineinherited

Set tag.

Parameters

tag tag

Returns: true if OK; else false

Definition at line 105 of file JTag.hh.

     {
       id = tag.getID();
     }

void JNET::JTag::setTag ( const std::string & tag )

inlineinherited

Set tag.

Parameters

tag tag

Returns: true if OK; else false

Definition at line 117 of file JTag.hh.

     {
       if (!tag.empty() && tag.size() <= TAGSIZE) {
         
         size_t i = 0;
 
         for ( ; i < tag.size(); ++i) {
           this->tag[i] = tag[i];
         }
 
         for ( ; i < TAGSIZE;    ++i) {
           this->tag[i] = '\0';
         }
 
       } else {
 
         return throw(JControlHostException("JTag::setTag() invalid tag length."));
       }
     }

JTag_t JNET::JTag::getID ( ) const

inlineinherited

Get identifier.

Returns: identifier

Definition at line 143 of file JTag.hh.

     { 
       return id;
     }

bool JNET::JTag::setID ( const JTag_t id )

inlineinherited

Set identifier.

Returns: identifier

Definition at line 154 of file JTag.hh.

     { 
       this->id = id;
 
       return true;
     }

std::string JNET::JTag::toString ( ) const

inlineinherited

Convert tag to string.

Returns: tag

Definition at line 167 of file JTag.hh.

     {
       int pos = TAGSIZE;
 
       while (pos != 0 && tag[pos-1] == '\0') {
         --pos;
       }
 
       return std::string(tag, pos);
     }

JNET::JTag::operator std::string ( ) const

inlineinherited

Type conversion operators.

Returns: tag

Definition at line 184 of file JTag.hh.

     {
       return toString();
     }

const char* JNET::JTag::c_str ( ) const

inlineinherited

C-string.

Returns: tag

Definition at line 195 of file JTag.hh.

     {
       return tag;
     }

const char JNET::JTag::operator[] ( int i ) const

inlineinherited

Get character.

Parameters

i index

Returns: character at index

Definition at line 207 of file JTag.hh.

     {
       return tag[i];
     }

void JLANG::JSharedCounter::initialise ( )

inlineinherited

Initialise counter.

Definition at line 32 of file JSharedCounter.hh.

     {
       detach();
 
       counter = new int(1);
     }

void JLANG::JSharedCounter::attach ( const JSharedCounter & object )

inlineinherited

Attach this counter to given shared counter object.

Parameters

object shared counter

Definition at line 45 of file JSharedCounter.hh.

     {
       detach();
 
       counter = object.counter;
 
       if (counter != NULL) {
         ++(*counter);
       }
     }

bool JLANG::JSharedCounter::detach ( )

inlineinherited

Detach.

Returns: true if counter at zero; else false

Definition at line 62 of file JSharedCounter.hh.

     {
       if (counter != NULL) {
 
         if (--(*counter) == 0) {
 
           delete counter;
 
           counter = NULL;
 
           return true;
         }
 
         counter = NULL;
       }
 
       return false;
     }

Member Data Documentation

long long int JNET::JDispatch::MEMORY_TOTAL = 0

static

Total size of data [Bytes].

Total memory allocation.

Definition at line 71 of file JLigier.cc.

long long int JNET::JDispatch::MEMORY_LIMIT

static

Limit size of data [Bytes].

Limit memory allocation.

Definition at line 72 of file JLigier.cc.

char* JNET::JDispatch::buffer

protected

Definition at line 234 of file JLigier.cc.

int JNET::JPrefix::size

protectedinherited

Definition at line 95 of file JPrefix.hh.

char JNET::JTag::tag[TAGSIZE]

inherited

Definition at line 247 of file JTag.hh.

JTag_t JNET::JTag::id

inherited

Definition at line 248 of file JTag.hh.

union { ... }

int* JLANG::JSharedCounter::counter

protectedinherited

Definition at line 82 of file JSharedCounter.hh.

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

JLigier.cc

Public Types

Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation