Mercurial > dive4elements > framework
view artifacts/src/main/java/de/intevation/artifacts/Artifact.java @ 75:d4c4c23847f5
Extended the Artifact-Interface-Method setup to be able to put the XML-Document which can contain further Data
to the Artifact-Implementation.
artifacts/trunk@649 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author | Tim Englich <tim.englich@intevation.de> |
---|---|
date | Mon, 01 Feb 2010 13:54:05 +0000 |
parents | 9a29899b31e5 |
children | 48d1a9a082c2 |
line wrap: on
line source
package de.intevation.artifacts; import java.io.IOException; import java.io.OutputStream; import java.io.Serializable; import org.w3c.dom.Document; /** * Interface of the core component of the artifact system: <strong>The artifact</strong>. * <br> * * An artifact is an abstract data type offering the following methods: * * <ol> * <li>{@link #identifier() identifier()}: Returns a gobally unique identfier * of this artifact.</li> * <li>{@link #hash() hash()}: Returns a hash value over the internal state * of this artifact.</li> * <li>{@link #describe(Object)}: Returns a description of this artifact.</li> * <li>{@link #advance(Document, Object) advance()}: Advances this artifact * to the next internal state</li> * <li>{@link #feed(Document, Object) feed()}: Feed new data into this artifact.</li> * <li>{@link #out(Document, OutputStream, CallContext) out()}: Produces output for this artifact.</li> * </ol> * * There are two more methods involved with the life cycle of the are: * <ol> * <li>{@link #setup(String, ArtifactFactory, Object) setup()}: Called after created by the * factory.</li> * <li>{@link #endOfLife(Object) endOfLife()}: Called when the artifact * is going to be removed from * system. Useful to clean up.</li> * </ol> * * @author Sascha L. Teichmann (sascha.teichmann@intevation.de) */ public interface Artifact extends Serializable { /** * Identify this artifact. * @return Returns unique string to identify this artifact globally. */ String identifier(); /** * Internal hash of this artifact. * @return Returns hash that should stay the same if the internal * value has not changed. Useful for caching */ String hash(); /** * A description used to build a interface to interact with this artifact. * @param context The global context of the runtime system. * @return An XML representation of the current state of the artifact. */ Document describe(Document data, CallContext context); /** * Change the internal state of the artifact. * @return An XML representation of the success of the advancing. * @param target Target of internal state to move to. * @param context The global context of the runtime system. */ Document advance(Document target, CallContext context); /** * Feed data into this artifact. * @param data Data to feed artifact with. * @param context The global context of the runtime system. * @return An XML representation of the success of the feeding. */ Document feed(Document data, CallContext context); /** * Produce output from this artifact. * @param format Specifies the format of the output. * @param context The global context of the runtime system. */ void out( Document format, OutputStream out, CallContext context) throws IOException; /** * When created by a factory this method is called to * initialize the artifact. * @param identifier The identifier from artifact database * @param factory The factory which created this artifact. * @param context The global context of the runtime system. * @param data The data which can be use to setup an Artifact with * more details. */ public void setup( String identifier, ArtifactFactory factory, Object context, Document data); /** * Called from artifact database when an artifact is * going to be removed from system. * @param context The global context of the runtime system. */ public void endOfLife(Object context); } // vim:set ts=4 sw=4 si et sta sts=4 fenc=utf8: