Class Dict

src/main/java/field/utility/Dict.java:30–816

This is our typed map class (Dict) with typed map keys (Dict.Prop) with some brain surgery level code to get type information out of Java's generics. It's used throughout Field (the type information is important because it enables the Conversions class which in turn allows us to massage dynamic lang

 * dynamic languages well while style exploiting Java's type system)
 */
public class Dict implements Serializable, fieldlinker.AsMap {
	private static final long serialVersionUID = 4506062700963421662L;

	static public class Canonical {
		static protected Map<String, Prop> canon = Collections.synchronizedMap(new HashMap<>());

		static public <T> Prop<T> canonicalize(Prop<T> p) {
			Prop<T> prop = canon.computeIfAbsent(p.name, x -> p);
			if (p.isCanon() && !prop.isCanon()) {
				canon.put(p.name, p);
				prop = p;
			} else if (p.isCanon() && prop.isCanon() && p != prop) {
				// should be an Error?
				System.err.println(" WARNING: two competing canonical definitions of a Prop <" + p + ">");
				if (p.typeInformation != null && prop.typeInformation == null) {
					canon.put(p.name, p);
					prop = p;
				} else if (p.typeInformation == null && prop.typeInformation != null) {

				} else if (p.typeInformation != null && prop.typeInformation != null) {
					if (!Conversions.typeInformationEquals(p.typeInformation, prop.typeInformation)) {
						System.err.println(" ERROR: the two competing canonical definitions of " + p + " have different type information");
						throw new IllegalArgumentException(p.typeInformation + " " + prop.typeInformation + " " + p + " " + prop);
					}
				}
			}
			prop.setCanon();
			return prop;
		}

		static public <T> Prop<T> findCanon(Prop<T> p) {
			return canon.get(p.name);
		}

		static public <T> Prop<T> findCanon(String p) {
			return canon.get(p);
		}
	}

	/**
	 * this property is used to tag other properties as pertaining to a particular "domain" of use, for example FLine attributes
	 */
	public static Dict.Prop<String> domain = new Dict.Prop<>("domain").toCanon();
	/**
	 * this property tags a property as readOnly (from the point of view of the scripting world, from Java there's nothing in place to prevent writing properties)
	 */
	public static Prop<Boolean> readOnly = new Prop<>("readOnly").toCanon().set(domain, "*/attributes");

	/**
	 * this lets you add to a property a function that massages values as they are set
	 */
	public static Prop<Function<Object, Object>> customCaster = new Prop<>("customCaster").toCanon().set(domain, "*/attributes");

	/**
	 * Range of for UI hint
	 */
	public static Prop<Collection<Number>> range = new Prop<>("range").toCanon().set(domain, "*/attributes").set(customCaster, new Function<Object, Object>() {
		@Override