Medical Imaging Interaction Toolkit  2024.06.00
Medical Imaging Interaction Toolkit
us::ModuleResource Class Reference

#include <usModuleResource.h>

Public Member Functions

 ModuleResource ()
 
 ModuleResource (const ModuleResource &resource)
 
 ~ModuleResource ()
 
ModuleResourceoperator= (const ModuleResource &resource)
 
bool operator< (const ModuleResource &resource) const
 
bool operator== (const ModuleResource &resource) const
 
bool operator!= (const ModuleResource &resource) const
 
bool IsValid () const
 
 operator bool_type () const
 
std::string GetName () const
 
std::string GetPath () const
 
std::string GetResourcePath () const
 
std::string GetBaseName () const
 
std::string GetCompleteBaseName () const
 
std::string GetSuffix () const
 
std::string GetCompleteSuffix () const
 
bool IsDir () const
 
bool IsFile () const
 
std::vector< std::string > GetChildren () const
 
std::vector< ModuleResourceGetChildResources () const
 
int GetSize () const
 
time_t GetLastModified () const
 

Detailed Description

Represents a resource (text file, image, etc.) embedded in a CppMicroServices module.

A ModuleResource object provides information about a resource (external file) which was embedded into this module's shared library. ModuleResource objects can be obtained be calling Module::GetResource or Module::FindResources.

Example code for retrieving a resource object and reading its contents:

// Get this module's Module object
ModuleResource resource = module->GetResource("config.properties");
if (resource.IsValid())
{
// Create a ModuleResourceStream object
ModuleResourceStream resourceStream(resource);
// Read the contents line by line
std::string line;
while (std::getline(resourceStream, line))
{
// Process the content
std::cout << line << std::endl;
}
}
else
{
// Error handling
}

ModuleResource objects have value semantics and copies are very inexpensive.

See also
ModuleResourceStream
The Resources System

Definition at line 55 of file usModuleResource.h.

Constructor & Destructor Documentation

◆ ModuleResource() [1/2]

us::ModuleResource::ModuleResource ( )

Creates in invalid ModuleResource object.

◆ ModuleResource() [2/2]

us::ModuleResource::ModuleResource ( const ModuleResource resource)

Copy constructor.

Parameters
resourceThe object to be copied.

◆ ~ModuleResource()

us::ModuleResource::~ModuleResource ( )

Member Function Documentation

◆ GetBaseName()

std::string us::ModuleResource::GetBaseName ( ) const

Returns the base name of the resource without the path.

Example:

ModuleResource resource = module->GetResource("/data/archive.tar.gz");
std::string base = resource.GetBaseName(); // base = "archive"
Returns
The resource base name.
See also
GetName(), GetSuffix(), GetCompleteSuffix() and GetCompleteBaseName()

◆ GetChildren()

std::vector<std::string> us::ModuleResource::GetChildren ( ) const

Returns a list of resource names which are children of this object.

The returned names are relative to the path of this ModuleResource object and may contain file as well as directory entries.

Returns
A list of child resource names.

◆ GetChildResources()

std::vector<ModuleResource> us::ModuleResource::GetChildResources ( ) const

Returns a list of resource objects which are children of this object.

The return ModuleResource objects may contain files as well as directory resources.

Returns
A list of child resource objects.

◆ GetCompleteBaseName()

std::string us::ModuleResource::GetCompleteBaseName ( ) const

Returns the complete base name of the resource without the path.

Example:

ModuleResource resource = module->GetResource("/data/archive.tar.gz");
std::string base = resource.GetCompleteBaseName(); // base = "archive.tar"
Returns
The resource's complete base name.
See also
GetName(), GetSuffix(), GetCompleteSuffix(), and GetBaseName()

◆ GetCompleteSuffix()

std::string us::ModuleResource::GetCompleteSuffix ( ) const

Returns the complete suffix of the resource.

The suffix consists of all characters in the resource name after (but not including) the first '.'.

Example:

ModuleResource resource = module->GetResource("/data/archive.tar.gz");
std::string suffix = resource.GetCompleteSuffix(); // suffix = "tar.gz"
Returns
The resource name suffix.
See also
GetName(), GetSuffix(), GetBaseName(), and GetCompleteBaseName()

◆ GetLastModified()

time_t us::ModuleResource::GetLastModified ( ) const

Returns the last modified time of this resource in seconds from the epoch.

Returns
Last modified time of this resource.

◆ GetName()

std::string us::ModuleResource::GetName ( ) const

Returns the name of the resource, excluding the path.

Example:

ModuleResource resource = module->GetResource("/data/archive.tar.gz");
std::string name = resource.GetName(); // name = "archive.tar.gz"
Returns
The resource name.
See also
GetPath(), GetResourcePath()

◆ GetPath()

std::string us::ModuleResource::GetPath ( ) const

Returns the resource's path, without the file name.

Example:

ModuleResource resource = module->GetResource("/data/archive.tar.gz");
std::string path = resource.GetPath(); // path = "/data/"

The path with always begin and end with a forward slash.

Returns
The resource path without the name.
See also
GetResourcePath(), GetName() and IsDir()

◆ GetResourcePath()

std::string us::ModuleResource::GetResourcePath ( ) const

Returns the resource path including the file name.

Returns
The resource path including the file name.
See also
GetPath(), GetName() and IsDir()

◆ GetSize()

int us::ModuleResource::GetSize ( ) const

Returns the size of the resource data for this ModuleResource object.

Returns
The resource data size.

◆ GetSuffix()

std::string us::ModuleResource::GetSuffix ( ) const

Returns the suffix of the resource.

The suffix consists of all characters in the resource name after (but not including) the last '.'.

Example:

ModuleResource resource = module->GetResource("/data/archive.tar.gz");
std::string suffix = resource.GetSuffix(); // suffix = "gz"
Returns
The resource name suffix.
See also
GetName(), GetCompleteSuffix(), GetBaseName() and GetCompleteBaseName()

◆ IsDir()

bool us::ModuleResource::IsDir ( ) const

Returns true if this ModuleResource object points to a directory and thus may have child resources.

Returns
true if this object points to a directory, false otherwise.

◆ IsFile()

bool us::ModuleResource::IsFile ( ) const

Returns true if this ModuleResource object points to a file resource.

Returns
true if this object points to an embedded file, false otherwise.

◆ IsValid()

bool us::ModuleResource::IsValid ( ) const

Tests this ModuleResource object for validity.

Invalid ModuleResource objects are created by the default constructor or can be returned by the Module class if the resource path is not found.

Returns
true if this ModuleReource object is valid and can safely be used, false otherwise.

◆ operator bool_type()

us::ModuleResource::operator bool_type ( ) const

Boolean conversion operator using IsValid().

◆ operator!=()

bool us::ModuleResource::operator!= ( const ModuleResource resource) const

Inequality operator for ModuleResource objects.

Parameters
resourceThe object for testing inequality.
Returns
The result of !(*this == resource).

◆ operator<()

bool us::ModuleResource::operator< ( const ModuleResource resource) const

A less then operator using the full resource path as returned by GetResourcePath() to define the ordering.

Parameters
resourceThe object to which this ModuleResource object is compared to.
Returns
true if this ModuleResource object is less then resource, false otherwise.

◆ operator=()

ModuleResource& us::ModuleResource::operator= ( const ModuleResource resource)

Assignment operator.

Parameters
resourceThe ModuleResource object which is assigned to this instance.
Returns
A reference to this ModuleResource instance.

◆ operator==()

bool us::ModuleResource::operator== ( const ModuleResource resource) const

Equality operator for ModuleResource objects.

Parameters
resourceThe object for testing equality.
Returns
true if this ModuleResource object is equal to resource, i.e. they are coming from the same module (shared or static) and have an equal resource path, false otherwise.

The documentation for this class was generated from the following file:
us::ModuleResource::Module
friend class Module
Definition: usModuleResource.h:282
us::GetModuleContext
static ModuleContext * GetModuleContext()
Returns the module context of the calling module.
Definition: usGetModuleContext.h:50
us::ModuleResource::ModuleResourceStream
friend class ModuleResourceStream
Definition: usModuleResource.h:285
ModuleContext::GetModule
Module * GetModule() const
us::ModuleResource::ModuleResource
ModuleResource()