|
| 1 | +package com.fasterxml.jackson.databind.type; |
| 2 | + |
| 3 | +import com.fasterxml.jackson.databind.JavaType; |
| 4 | + |
| 5 | +/** |
| 6 | + * Specialized {@link SimpleType} for types that are referential types, |
| 7 | + * that is, values that can be dereferenced to another value (or null), |
| 8 | + * of different type. |
| 9 | + * Referenced type is accessible using {@link #getContentType()}. |
| 10 | + * |
| 11 | + * @since 2.6 |
| 12 | + */ |
| 13 | +public class ReferenceType extends SimpleType |
| 14 | +{ |
| 15 | + private static final long serialVersionUID = 1L; |
| 16 | + |
| 17 | + protected final JavaType _referencedType; |
| 18 | + |
| 19 | + protected ReferenceType(Class<?> cls, JavaType refType, |
| 20 | + Object valueHandler, Object typeHandler, boolean asStatic) |
| 21 | + { |
| 22 | + super(cls, refType.hashCode(), |
| 23 | + valueHandler, typeHandler, asStatic); |
| 24 | + _referencedType = refType; |
| 25 | + } |
| 26 | + |
| 27 | + public static ReferenceType construct(Class<?> cls, JavaType refType, |
| 28 | + Object valueHandler, Object typeHandler) |
| 29 | + { |
| 30 | + return new ReferenceType(cls, refType, null, null, false); |
| 31 | + } |
| 32 | + |
| 33 | + @Override |
| 34 | + public ReferenceType withTypeHandler(Object h) |
| 35 | + { |
| 36 | + if (h == _typeHandler) { |
| 37 | + return this; |
| 38 | + } |
| 39 | + return new ReferenceType(_class, _referencedType, _valueHandler, h, _asStatic); |
| 40 | + } |
| 41 | + |
| 42 | + @Override |
| 43 | + public ReferenceType withContentTypeHandler(Object h) |
| 44 | + { |
| 45 | + if (h == _referencedType.<Object>getTypeHandler()) { |
| 46 | + return this; |
| 47 | + } |
| 48 | + return new ReferenceType(_class, _referencedType.withTypeHandler(h), |
| 49 | + _valueHandler, _typeHandler, _asStatic); |
| 50 | + } |
| 51 | + |
| 52 | + @Override |
| 53 | + public ReferenceType withValueHandler(Object h) { |
| 54 | + if (h == _valueHandler) { |
| 55 | + return this; |
| 56 | + } |
| 57 | + return new ReferenceType(_class, _referencedType, h, _typeHandler,_asStatic); |
| 58 | + } |
| 59 | + |
| 60 | + @Override |
| 61 | + public ReferenceType withContentValueHandler(Object h) { |
| 62 | + if (h == _referencedType.<Object>getValueHandler()) { |
| 63 | + return this; |
| 64 | + } |
| 65 | + return new ReferenceType(_class, _referencedType.withValueHandler(h), |
| 66 | + _valueHandler, _typeHandler, _asStatic); |
| 67 | + } |
| 68 | + |
| 69 | + @Override |
| 70 | + public ReferenceType withStaticTyping() { |
| 71 | + if (_asStatic) { |
| 72 | + return this; |
| 73 | + } |
| 74 | + return new ReferenceType(_class, _referencedType.withStaticTyping(), |
| 75 | + _valueHandler, _typeHandler, true); |
| 76 | + } |
| 77 | + |
| 78 | + @Override |
| 79 | + protected String buildCanonicalName() |
| 80 | + { |
| 81 | + StringBuilder sb = new StringBuilder(); |
| 82 | + sb.append(_class.getName()); |
| 83 | + sb.append('<'); |
| 84 | + sb.append(_referencedType.toCanonical()); |
| 85 | + return sb.toString(); |
| 86 | + } |
| 87 | + |
| 88 | + /* |
| 89 | + /********************************************************** |
| 90 | + /* Narrow/widen |
| 91 | + /********************************************************** |
| 92 | + */ |
| 93 | + |
| 94 | + @Override |
| 95 | + protected JavaType _narrow(Class<?> subclass) |
| 96 | + { |
| 97 | + // Should we check that there is a sub-class relationship? |
| 98 | + return new ReferenceType(subclass, _referencedType, |
| 99 | + _valueHandler, _typeHandler, _asStatic); |
| 100 | + } |
| 101 | + |
| 102 | + /* |
| 103 | + /********************************************************** |
| 104 | + /* Extended API |
| 105 | + /********************************************************** |
| 106 | + */ |
| 107 | + |
| 108 | + @Override |
| 109 | + public JavaType getReferencedType() { |
| 110 | + return _referencedType; |
| 111 | + } |
| 112 | + |
| 113 | + @Override |
| 114 | + public boolean isReferenceType() { |
| 115 | + return true; |
| 116 | + } |
| 117 | + |
| 118 | + /* |
| 119 | + /********************************************************** |
| 120 | + /* Public API overrides |
| 121 | + /********************************************************** |
| 122 | + */ |
| 123 | + |
| 124 | + @Override |
| 125 | + public int containedTypeCount() { |
| 126 | + return 1; |
| 127 | + } |
| 128 | + |
| 129 | + @Override |
| 130 | + public JavaType containedType(int index) { |
| 131 | + return (index == 0) ? _referencedType : null; |
| 132 | + } |
| 133 | + |
| 134 | + @Override |
| 135 | + public String containedTypeName(int index) { |
| 136 | + return (index == 0) ? "T" : null; |
| 137 | + } |
| 138 | + |
| 139 | + @Override |
| 140 | + public Class<?> getParameterSource() { |
| 141 | + // Hmmh. For now, assume it's the raw type |
| 142 | + return _class; |
| 143 | + } |
| 144 | + |
| 145 | + @Override |
| 146 | + public StringBuilder getErasedSignature(StringBuilder sb) { |
| 147 | + return _classSignature(_class, sb, true); |
| 148 | + } |
| 149 | + |
| 150 | + @Override |
| 151 | + public StringBuilder getGenericSignature(StringBuilder sb) |
| 152 | + { |
| 153 | + _classSignature(_class, sb, false); |
| 154 | + sb.append('<'); |
| 155 | + sb = _referencedType.getGenericSignature(sb); |
| 156 | + sb.append(';'); |
| 157 | + return sb; |
| 158 | + } |
| 159 | + |
| 160 | + /* |
| 161 | + /********************************************************** |
| 162 | + /* Standard methods |
| 163 | + /********************************************************** |
| 164 | + */ |
| 165 | + |
| 166 | + @Override |
| 167 | + public String toString() |
| 168 | + { |
| 169 | + return new StringBuilder(40) |
| 170 | + .append("[reference type, class ") |
| 171 | + .append(buildCanonicalName()) |
| 172 | + .append('<') |
| 173 | + .append(_referencedType) |
| 174 | + .append('>') |
| 175 | + .append(']') |
| 176 | + .toString(); |
| 177 | + } |
| 178 | + |
| 179 | + @Override |
| 180 | + public boolean equals(Object o) |
| 181 | + { |
| 182 | + if (o == this) return true; |
| 183 | + if (o == null) return false; |
| 184 | + if (o.getClass() != getClass()) return false; |
| 185 | + |
| 186 | + ReferenceType other = (ReferenceType) o; |
| 187 | + |
| 188 | + // Otherwise actually mostly worry about referenced type |
| 189 | + return _referencedType.equals(other._referencedType); |
| 190 | + } |
| 191 | +} |
0 commit comments