blob: 1357651730c007acc9f7d8942a661bc2a30ae4fa (
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
|
// Copyright (C) 2013 Google 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.
//
// An object to wrap data with a checksum and a timestamp. These fields are used
// to verify that the data is not stale or corrupted. Staleness threshold is 1
// month.
#ifndef I18N_ADDRESSINPUT_VALIDATING_UTIL_H_
#define I18N_ADDRESSINPUT_VALIDATING_UTIL_H_
#include <ctime>
#include <string>
namespace i18n {
namespace addressinput {
// Wraps data with a checksum and a timestamp. Sample usage:
// std::string data = ...
// ValidatingUtil::Wrap(time(NULL), &data);
// Process(data);
//
// std::string unwrapped = wrapped;
// if (ValidatingUtil::UnwrapTimestamp(&unwrapped, time(NULL)) &&
// ValidatingUtil::UnwrapChecksum(&unwrapped)) {
// Process(unwrapped);
// }
class ValidatingUtil {
public:
// Adds checksum and given |timestamp| to |data|.
static void Wrap(time_t timestamp, std::string* data);
// Strips out the timestamp from |data|. Returns |true| if the timestamp is
// present, formatted correctly, valid, and recent with respect to |now|.
static bool UnwrapTimestamp(std::string* data, time_t now);
// Strips out the checksum from |data|. Returns |true| if the checksum is
// present, formatted correctly, and valid for this data.
static bool UnwrapChecksum(std::string* data);
};
} // namespace addressinput
} // namespace i18n
#endif // I18N_ADDRESSINPUT_VALIDATING_UTIL_H_
|
