package net.sourceforge.pain.logic; import net.sourceforge.pain.data.*; /** * Affect base class. (Controller for persistent AffectData) * <p/> * this class is linked statically to Core (could not be reloaded) * all it's subclasses in '..logic.affect.*' package are loaded(linked) dynamycally * * Codebase require from all affect controllers (Affect subclasses) to have constructor with (AffectData d) param. * this constructor is used for automatically affect controller instantiation and initialization with * persistent image */ public abstract class Affect { protected AffectData ad; protected Affect(AffectData ad) { if (ad==null) { throw new NullPointerException("Affect data image is null!"); } this.ad = ad; } /** * reflection is 10 times slower than 'new' method call (jdk1.4.2) * First time affect instance is created by codebase with reflection, * but all subsequent affect instance creations use this method call. * (It's required for all affects to have a public constructor like 'AffectAAA(AffectData ad)' * this constructor is used during first Affect instantiation by codebase) * @return new Affect object instance, inited with AffectData param */ public abstract Affect newInstance(AffectData ad); }