ViewVC Help

View File | Revision Log | Show Annotations | Revision Graph | Root Listing

root/i-scream/projects/cms/source/conient/uk/org/iscream/cms/conient/datacomponents/StringDataComponent.java

Comparing projects/cms/source/conient/uk/org/iscream/cms/conient/datacomponents/StringDataComponent.java (file contents):
Revision 1.2 by ajm, Mon Jan 22 12:32:14 2001 UTC vs.
Revision 1.12 by ajm, Sun Feb 4 17:59:16 2001 UTC

#	Line 1 | Line 1
1		//---PACKAGE DECLARATION---
2	+	package uk.ac.ukc.iscream.conient.datacomponents;
3
4		//---IMPORTS---
5		import javax.swing.JLabel;
6	+	import javax.swing.JTextField;
7		import java.awt.GridLayout;
8	+	import javax.swing.SwingUtilities;
9
10		/**
11		* This is the most basic of DataComponents.
12		*
13		* It simply displays the value as a String
14	<	* in a JLabel.
14	>	* in a JTextField.
15		*
16		* @author  $Author$
17		* @version $Id$
18		*/
19	<	public class StringDataComponent extends DataComponent {
19	>	public class StringDataComponent extends VisibleDataComponent {
20
21		//---FINAL ATTRIBUTES---
22
#	Line 21 | Line 24 | public class StringDataComponent extends DataComponent
24		* The current CVS revision of this class
25		*/
26		public final String REVISION = "$Revision$";
27	+
28	+	/**
29	+	* The default length of the JTextField
30	+	*/
31	+	protected final int DEFAULT_TEXT_LENGTH = 20;
32
33		//---STATIC METHODS---
34
#	Line 31 | Line 39 | public class StringDataComponent extends DataComponent
39		* used as label
40		*
41		* @param name the friendly name
42	+	* @param attribute the data attribute we look after
43		*/
44	<	public StringDataComponent(String name) {
45	<	_label = new JLabel(name + ": ");
44	>	public StringDataComponent(String name, String attribute) {
45	>	_name = name;
46	>	_attribute = attribute;
47	>	_item = new JTextField("", DEFAULT_TEXT_LENGTH);
48	>	_item.setEditable(false);
49	>	_label = new JLabel(_name + ": ");
50		_label.setHorizontalAlignment(JLabel.RIGHT);
51		setLayout(new GridLayout(1, 2));
52	+	_item.setText("-uninitialised-");
53		add(_label);
54		add(_item);
55		}
56
57		//---PUBLIC METHODS---
58
59	+	/**
60	+	* This run method updates any Swing components
61	+	* The setValue() method adds this component
62	+	* to the Swing Event Dispatching Queue to
63	+	* run this method.
64	+	*/
65	+	public void run() {
66	+	_item.setText(_cache);
67	+	}
68	+
69	+	/**
70	+	* Overrides the {@link java.lang.Object#toString() Object.toString()}
71	+	* method to provide clean logging (every class should have this).
72	+	*
73	+	* @return the name of this class and its CVS revision
74	+	*/
75	+	public String toString() {
76	+	return _name + "(" + _attribute + ")";
77	+	}
78	+
79		//---PRIVATE METHODS---
80
81		//---ACCESSOR/MUTATOR METHODS---
#	Line 49 | Line 83 | public class StringDataComponent extends DataComponent
83		/**
84		* This takes the String value of the parameter that this component
85		* is monitoring direct from the packet, it then performs all
86	<	* approriate conversions and displays the data.
86	>	* approriate conversions and adds this class to the Swing Event
87	>	* Dispatching queue.
88		*
89		* @param value the value for this data component
90		* @throws DataFormatException if there was a problem converting the data for display
91		*/
92		public void setValue(String value) throws DataFormatException {
93		try {
94	<	_item.setText(value);
94	>	if(!_cache.equals(value)) {
95	>	_cache = value;
96	>	SwingUtilities.invokeLater(this);
97	>	}
98		} catch (Exception e) {
99	<	throw new DataFormatException("invalid data type for component");
99	>	throw new DataFormatException(value + " is an invalid data type for " + toString());
100		}
101	<	}
101	>	}
102	>
103	>	/**
104	>	* Returns the string showing the packet
105	>	* attribute that the component is looking after
106	>	*
107	>	* @return the packet reference
108	>	*/
109	>	public String getPacketAttribute() {
110	>	return _attribute;
111	>	}
112
113		//---ATTRIBUTES---
114
115		/**
116	+	* The friendly name of this component
117	+	*/
118	+	protected String _name;
119	+
120	+	/**
121	+	* The attribute that this component is concerned with
122	+	*/
123	+	protected String _attribute;
124	+
125	+	/**
126		* The friendly label for this component
127		*/
128		protected JLabel _label;
129
130		/**
131	+	* Remebers what the last value was, so we
132	+	* only update if we have to.
133	+	*/
134	+	String _cache = "";
135	+
136	+	/**
137	+	* The length of the JTextField
138	+	*/
139	+	protected int _displayLength;
140	+
141	+	/**
142		* Just a normal label to display our value as a String
143		*/
144	<	protected JLabel _item = new JLabel();
144	>	protected JTextField _item;
145
146		//---STATIC ATTRIBUTES---
147
148	<	}
148	>	}

Diff Legend

–	Removed lines
+	Added lines
<	Changed lines
>	Changed lines