JSUPPORT::JFileScanner< T > Class Template Reference

Object reading from file. More...

#include <JFileScanner.hh>

Inheritance diagram for JSUPPORT::JFileScanner< T >:

Public Types
typedef JAccessibleObjectReader< T >::helper_type	helper_type
typedef JObjectIterator< T >::pointer_type	pointer_type
typedef JStorage< JAccessibleObjectIterator< T >, JNew >	storage_type
typedef JNew< JAccessibleObjectIterator< T > >	memory_type

Public Member Functions
	JFileScanner ()
	Default constructor.
	JFileScanner (const char *file_name)
	Constructor.
	~JFileScanner ()
	Destructor.
virtual void	open (const char *file_name) override
	Open file.
virtual void	close () override
	Close device.
virtual JAccessibleObjectIterator< T > *	getHelper () const override
	Get helper.
virtual bool	hasNext () override
	Check availability of next element.
virtual const pointer_type &	next () override
	Get next element.
virtual skip_type	skip (const skip_type ns) override
	Skip items.
virtual bool	is_open () const override
	Check is device is open.
const JSharedPointer &	getSharedPointer () const
	Get shared pointer.
JSharedPointer &	getSharedPointer ()
	Get shared pointer.
void	setSharedPointer (const JSharedPointer &object)
	Set shared pointer.
virtual void	reset () override
	Reset pointer.
void	reset (const JPointer< T > &pointer)
	Reset pointer.
void	reset (JAccessibleObjectIterator< T > *p)
	Reset pointer.
void	set (const JPointer< T > &pointer)
	Set pointer.
void	initialise ()
	Initialise counter.
void	attach (const JSharedCounter &object)
	Attach this counter to given shared counter object.
bool	detach ()
	Detach.
const int	getCount ()
	Get count.
void	recreate ()
	Recreate object in memory.
void	create ()
	Create object in memory.
void	create (const unsigned int size)
	Create array of objects in memory.
virtual JAccessibleObjectIterator< T > *	get () const override
	Get pointer.
JAccessibleObjectIterator< T > *const &	getReference () const
	Get rereference to internal pointer.
JAccessibleObjectIterator< T > *&	getReference ()
	Get rereference to internal pointer.
virtual bool	equals (const JAbstractPointer &object) const
	Equals.
bool	is_valid () const
	Check validity of pointer.
JAccessibleObjectIterator< T > *	operator-> () const
	Smart pointer operator.
	operator JAccessibleObjectIterator< T > * () const
	Type conversion operator.

Static Public Member Functions
static void	release (JAccessibleObjectIterator< T > *p)
	Release memory.
static void	Throw (const bool option)
	Enable/disable throw option.
static int	Throw (const JException_t &error, const int value=-1)
	Throw exception or return error.

Protected Member Functions
void	set (const JSharedPointer &object)
	Set pointer.
virtual void	set (JAccessibleObjectIterator< T > *p) override
	Set pointer.
void	release ()
	Release memory.

Protected Attributes
int *	counter
JAccessibleObjectIterator< T > *	__p
	pointer to object

Static Protected Attributes
static bool	do_throw
	throw option

Private Attributes
pointer_type	ps

Detailed Description

template<class T>
class JSUPPORT::JFileScanner< T >

Object reading from file.

This class implements the method open of the JLANG::JAccessible interface. The file format is derived from the file name extension.

Definition at line 37 of file JFileScanner.hh.

Member Typedef Documentation

helper_type

template<class T >

JAccessibleObjectReader<T>::helper_type JSUPPORT::JFileScanner< T >::helper_type

Definition at line 42 of file JFileScanner.hh.

pointer_type

template<class T >

JObjectIterator<T>::pointer_type JLANG::JAccessibleObjectReader< T >::pointer_type

inherited

Definition at line 98 of file JObjectReader.hh.

storage_type

JStorage<JAccessibleObjectIterator< T >, JNew> JLANG::JSharedPointer< JAccessibleObjectIterator< T >, JNew >::storage_type

inherited

Definition at line 35 of file JSharedPointer.hh.

memory_type

JNew<JAccessibleObjectIterator< T >> JLANG::JStorage< JAccessibleObjectIterator< T >, JNew >::memory_type

inherited

Definition at line 33 of file JStorage.hh.

Constructor & Destructor Documentation

JFileScanner() [1/2]

template<class T >

JSUPPORT::JFileScanner< T >::JFileScanner ( )

inline

Default constructor.

Definition at line 47 of file JFileScanner.hh.

    {}

JFileScanner() [2/2]

template<class T >

JSUPPORT::JFileScanner< T >::JFileScanner ( const char * file_name )

inline

Constructor.

Parameters

file_name

file name

Definition at line 56 of file JFileScanner.hh.

    {
      open(file_name);
    }

~JFileScanner()

template<class T >

JSUPPORT::JFileScanner< T >::~JFileScanner ( )

inline

Destructor.

Definition at line 65 of file JFileScanner.hh.

    {
      if (this->is_open()) {
        this->close();
      }
    }

Member Function Documentation

open()

template<class T >

virtual void JSUPPORT::JFileScanner< T >::open ( const char * file_name )

inlineoverridevirtual

Open file.

Parameters

file_name

file name

Implements JLANG::JAccessible.

Definition at line 78 of file JFileScanner.hh.

    {
      using namespace std;
      using namespace JPP;
 
      JAccessible::Throw(true);
 
      if      (getProtocol(file_name)          == ROOT_FILE_FORMAT)
        this->reset(new JRootFileReader<T>());
      else if (getFilenameExtension(file_name) == ROOT_FILE_FORMAT)
        this->reset(new JRootFileReader<T>());
      else if (getFilenameExtension(file_name) == DAQ_FILE_FORMAT)
        this->reset(new JDAQFileReader<T>());
      else if (getFilenameExtension(file_name) == JPP_FILE_FORMAT)
        this->reset(new JBinaryFileReader<T>());
      else if (getFilenameExtension(file_name) == MONTE_CARLO_FILE_FORMAT)
        this->reset(new JMonteCarloASCIIFileReader<T>());
      else if (getFilenameExtension(file_name) == GZIP_FILE_FORMAT) 
        this->reset(new JMonteCarloGZFileReader<T>());
      else
        this->Throw(JProtocolException(MAKE_STRING("Protocol not defined: " << file_name)));
 
      if (this->is_valid()) {
 
        this->get()->open(file_name);
 
        if (!this->get()->is_open()) {
          if (getFilenameExtension(file_name) != ROOT_FILE_FORMAT) {
            JAccessible::Throw(JFileOpenException("File not opened."));
          }
        }
      }
    }

close()

template<class T >

virtual void JSUPPORT::JFileScanner< T >::close ( )

inlineoverridevirtual

Close device.

Implements JLANG::JAccessible.

Definition at line 116 of file JFileScanner.hh.

    {
      if (this->is_valid()) {
        this->get()->close();
        this->reset();
      }
    }

getHelper()

template<class T >

virtual JAccessibleObjectIterator< T > * JLANG::JAccessibleObjectReader< T >::getHelper ( ) const

inlineoverridevirtualinherited

Get helper.

Returns

helper

Implements JLANG::JAbstractAccessibleObjectReader< T >.

Definition at line 112 of file JObjectReader.hh.

    {
      return this->get();
    }

hasNext()

template<class T >

virtual bool JLANG::JAbstractObjectReader< T >::hasNext ( )

inlineoverridevirtualinherited

Check availability of next element.

Returns

true if the iteration has more elements; else false

Implements JLANG::JObjectIterator< T >.

Definition at line 43 of file JAbstractObjectReader.hh.

    {
      return (this->getHelper() != NULL && this->getHelper()->hasNext());
    }

next()

template<class T >

virtual const pointer_type & JLANG::JAbstractObjectReader< T >::next ( )

inlineoverridevirtualinherited

Get next element.

Returns

pointer to element

Implements JLANG::JObjectIterator< T >.

Definition at line 54 of file JAbstractObjectReader.hh.

    {
      if (this->getHelper() != NULL)
        return this->getHelper()->next();
      else
        return ps;
    }

skip()

template<class T >

virtual skip_type JLANG::JAbstractObjectReader< T >::skip ( const skip_type ns )

inlineoverridevirtualinherited

Skip items.

Parameters

ns	number of items to skip

Returns

number of items skipped

Reimplemented from JLANG::JObjectIterator< T >.

Definition at line 69 of file JAbstractObjectReader.hh.

    {
      if (this->getHelper() != NULL)
        return this->getHelper()->skip(ns);
      else
        return 0;
    } 

is_open()

template<class T >

virtual bool JLANG::JAbstractAccessibleObjectReader< T >::is_open ( ) const

inlineoverridevirtualinherited

Check is device is open.

Returns

true if open; else false

Implements JLANG::JAccessible.

Definition at line 137 of file JAbstractObjectReader.hh.

    {
      if (this->getHelper() != NULL)
        return this->getHelper()->is_open();
      else
        return false;
    }

getSharedPointer() [1/2]

const JSharedPointer & JLANG::JSharedPointer< JAccessibleObjectIterator< T >, JNew >::getSharedPointer ( ) const

inlineinherited

Get shared pointer.

Returns

this shared pointer

Definition at line 95 of file JSharedPointer.hh.

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

getSharedPointer() [2/2]

JSharedPointer & JLANG::JSharedPointer< JAccessibleObjectIterator< T >, JNew >::getSharedPointer ( )

inlineinherited

Get shared pointer.

Returns

this shared pointer

Definition at line 106 of file JSharedPointer.hh.

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

setSharedPointer()

void JLANG::JSharedPointer< JAccessibleObjectIterator< T >, JNew >::setSharedPointer ( const JSharedPointer< JAccessibleObjectIterator< T > > & object )

inlineinherited

Set shared pointer.

Parameters

object

shared pointer

Definition at line 117 of file JSharedPointer.hh.

    {
      if (this->get() != object.get()) {
 
        this->reset();
 
        if (object.is_valid()) {
          this->set(object);
        }
      }
    }

reset() [1/3]

virtual void JLANG::JSharedPointer< JAccessibleObjectIterator< T >, JNew >::reset ( )

inlineoverridevirtualinherited

Reset pointer.

The reference counter is decremented by one and the object pointed to previously is deleted when its reference counter is zero.

Reimplemented from JLANG::JStorage< JAccessibleObjectIterator< T >, JNew >.

Definition at line 171 of file JSharedPointer.hh.

    {
      if (this->detach()) {
        storage_type::reset();
      }
 
      pointer_type::reset();
    }

reset() [2/3]

void JLANG::JPointer< JAccessibleObjectIterator< T > >::reset ( const JPointer< T > & pointer )

inlineinherited

Reset pointer.

Parameters

pointer

pointer to object

Definition at line 35 of file JPointer.hh.

    {
      this->reset(pointer.get());
    }

reset() [3/3]

void JLANG::JAbstractPointer< JAccessibleObjectIterator< T > >::reset ( JAccessibleObjectIterator< T > * p )

inlineinherited

Reset pointer.

Parameters

p	pointer to object

Definition at line 94 of file JAbstractPointer.hh.

    {
      if (this->get() != p) {
 
        this->reset();
 
        if (p != NULL) {
          this->set(p);
        }
      }
    }

set() [1/3]

void JLANG::JSharedPointer< JAccessibleObjectIterator< T >, JNew >::set ( const JSharedPointer< JAccessibleObjectIterator< T > > & object )

inlineprotectedinherited

Set pointer.

The reference counter of the shared object pointed to is incremented by one.

Parameters

object

shared pointer

Definition at line 188 of file JSharedPointer.hh.

    {
      pointer_type::set(object.get());
 
      this->attach(object);
    }

set() [2/3]

virtual void JLANG::JSharedPointer< JAccessibleObjectIterator< T >, JNew >::set ( JAccessibleObjectIterator< T > * p )

inlineoverrideprotectedvirtualinherited

Set pointer.

The reference counter of the shared object pointed to is initialised to one.

Parameters

p	pointer to derived class object

Reimplemented from JLANG::JPointer< JAccessibleObjectIterator< T > >.

Definition at line 202 of file JSharedPointer.hh.

    {
      pointer_type::set(p);
 
      this->initialise();
    }

set() [3/3]

void JLANG::JPointer< JAccessibleObjectIterator< T > >::set ( const JPointer< T > & pointer )

inlineinherited

Set pointer.

Parameters

pointer

pointer to object

Definition at line 96 of file JPointer.hh.

    {
      this->set(pointer.get());
    }

initialise()

void JLANG::JSharedCounter::initialise ( )

inlineinherited

Initialise counter.

Definition at line 33 of file JSharedCounter.hh.

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

attach()

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

inlineinherited

Attach this counter to given shared counter object.

Parameters

object

shared counter

Definition at line 46 of file JSharedCounter.hh.

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

detach()

bool JLANG::JSharedCounter::detach ( )

inlineinherited

Detach.

Returns

true if counter at zero; else false

Definition at line 63 of file JSharedCounter.hh.

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

getCount()

const int JLANG::JSharedCounter::getCount ( )

inlineinherited

Get count.

Returns

count

Definition at line 88 of file JSharedCounter.hh.

    {
      return (counter != NULL ? *counter : 0);
    }

recreate()

void JLANG::JStorage< JAccessibleObjectIterator< T >, JNew >::recreate ( )

inlineinherited

Recreate object in memory.

A new object is created if no memory is allocated yet, else the previously created object is maintained.

Definition at line 57 of file JStorage.hh.

    {
      if (!this->is_valid()) {
        this->set(memory_type::create());
      }
    }

create() [1/2]

void JLANG::JStorage< JAccessibleObjectIterator< T >, JNew >::create ( )

inlineinherited

Create object in memory.

The memory allocated by a previously created object will be released.

Definition at line 69 of file JStorage.hh.

    {
      this->reset(memory_type::create());
    }

create() [2/2]

void JLANG::JStorage< JAccessibleObjectIterator< T >, JNew >::create ( const unsigned int size )

inlineinherited

Create array of objects in memory.

The memory allocated by previously created objects will be released.

Parameters

size	number of elements

Definition at line 81 of file JStorage.hh.

    {
      this->reset(memory_type::create(size));
    }

release() [1/2]

void JLANG::JStorage< JAccessibleObjectIterator< T >, JNew >::release ( )

inlineprotectedinherited

Release memory.

Definition at line 91 of file JStorage.hh.

    { 
      memory_type::release(this->get());
    }

release() [2/2]

static void JLANG::JNew< JAccessibleObjectIterator< T > >::release ( JAccessibleObjectIterator< T > * p )

inlinestaticinherited

Release memory.

Parameters

p	pointer to data

Definition at line 41 of file JMemory.hh.

    {
      delete p;
    }

get()

virtual JAccessibleObjectIterator< T > * JLANG::JPointer< JAccessibleObjectIterator< T > >::get ( ) const

inlineoverridevirtualinherited

Get pointer.

Returns

pointer to object

Implements JLANG::JAbstractPointer< JAccessibleObjectIterator< T > >.

Definition at line 64 of file JPointer.hh.

    {
      return this->__p;
    }

getReference() [1/2]

JAccessibleObjectIterator< T > *const & JLANG::JPointer< JAccessibleObjectIterator< T > >::getReference ( ) const

inlineinherited

Get rereference to internal pointer.

Returns

reference to internal pointer

Definition at line 119 of file JPointer.hh.

    {
      return __p;
    }

getReference() [2/2]

JAccessibleObjectIterator< T > *& JLANG::JPointer< JAccessibleObjectIterator< T > >::getReference ( )

inlineinherited

Get rereference to internal pointer.

Returns

reference to internal pointer

Definition at line 130 of file JPointer.hh.

    {
      return __p;
    }

equals()

virtual bool JLANG::JAbstractPointer< JAccessibleObjectIterator< T > >::equals ( const JAbstractPointer< JAccessibleObjectIterator< T > > & object ) const

inlinevirtualinherited

Equals.

The equality is evaluated by comparison of the internal pointers.

Parameters

object

abstract pointer

Returns

true if equals; else false

Definition at line 50 of file JAbstractPointer.hh.

    {
      return this->get() == object.get();
    }

is_valid()

bool JLANG::JAbstractPointer< JAccessibleObjectIterator< T > >::is_valid ( ) const

inlineinherited

Check validity of pointer.

Returns

true if pointer not null; else false

Definition at line 83 of file JAbstractPointer.hh.

    { 
      return this->get() != NULL; 
    }

operator->()

JAccessibleObjectIterator< T > * JLANG::JAbstractPointer< JAccessibleObjectIterator< T > >::operator-> ( ) const

inlineinherited

Smart pointer operator.

Returns

pointer to object

Definition at line 112 of file JAbstractPointer.hh.

    { 
      if (!is_valid())
        THROW(JNullPointerException, "JAbstractPointer::operator->()");
      else
        return this->get();
    }

operator JAccessibleObjectIterator< T > *()

JLANG::JAbstractPointer< JAccessibleObjectIterator< T > >::operator JAccessibleObjectIterator< T > * ( ) const

inlineinherited

Type conversion operator.

Returns

pointer to object

Definition at line 126 of file JAbstractPointer.hh.

    {
      return this->get();
    }

Throw() [1/2]

static void JLANG::JThrow< JAccessible >::Throw ( const bool option )

inlinestaticinherited

Enable/disable throw option.

Parameters

option

true enable; false disable

Definition at line 37 of file JThrow.hh.

    {
      do_throw = option;
    }

Throw() [2/2]

static int JLANG::JThrow< JAccessible >::Throw ( const JException_t & error, const int value = -1 )

inlinestaticinherited

Throw exception or return error.

Parameters

error	exception
value	return code

Returns

return code

Definition at line 51 of file JThrow.hh.

    {
      using namespace std;
      
      if (do_throw) {
        throw error;
      }
 
      cerr << error.what() << endl;
      
      return value;
    }

Member Data Documentation

ps

template<class T >

pointer_type JLANG::JAbstractObjectReader< T >::ps

privateinherited

Definition at line 78 of file JAbstractObjectReader.hh.

counter

int* JLANG::JSharedCounter::counter

protectedinherited

Definition at line 94 of file JSharedCounter.hh.

__p

JAccessibleObjectIterator< T >* JLANG::JPointer< JAccessibleObjectIterator< T > >::__p

protectedinherited

pointer to object

Definition at line 136 of file JPointer.hh.

do_throw

bool JLANG::JThrow< JAccessible >::do_throw

staticprotectedinherited

throw option

Set default throw option to true.

Definition at line 28 of file JThrow.hh.

---

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

• JFileScanner.hh