RoutingExceptions.h

Go to the documentation of this file.

// Copyright 2014 Sensics, Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

#ifndef INCLUDED_RoutingExceptions_h_GUID_DDBD7E30_8C15_46AE_4221_1EB366EA079D
#define INCLUDED_RoutingExceptions_h_GUID_DDBD7E30_8C15_46AE_4221_1EB366EA079D

// Internal Includes
// - none

// Library/third-party includes
// - none

// Standard includes
#include <stdexcept>
#include <string>

namespace osvr {
namespace common {
    namespace exceptions {
        struct InvalidDeviceName : std::runtime_error {
            InvalidDeviceName(std::string const &details)
                : std::runtime_error(
                      "Attempted to add invalid device name to tree: " +
                      details) {}
        };

        struct EmptyPathComponent : std::runtime_error {
            EmptyPathComponent(std::string const &path)
                : std::runtime_error(
                      "Cannot use a path with an empty component: " + path) {}
        };

        struct ImpossibleParentPath : std::runtime_error {
            ImpossibleParentPath()
                : std::runtime_error("Cannot specify .. for parent path when "
                                     "already at the root!") {}
        };

        struct ForbiddenAbsolutePath : std::runtime_error {
            ForbiddenAbsolutePath()
                : std::runtime_error(
                      "Cannot specify an absolute path in this context!") {}
        };

        struct ForbiddenParentPath : std::runtime_error {
            ForbiddenParentPath()
                : std::runtime_error("Cannot specify .. in a parent path used "
                                     "in this context!") {}
        };

        struct EmptyPath : std::runtime_error {
            EmptyPath()
                : std::runtime_error("Cannot retrieve an empty path!") {}
        };

        struct PathNotAbsolute : std::runtime_error {
            PathNotAbsolute(std::string const &path)
                : std::runtime_error(
                      "Provided path was not absolute (no leading slash): " +
                      path) {}
        };

        namespace invariants {
            struct InvariantError : std::runtime_error {
                InvariantError(std::string const &msg)
                    : std::runtime_error("Path tree violated invariant: " +
                                         msg) {}
            };

            struct SensorMissingParent : InvariantError {
                SensorMissingParent(std::string const &path = std::string())
                    : InvariantError("Sensor element missing a parent! " +
                                     path) {}
            };
            struct SensorMissingInterfaceParent : InvariantError {
                SensorMissingInterfaceParent(
                    std::string const &path = std::string())
                    : InvariantError("Sensor element does not have an "
                                     "InterfaceElement parent! " +
                                     path) {}
            };

            struct InterfaceMissingParent : InvariantError {
                InterfaceMissingParent(std::string const &path = std::string())
                    : InvariantError("Interface elements must have a "
                                     "parent of some device type! " +
                                     path) {}
            };
        } // namespace invariants

    } // namespace exceptions
} // namespace common
} // namespace osvr
#endif // INCLUDED_RoutingExceptions_h_GUID_DDBD7E30_8C15_46AE_4221_1EB366EA079D