protected void _addClassMixIns(AnnotationMap annotations, Class<?> toMask, Class<?> mixin) {
if (mixin == null) {
return;
}
// Ok, first: annotations from mix-in class itself:
for (Annotation a : mixin.getDeclaredAnnotations()) {
if (_annotationIntrospector.isHandled(a)) {
annotations.addIfNotPresent(a);
}
}
/* And then from its supertypes, if any. But note that we will
* only consider super-types up until reaching the masked
* class (if found); this because often mix-in class
* is a sub-class (for convenience reasons). And if so, we
* absolutely must NOT include super types of masked class,
* as that would inverse precedence of annotations.
*/
for (Class<?> parent : ClassUtil.findSuperTypes(mixin, toMask)) {
for (Annotation a : parent.getDeclaredAnnotations()) {
if (_annotationIntrospector.isHandled(a)) {
annotations.addIfNotPresent(a);
}
}
}
}
/**
* Initialization method that will recursively collect Jackson annotations for this class and all
* super classes and interfaces.
*
* <p>Starting with 1.2, it will also apply mix-in annotations, as per [JACKSON-76]
*/
protected void resolveClassAnnotations() {
_classAnnotations = new AnnotationMap();
// add mix-in annotations first (overrides)
if (_primaryMixIn != null) {
_addClassMixIns(_classAnnotations, _class, _primaryMixIn);
}
// first, annotations from the class itself:
for (Annotation a : _class.getDeclaredAnnotations()) {
if (_annotationIntrospector.isHandled(a)) {
_classAnnotations.addIfNotPresent(a);
}
}
// and then from super types
for (Class<?> cls : _superTypes) {
// and mix mix-in annotations in-between
_addClassMixIns(_classAnnotations, cls);
for (Annotation a : cls.getDeclaredAnnotations()) {
if (_annotationIntrospector.isHandled(a)) {
_classAnnotations.addIfNotPresent(a);
}
}
}
/* and finally... any annotations there might be for plain
* old Object.class: separate because for all other purposes
* it is just ignored (not included in super types)
*/
/* 12-Jul-2009, tatu: Should this be done for interfaces too?
* For now, yes, seems useful for some cases, and not harmful
* for any?
*/
_addClassMixIns(_classAnnotations, Object.class);
}
/**
* Method that will add annotations from specified source method to target method, but only if
* target does not yet have them.
*/
protected void _addMixUnders(Method src, AnnotatedMethod target) {
for (Annotation a : src.getDeclaredAnnotations()) {
if (_annotationIntrospector.isHandled(a)) {
target.addIfNotPresent(a);
}
}
}
protected AnnotationMap _collectRelevantAnnotations(Annotation[] anns) {
AnnotationMap annMap = new AnnotationMap();
if (anns != null) {
for (Annotation a : anns) {
if (_annotationIntrospector.isHandled(a)) {
annMap.add(a);
}
}
}
return annMap;
}
/** @param addParamAnnotations Whether parameter annotations are to be added as well */
protected void _addMixOvers(Method mixin, AnnotatedMethod target, boolean addParamAnnotations) {
for (Annotation a : mixin.getDeclaredAnnotations()) {
if (_annotationIntrospector.isHandled(a)) {
target.addOrOverride(a);
}
}
if (addParamAnnotations) {
Annotation[][] pa = mixin.getParameterAnnotations();
for (int i = 0, len = pa.length; i < len; ++i) {
for (Annotation a : pa[i]) {
target.addOrOverrideParam(i, a);
}
}
}
}
/**
* Method called to add field mix-ins from given mix-in class (and its fields) into already
* collected actual fields (from introspected classes and their super-classes)
*/
protected void _addFieldMixIns(Class<?> mixin, Map<String, AnnotatedField> fields) {
for (Field mixinField : mixin.getDeclaredFields()) {
/* there are some dummy things (static, synthetic); better
* ignore
*/
if (!_isIncludableField(mixinField)) {
continue;
}
String name = mixinField.getName();
// anything to mask? (if not, quietly ignore)
AnnotatedField maskedField = fields.get(name);
if (maskedField != null) {
for (Annotation a : mixinField.getDeclaredAnnotations()) {
if (_annotationIntrospector.isHandled(a)) {
maskedField.addOrOverride(a);
}
}
}
}
}
