Mercurial > dive4elements > river
view flys-artifacts/src/main/java/de/intevation/flys/artifacts/states/DefaultState.java @ 2681:b94b367d8b4d
Minor refactoring, docs.
flys-artifacts/trunk@4379 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author | Felix Wolfsteller <felix.wolfsteller@intevation.de> |
---|---|
date | Thu, 10 May 2012 09:44:31 +0000 |
parents | 17927c60ac1c |
children | d9af29a4bb85 |
line wrap: on
line source
package de.intevation.flys.artifacts.states; import java.text.NumberFormat; import java.util.Iterator; import java.util.Locale; import java.util.Map; import java.util.List; import org.apache.log4j.Logger; import org.w3c.dom.Document; import org.w3c.dom.Element; import org.w3c.dom.Node; import de.intevation.artifacts.Artifact; import de.intevation.artifacts.ArtifactNamespaceContext; import de.intevation.artifacts.CallContext; import de.intevation.artifacts.CallMeta; import de.intevation.artifacts.common.utils.XMLUtils; import de.intevation.artifacts.common.utils.XMLUtils.ElementCreator; import de.intevation.artifactdatabase.ProtocolUtils; import de.intevation.artifactdatabase.data.StateData; import de.intevation.artifactdatabase.state.AbstractState; import de.intevation.artifactdatabase.state.Facet; import de.intevation.flys.artifacts.FLYSArtifact; import de.intevation.flys.artifacts.resources.Resources; /** * @author <a href="mailto:ingo.weinzierl@intevation.de">Ingo Weinzierl</a> */ public abstract class DefaultState extends AbstractState { /** The logger that is used in this class. */ private static Logger logger = Logger.getLogger(DefaultState.class); /** Determines, if the DESCRIBE document should contain default values or * not. */ public static final boolean USE_DEFAULTS = Boolean.getBoolean("flys.use.default.values"); /** The three possible compute types. */ public static enum ComputeType { FEED, ADVANCE, INIT } protected StateData getData(FLYSArtifact artifact, String name) { return artifact.getData(name); } /** * Append to a node and return xml description relevant for gui. */ public Element describeStatic( Artifact artifact, Document document, Node root, CallContext context, String uuid) { ElementCreator creator = new ElementCreator( document, ArtifactNamespaceContext.NAMESPACE_URI, ArtifactNamespaceContext.NAMESPACE_PREFIX); CallMeta meta = context.getMeta(); String helpText = Resources.getMsg(meta, getHelpText(), getHelpText()); String label = Resources.getMsg(meta, getID(), getID()); Element ui = ProtocolUtils.createArtNode( creator, "state", new String[] { "name", "uiprovider", "label", "helpText"}, new String[] { getID(), getUIProvider(), label, helpText }); Map<String, StateData> theData = getData(); if (theData == null) { return ui; } Iterator<String> iter = theData.keySet().iterator(); FLYSArtifact flys = (FLYSArtifact) artifact; while (iter.hasNext()) { String name = iter.next(); appendStaticData(flys, context, creator, ui, name); } return ui; } protected void appendStaticData( FLYSArtifact flys, CallContext context, ElementCreator cr, Element ui, String name ) { StateData data = getData(flys, name); String value = (data != null) ? (String) data.getValue() : null; if (value == null) { return; } String type = data.getType(); logger.debug( "Append element " + type + "'" + name + "' (" + value + ")"); Element e = createStaticData(flys, cr, context, name, value, type); ui.appendChild(e); } /** * Creates a <i>data</i> element used in the static part of the DESCRIBE * document. * * @param creator The ElementCreator that is used to build new Elements. * @param meta The CallMeta object used for i18n. * @param name The name of the data item. * @param value The value as string. * * @return an Element. */ protected Element createStaticData( FLYSArtifact flys, ElementCreator creator, CallContext cc, String name, String value, String type ) { Element dataElement = creator.create("data"); creator.addAttr(dataElement, "name", name, true); creator.addAttr(dataElement, "type", type, true); Element itemElement = creator.create("item"); creator.addAttr(itemElement, "value", value, true); creator.addAttr( itemElement, "label", getLabelFor(cc, name, value, type), true); dataElement.appendChild(itemElement); return dataElement; } /** * @param cc * @param name * @param value * @param type * * @return */ protected String getLabelFor( CallContext cc, String name, String value, String type ) { CallMeta meta = cc.getMeta(); try { // XXX A better way to format the output would be to use the // 'type' value of the data objects. double doubleVal = Double.valueOf(value); Locale l = Resources.getLocale(meta); NumberFormat nf = NumberFormat.getInstance(l); return nf.format(doubleVal); } catch (NumberFormatException nfe) { return Resources.getMsg(meta, value, value); } } public Element describe( Artifact artifact, Document document, Node root, CallContext context, String uuid) { ElementCreator creator = new ElementCreator( document, ArtifactNamespaceContext.NAMESPACE_URI, ArtifactNamespaceContext.NAMESPACE_PREFIX); String helpText = Resources.getMsg( context.getMeta(), getHelpText(), getHelpText()); Element ui = null; String uiprovider = getUIProvider(); if (uiprovider != null) { ui = ProtocolUtils.createArtNode( creator, "dynamic", new String[] { "uiprovider", "helpText" }, new String[] { uiprovider, helpText }); } else { ui = ProtocolUtils.createArtNode( creator, "dynamic", new String[] { "helpText" }, new String[] { helpText }); } Map<String, StateData> theData = getData(); if (theData == null) { return ui; } Iterator<String> iter = theData.keySet().iterator(); FLYSArtifact flys = (FLYSArtifact) artifact; while (iter.hasNext()) { String name = iter.next(); StateData data = getData(flys, name); data = data != null ? data : getData(name); Element select = createData(creator, artifact, data, context); if (USE_DEFAULTS) { String defValue = (String) data.getValue(); String defDesc = null; if (defValue != null && defValue.length() > 0) { defDesc = Resources.getMsg( context.getMeta(), defValue, defValue); } if (defValue != null && defDesc != null) { creator.addAttr(select, "defaultValue", defValue, true); creator.addAttr(select, "defaultLabel", defDesc, true); } } appendItems(artifact, creator, name, context, select); ui.appendChild(select); } return ui; } /** * @param artifact * @param creator * @param name * @param context * @param select */ protected void appendItems( Artifact artifact, ElementCreator creator, String name, CallContext context, Element select ) { Element choices = ProtocolUtils.createArtNode( creator, "choices", null, null); select.appendChild(choices); Element[] items = createItems(creator, artifact, name, context); if (items != null) { for (Element item: items) { choices.appendChild(item); } } } /** * This method creates the root node that contains the list of selectable * items. * * @param cr The ElementCreator. * @param name The name of the amount of data. * * @return the root node of the item list. */ protected Element createData( ElementCreator cr, Artifact artifact, StateData data, CallContext context) { Element select = ProtocolUtils.createArtNode( cr, "select", null, null); cr.addAttr(select, "name", data.getName(), true); Element label = ProtocolUtils.createArtNode( cr, "label", null, null); select.appendChild(label); label.setTextContent(Resources.getMsg( context.getMeta(), getID(), getID())); return select; } /** * This method creates a list of items. These items represent the amount of * input data that is possible for this state. * * @param cr The ElementCreator. * @param name The name of the amount of data. * * @return a list of items. */ protected Element[] createItems( ElementCreator cr, Artifact artifact, String name, CallContext context ) { return null; } /** * This method is used to create an <i>item</i> Element that contains two * further elements <i>label</i> and <i>value</i>. The label and value * elements both have text nodes. * * @param cr The ElementCreator used to build new Elements. * @param obj This implementation awaits a String array with [0] = label and * [1] = value. * * @return an Element. */ protected Element createItem(XMLUtils.ElementCreator cr, Object obj) { Element item = ProtocolUtils.createArtNode(cr, "item", null, null); Element label = ProtocolUtils.createArtNode(cr, "label", null, null); Element value = ProtocolUtils.createArtNode(cr, "value", null, null); String[] arr = (String[]) obj; label.setTextContent(arr[0]); value.setTextContent(arr[1]); item.appendChild(label); item.appendChild(value); return item; } /** * This method transform a given value into a StateData object. * * @param flys The FLYSArtifact. * @param name The name of the data object. * @param val The value of the data object. * * @return a StateData object with <i>name</i> and <i>val</i>ue. */ public StateData transform( FLYSArtifact flys, CallContext cc, StateData stateData, String name, String val ) { logger.debug("Transform data ('" + name + "','" + val + "')"); stateData.setValue(val); return stateData; } /** * This method validates the inserted data and returns true, if everything * was correct, otherwise an exception is thrown. * * @param artifact A reference to the owner artifact. * * @return true, if everything was fine. */ public boolean validate(Artifact artifact) throws IllegalArgumentException { return true; } /** * Returns which UIProvider shall be used to aid user input. */ protected String getUIProvider() { return null; } public Object computeAdvance( FLYSArtifact artifact, String hash, CallContext context, List<Facet> facets, Object old ) { return null; } public Object computeFeed( FLYSArtifact artifact, String hash, CallContext context, List<Facet> facets, Object old ) { return null; } public Object computeInit( FLYSArtifact artifact, String hash, Object context, CallMeta meta, List<Facet> facets) { return null; } } // vim:set ts=4 sw=4 si et sta sts=4 fenc=utf-8 :