KafkaTopology.kt 9.52 KB
Newer Older
Jonas Waeber's avatar
Jonas Waeber committed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
/*
 * mapper-service
 * Copyright (C) 2020 Memoriav
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * 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 Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */

package org.memobase

Jonas Waeber's avatar
Jonas Waeber committed
21
import ch.memobase.builder.ResourceBuilder
22
import ch.memobase.exceptions.InvalidMappingException
Jonas Waeber's avatar
Jonas Waeber committed
23
24
import ch.memobase.kafka.utils.ConfigJoiner
import ch.memobase.kafka.utils.models.ImportService
Jonas Waeber's avatar
Jonas Waeber committed
25
import ch.memobase.kafka.utils.models.JoinedValues
26
import ch.memobase.kafka.utils.models.ValueWithException
Jonas Waeber's avatar
Jonas Waeber committed
27
import ch.memobase.mapping.MapperConfiguration
Jonas Waeber's avatar
Jonas Waeber committed
28
import ch.memobase.mapping.MappingConfigurationParser
Jonas Waeber's avatar
Jonas Waeber committed
29
30
31
32
33
import ch.memobase.reporting.Report
import ch.memobase.reporting.ReportStatus
import ch.memobase.settings.HeaderExtractionTransformSupplier
import ch.memobase.settings.HeaderMetadata
import ch.memobase.settings.SettingsLoader
Jonas Waeber's avatar
Jonas Waeber committed
34
import com.beust.klaxon.Klaxon
35
import com.beust.klaxon.KlaxonException
Jonas Waeber's avatar
Jonas Waeber committed
36
import org.apache.jena.riot.RDFFormat
Jonas Waeber's avatar
Jonas Waeber committed
37
import org.apache.kafka.common.serialization.Serdes
Jonas Waeber's avatar
Jonas Waeber committed
38
import org.apache.kafka.streams.KeyValue
Jonas Waeber's avatar
Jonas Waeber committed
39
import org.apache.kafka.streams.StreamsBuilder
40
41
import org.apache.kafka.streams.kstream.KStream
import org.apache.kafka.streams.kstream.Predicate
Jonas Waeber's avatar
Jonas Waeber committed
42
43
import org.apache.logging.log4j.LogManager

44
45
class KafkaTopology(
    private val settings: SettingsLoader
Jonas Waeber's avatar
Jonas Waeber committed
46
) {
Jonas Waeber's avatar
Jonas Waeber committed
47

Jonas Waeber's avatar
Jonas Waeber committed
48
    private val log = LogManager.getLogger("MappingProcessor")
Jonas Waeber's avatar
Jonas Waeber committed
49
    private val reportTopic = settings.processReportTopic
Jonas Waeber's avatar
Jonas Waeber committed
50
    private val klaxon = Klaxon()
Jonas Waeber's avatar
Jonas Waeber committed
51

52
    private val configJoiner = ConfigJoiner<String, ByteArray>(
Jonas Waeber's avatar
Jonas Waeber committed
53
54
55
        ImportService.Mapping,
        Serdes.String(),
        Serdes.serdeFrom(
56
57
58
59
60
61
62
            { _, data ->
                data
            },
            { _, data ->
                data
            }
        ),
Jonas Waeber's avatar
Jonas Waeber committed
63
64
        this::parseConfig
    )
Jonas Waeber's avatar
Jonas Waeber committed
65

Jonas Waeber's avatar
Jonas Waeber committed
66
    fun prepare(): StreamsBuilder {
Jonas Waeber's avatar
Jonas Waeber committed
67
68
        val builder = StreamsBuilder()

Jonas Waeber's avatar
Jonas Waeber committed
69
70
        val configStream = builder.stream<String, String>("import-process-config")
            .map { key, value -> KeyValue(key.toByteArray(), value.toByteArray()) }
Jonas Waeber's avatar
Jonas Waeber committed
71

Jonas Waeber's avatar
Jonas Waeber committed
72
        val stream = builder.stream<String, String>(settings.inputTopic)
73

Jonas Waeber's avatar
Jonas Waeber committed
74
75
        val joinedStream =
            configJoiner.join(stream, configStream)
76

77
        val handledStream = joinedStream
Jonas Waeber's avatar
Jonas Waeber committed
78
            .mapValues { value -> handleExceptions(value) }
79
80
81
82
83
84
85
            .branch(
                Predicate { _, value -> value.third != "" },
                Predicate { _, _ -> true }
            )

        handledStream[0]
            .mapValues { readOnlyKey, value ->
Jonas Waeber's avatar
Jonas Waeber committed
86
                Report(readOnlyKey, ReportStatus.fatal, value.third, Service.step).toJson()
Sebastian Schüpbach's avatar
Sebastian Schüpbach committed
87
            }
88
89
90
91
            .to(reportTopic)

        val parsedStream = handledStream[1]
            .mapValues { value -> Pair(value.first, value.second) }
Sebastian Schüpbach's avatar
Sebastian Schüpbach committed
92
93
94
            .mapValues { readOnlyKey, value ->
                parse(readOnlyKey, value)
            }
Jonas Waeber's avatar
Jonas Waeber committed
95
96
97
98
99
100
101
102
103
            .branch(
                Predicate { _, value -> value.third != null },
                Predicate { _, _ -> true }
            )

        parsedStream[0]
            .mapValues { key, value ->
                value.third?.toJson() ?: Report(
                    key,
Jonas Waeber's avatar
Jonas Waeber committed
104
                    ReportStatus.fatal,
105
                    "Caught an error, but no report was created.",
Jonas Waeber's avatar
Jonas Waeber committed
106
                    Service.step
Jonas Waeber's avatar
Jonas Waeber committed
107
108
109
                )
            }
            .to(reportTopic)
110

Jonas Waeber's avatar
Jonas Waeber committed
111
112
        val extractedRecordIdStream = parsedStream[1]
            .mapValues { value -> Pair(value.first!!, value.second!!) }
Jonas Waeber's avatar
Jonas Waeber committed
113
            .transformValues(HeaderExtractionTransformSupplier<Pair<Map<String, Any>, MapperConfiguration>>())
114
115
116
117
118
119
120
121
122
123
124
125
126
            .mapValues { value -> buildResources(value) }
            .mapValues { value -> value.extractRecordId() }

        val extractedRecordTypeValueStream = extractRecordId(extractedRecordIdStream)

        val hasIdAndTypeStream = extractRecordTypeValue(extractedRecordTypeValueStream)

        val completedMappingStream = hasIdAndTypeStream
            .mapValues { value -> value.generateRecord() }
            .mapValues { value -> value.generatePhysicalObject() }
            .mapValues { value -> value.generateDigitalObject() }
            .mapValues { value -> value.addDerivedConnection() }

Jonas Waeber's avatar
Jonas Waeber committed
127
128
        val recordStream = completedMappingStream
            .map { _, value -> writeRecord(value) }
Jonas Waeber's avatar
Jonas Waeber committed
129
        objectOutput(recordStream)
Jonas Waeber's avatar
Jonas Waeber committed
130
        return builder
Jonas Waeber's avatar
Jonas Waeber committed
131
    }
Jonas Waeber's avatar
Jonas Waeber committed
132

133
134
135
    private fun handleExceptions(value: ValueWithException<JoinedValues<String, ByteArray>>): Triple<String, ByteArray, String> {
        return when {
            value.hasException() -> {
Sebastian Schüpbach's avatar
Sebastian Schüpbach committed
136
                Triple("", ByteArray(0), value.exception.localizedMessage)
137
138
139
140
141
142
143
144
145
146
            }
            value.hasValue() -> {
                Triple(value.value.left, value.value.right, "")
            }
            else -> {
                Triple("", ByteArray(0), "Could not handle error in kafka utils library.")
            }
        }
    }

Jonas Waeber's avatar
Jonas Waeber committed
147
    private fun objectOutput(stream: KStream<String, Pair<String, Report>>) {
148
        stream
Jonas Waeber's avatar
Jonas Waeber committed
149
            .mapValues { _, value -> value.first }
150
151
152
            .to(settings.outputTopic)

        stream
Jonas Waeber's avatar
Jonas Waeber committed
153
            .mapValues { _, value -> value.second.toJson() }
154
155
156
            .to(reportTopic)
    }

Jonas Waeber's avatar
Jonas Waeber committed
157
    private fun buildResources(value: Pair<Pair<Map<String, Any>, MapperConfiguration>, HeaderMetadata>): ResourceBuilder {
158
        return ResourceBuilder(
Jonas Waeber's avatar
Jonas Waeber committed
159
160
161
            value.first.first,
            value.first.second,
            value.second.institutionId,
162
            value.second.recordSetId,
Jonas Waeber's avatar
Jonas Waeber committed
163
            value.second.isPublished
164
165
166
167
168
169
170
171
172
173
174
175
        )
    }

    private fun extractRecordId(stream: KStream<String, ResourceBuilder>): KStream<String, ResourceBuilder> {
        val hasRecordId = stream.branch(
            Predicate { _, value -> value.hasRecordId() },
            Predicate { _, _ -> true }
        )
        // early termination if there is no record id!
        val noRecordId = hasRecordId[1]

        noRecordId
176
177
178
179
180
181
182
183
            .mapValues { key, value ->
                Report(
                    key,
                    ReportStatus.fatal,
                    value.errorMessages.joinToString("\n"),
                    Service.step
                ).toJson()
            }
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
            .to(reportTopic)

        return hasRecordId[0]
            .mapValues { value -> value.extractRecordTypeValue() }
    }

    private fun extractRecordTypeValue(stream: KStream<String, ResourceBuilder>): KStream<String, ResourceBuilder> {
        val hasRecordTypeValue = stream
            .branch(
                Predicate { _, value -> value.hasRecordType() },
                Predicate { _, _ -> true }
            )

        val noRecordTypeValue = hasRecordTypeValue[1]

        noRecordTypeValue
Jonas Waeber's avatar
Jonas Waeber committed
200
            .mapValues { key, value ->
Jonas Waeber's avatar
Jonas Waeber committed
201
202
                Report(
                    key,
Jonas Waeber's avatar
Jonas Waeber committed
203
                    ReportStatus.fatal,
204
                    value.errorMessages.joinToString("\n"),
Jonas Waeber's avatar
Jonas Waeber committed
205
                    Service.step
Jonas Waeber's avatar
Jonas Waeber committed
206
                ).toJson()
Jonas Waeber's avatar
Jonas Waeber committed
207
            }
208
209
210
211
            .to(reportTopic)

        return hasRecordTypeValue[0]
    }
Jonas Waeber's avatar
Jonas Waeber committed
212

Jonas Waeber's avatar
Jonas Waeber committed
213
    private fun writeRecord(builder: ResourceBuilder): KeyValue<String, Pair<String, Report>> {
Jonas Waeber's avatar
Jonas Waeber committed
214
        val result = builder.writeRecord(RDFFormat.NTRIPLES_UTF8)
215
216
217
218
219
220
221
222

        if (result.third.isEmpty()) {
            return KeyValue(
                result.first,
                Pair(
                    result.second,
                    Report(result.first, ReportStatus.success, "", Service.step)
                )
Jonas Waeber's avatar
Jonas Waeber committed
223
            )
224
225
226
227
228
229
230
231
232
        } else {
            return KeyValue(
                result.first,
                Pair(
                    result.second,
                    Report(result.first, ReportStatus.warning, result.third.joinToString("\n"), Service.step)
                )
            )
        }
Jonas Waeber's avatar
Jonas Waeber committed
233
234
    }

235
236
    private fun parseConfig(data: ByteArray): ByteArray {
        return data
Jonas Waeber's avatar
Jonas Waeber committed
237
    }
Jonas Waeber's avatar
Jonas Waeber committed
238
239
240

    private fun parse(
        key: String,
241
        value: Pair<String, ByteArray>
Jonas Waeber's avatar
Jonas Waeber committed
242
243
    ): Triple<Map<String, Any>?, MapperConfiguration?, Report?> {
        return try {
244
245
            val mapperConfiguration = MappingConfigurationParser(value.second)
            val parsedSource = klaxon.parse<Map<String, Any>>(value.first)
Jonas Waeber's avatar
Jonas Waeber committed
246
247
248
249
            if (parsedSource != null) {
                log.info("Successfully parsed source & mapping configuration.")
                Triple(parsedSource, mapperConfiguration.get(), null)
            } else {
250
                log.error("Parsed source is empty: ${value.first}.")
Jonas Waeber's avatar
Jonas Waeber committed
251
                Triple(null, null, Report(key, ReportStatus.fatal, "Could not parse source document.", Service.step))
Jonas Waeber's avatar
Jonas Waeber committed
252
253
254
            }
        } catch (ex: InvalidMappingException) {
            log.error(ex.localizedMessage)
Jonas Waeber's avatar
Jonas Waeber committed
255
            Triple(null, null, Report(key, ReportStatus.fatal, ex.localizedMessage, Service.step))
Jonas Waeber's avatar
Jonas Waeber committed
256
257
        } catch (ex: KlaxonException) {
            log.error(ex.localizedMessage)
Jonas Waeber's avatar
Jonas Waeber committed
258
            Triple(null, null, Report(key, ReportStatus.fatal, ex.localizedMessage, Service.step))
Sebastian Schüpbach's avatar
Sebastian Schüpbach committed
259
260
261
262
263
        } catch (ex: NullPointerException) {
            log.error(ex.localizedMessage)
            Triple(
                null,
                null,
Jonas Waeber's avatar
Jonas Waeber committed
264
                Report(key, ReportStatus.fatal, "There's no data to be processed: ${ex.localizedMessage}", Service.step)
Sebastian Schüpbach's avatar
Sebastian Schüpbach committed
265
            )
Jonas Waeber's avatar
Jonas Waeber committed
266
267
        }
    }
268
}