1 |
|
//---PACKAGE DECLARATION--- |
2 |
+ |
package uk.ac.ukc.iscream.conient; |
3 |
|
|
4 |
|
//---IMPORTS--- |
5 |
|
import javax.swing.*; |
8 |
|
import java.awt.event.*; |
9 |
|
|
10 |
|
/** |
11 |
< |
* Root for the SwingClient...starts the whole show off... |
11 |
> |
* This is the main class of the Conient client. |
12 |
|
* |
13 |
+ |
* This sets up the control panel, the data panel |
14 |
+ |
* and its own display. |
15 |
+ |
* |
16 |
|
* @author $Author$ |
17 |
|
* @version $Id$ |
18 |
|
*/ |
19 |
< |
public class SwingClient extends JFrame { |
19 |
> |
public class Conient extends JFrame { |
20 |
|
|
21 |
|
//---FINAL ATTRIBUTES--- |
22 |
|
|
24 |
|
* The current CVS revision of this class |
25 |
|
*/ |
26 |
|
public final String REVISION = "$Revision$"; |
27 |
< |
|
28 |
< |
private final int width = 600; |
29 |
< |
private final int height = 600; |
27 |
> |
|
28 |
> |
/** |
29 |
> |
* The initial width of the window |
30 |
> |
*/ |
31 |
> |
private final int DEFAULT_WIDTH = 600; |
32 |
|
|
33 |
< |
// the well known port |
34 |
< |
public static final int PORT = 4510; |
33 |
> |
/** |
34 |
> |
* The initial height of the window |
35 |
> |
*/ |
36 |
> |
private final int DEFAULT_HEIGHT = 600; |
37 |
|
|
38 |
+ |
/** |
39 |
+ |
* The default configuration fle |
40 |
+ |
* This can be specified on the command line |
41 |
+ |
*/ |
42 |
+ |
public static final String DEFAULT_CONFIG_FILE = "./etc/default.conf"; |
43 |
+ |
|
44 |
+ |
/** |
45 |
+ |
* The time in seconds to display the splash |
46 |
+ |
* screen for |
47 |
+ |
*/ |
48 |
+ |
public static final int DISPLAY_SPLASH_TIME_SECONDS = 3; |
49 |
+ |
|
50 |
|
//---STATIC METHODS--- |
51 |
|
|
52 |
+ |
/** |
53 |
+ |
* The first method that is called. |
54 |
+ |
* Sets up the various panels |
55 |
+ |
* |
56 |
+ |
* @param args the command line arguments |
57 |
+ |
*/ |
58 |
|
public static void main(String[] args) { |
59 |
|
// get the host from the command line if they gave it |
60 |
|
String host = null; |
61 |
+ |
String configFile = DEFAULT_CONFIG_FILE; |
62 |
|
if (args.length == 1) { |
63 |
< |
host = args[0]; |
63 |
> |
configFile = args[0]; |
64 |
|
} |
65 |
+ |
|
66 |
+ |
// start the configuration system |
67 |
+ |
Configuration.initialise(configFile); |
68 |
|
|
69 |
|
// the data display panel |
70 |
|
DataPanel data = new DataPanel(); |
73 |
|
ControlPanel control = new ControlPanel(data); |
74 |
|
|
75 |
|
// the main frame (passed the two panels) |
76 |
< |
SwingClient client = new SwingClient(data, control); |
77 |
< |
SwingClient.addMessage("Client started"); |
76 |
> |
Conient client = new Conient(data, control); |
77 |
> |
conientFrame = (Frame) client; |
78 |
> |
Conient.addMessage("Conient {an i-scream Client} © 2001 University of Kent & Project i-scream"); |
79 |
> |
|
80 |
> |
Conient.addMessage("Conient ready."); |
81 |
> |
|
82 |
|
} |
49 |
– |
|
83 |
|
|
84 |
+ |
/** |
85 |
+ |
* A static accessor, allowing components of the system |
86 |
+ |
* to get hold of the root frame of the system. |
87 |
+ |
* |
88 |
+ |
* see conientFrame attribute for details. |
89 |
+ |
* |
90 |
+ |
* @return the root Conient frame |
91 |
+ |
*/ |
92 |
+ |
public static Frame getFrame() { |
93 |
+ |
return conientFrame; |
94 |
+ |
} |
95 |
+ |
|
96 |
|
//---CONSTRUCTORS--- |
97 |
|
|
98 |
|
/** |
99 |
|
* Creates a new Swing Client Frame |
100 |
|
*/ |
101 |
< |
private SwingClient(JPanel data, JPanel control) { |
101 |
> |
private Conient(JPanel data, JPanel control) { |
102 |
|
// set up the Frame |
103 |
< |
super("I-Scream Client"); |
104 |
< |
|
105 |
< |
setSize(width, height); |
103 |
> |
super("Conient {an i-scream Client}"); |
104 |
> |
setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT); |
105 |
> |
|
106 |
> |
// set what happens when the X in the corner is clicked |
107 |
|
addWindowListener(new WindowAdapter() { |
108 |
|
public void windowClosing(WindowEvent e) {System.exit(0);} |
109 |
|
}); |
110 |
|
|
111 |
+ |
// add the control pane to the top border |
112 |
|
getContentPane().add(control, "North"); |
113 |
|
|
114 |
+ |
// create a scrollable pane for the data in the centre |
115 |
|
JScrollPane scrollPane = new JScrollPane(data); |
116 |
|
getContentPane().add(scrollPane, "Center"); |
117 |
< |
|
118 |
< |
|
117 |
> |
|
118 |
> |
// setup the status panel |
119 |
|
JPanel bottom = new JPanel(); |
120 |
|
bottom.setLayout(new BorderLayout()); |
121 |
|
_messages.setEditable(false); |
122 |
|
_messages.setRows(3); |
123 |
|
JScrollPane messagesPane = new JScrollPane(_messages); |
124 |
|
messagesPane.setBorder(new TitledBorder(new LineBorder(new Color(0, 0, 102)), " Messages ")); |
77 |
– |
|
125 |
|
bottom.add(messagesPane, "Center"); |
126 |
|
JPanel statusPanel = new JPanel(); |
127 |
|
JPanel linkPanel = new JPanel(); |
128 |
< |
linkPanel.setLayout(new GridLayout(2,1)); |
128 |
> |
linkPanel.setLayout(new GridLayout(1,2)); |
129 |
|
linkPanel.add(_controlStatus); |
130 |
|
linkPanel.add(_dataStatus); |
131 |
< |
statusPanel.setLayout(new GridLayout(1,3)); |
131 |
> |
statusPanel.setLayout(new GridLayout(2,1)); |
132 |
|
statusPanel.add(linkPanel); |
133 |
|
statusPanel.add(_queueStatus); |
87 |
– |
|
134 |
|
bottom.add(statusPanel, "South"); |
135 |
+ |
|
136 |
+ |
// add the status panel to the bottom border |
137 |
|
getContentPane().add(bottom, "South"); |
138 |
|
|
139 |
< |
// show the window |
139 |
> |
// a nice icon for the window |
140 |
> |
setIconImage((new ImageIcon("./uk/ac/ukc/iscream/conient/server.gif")).getImage()); |
141 |
> |
|
142 |
> |
// and just because we can, a silly splash screen |
143 |
> |
// of the dudes that did this funky gibble |
144 |
> |
Splash splash = new Splash(); |
145 |
> |
splash.show(); |
146 |
> |
// wait |
147 |
> |
try { |
148 |
> |
Thread.sleep(DISPLAY_SPLASH_TIME_SECONDS * 1000); |
149 |
> |
} catch (InterruptedException e) { |
150 |
> |
// don't do anything, we don't care |
151 |
> |
} |
152 |
> |
//loose the window |
153 |
> |
splash.dispose(); |
154 |
> |
splash = null; |
155 |
> |
// show the main window |
156 |
|
show(); |
157 |
|
} |
158 |
|
|
162 |
|
|
163 |
|
//---ACCESSOR/MUTATOR METHODS--- |
164 |
|
|
165 |
+ |
/** |
166 |
+ |
* Sets the control link status. |
167 |
+ |
* |
168 |
+ |
* @param status the message |
169 |
+ |
*/ |
170 |
|
public static void setControlStatus(String status) { |
171 |
|
_controlStatus.setText("Control Link: " + status); |
172 |
|
_controlStatus.repaint(); |
173 |
|
} |
174 |
|
|
175 |
+ |
/** |
176 |
+ |
* Sets the data link status. |
177 |
+ |
* |
178 |
+ |
* @param status the message |
179 |
+ |
*/ |
180 |
|
public static void setDataStatus(String status) { |
181 |
|
_dataStatus.setText("Data Link: " + status); |
182 |
|
_dataStatus.repaint(); |
183 |
|
} |
184 |
|
|
185 |
+ |
/** |
186 |
+ |
* Updates the queue status. |
187 |
+ |
* |
188 |
+ |
* @param currentQueue |
189 |
+ |
* @param numElements |
190 |
+ |
*/ |
191 |
|
public static void setQueueStatus(int currentQueue, int numElements) { |
192 |
|
_queueStatus.setText("Data Queue : " + currentQueue + " Packets Recieved : " + numElements); |
193 |
|
_queueStatus.repaint(); |
194 |
|
} |
195 |
|
|
196 |
+ |
/** |
197 |
+ |
* Adds a system message to the messages list |
198 |
+ |
* |
199 |
+ |
* @param message the new message |
200 |
+ |
*/ |
201 |
|
public static void addMessage(String message) { |
202 |
|
_messages.insert(message + "\n", 0); |
203 |
|
} |
204 |
|
|
205 |
|
//---ATTRIBUTES--- |
206 |
|
|
122 |
– |
ImageIcon _serverIcon = new ImageIcon("server.gif"); |
123 |
– |
JLabel _serverCountLabel; |
124 |
– |
int _serverCount = 0; |
125 |
– |
|
207 |
|
//---STATIC ATTRIBUTES--- |
208 |
|
|
209 |
+ |
/** |
210 |
+ |
* Displays information about the data link |
211 |
+ |
*/ |
212 |
|
static JLabel _controlStatus = new JLabel("Control Link: Disconnected", JLabel.LEFT); |
213 |
|
{ |
214 |
|
_controlStatus.setBorder(new EtchedBorder(EtchedBorder.LOWERED)); |
215 |
|
} |
216 |
|
|
217 |
+ |
/** |
218 |
+ |
* Displays information about the data link |
219 |
+ |
*/ |
220 |
|
static JLabel _dataStatus = new JLabel("Data Link: Disconnected", JLabel.LEFT); |
221 |
|
{ |
222 |
|
_dataStatus.setBorder(new EtchedBorder(EtchedBorder.LOWERED)); |
223 |
|
} |
224 |
|
|
225 |
+ |
/** |
226 |
+ |
* Displays information about the inbound data queue. |
227 |
+ |
*/ |
228 |
|
static JLabel _queueStatus = new JLabel(" ", JLabel.LEFT); |
229 |
|
{ |
230 |
|
_queueStatus.setBorder(new EtchedBorder(EtchedBorder.LOWERED)); |
231 |
|
} |
232 |
+ |
|
233 |
+ |
/** |
234 |
+ |
* The place where system messages are written. |
235 |
+ |
*/ |
236 |
|
static JTextArea _messages = new JTextArea(); |
237 |
+ |
{ |
238 |
+ |
_messages.setLineWrap(true); |
239 |
+ |
} |
240 |
+ |
|
241 |
+ |
/** |
242 |
+ |
* Holds a reference to the root frame for Conient |
243 |
+ |
* This is only used by dialogs (specifically the configurationn |
244 |
+ |
* dialog) so that it can be modal, please use the accessor. |
245 |
+ |
*/ |
246 |
+ |
private static Frame conientFrame; |
247 |
+ |
|
248 |
+ |
//---INNER CLASSES---- |
249 |
+ |
|
250 |
+ |
/** |
251 |
+ |
* An inner class to display a splash screen |
252 |
+ |
*/ |
253 |
+ |
private class Splash extends JWindow { |
254 |
+ |
|
255 |
+ |
/** |
256 |
+ |
* Constructs a new splash screen |
257 |
+ |
*/ |
258 |
+ |
public Splash() { |
259 |
+ |
setCursor(Cursor.getPredefinedCursor(Cursor.WAIT_CURSOR)); |
260 |
+ |
JPanel splash = new JPanel(); |
261 |
+ |
splash.setBackground(Color.black); |
262 |
+ |
JLabel image = new JLabel((new ImageIcon("./uk/ac/ukc/iscream/conient/i-scream-splash.gif"))); |
263 |
+ |
splash.add(image); |
264 |
+ |
setContentPane(splash); |
265 |
+ |
Dimension screen = getToolkit().getScreenSize(); |
266 |
+ |
pack(); |
267 |
+ |
setLocation((screen.width - getSize().width) / 2, |
268 |
+ |
(screen.height - getSize().height) / 2); |
269 |
+ |
|
270 |
+ |
|
271 |
+ |
} |
272 |
+ |
} |
273 |
|
} |