/usr/include/kido/utils/CompositeResourceRetriever.hpp is in libkido-utils-dev 0.1.0+dfsg-2build9.
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 | /*
* Copyright (c) 2015, Georgia Tech Research Corporation
* All rights reserved.
*
* Author(s): Michael Koval <mkoval@cs.cmu.edu>
*
* Georgia Tech Graphics Lab and Humanoid Robotics Lab
*
* Directed by Prof. C. Karen Liu and Prof. Mike Stilman
* <karenliu@cc.gatech.edu> <mstilman@cc.gatech.edu>
*
* This file is provided under the following "BSD-style" License:
* Redistribution and use in source and binary forms, with or
* without modification, are permitted provided that the following
* conditions are met:
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above
* copyright notice, this list of conditions and the following
* disclaimer in the documentation and/or other materials provided
* with the distribution.
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
* CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
#ifndef KIDO_UTILS_COMPOSITERESOURCERETRIEVER_HPP_
#define KIDO_UTILS_COMPOSITERESOURCERETRIEVER_HPP_
#include <unordered_map>
#include <vector>
#include "kido/common/ResourceRetriever.hpp"
namespace kido {
namespace utils {
/// CompositeResourceRetriever allows multiple \ref ResourceRetriever to be
/// used interchangably by: (1) associating each \ref ResourceRetriever with a
/// particular URI schema and/or (2) providing a precedence order for trying
/// multiple retrievers.
class CompositeResourceRetriever : public virtual common::ResourceRetriever
{
public:
virtual ~CompositeResourceRetriever() = default;
/// \brief Add a default \ref ResourceRetriever for all URIs.
/// This \ref ResourceRetriever will be called after all schema-specific
/// ResourceRetrievers, if any, have failed. This method may be called
/// multiple times. In that case, the ResourceRetrievers will be queried
/// in the same order in which they were added.
void addDefaultRetriever(
const common::ResourceRetrieverPtr& _resourceRetriever);
/// \brief Add a default \ref ResourceRetriever for \a _schema
/// This \ref ResourceRetriever will be called after URIs that match the
/// specified schema. This method may be called multiple times. In that
/// case, the ResourceRetrievers will be queried in the same order in which
/// they were added.
bool addSchemaRetriever(
const std::string& _schema,
const common::ResourceRetrieverPtr& _resourceRetriever);
// Documentation inherited.
bool exists(const common::Uri& _uri) override;
// Documentation inherited.
common::ResourcePtr retrieve(const common::Uri& _uri) override;
private:
std::vector<common::ResourceRetrieverPtr> getRetrievers(
const common::Uri& _uri) const;
std::unordered_map<std::string,
std::vector<common::ResourceRetrieverPtr> > mResourceRetrievers;
std::vector<common::ResourceRetrieverPtr> mDefaultResourceRetrievers;
};
using CompositeResourceRetrieverPtr
= std::shared_ptr<CompositeResourceRetriever>;
} // namespace utils
} // namespace kido
#endif // ifndef KIDO_UTILS_COMPOSITERESOURCERETRIEVER_HPP_
|