Hibernate et JPA; Accès aux membres ou via les accesseurs

package be.gaudry.model.brolmeter;
 
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.Date;
import java.util.List;
import java.util.RandomAccess;
import java.util.Set;
import java.util.TreeSet;
 
import be.gaudry.model.LightObject;
 
/**
 * Adding or removing measures from the indexes may lead to dirty relative
 * measures (i.e. adding an index with an oldest date than the last index). This
 * method sort the original measures (indexes), and re-evaluate the relative
 * measures. The cost of maintaining relative measures is minimized by the fact
 * nothing is done on an insert or a remove, but the state is set to dirty, and
 * the relative measures must be re-evaluated the next time they will be asked
 * for. Asking for relative measures if dirty flag is not set has no cost.
 * 
 * @date Feb 7, 2009
 * @author Steph GAUDRY
 * 
 */
public class Meter extends LightObject {
 
 
	/**
	 * Indexes of the meter
	 * @todo: use a Set and builds a treeset to avoid sorting manually
	 */
	private List‹Measure› measures;
	private EMeterType meterType;
	private String unit;
 
 
	public Meter() {
		this("?", "?");
	}
 
	public Meter(String name, String unit) {
		this(-1, EMeterType.DEFAULT, unit);
		this.display = name;
	}
 
	/**
	 * @param id
	 * @param _meterType
	 * @param _unit
	 */
	public Meter(int id, EMeterType _meterType, String _unit) {
		super(id, "");
		this.unit = _unit;
		this.meterType = _meterType;
		this.measures = new ArrayList‹Measure›();
	}
 
 
	/**
	 * @return the meterType
	 */
	public EMeterType getMeterType() {
		return meterType;
	}
 
	/**
	 * Returns an unmodifiable view of the measures (only ‹b›indexes of the
	 * meter‹/b›). This collection is ‹b›sorted by insertion order‹/b› and not
	 * by date; call the {@link java.util.Collections#sort(List)
	 * Collections.sort(List)} method to sort by date. ‹br /›
	 * This method allows modules to provide users with "read-only" access to
	 * the measures. Query operations on the returned list "read through" to the
	 * specified list, and attempts to modify the returned list, whether direct
	 * or via its iterator, result in an ‹tt›UnsupportedOperationException‹/tt›. ‹br /›
	 * ‹br /›
	 * The returned list will be serializable if the specified list is
	 * serializable. Similarly, the returned list will implement
	 * {@link RandomAccess} if the specified list does.
	 * 
	 * @return an unmodifiable view of the measures (never null).
	 */
	public Collection‹Measure› getMeasures() {
		return Collections.unmodifiableList(measures);
	}
 
	/**
	 * @param unit
	 *            the unit to set
	 */
	public void setUnit(String unit) {
		this.unit = unit;
	}
 
	/**
	 * @return the unit
	 */
	public String getUnit() {
		return unit;
	}
 
 
	/**
	 * Adds a {@link Measure} for this meter.
	 * ‹br /›Sets also the {@link Measure#setMeter(Meter) measure meter} with this.
	 * @param measure
	 * @deprecated use {@link #addMeasure(Date, double)} instead of this (will be protected into next versions)
	 */
	public void addMeasure(Measure measure) {
		measures.add(measure);
		measure.setMeter(this);
	}
 
	/**
	 * Builds and adds a {@link Measure} for this meter.
	 */
	public void addMeasure(Date date, double value) {
		measures.add(new Measure(this, date, value));
	}
 
	public void clearMeasures() {
		measures.clear();
		relativeMeasures.clear();
		dirty = false;
	}
}

‹?xml version="1.0" encoding="UTF-8"?›
‹!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.6//EN" "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"›
‹hibernate-mapping default-access="field"
	default-cascade="none" default-lazy="false" package="be.gaudry.model.brolmeter"›
	‹union-subclass name="MeterHibernateWrapper" table="T_METERS"
			extends="be.gaudry.model.LightObject"›
		‹list name="measures" cascade="all"›
			‹key column="meter"/›
			‹index column="MEASURES_LIST_INDEX"/›
			‹one-to-many class="MeasureHibernateWrapper"/›
		‹/list›
		‹property name="unit" type="string" not-null="false" /›
		‹property name="meterType" type="be.gaudry.model.brolmeter.EMeterType" not-null="false" /›
	‹/union-subclass›
‹/hibernate-mapping›

default-access="field"