Arc::URLMap Class Reference

URLMap allows mapping certain patterns of URLs to other URLs. More...

#include <arc/data/URLMap.h>

Public Member Functions
	URLMap ()
	Construct an empty URLMap.
bool	map (URL &url) const
	Map a URL if possible. More...
bool	local (const URL &url) const
	Check if a mapping exists for a URL. More...
void	add (const URL &templ, const URL &repl, const URL &accs=URL())
	Add an entry to the URLMap. More...
	operator bool () const
	Returns true if the URLMap is not empty.
bool	operator! () const
	Returns true if the URLMap is empty.

Detailed Description

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.

Member Function Documentation

void Arc::URLMap::add	(	const URL &	templ,
		const URL &	repl,
		const URL &	accs = URL()
	)

Add an entry to the URLMap.

All URLs matching templ will have the templ part replaced by repl.

Parameters

templ	template to replace, for example gsiftp://se.org/files
repl	replacement for template, for example /export/grid/files
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

bool Arc::URLMap::local

(

const 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.

Parameters

url	URL to check

Returns

true if a mapping exists for this URL

bool Arc::URLMap::map

(

URL &

url

)

const

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.

Parameters

url	URL to check

Returns

true if the URL was mapped to a new URL, false if it was not mapped or an error occurred during mapping

---

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

• URLMap.h