1 |
|
//---PACKAGE DECLARATION--- |
2 |
+ |
package uk.org.iscream.conient; |
3 |
|
|
4 |
|
//---IMPORTS--- |
5 |
|
import javax.swing.*; |
6 |
|
import javax.swing.border.*; |
6 |
– |
import java.awt.Color; |
7 |
– |
import uk.ac.ukc.iscream.util.*; |
8 |
– |
|
7 |
|
import java.awt.*; |
8 |
|
import java.awt.event.*; |
11 |
– |
import java.net.*; |
12 |
– |
import java.io.*; |
13 |
– |
import java.util.Date; |
14 |
– |
import java.text.DateFormat; |
15 |
– |
import java.util.Locale; |
16 |
– |
import java.util.HashMap; |
17 |
– |
import javax.swing.border.*; |
9 |
|
|
10 |
|
/** |
11 |
< |
* NASTY AND BASIC, PLEASE DON'T COMPLAIN |
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 = 700; |
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 |
|
} |
59 |
– |
|
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, ControlPanel control) { |
102 |
|
// set up the Frame |
103 |
< |
super("I-Scream Client"); |
103 |
> |
super("Conient {an i-scream Client}"); |
104 |
> |
setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT); |
105 |
> |
setJMenuBar(control.getMenuBar()); |
106 |
|
|
107 |
< |
setSize(width, height); |
107 |
> |
// set what happens when the X in the corner is clicked |
108 |
|
addWindowListener(new WindowAdapter() { |
109 |
|
public void windowClosing(WindowEvent e) {System.exit(0);} |
110 |
|
}); |
111 |
|
|
112 |
< |
|
76 |
< |
// build the frame |
112 |
> |
// add the control pane to the top border |
113 |
|
getContentPane().add(control, "North"); |
78 |
– |
getContentPane().add(data, "Center"); |
114 |
|
|
115 |
+ |
// create a scrollable pane for the data in the centre |
116 |
+ |
JScrollPane scrollPane = new JScrollPane(data); |
117 |
+ |
getContentPane().add(scrollPane, "Center"); |
118 |
+ |
|
119 |
+ |
// setup the status panel |
120 |
|
JPanel bottom = new JPanel(); |
121 |
|
bottom.setLayout(new BorderLayout()); |
122 |
|
_messages.setEditable(false); |
123 |
|
_messages.setRows(3); |
124 |
|
JScrollPane messagesPane = new JScrollPane(_messages); |
125 |
|
messagesPane.setBorder(new TitledBorder(new LineBorder(new Color(0, 0, 102)), " Messages ")); |
86 |
– |
|
126 |
|
bottom.add(messagesPane, "Center"); |
127 |
|
JPanel statusPanel = new JPanel(); |
128 |
|
JPanel linkPanel = new JPanel(); |
129 |
< |
linkPanel.setLayout(new GridLayout(2,1)); |
129 |
> |
linkPanel.setLayout(new GridLayout(1,2)); |
130 |
|
linkPanel.add(_controlStatus); |
131 |
|
linkPanel.add(_dataStatus); |
132 |
< |
statusPanel.setLayout(new GridLayout(1,3)); |
132 |
> |
statusPanel.setLayout(new GridLayout(2,1)); |
133 |
|
statusPanel.add(linkPanel); |
134 |
|
statusPanel.add(_queueStatus); |
96 |
– |
|
135 |
|
bottom.add(statusPanel, "South"); |
136 |
+ |
|
137 |
+ |
// add the status panel to the bottom border |
138 |
|
getContentPane().add(bottom, "South"); |
139 |
|
|
140 |
< |
// show the window |
140 |
> |
// a nice icon for the window |
141 |
> |
setIconImage((new ImageIcon("./resources/server.gif")).getImage()); |
142 |
> |
|
143 |
> |
// and just because we can, a silly splash screen |
144 |
> |
// of the dudes that did this funky gibble |
145 |
> |
Splash splash = new Splash(); |
146 |
> |
splash.show(); |
147 |
> |
// wait |
148 |
> |
try { |
149 |
> |
Thread.sleep(DISPLAY_SPLASH_TIME_SECONDS * 1000); |
150 |
> |
} catch (InterruptedException e) { |
151 |
> |
// don't do anything, we don't care |
152 |
> |
} |
153 |
> |
//loose the window |
154 |
> |
splash.dispose(); |
155 |
> |
splash = null; |
156 |
> |
// show the main window |
157 |
|
show(); |
158 |
|
} |
159 |
|
|
163 |
|
|
164 |
|
//---ACCESSOR/MUTATOR METHODS--- |
165 |
|
|
166 |
+ |
/** |
167 |
+ |
* Sets the control link status. |
168 |
+ |
* |
169 |
+ |
* @param status the message |
170 |
+ |
*/ |
171 |
|
public static void setControlStatus(String status) { |
172 |
|
_controlStatus.setText("Control Link: " + status); |
173 |
|
_controlStatus.repaint(); |
174 |
|
} |
175 |
|
|
176 |
+ |
/** |
177 |
+ |
* Sets the data link status. |
178 |
+ |
* |
179 |
+ |
* @param status the message |
180 |
+ |
*/ |
181 |
|
public static void setDataStatus(String status) { |
182 |
|
_dataStatus.setText("Data Link: " + status); |
183 |
|
_dataStatus.repaint(); |
184 |
|
} |
185 |
|
|
186 |
+ |
/** |
187 |
+ |
* Updates the queue status. |
188 |
+ |
* |
189 |
+ |
* @param currentQueue |
190 |
+ |
* @param numElements |
191 |
+ |
*/ |
192 |
|
public static void setQueueStatus(int currentQueue, int numElements) { |
193 |
|
_queueStatus.setText("Data Queue : " + currentQueue + " Packets Recieved : " + numElements); |
194 |
|
_queueStatus.repaint(); |
195 |
|
} |
196 |
|
|
197 |
+ |
/** |
198 |
+ |
* Adds a system message to the messages list |
199 |
+ |
* |
200 |
+ |
* @param message the new message |
201 |
+ |
*/ |
202 |
|
public static void addMessage(String message) { |
203 |
|
_messages.insert(message + "\n", 0); |
204 |
|
} |
128 |
– |
//---ATTRIBUTES--- |
205 |
|
|
206 |
+ |
//---ATTRIBUTES--- |
207 |
+ |
|
208 |
+ |
//---STATIC ATTRIBUTES--- |
209 |
+ |
|
210 |
+ |
/** |
211 |
+ |
* Displays information about the data link |
212 |
+ |
*/ |
213 |
|
static JLabel _controlStatus = new JLabel("Control Link: Disconnected", JLabel.LEFT); |
214 |
|
{ |
215 |
|
_controlStatus.setBorder(new EtchedBorder(EtchedBorder.LOWERED)); |
216 |
|
} |
217 |
|
|
218 |
+ |
/** |
219 |
+ |
* Displays information about the data link |
220 |
+ |
*/ |
221 |
|
static JLabel _dataStatus = new JLabel("Data Link: Disconnected", JLabel.LEFT); |
222 |
|
{ |
223 |
|
_dataStatus.setBorder(new EtchedBorder(EtchedBorder.LOWERED)); |
224 |
|
} |
225 |
|
|
226 |
< |
static JLabel _queueStatus = new JLabel("-", JLabel.LEFT); |
226 |
> |
/** |
227 |
> |
* Displays information about the inbound data queue. |
228 |
> |
*/ |
229 |
> |
static JLabel _queueStatus = new JLabel(" ", JLabel.LEFT); |
230 |
|
{ |
231 |
|
_queueStatus.setBorder(new EtchedBorder(EtchedBorder.LOWERED)); |
232 |
|
} |
233 |
|
|
234 |
< |
ImageIcon _serverIcon = new ImageIcon("server.gif"); |
235 |
< |
JLabel _serverCountLabel; |
236 |
< |
int _serverCount = 0; |
234 |
> |
/** |
235 |
> |
* The place where system messages are written. |
236 |
> |
*/ |
237 |
|
static JTextArea _messages = new JTextArea(); |
238 |
+ |
{ |
239 |
+ |
_messages.setLineWrap(true); |
240 |
+ |
} |
241 |
|
|
242 |
< |
//---STATIC ATTRIBUTES--- |
242 |
> |
/** |
243 |
> |
* Holds a reference to the root frame for Conient |
244 |
> |
* This is only used by dialogs (specifically the configurationn |
245 |
> |
* dialog) so that it can be modal, please use the accessor. |
246 |
> |
*/ |
247 |
> |
private static Frame conientFrame; |
248 |
|
|
249 |
+ |
//---INNER CLASSES---- |
250 |
+ |
|
251 |
+ |
/** |
252 |
+ |
* An inner class to display a splash screen |
253 |
+ |
*/ |
254 |
+ |
private class Splash extends JWindow { |
255 |
+ |
|
256 |
+ |
/** |
257 |
+ |
* Constructs a new splash screen |
258 |
+ |
*/ |
259 |
+ |
public Splash() { |
260 |
+ |
setCursor(Cursor.getPredefinedCursor(Cursor.WAIT_CURSOR)); |
261 |
+ |
JPanel splash = new JPanel(); |
262 |
+ |
splash.setBackground(Color.black); |
263 |
+ |
JLabel image = new JLabel((new ImageIcon("./resources/i-scream-splash.gif"))); |
264 |
+ |
splash.add(image); |
265 |
+ |
setContentPane(splash); |
266 |
+ |
Dimension screen = getToolkit().getScreenSize(); |
267 |
+ |
pack(); |
268 |
+ |
setLocation((screen.width - getSize().width) / 2, |
269 |
+ |
(screen.height - getSize().height) / 2); |
270 |
+ |
|
271 |
+ |
|
272 |
+ |
} |
273 |
+ |
} |
274 |
|
} |