-
Notifications
You must be signed in to change notification settings - Fork 2
/
JsonLdDeserializer.java
115 lines (101 loc) · 4.42 KB
/
JsonLdDeserializer.java
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
/**
* Copyright (C) 2022 Czech Technical University in Prague
* <p>
* This program is free software: you can redistribute it and/or modify it under
* the terms of the GNU General Public License as published by the Free Software
* Foundation, either version 3 of the License, or (at your option) any
* later version.
* <p>
* 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 General Public License for more
* details. You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
package cz.cvut.kbss.jsonld.deserialization;
import cz.cvut.kbss.jopa.model.annotations.OWLClass;
import cz.cvut.kbss.jsonld.ConfigParam;
import cz.cvut.kbss.jsonld.Configuration;
import cz.cvut.kbss.jsonld.common.BeanAnnotationProcessor;
import cz.cvut.kbss.jsonld.common.Configured;
import cz.cvut.kbss.jsonld.deserialization.expanded.ExpandedJsonLdDeserializer;
import cz.cvut.kbss.jsonld.deserialization.util.ClasspathScanner;
import cz.cvut.kbss.jsonld.deserialization.util.TargetClassResolver;
import cz.cvut.kbss.jsonld.deserialization.util.TargetClassResolverConfig;
import cz.cvut.kbss.jsonld.deserialization.util.TypeMap;
import java.util.Objects;
/**
* Takes a pre-processed JSON-LD structure and deserializes it.
*/
public abstract class JsonLdDeserializer implements Configured {
private final Configuration configuration;
protected final TargetClassResolver classResolver;
protected ValueDeserializers deserializers = new CommonValueDeserializers();
protected JsonLdDeserializer() {
this.configuration = new Configuration();
this.classResolver = initializeTargetClassResolver();
}
protected JsonLdDeserializer(Configuration configuration) {
this.configuration = Objects.requireNonNull(configuration);
this.classResolver = initializeTargetClassResolver();
}
private TargetClassResolver initializeTargetClassResolver() {
final TypeMap typeMap = new TypeMap();
final String scanPath = configuration.get(ConfigParam.SCAN_PACKAGE, "");
new ClasspathScanner(c -> {
final OWLClass ann = c.getDeclaredAnnotation(OWLClass.class);
if (ann != null) {
typeMap.register(BeanAnnotationProcessor.expandIriIfNecessary(ann.iri(), c), c);
}
}).processClasses(scanPath);
return new TargetClassResolver(typeMap,
new TargetClassResolverConfig(
configuration.is(ConfigParam.ASSUME_TARGET_TYPE),
configuration().is(ConfigParam.ENABLE_OPTIMISTIC_TARGET_TYPE_RESOLUTION),
configuration().is(ConfigParam.PREFER_SUPERCLASS)));
}
@Override
public Configuration configuration() {
return configuration;
}
/**
* Registers a custom deserializer for the specified type.
* <p>
* If a deserializer already existed for the type, it is replaced by the new one.
*
* @param type Target type to register the deserializer for
* @param deserializer Deserializer to register
* @param <T> Target type
*/
public <T> void registerSerializer(Class<T> type, ValueDeserializer<T> deserializer) {
Objects.requireNonNull(type);
Objects.requireNonNull(deserializer);
deserializers.registerDeserializer(type, deserializer);
}
/**
* Deserializes the specified JSON-LD data.
*
* @param <T> The type of the target object
* @param jsonLd JSON-LD structure
* @param resultClass Type of the result instance
* @return Deserialized Java instance
*/
public abstract <T> T deserialize(Object jsonLd, Class<T> resultClass);
/**
* Creates deserializer for expanded JSON-LD, initialized with the specified configuration.
*
* @param configuration Configuration of the deserializer
* @return New deserializer
*/
public static JsonLdDeserializer createExpandedDeserializer(Configuration configuration) {
return new ExpandedJsonLdDeserializer(configuration);
}
/**
* Creates deserializer for expanded JSON-LD.
*
* @return New deserializer
*/
public static JsonLdDeserializer createExpandedDeserializer() {
return new ExpandedJsonLdDeserializer();
}
}