aboutsummaryrefslogtreecommitdiffstats
path: root/yt/cpp/mapreduce/interface/skiff_row.h
blob: 5dd335cb6536097625341a70a15de21e1d7754bb (plain) (blame)
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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
#pragma once

///
/// @file yt/cpp/mapreduce/interface/skiff_row.h
/// Header containing interfaces that you need to define for using TSkiffRowTableReader
/// What you need to do for your struct type TMyType:
/// 1. Write `true` specialization TIsSkiffRow<TMyType>;
/// 2. Write specialization GetSkiffSchema<TMyType>();
/// 3. Write your own parser derived from ISkiffRowParser and write specialization GetSkiffParser<TMyType>() which returns this parser.

#include "fwd.h"

#include <yt/cpp/mapreduce/skiff/skiff_schema.h>

#include <yt/cpp/mapreduce/interface/format.h>

#include <library/cpp/skiff/skiff.h>

#include <util/generic/maybe.h>

namespace NYT {

////////////////////////////////////////////////////////////////////////////////

//! Need to write `true_type` specialization for your row type `T`.
/// And implement two functions: `GetSkiffSchema` and `CreateSkiffParser`.
///
/// Example:
///
/// template <>
/// struct TIsSkiffRow<T>
///     : std::true_type
/// { };
///
template<class T>
struct TIsSkiffRow
    : std::false_type
{ };

////////////////////////////////////////////////////////////////////////////////

//! Return skiff schema for row type `T`.
/// Need to write its specialization.
template <typename T>
NSkiff::TSkiffSchemaPtr GetSkiffSchema(const TMaybe<TSkiffRowHints>& /*hints*/)
{
    static_assert(TDependentFalse<T>, "Unimplemented `GetSkiffSchema` method");
}

////////////////////////////////////////////////////////////////////////////////

//! Allow to parse rows as user's structs from stream (TCheckedInDebugSkiffParser).
/// Need to write derived class for your own row type.
///
/// Example:
///
/// class TMySkiffRowParser : public ISkiffRowParser
/// {
/// public:
///    TMySkiffRowParser(TMySkiffRow* row)
///        : Row_(row)
///    {}
///
///    void Parse(NSkiff::TCheckedInDebugSkiffParser* parser)
/// .  {
///        Row_->SomeInt64Field = parser->ParseInt64();
///    }
///
/// private:
///    TMySkiffRow* Row_;
/// }
///
class ISkiffRowParser
    : public TThrRefBase
{
public:
    //! Read one row from parser
    virtual void Parse(NSkiff::TCheckedInDebugSkiffParser* /*parser*/) = 0;
};

//! Creates a parser for row type `T`.
template <typename T>
ISkiffRowParserPtr CreateSkiffParser(T* /*row*/, const TMaybe<TSkiffRowHints>& /*hints*/)
{
    static_assert(TDependentFalse<T>, "Unimplemented `CreateSkiffParser` function");
}

////////////////////////////////////////////////////////////////////////////////

//! Allow to skip row content without getting row.
/// By default row will be parsed using your parser derived from ISkiffRowParser.
/// If you want, you can write more optimal skipper, but it isn't required.
class ISkiffRowSkipper
    : public TThrRefBase
{
public:
    virtual void SkipRow(NSkiff::TCheckedInDebugSkiffParser* /*parser*/) = 0;
};

//! Default ISkiffRowSkipper implementation.
template <typename T>
class TSkiffRowSkipper : public ISkiffRowSkipper {
public:
  explicit TSkiffRowSkipper(const TMaybe<TSkiffRowHints>& hints)
    : Parser_(CreateSkiffParser<T>(&Row_, hints))
  { }

  void SkipRow(NSkiff::TCheckedInDebugSkiffParser* parser) {
    Parser_->Parse(parser);
  }

private:
  T Row_;
  ISkiffRowParserPtr Parser_;
};

//! Creates a skipper for row type 'T'.
/// You don't need to write its specialization.
template <typename T>
ISkiffRowSkipperPtr CreateSkiffSkipper(const TMaybe<TSkiffRowHints>& hints)
{
    return ::MakeIntrusive<TSkiffRowSkipper<T>>(hints);
}

////////////////////////////////////////////////////////////////////////////////

} // namespace NYT