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

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

#pragma once

#include <boost/cstdint.hpp>
#include <boost/optional.hpp>
#include <boost/shared_ptr.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 boost::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_;
			}

		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);

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