NAME
EDG::WP4::CCM::Fetch
SYNOPSIS
$fetch = EDG::WP4::CCM::Fetch->new({PROFILE_URL => "profile_url or hostname",
CONFIG => "path of config file",
FOREIGN => "1/0"});
$fetch->fetchProfile();
DESCRIPTION
Module provides Fetch class. This helps in retrieving XML profiles and from specified URLs. It allows users to retrieve local, as well as foreign node profiles.
Functions
-
new()
new({PROFILE_URL => "profile_url or hostname", CONFIG => "path of config file", FOREIGN => "1/0"});
Creates new Fetch object. Full url of the profile can be provided as parameter PROFILE_URL, if it is not a url a profile url will be calculated using 'base_url' config option in
/etc/ccm.conf
. Path of alternative configuration file can be given as CONFIG.Returns undef in case of error.
-
fetchProfile()
fetchProfile fetches the profile from profile url and keeps it at configured area. The cache root variable is set as $fetch_handle{'CACHE_ROOT'} which can further be passed to CacheManager object and use NVA-API to access Resources and Properties.
If the profile is foreign, then the cache_root configuration is expected to be just for this foreign host and unexpected behaviour will result if the cache_root is shared. Only a single (most recent) copy of the foreign copy will be stored: previous versions will be removed. Foreign profiles do not use failover URLs: if the primary URL is unavailable, then the fetch will fail.
Returns undef if it cannot fetch the profile due to a network error,
<$EDG::WP4::CCM::Fetch::ProfileCache::ERROR
> in case of other failure,SUCCESS
in case of successful fetch, but no updated profile andCHANGED
in case of successful fetch and updated profile.