ACE  6.3.3
Public Types | Public Member Functions | Protected Member Functions | Private Member Functions | Private Attributes | Friends | List of all members
ACE_Filecache_Object Class Reference

Abstraction over a real file. This is what the Virtual Filesystem contains. This class is not intended for general consumption. Please consult a physician before attempting to use this class. More...

#include <Filecache.h>

Collaboration diagram for ACE_Filecache_Object:
Collaboration graph
[legend]

Public Types

enum  Creation_States { ACE_READING = 1, ACE_WRITING = 2 }
 
enum  Error_Conditions {
  ACE_SUCCESS = 0, ACE_ACCESS_FAILED, ACE_OPEN_FAILED, ACE_COPY_FAILED,
  ACE_STAT_FAILED, ACE_MEMMAP_FAILED, ACE_WRITE_FAILED
}
 

Public Member Functions

 ACE_Filecache_Object (const ACE_TCHAR *filename, ACE_SYNCH_RW_MUTEX &lock, LPSECURITY_ATTRIBUTES sa=0, int mapit=1)
 Creates a file for reading. More...
 
 ACE_Filecache_Object (const ACE_TCHAR *filename, ACE_OFF_T size, ACE_SYNCH_RW_MUTEX &lock, LPSECURITY_ATTRIBUTES sa=0)
 Creates a file for writing. More...
 
 ~ACE_Filecache_Object (void)
 Only if reference count is zero should this be called. More...
 
int acquire (void)
 Increment the reference_count_. More...
 
int release (void)
 Decrement the reference_count_. More...
 
int error (void) const
 
int error (int error_value, const ACE_TCHAR *s=ACE_TEXT("ACE_Filecache_Object"))
 
const ACE_TCHARfilename (void) const
 filename_ accessor More...
 
ACE_HANDLE handle (void) const
 handle_ accessor. More...
 
void * address (void) const
 Base memory address for memory mapped file. More...
 
ACE_OFF_T size (void) const
 size_ accessor. More...
 
int update (void) const
 True if file on disk is newer than cached file. More...
 

Protected Member Functions

 ACE_Filecache_Object (void)
 Prevent from being called. More...
 
void init (void)
 Common initialization code,. More...
 

Private Member Functions

int error_i (int error_value, const ACE_TCHAR *s=ACE_TEXT("ACE_Filecache_Object"))
 Internal error logging method, no locking. More...
 

Private Attributes

ACE_TCHARtempname_
 
ACE_TCHAR filename_ [MAXPATHLEN+1]
 
ACE_Mem_Map mmap_
 Holds the memory mapped version of the temporary file. More...
 
ACE_HANDLE handle_
 The descriptor to the temporary file. More...
 
ACE_stat stat_
 Used to compare against the real file to test if an update is needed. More...
 
ACE_OFF_T size_
 
int action_
 Status indicators. More...
 
int error_
 
int stale_
 If set to 1, means the object is flagged for removal. More...
 
LPSECURITY_ATTRIBUTES sa_
 Security attribute object. More...
 
ACE_SYNCH_RW_MUTEX junklock_
 The default initializer. More...
 
ACE_SYNCH_RW_MUTEXlock_
 Provides a bookkeeping mechanism for users of this object. More...
 

Friends

class ACE_Filecache
 

Detailed Description

Abstraction over a real file. This is what the Virtual Filesystem contains. This class is not intended for general consumption. Please consult a physician before attempting to use this class.

Member Enumeration Documentation

Enumerator
ACE_READING 
ACE_WRITING 
Enumerator
ACE_SUCCESS 
ACE_ACCESS_FAILED 
ACE_OPEN_FAILED 
ACE_COPY_FAILED 
ACE_STAT_FAILED 
ACE_MEMMAP_FAILED 
ACE_WRITE_FAILED 

Constructor & Destructor Documentation

ACE_Filecache_Object::ACE_Filecache_Object ( const ACE_TCHAR filename,
ACE_SYNCH_RW_MUTEX lock,
LPSECURITY_ATTRIBUTES  sa = 0,
int  mapit = 1 
)

Creates a file for reading.

ACE_Filecache_Object::ACE_Filecache_Object ( const ACE_TCHAR filename,
ACE_OFF_T  size,
ACE_SYNCH_RW_MUTEX lock,
LPSECURITY_ATTRIBUTES  sa = 0 
)

Creates a file for writing.

ACE_Filecache_Object::~ACE_Filecache_Object ( void  )

Only if reference count is zero should this be called.

ACE_Filecache_Object::ACE_Filecache_Object ( void  )
protected

Prevent from being called.

Member Function Documentation

int ACE_Filecache_Object::acquire ( void  )

Increment the reference_count_.

void * ACE_Filecache_Object::address ( void  ) const

Base memory address for memory mapped file.

int ACE_Filecache_Object::error ( void  ) const
int ACE_Filecache_Object::error ( int  error_value,
const ACE_TCHAR s = ACE_TEXT("ACE_Filecache_Object") 
)
int ACE_Filecache_Object::error_i ( int  error_value,
const ACE_TCHAR s = ACE_TEXT ("ACE_Filecache_Object") 
)
private

Internal error logging method, no locking.

const ACE_TCHAR * ACE_Filecache_Object::filename ( void  ) const

filename_ accessor

ACE_HANDLE ACE_Filecache_Object::handle ( void  ) const

handle_ accessor.

void ACE_Filecache_Object::init ( void  )
protected

Common initialization code,.

int ACE_Filecache_Object::release ( void  )

Decrement the reference_count_.

ACE_OFF_T ACE_Filecache_Object::size ( void  ) const

size_ accessor.

int ACE_Filecache_Object::update ( void  ) const

True if file on disk is newer than cached file.

Friends And Related Function Documentation

friend class ACE_Filecache
friend

Member Data Documentation

int ACE_Filecache_Object::action_
private

Status indicators.

int ACE_Filecache_Object::error_
private
ACE_TCHAR ACE_Filecache_Object::filename_[MAXPATHLEN+1]
private
ACE_HANDLE ACE_Filecache_Object::handle_
private

The descriptor to the temporary file.

ACE_SYNCH_RW_MUTEX ACE_Filecache_Object::junklock_
private

The default initializer.

ACE_SYNCH_RW_MUTEX& ACE_Filecache_Object::lock_
private

Provides a bookkeeping mechanism for users of this object.

ACE_Mem_Map ACE_Filecache_Object::mmap_
private

Holds the memory mapped version of the temporary file.

LPSECURITY_ATTRIBUTES ACE_Filecache_Object::sa_
private

Security attribute object.

ACE_OFF_T ACE_Filecache_Object::size_
private
int ACE_Filecache_Object::stale_
private

If set to 1, means the object is flagged for removal.

ACE_stat ACE_Filecache_Object::stat_
private

Used to compare against the real file to test if an update is needed.

ACE_TCHAR* ACE_Filecache_Object::tempname_
private

The temporary file name and the real file name. The real file is copied into the temporary file for safety reasons.


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