summaryrefslogtreecommitdiffstats
blob: e6442b77272f33866006506e8bb2320258d79cb4 (plain)
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
/*
 * Copyright (c) 2011 Tobias Markmann
 * Licensed under the simplified BSD license.
 * See Documentation/Licenses/BSD-simplified.txt for more information.
 */

/*
 * Copyright (c) 2013-2016 Isode Limited.
 * All rights reserved.
 * See the COPYING file for more information.
 */

#pragma once

#include <memory>

#include <boost/cstdint.hpp>
#include <boost/optional.hpp>

#include <Swiften/Base/API.h>
#include <Swiften/Base/boost_bsignals.h>
#include <Swiften/FileTransfer/FileTransferError.h>

namespace Swift {
    /**
     * The FileTransfer class provides a general interface for file-transfer
     * implmenetations. Currently, only Jingle File Transfer based on XEP-0234 is
     * implementated in the \ref OutgoingJingleFileTransfer and
     * \ref IncomingJingleFileTransfer classes.
     */
    class SWIFTEN_API FileTransfer {
        public:
            struct State {
                enum Type {
                    Initial,
                    WaitingForStart,
                    Negotiating,
                    WaitingForAccept,
                    Transferring,
                    Canceled,
                    Failed,
                    Finished
                };

                State(Type type, const std::string& message = "") : type(type), message(message) {}

                Type type;
                std::string message;
            };
            typedef std::shared_ptr<FileTransfer> ref;

        public:
            FileTransfer();
            virtual ~FileTransfer();

            virtual void cancel() = 0;

            const std::string& getFileName() const {
                return filename_;
            }

            boost::uintmax_t getFileSizeInBytes() const {
                return fileSizeInBytes_;
            }

            const State& getState() const {
                return state_;
            }

            const std::string& getDescription() const {
                return description_;
            }

        public:
            boost::signal<void (size_t /* proccessedBytes */)> onProcessedBytes;
            boost::signal<void (const State&)> onStateChanged;
            boost::signal<void (boost::optional<FileTransferError>)> onFinished;

        protected:
            void setState(const State& state);
            void setFileInfo(const std::string& name, boost::uintmax_t size, const std::string& description);

        private:
            boost::uintmax_t fileSizeInBytes_;
            std::string filename_;
            std::string description_;
            State state_;
    };
}