01: /*
02: * This file or a portion of this file is licensed under the terms of
03: * the Globus Toolkit Public License, found in file GTPL, or at
04: * http://www.globus.org/toolkit/download/license.html. This notice must
05: * appear in redistributions of this file, with or without modification.
06: *
07: * Redistributions of this Software, with or without modification, must
08: * reproduce the GTPL in: (1) the Software, or (2) the Documentation or
09: * some other similar material which is provided with the Software (if
10: * any).
11: *
12: * Copyright 1999-2004 University of Chicago and The University of
13: * Southern California. All rights reserved.
14: */
15: package org.griphyn.vdl.invocation;
16:
17: /**
18: * This interface defines a common base for all elements in an invocation
19: * record that can carry text in their values. It exists primarily for
20: * grouping purposes and for easier access through the character SAX
21: * callback. Due to the fact that SAX may present text in several chunks,
22: * all text-carrying classes must also provide the append function.
23: *
24: * @author Jens-S. Vöckler
25: * @author Yong Zhao
26: * @version $Revision: 50 $
27: */
28: public interface HasText {
29: /**
30: * Appends a piece of text to the existing text.
31: * @param fragment is a piece of text to append to existing text.
32: * Appending <code>null</code> is a noop.
33: */
34: public void appendValue(String fragment);
35:
36: /**
37: * Accessor
38: *
39: * @see #setValue(String)
40: */
41: public String getValue();
42:
43: /**
44: * Accessor.
45: *
46: * @param value is the new value to set.
47: * @see #getValue()
48: */
49: public void setValue(String value);
50: }
|