/*
 * All content copyright Terracotta, Inc., unless otherwise indicated.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.terracotta.context.extractor;

import org.terracotta.context.ContextElement;
import org.terracotta.context.annotations.ContextAttribute;

import java.lang.reflect.Field;
import java.lang.reflect.Method;
import java.lang.reflect.Modifier;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;

Extracts context information from object instances and creates appropriate enclosing ContextElement instances.
/** * Extracts context information from object instances and creates appropriate * enclosing {@link ContextElement} instances. */
public final class ObjectContextExtractor { private ObjectContextExtractor() { //singleton }
Returns a ContextElement instance for the supplied object.

The supplied object's class type is parsed for ContextAttribute annotations and the associated attributes are extracted and returned in the form of a ContextElement.

Params:
  • from – object to extract context for
Returns:a ContextElement
/** * Returns a {@code ContextElement} instance for the supplied object. * <p> * The supplied object's class type is parsed for {@link ContextAttribute} * annotations and the associated attributes are extracted and returned in the * form of a {@code ContextElement}. * * @param from object to extract context for * @return a {@code ContextElement} */
public static ContextElement extract(Object from) { Map<String, AttributeGetter<Object>> attributes = new HashMap<>(); attributes.putAll(extractInstanceAttribute(from)); attributes.putAll(extractMethodAttributes(from)); attributes.putAll(extractFieldAttributes(from)); return new LazyContextElement(from.getClass(), attributes); } private static Map<? extends String, ? extends AttributeGetter<Object>> extractInstanceAttribute(Object from) { ContextAttribute annotation = from.getClass().getAnnotation(ContextAttribute.class); if (annotation == null) { return Collections.emptyMap(); } else { return Collections.singletonMap(annotation.value(), new WeakAttributeGetter<>(from)); } } private static Map<String, AttributeGetter<Object>> extractMethodAttributes(Object from) { Map<String, AttributeGetter<Object>> attributes = new HashMap<>(); for (Method m : from.getClass().getMethods()) { if (m.getParameterTypes().length == 0 && m.getReturnType() != Void.TYPE) { ContextAttribute annotation = m.getAnnotation(ContextAttribute.class); if (annotation != null) { attributes.put(annotation.value(), new WeakMethodAttributeGetter<>(from, m)); } } } return attributes; } private static Map<String, AttributeGetter<Object>> extractFieldAttributes(Object from) { Map<String, AttributeGetter<Object>> attributes = new HashMap<>(); for (Class<?> c = from.getClass(); c != null; c = c.getSuperclass()) { for (Field f : c.getDeclaredFields()) { ContextAttribute annotation = f.getAnnotation(ContextAttribute.class); if (annotation != null) { attributes.put(annotation.value(), createFieldAttributeGetter(from, f)); } } } return attributes; } private static AttributeGetter<Object> createFieldAttributeGetter(Object from, Field f) { f.setAccessible(true); if (Modifier.isFinal(f.getModifiers())) { try { return new DirectAttributeGetter<>(f.get(from)); } catch (IllegalArgumentException | IllegalAccessException ex) { throw new RuntimeException(ex); } } else { return new WeakFieldAttributeGetter<>(from, f); } } }