/usr/include/Poco/URIStreamOpener.h is in libpoco-dev 1.8.0.1-1ubuntu4.
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 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 | //
// URIStreamOpener.h
//
// Library: Foundation
// Package: URI
// Module: URIStreamOpener
//
// Definition of the URIStreamOpener class.
//
// Copyright (c) 2004-2006, Applied Informatics Software Engineering GmbH.
// and Contributors.
//
// SPDX-License-Identifier: BSL-1.0
//
#ifndef Foundation_URIStreamOpener_INCLUDED
#define Foundation_URIStreamOpener_INCLUDED
#include "Poco/Foundation.h"
#include "Poco/Mutex.h"
#include <istream>
#include <map>
namespace Poco {
class URI;
class URIStreamFactory;
class Path;
class Foundation_API URIStreamOpener
/// The URIStreamOpener class is used to create and open input streams
/// for resourced identified by Uniform Resource Identifiers.
///
/// For every URI scheme used, a URIStreamFactory must be registered.
/// A FileStreamFactory is automatically registered for file URIs.
{
public:
enum
{
MAX_REDIRECTS = 10
};
URIStreamOpener();
/// Creates the URIStreamOpener and registers a FileStreamFactory
/// for file URIs.
~URIStreamOpener();
/// Destroys the URIStreamOpener and deletes all registered
/// URI stream factories.
std::istream* open(const URI& uri) const;
/// Tries to create and open an input stream for the resource specified
/// by the given uniform resource identifier.
///
/// If no URIStreamFactory has been registered for the URI's
/// scheme, a UnknownURIScheme exception is thrown.
/// If the stream cannot be opened for any reason, an
/// IOException is thrown.
///
/// The given URI must be a valid one. This excludes file system paths.
///
/// Whoever calls the method is responsible for deleting
/// the returned stream.
std::istream* open(const std::string& pathOrURI) const;
/// Tries to create and open an input stream for the resource specified
/// by the given path or uniform resource identifier.
///
/// If the stream cannot be opened for any reason, an
/// Exception is thrown.
///
/// The method first tries to interpret the given pathOrURI as an URI.
/// If this fails, the pathOrURI is treated as local filesystem path.
/// If this also fails, an exception is thrown.
///
/// Whoever calls the method is responsible for deleting
/// the returned stream.
std::istream* open(const std::string& basePathOrURI, const std::string& pathOrURI) const;
/// Tries to create and open an input stream for the resource specified
/// by the given path or uniform resource identifier.
///
/// pathOrURI is resolved against basePathOrURI (see URI::resolve() and
/// Path::resolve() for more information).
///
/// If the stream cannot be opened for any reason, an
/// Exception is thrown.
///
/// Whoever calls the method is responsible for deleting
/// the returned stream.
void registerStreamFactory(const std::string& scheme, URIStreamFactory* pFactory);
/// Registers a URIStreamFactory for the given scheme. If another factory
/// has already been registered for the scheme, an ExistsException is thrown.
///
/// The URIStreamOpener takes ownership of the factory and deletes it when it is
/// no longer needed (in other words, when the URIStreamOpener is deleted).
void unregisterStreamFactory(const std::string& scheme);
/// Unregisters and deletes the URIStreamFactory for the given scheme.
///
/// Throws a NotFoundException if no URIStreamFactory has been registered
/// for the given scheme.
bool supportsScheme(const std::string& scheme);
/// Returns true iff a URIStreamFactory for the given scheme
/// has been registered.
static URIStreamOpener& defaultOpener();
/// Returns a reference to the default URIStreamOpener.
protected:
std::istream* openFile(const Path& path) const;
std::istream* openURI(const std::string& scheme, const URI& uri) const;
private:
URIStreamOpener(const URIStreamOpener&);
URIStreamOpener& operator = (const URIStreamOpener&);
typedef std::map<std::string, URIStreamFactory*> FactoryMap;
FactoryMap _map;
mutable FastMutex _mutex;
};
} // namespace Poco
#endif // Foundation_URIStreamOpener_INCLUDED
|