--- branches/1.0-gt2-2.6/src/skrueger/AttributeMetadata.java	2009/10/13 13:22:31	464
+++ branches/2.0-RC2/src/skrueger/AttributeMetadata.java	2010/01/28 10:06:05	621
@@ -29,6 +29,9 @@
  ******************************************************************************/
 package skrueger;
 
+import java.util.ArrayList;
+import java.util.List;
+
 import org.apache.log4j.Logger;
 import org.geotools.feature.NameImpl;
 import org.opengis.feature.type.AttributeDescriptor;
@@ -36,24 +39,78 @@
 
 import skrueger.geotools.Copyable;
 import skrueger.geotools.StyledLayerInterface;
+import skrueger.i8n.I8NUtil;
 import skrueger.i8n.Translation;
 
 /**
  * This class holds meta information about an attribute/column. This information
- * is used by {@link StyledLayerInterface}.
+ * is used by {@link StyledLayerInterface} and many others.<br/>
  * 
  * @author <a href="mailto:skpublic@wikisquare.de">Stefan Alfons Kr&uuml;ger</a>
  */
-public class AttributeMetadata implements Copyable<AttributeMetadata> {
+public class AttributeMetadata implements Copyable<AttributeMetadata>,
+		Comparable<AttributeMetadata> {
+	
 	static private final Logger LOGGER = Logger
 			.getLogger(AttributeMetadata.class);
 
-	protected Translation title = new Translation();
+	/** Translation of the attribute's description **/
 	protected Translation desc = new Translation();
-	protected boolean visible = true;
+
+	/**
+	 * For numerical attributes the value can be transformed by VALUE*X+A when
+	 * presented on screen. TODO not implemented yet
+	 **/
+	protected Double functionA = 0.;
+
+	/**
+	 * For numerical attributes the value can be transformed by VALUE*X+A when
+	 * presented on screen. TODO not implemented yet
+	 **/
+	protected Double functionX = 1.;
+
+	/** The Name of the attribute **/
+	private Name name;
+
+	/**
+	 * Allows to define general NODATA values for an attribute. e.g. -9999 can
+	 * be set and will always be interpreted as NULL internally and will usually
+	 * be ignored. TODO not implemented yet
+	 **/
+	protected List<Object> nodataValues = new ArrayList<Object>();
+
+	/** Translation of the attribute's title **/
+	protected Translation title = new Translation();
+
+	/**
+	 * The unit append to all visualizations of values of this attribute (is not
+	 * null)
+	 **/
 	protected String unit = "";
-	protected int colIdx;
-	private org.opengis.feature.type.Name name;
+
+	/** Is the attribute visible to the user or ignored where possible **/
+	protected boolean visible = true;
+
+	/**
+	 * When listed, the attributes are listed according to their {@link #weight} (heavier
+	 * => further down)
+	 * @see #compareTo(AttributeMetadata)
+	 **/
+	protected int weight = 0;
+
+	/** Only used for {@link Copyable<AttributeMetaData>#copy()} **/
+	private AttributeMetadata() {
+	}
+
+	public AttributeMetadata(final AttributeDescriptor attDesc, final int weight,
+			final List<String> langs) {
+		this(attDesc.getName(), langs);
+		setWeight(weight);
+	}
+
+	public AttributeMetadata(final AttributeDescriptor attDesc, final List<String> langs) {
+		this(attDesc.getName(), langs);
+	}
 
 	/**
 	 * Creates an {@link AttributeMetadata} object with the following
@@ -77,14 +134,28 @@
 		this.setName(name);
 		this.title = title;
 		this.desc = desc;
-		
-		// The THE_GEOM and shall never be visible!
-		if (name.getLocalPart().equalsIgnoreCase("the_geom")) this.visible = false;
-		
+		this.visible = visible;
 		this.unit = unit;
 	}
 
 	/**
+	 * Creates a new visible {@link AttributeMetadata}
+	 */
+	public AttributeMetadata(final Name name, final List<String> langs) {
+		this(name, true, new Translation(langs, name.getLocalPart()),
+				new Translation(), "");
+	}
+
+	/**
+	 * Creates a new visible {@link AttributeMetadata} 
+	 */
+	public AttributeMetadata(final Name name, final String defaultTitle,
+			final List<String> langs) {
+		this(name, true, new Translation(langs, defaultTitle),
+				new Translation(), "");
+	}
+
+	/**
 	 * Creates an {@link AttributeMetadata} object with the following
 	 * information
 	 * 
@@ -105,119 +176,192 @@
 	/**
 	 * Creates a new visible {@link AttributeMetadata} with default (no) values.
 	 */
-	public AttributeMetadata(final String localName, final String defaultTitle) {
-		this(localName, true, new Translation(defaultTitle), new Translation(),
-				"");
+	public AttributeMetadata(final String localName, final List<String> langs) {
+		this(localName, true, new Translation(langs, localName),
+				new Translation(), "");
 	}
 
 	/**
-	 * Creates a new visible {@link AttributeMetadata} with default (no) values.
+	 * Creates a new visible {@link AttributeMetadata} 
 	 */
-	public AttributeMetadata(final Name name, final String defaultTitle) {
-		this(name, true, new Translation(defaultTitle), new Translation(), "");
+	public AttributeMetadata(final String localName, final String defaultTitle,
+			final List<String> langs) {
+		this(localName, true, new Translation(langs, defaultTitle),
+				new Translation(), "");
 	}
 
 	/**
-	 * Creates a new visible {@link AttributeMetadata} with default (no) values.
+	 * Orders the attributes according to their {@link #weight}. Heavier =>
+	 * further down.
 	 */
-	public AttributeMetadata(final Name name) {
-		this(name, true, new Translation(name.getLocalPart()),
-				new Translation(), "");
+	@Override
+	public int compareTo(final AttributeMetadata atm2) {
+		return new Integer(weight).compareTo(atm2.getWeight());
 	}
 
 	/**
-	 * Creates a new visible {@link AttributeMetadata} with default (no) values.
+	 * @see Copyable inferface
 	 */
-	public AttributeMetadata(final String localName) {
-		this(localName, true, new Translation(localName), new Translation(), "");
+	@Override
+	public AttributeMetadata copy() {
+		return copyTo(new AttributeMetadata());
 	}
 
-	/** Only used for {@link Copyable<AttributeMetaData>#copy()} **/
-	private AttributeMetadata() {
+	/**
+	 * @see Copyable inferface
+	 */
+	@Override
+	public AttributeMetadata copyTo(final AttributeMetadata amd) {
+		getTitle().copyTo(amd.getTitle());
+		getDesc().copyTo(amd.getDesc());
+		amd.setUnit(getUnit());
+		amd.setVisible(isVisible());
+		amd.setName(new NameImpl(getName().getNamespaceURI(), getName()
+				.getLocalPart()));
+
+		amd.setWeight(getWeight());
+		amd.setFunctionX(getFunctionX());
+		amd.setFunctionA(getFunctionA());
+
+		for (final Object nodataValue : getNodataValues()) {
+			amd.getNodataValues().add(nodataValue);
+		}
+
+		return amd;
 	}
 
-	public AttributeMetadata(AttributeDescriptor attDesc) {
-		this(attDesc.getName());
+	public Translation getDesc() {
+		return desc;
 	}
 
-	public boolean isVisible() {
-		return visible;
+	public Double getFunctionA() {
+		return functionA;
 	}
 
-	public void setVisible(final Boolean visible) {
-		this.visible = visible;
+	public Double getFunctionX() {
+		return functionX;
 	}
-//
-//	/** @return the index of this attribute in the underlying table/dbf **/
-//	public int getColIdx() {
-//		return colIdx;
-//	}
 
-	public Translation getTitle() {
-		return title;
+	/**
+	 * The local name. E.g. the name of the DBF column as a {@link String}
+	 */
+	public String getLocalName() {
+		return getName().getLocalPart();
 	}
 
-	public void setTitle(final Translation title) {
-		this.title = title;
+	/**
+	 * The fully qualified {@link Name} of the attribute, e.g. <code>org.bla.plo:blub</code>
+	 */
+	public Name getName() {
+		return name;
 	}
 
-	public Translation getDesc() {
-		return desc;
+	public List<Object> getNodataValues() {
+		return nodataValues;
 	}
 
-	public void setDesc(final Translation desc) {
-		this.desc = desc;
+	/**
+	 * @return a number between 0 (bad) and 1 (good) that is calculated from the
+	 *         amount of translation available. If this attribute is not
+	 *         {@link #visible}, it will return 1.
+	 */
+	public double getQuality(final List<String> languages) {
+
+		if (!isVisible())
+			return 1.;
+
+		return (I8NUtil.qmTranslation(languages, getTitle()) * 2. + I8NUtil
+				.qmTranslation(languages, getDesc()) * 1.) / 3.;
+	}
+
+	public Translation getTitle() {
+		return title;
 	}
 
 	public String getUnit() {
 		return unit;
 	}
 
-	public void setUnit(final String unit) {
-		this.unit = unit;
+	public int getWeight() {
+		return weight;
 	}
 
-	@Override
-	public AttributeMetadata copyTo(AttributeMetadata amd) {
-		getTitle().copyTo(amd.getTitle());
-		getDesc().copyTo(amd.getDesc());
-		amd.setUnit(getUnit());
-		amd.setVisible(isVisible());
-		amd.setName(new NameImpl(getName().getNamespaceURI(), getName().getLocalPart()));
+	/**
+	 * Will the end-user see this attribute?
+	 */
+	public boolean isVisible() {
+		return visible;
+	}
 
-		return amd;
+	public void setDesc(final Translation desc) {
+		this.desc = desc;
 	}
 
-	@Override
-	public AttributeMetadata copy() {
-		return copyTo( new AttributeMetadata());
+	public void setFunctionA(final Double functionA) {
+		this.functionA = functionA;
 	}
 
-	/**
-	 * The local Name. E.g. the name of the DBF column as a String
-	 */
-	public String getLocalName() {
-		return getName().getLocalPart();
+	public void setFunctionX(final Double functionX) {
+		this.functionX = functionX;
 	}
 
 	/**
 	 * The fully qualified Name of the attribute, e.g. org.bla.plo:blub
 	 */
-	public Name getName() {
-		return name;
+	public void setLocalName(final String localName) {
+		this.name = new NameImpl(localName);
 	}
 
 	/**
-	 * The fully qualified Name of the attribute, e.g. org.bla.plo:blub
+	 * The fully qualified {@link Name} of the attribute, e.g. <code>org.bla.plo:blub</code>
 	 */
-	public void setName(org.opengis.feature.type.Name name) {
+	public void setName(final Name name) {
 		this.name = name;
 	}
 
+	public void setNodataValues(final List<Object> nodataValues) {
+		this.nodataValues = nodataValues;
+	}
+
+	public void setTitle(final Translation title) {
+		this.title = title;
+	}
+
+	public void setUnit(final String unit) {
+		this.unit = unit;
+	}
+
+	public void setVisible(final boolean visible) {
+		this.visible = visible;
+	}
+
 	/**
-	 * The fully qualified Name of the attribute, e.g. org.bla.plo:blub
+	 * Shall the end-user see this attribute?
+	 * @param visible
 	 */
-	public void setLocalName(String localName) {
-		this.name = new NameImpl(localName);
+	public void setVisible(final Boolean visible) {
+//		// The THE_GEOM and shall never be visible! 
+//		if (name.getLocalPart().equalsIgnoreCase("the_geom"))
+//			this.visible = false;
+//		else
+//			this.visible = visible;
+
+		this.visible = visible;
+	}
+
+	public void setWeight(final int weight) {
+		this.weight = weight;
+	}
+	
+	/**
+	 * For nicer debugging
+	 */
+	@Override
+	public String toString() {
+		StringBuffer sb = new StringBuffer();
+		if (name != null) sb.append(name.toString()+" ");
+		sb.append("weight="+weight+" ");
+		sb.append("title="+getTitle().toString());
+		return sb.toString();
 	}
 }