org.perfectable.introspection.bean.Bean Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of introspectable Show documentation
Easier java reflections
There is a newer version: 5.1.0
package org.perfectable.introspection.bean;

import org.perfectable.introspection.query.FieldQuery;

import java.lang.reflect.Modifier;
import java.util.Objects;

import com.google.common.collect.ImmutableSet;

import static java.util.Objects.requireNonNull;

/**
 * Represents a view of an instance as its property values, typically containing a proper Java Bean.
 *
 * Instances are created using {@link #from}.
 *
 * 
Allows access to properties either by name (using {@link #property}) or by listing them
 * (eg. {@link #fieldProperties}).
 * Properties are defined as either getter and/or setter or field.
 *
 * @param  type of instance contained in this bean
 */
public final class Bean {

	private final B instance;

	private Bean(B instance) {
		this.instance = instance;
	}

	/**
	 * Creates bean from Java Bean object.
	 *
	 * @param instance a non-null object that this bean will allow introspection into
	 * @param  Instance type
	 * @return Bean containing specified instance
	 */
	public static  Bean from(X instance) {
		requireNonNull(instance);
		return new Bean<>(instance);
	}

	/**
	 * Extracts instance that is backing this bean.
	 *
	 * @return instance that is backing this bean.
	 */
	public B contents() {
		return instance;
	}

	/**
	 * Extracts actual type of backing instance.
	 *
	 * @return actual type of backing instance.
	 */
	@SuppressWarnings("unchecked")
	public Class type() {
		return (Class) this.instance.getClass();
	}

	/**
	 * Finds property by name.
	 *
	 * @param name name of the property to look for.
	 * @return property with provided name
	 * @throws IllegalArgumentException when there is no property with provided name
	 */
	public Property property(String name) {
		return Properties.create(type(), name).bind(this.instance);
	}

	/**
	 * Creates new bean with contained instance copied field-by-field from this bean backing instance.
	 *
	 * 
Copy is created by default constructor.
	 *
	 * @return copy of this bean.
	 */
	public Bean copy() {
		Bean duplicate = BeanSchema.from(type()).instantiate();
		fieldProperties()
				.forEach(property -> property.copy(duplicate));
		return duplicate;
	}

	/**
	 * Lists all properties that are backed by a field.
	 *
	 * @return all properties backed by a field.
	 */
	public ImmutableSet> fieldProperties() {
		return FieldQuery.of(type())
			.excludingModifier(Modifier.STATIC)
			.stream()
			.map(field -> Properties.fromField(field).bind(this.instance))
			.collect(ImmutableSet.toImmutableSet());
	}

	/**
	 * Finds all object that backing instance has reference to.
	 *
	 * @return all objects that backing instance has reference to.
	 */
	public ImmutableSet