/usr/include/arc/data/URLMap.h is in nordugrid-arc-dev 4.2.0-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 | // -*- indent-tabs-mode: nil -*-
#ifndef __ARC_URLMAP_H__
#define __ARC_URLMAP_H__
#include <list>
#include <arc/URL.h>
#include <arc/Logger.h>
namespace Arc {
/// URLMap allows mapping certain patterns of URLs to other URLs.
/**
* A URLMap can be used if certain URLs can be more efficiently accessed
* by other means on a certain site. For example a GridFTP storage element
* may be mounted as a local file system and so a map can be made from a
* gsiftp:// URL to a local file path.
* \ingroup data
* \headerfile URLMap.h arc/data/URLMap.h
*/
class URLMap {
private:
class map_entry {
public:
URL initial;
URL replacement;
URL access;
map_entry() {}
map_entry(const URL& templ, const URL& repl, const URL& accs = URL())
: initial(templ),
replacement(repl),
access(accs) {}
};
std::list<map_entry> entries;
static Logger logger;
public:
/// Construct an empty URLMap.
URLMap();
~URLMap();
/// Map a URL if possible.
/**
* If the given URL matches any template it will be changed to the mapped
* URL. Additionally, if the mapped URL is a local file, a permission check
* is done by attempting to open the file. If a different access path is
* specified for this URL the URL will be changed to link://accesspath. To
* check if a URL will be mapped without changing it local() can be used.
* \param url URL to check
* \return true if the URL was mapped to a new URL, false if it was not
* mapped or an error occurred during mapping
*/
bool map(URL& url) const;
/// Check if a mapping exists for a URL.
/**
* Checks to see if a URL will be mapped but does not do the mapping.
* @param url URL to check
* @return true if a mapping exists for this URL
*/
bool local(const URL& url) const;
/// Add an entry to the URLMap.
/**
* All URLs matching templ will have the templ part replaced by repl.
* @param templ template to replace, for example gsiftp://se.org/files
* @param repl replacement for template, for example /export/grid/files
* @param accs replacement path if it differs in the place the file will
* actually be accessed (e.g. on worker nodes), for example
* /mount/grid/files
*/
void add(const URL& templ, const URL& repl, const URL& accs = URL());
/// Returns true if the URLMap is not empty.
operator bool() const { return entries.size() != 0; };
/// Returns true if the URLMap is empty.
bool operator!() const { return entries.size() == 0; };
};
} // namespace Arc
#endif // __ARC_URLMAP_H__
|