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
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
package com.fasterxml.jackson.databind.ser;
import com.fasterxml.jackson.databind.*;
import com.fasterxml.jackson.databind.jsontype.TypeSerializer;
import com.fasterxml.jackson.databind.type.*;
/**
* Interface that defines API for simple extensions that can provide additional serializers
* for various types. Access is by a single callback method; instance is to either return
* a configured {@link JsonSerializer} for specified type, or null to indicate that it
* does not support handling of the type. In latter case, further calls can be made
* for other providers; in former case returned serializer is used for handling of
* instances of specified type.
*/
public interface Serializers
{
/**
* Method called by serialization framework first time a serializer is needed for
* specified type, which is not of a container type (for which other methods are
* called).
*
* @param type Fully resolved type of instances to serialize
* @param config Serialization configuration in use
* @param beanDesc Additional information about type
*
* @return Configured serializer to use for the type; or null if implementation
* does not recognize or support type
*/
public JsonSerializer<?> findSerializer(SerializationConfig config,
JavaType type, BeanDescription beanDesc);
/**
* Method called by serialization framework first time a serializer is needed for
* specified array type.
* Implementation should return a serializer instance if it supports
* specified type; or null if it does not.
*/
public JsonSerializer<?> findArraySerializer(SerializationConfig config,
ArrayType type, BeanDescription beanDesc,
TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer);
/**
* Method called by serialization framework first time a serializer is needed for
* specified {@link java.util.Collection} type.
* Implementation should return a serializer instance if it supports
* specified type; or null if it does not.
*/
public JsonSerializer<?> findCollectionSerializer(SerializationConfig config,
CollectionType type, BeanDescription beanDesc,
TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer);
/**
* Method called by serialization framework first time a serializer is needed for
* specified "Collection-like" type (type that acts like {@link java.util.Collection},
* but does not implement it).
* Implementation should return a serializer instance if it supports
* specified type; or null if it does not.
*/
public JsonSerializer<?> findCollectionLikeSerializer(SerializationConfig config,
CollectionLikeType type, BeanDescription beanDesc,
TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer);
/**
* Method called by serialization framework first time a serializer is needed for
* specified {@link java.util.Map} type.
* Implementation should return a serializer instance if it supports
* specified type; or null if it does not.
*/
public JsonSerializer<?> findMapSerializer(SerializationConfig config,
MapType type, BeanDescription beanDesc,
JsonSerializer<Object> keySerializer,
TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer);
/**
* Method called by serialization framework first time a serializer is needed for
* specified "Map-like" type (type that acts like {@link java.util.Map},
* but does not implement it).
* Implementation should return a serializer instance if it supports
* specified type; or null if it does not.
*/
public JsonSerializer<?> findMapLikeSerializer(SerializationConfig config,
MapLikeType type, BeanDescription beanDesc,
JsonSerializer<Object> keySerializer,
TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer);
/**
* Basic {@link Serializers} implementation that implements all methods but provides
* no serializers. Its main purpose is to serve as a base class so that
* sub-classes only need to override methods they need.
*/
public static class Base implements Serializers
{
@Override
public JsonSerializer<?> findSerializer(SerializationConfig config,
JavaType type, BeanDescription beanDesc)
{
return null;
}
@Override
public JsonSerializer<?> findArraySerializer(SerializationConfig config,
ArrayType type, BeanDescription beanDesc,
TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer)
{
return null;
}
@Override
public JsonSerializer<?> findCollectionSerializer(SerializationConfig config,
CollectionType type, BeanDescription beanDesc,
TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer)
{
return null;
}
@Override
public JsonSerializer<?> findCollectionLikeSerializer(SerializationConfig config,
CollectionLikeType type, BeanDescription beanDesc,
TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer)
{
return null;
}
@Override
public JsonSerializer<?> findMapSerializer(SerializationConfig config,
MapType type, BeanDescription beanDesc,
JsonSerializer<Object> keySerializer,
TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer)
{
return null;
}
@Override
public JsonSerializer<?> findMapLikeSerializer(SerializationConfig config,
MapLikeType type, BeanDescription beanDesc,
JsonSerializer<Object> keySerializer,
TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer)
{
return null;
}
}
}
|
