File: device.h

package info (click to toggle)
biometryd 0.3.2-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 1,500 kB
  • sloc: cpp: 10,221; ansic: 191; python: 42; makefile: 20
file content (85 lines) | stat: -rw-r--r-- 2,531 bytes parent folder | download | duplicates (3)
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
/*
 * Copyright (C) 2016 Canonical, Ltd.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation; version 3.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 * Authored by: Thomas Voß <thomas.voss@canonical.com>
 *
 */

#ifndef BIOMETRY_DEVICE_H_
#define BIOMETRY_DEVICE_H_

#include <biometry/do_not_copy_or_move.h>
#include <biometry/visibility.h>

#include <iosfwd>
#include <memory>
#include <string>

namespace biometry
{
/// @cond
class Identifier;
class TemplateStore;
class Verifier;
namespace util
{
class Configuration;
}
/// @endcond

/// @brief Device models a biometric device.
class BIOMETRY_DLL_PUBLIC Device : public DoNotCopyOrMove
{
public:
    /// @brief Id is the unique name of a device.
    typedef std::string Id;

    /// @brief Descriptor bundles details about a device.
    class Descriptor : public DoNotCopyOrMove
    {
    public:
        // Safe us some typing.
        typedef std::shared_ptr<Descriptor> Ptr;

        /// @brief create returns an instance of the device.
        virtual std::shared_ptr<Device> create(const util::Configuration&) = 0;
        /// @brief name returns the human-readable name of the device.
        virtual std::string name() const = 0;
        /// @brief author returns the name of the author of the device implementation.
        virtual std::string author() const = 0;
        /// @brief description returns a one-line summary of the device implementation.
        virtual std::string description() const = 0;

    protected:
        /// @cond
        Descriptor() = default;
        /// @endcond
    };

    /// @brief enroller returns a device-specific template_store implementation.
    virtual TemplateStore& template_store() = 0;
    /// @brief identifier returns a device-specific Identifier implementation.
    virtual Identifier& identifier() = 0;
    /// @brief verifier returns a device-specific Verifier implementation.
    virtual Verifier& verifier() = 0;

protected:
    /// @cond
    Device() = default;
    /// @endcond
};
}

#endif // BIOMETRY_DEVICE_H_