cms/conient/Conient.java

/* 
 * i-scream central monitoring system
 * http://www.i-scream.org.uk
 * Copyright (C) 2000-2002 i-scream
 * 
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 */

//---PACKAGE DECLARATION---
package uk.org.iscream.cms.conient;

//---IMPORTS---
import javax.swing.*;
import javax.swing.border.*;
import java.awt.*;
import java.awt.event.*;

/**
 * This is the main class of the Conient client.
 *
 * This sets up the control panel, the data panel
 * and its own display.
 *
 * @author  $Author: tdb $
 * @version $Id: Conient.java,v 1.34 2002/05/21 16:47:10 tdb Exp $
 */
public class Conient extends JFrame {

//---FINAL ATTRIBUTES---

    /**
     * The current CVS revision of this class
     */
    public final String REVISION = "$Revision: 1.34 $";

    /**
     * The initial width of the window
     */        
    private final int DEFAULT_WIDTH = 700;
    
    /**
     * The initial height of the window
     */
    private final int DEFAULT_HEIGHT = 600;
    
    /**
     * The default configuration fle
     * This can be specified on the command line
     */
    public static final String DEFAULT_CONFIG_FILE = "./etc/default.conf";
    
    /**
     * The time in seconds to display the splash
     * screen for
     */
    public static final int DISPLAY_SPLASH_TIME_SECONDS = 3;
    
//---STATIC METHODS---

    /**
     * The first method that is called.
     * Sets up the various panels
     *
     * @param args the command line arguments
     */
    public static void main(String[] args) {
        // get the host from the command line if they gave it
        String host = null;
        String configFile = DEFAULT_CONFIG_FILE;
        if (args.length == 1) {
            configFile = args[0];
        }

        // start the configuration system
        Configuration.initialise(configFile);
 
        // the data display panel
        DataPanel data = new DataPanel();
        
        // the control panel
        ControlPanel control = new ControlPanel(data);
        
        // the main frame (passed the two panels)
        Conient client = new Conient(data, control);
        conientFrame = (Frame) client;
        Conient.addMessage("Conient {an i-scream Client} (c) 2001 The i-scream Project (http://www.i-scream.org.uk)");

        Conient.addMessage("Conient ready.");
        
    }
    
    /**
     * A static accessor, allowing components of the system
     * to get hold of the root frame of the system.
     *
     * see conientFrame attribute for details.
     *
     * @return the root Conient frame
     */
    public static Frame getFrame() {
        return conientFrame;
    }
    
//---CONSTRUCTORS---

    /**
     * Creates a new Swing Client Frame
     */
    private Conient(JSplitPane data, ControlPanel control) {
        // set up the Frame
        super("Conient {an i-scream Client}");
        setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT);
        setJMenuBar(control.getMenuBar());
        
        // set what happens when the X in the corner is clicked        
        addWindowListener(new WindowAdapter() {
            public void windowClosing(WindowEvent e) {System.exit(0);}
        });

        // add the control pane to the top border
        getContentPane().add(control, "North");
        // add the data pane to the centre        
        getContentPane().add(data);

        // setup the status panel        
        JPanel bottom = new JPanel();
        bottom.setLayout(new BorderLayout());
        _messages.setEditable(false);
        _messages.setRows(3);
        JScrollPane messagesPane = new JScrollPane(_messages);
        messagesPane.setBorder(new TitledBorder(new LineBorder(new Color(0, 0, 102)), " Messages "));
        bottom.add(messagesPane, "Center");
        JPanel statusPanel = new JPanel();
        JPanel linkPanel = new JPanel();
        linkPanel.setLayout(new GridLayout(1,2));
        linkPanel.add(_controlStatus);
        linkPanel.add(_dataStatus);
        statusPanel.setLayout(new GridLayout(2,1));
        statusPanel.add(linkPanel);
        statusPanel.add(_queueStatus);
        bottom.add(statusPanel, "South");

        // add the status panel to the bottom border
        getContentPane().add(bottom, "South");
        
        // a nice icon for the window
        setIconImage((new ImageIcon(getClass().getResource("/resources/server.gif"))).getImage());

        // and just because we can, a silly splash screen
        // of the dudes that did this funky jibble
        Splash splash = new Splash();
        splash.show();
        // wait
        try {
            Thread.sleep(DISPLAY_SPLASH_TIME_SECONDS * 1000);
        } catch (InterruptedException e) {
            // don't do anything, we don't care
        }
        //loose the window
        splash.dispose();
        splash = null;        
        // show the main window
        show();
    }

//---PUBLIC METHODS---

//---PRIVATE METHODS---

//---ACCESSOR/MUTATOR METHODS---

    /**
     * Sets the control link status.
     *
     * @param status the message
     */
    public static void setControlStatus(String status) {
        _controlStatus.setText("Control Link: " + status);
        _controlStatus.repaint();
    }
    
    /**
     * Sets the data link status.
     *
     * @param status the message
     */
    public static void setDataStatus(String status) {
        _dataStatus.setText("Data Link: " + status);
        _dataStatus.repaint();
    }

    /**
     * Updates the queue status.
     *
     * @param currentQueue
     * @param numElements
     */
    public static void setQueueStatus(int currentQueue, int numElements) {
        _queueStatus.setText("Data Queue : " + currentQueue + " Packets Recieved : " + numElements);
        _queueStatus.repaint();
    }

    /**
     * Adds a system message to the messages list
     *
     * @param message the new message
     */
    public static void addMessage(String message) {
        _messages.insert(message + "\n", 0);
    }

//---ATTRIBUTES---
    
//---STATIC ATTRIBUTES---
    
    /**
     * Displays information about the data link
     */
    static JLabel _controlStatus = new JLabel("Control Link: Disconnected", JLabel.LEFT);
    {
        _controlStatus.setBorder(new EtchedBorder(EtchedBorder.LOWERED));
    }
    
    /**
     * Displays information about the data link
     */
    static JLabel _dataStatus = new JLabel("Data Link: Disconnected", JLabel.LEFT);
    {
        _dataStatus.setBorder(new EtchedBorder(EtchedBorder.LOWERED));
    }
    
    /**
     * Displays information about the inbound data queue.
     */
    static JLabel _queueStatus = new JLabel(" ", JLabel.LEFT);
    {
        _queueStatus.setBorder(new EtchedBorder(EtchedBorder.LOWERED));
    }
    
    /**
     * The place where system messages are written.
     */
    static JTextArea _messages = new JTextArea();
    {
        _messages.setLineWrap(true);
    }
    
    /**
     * Holds a reference to the root frame for Conient
     * This is only used by dialogs (specifically the configurationn
     * dialog) so that it can be modal, please use the accessor.
     */
    private static Frame conientFrame;
    
//---INNER CLASSES----

    /**
     * An inner class to display a splash screen
     */
    private class Splash extends JWindow {
        
        /**
         * Constructs a new splash screen
         */
        public Splash() {
            setCursor(Cursor.getPredefinedCursor(Cursor.WAIT_CURSOR));
            JPanel splash = new JPanel();
            splash.setBackground(Color.black);
            JLabel image = new JLabel((new ImageIcon(getClass().getResource("/resources/i-scream-splash.gif"))));
            splash.add(image);
            setContentPane(splash);
            Dimension screen = getToolkit().getScreenSize();
            pack();
            setLocation((screen.width - getSize().width) / 2,
                        (screen.height - getSize().height) / 2);
            
            
        }
    }
}
Revision:	1.35
Committed:	Fri Jan 31 17:05:50 2003 UTC (21 years, 3 months ago) by tdb
Branch:	MAIN
Changes since 1.34:	+4 -4 lines
Log Message:	The images (from the resources directory) are now inside the JAR file. Thanks Pete for pointing out how to do this ;)
#	Content
1	/*
2	* i-scream central monitoring system
3	* http://www.i-scream.org.uk
4	* Copyright (C) 2000-2002 i-scream
5	*
6	* This program is free software; you can redistribute it and/or
7	* modify it under the terms of the GNU General Public License
8	* as published by the Free Software Foundation; either version 2
9	* of the License, or (at your option) any later version.
10	*
11	* This program is distributed in the hope that it will be useful,
12	* but WITHOUT ANY WARRANTY; without even the implied warranty of
13	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14	* GNU General Public License for more details.
15	*
16	* You should have received a copy of the GNU General Public License
17	* along with this program; if not, write to the Free Software
18	* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
19	*/
20
21	//---PACKAGE DECLARATION---
22	package uk.org.iscream.cms.conient;
23
24	//---IMPORTS---
25	import javax.swing.*;
26	import javax.swing.border.*;
27	import java.awt.*;
28	import java.awt.event.*;
29
30	/**
31	* This is the main class of the Conient client.
32	*
33	* This sets up the control panel, the data panel
34	* and its own display.
35	*
36	* @author $Author: tdb $
37	* @version $Id: Conient.java,v 1.34 2002/05/21 16:47:10 tdb Exp $
38	*/
39	public class Conient extends JFrame {
40
41	//---FINAL ATTRIBUTES---
42
43	/**
44	* The current CVS revision of this class
45	*/
46	public final String REVISION = "$Revision: 1.34 $";
47
48	/**
49	* The initial width of the window
50	*/
51	private final int DEFAULT_WIDTH = 700;
52
53	/**
54	* The initial height of the window
55	*/
56	private final int DEFAULT_HEIGHT = 600;
57
58	/**
59	* The default configuration fle
60	* This can be specified on the command line
61	*/
62	public static final String DEFAULT_CONFIG_FILE = "./etc/default.conf";
63
64	/**
65	* The time in seconds to display the splash
66	* screen for
67	*/
68	public static final int DISPLAY_SPLASH_TIME_SECONDS = 3;
69
70	//---STATIC METHODS---
71
72	/**
73	* The first method that is called.
74	* Sets up the various panels
75	*
76	* @param args the command line arguments
77	*/
78	public static void main(String[] args) {
79	// get the host from the command line if they gave it
80	String host = null;
81	String configFile = DEFAULT_CONFIG_FILE;
82	if (args.length == 1) {
83	configFile = args[0];
84	}
85
86	// start the configuration system
87	Configuration.initialise(configFile);
88
89	// the data display panel
90	DataPanel data = new DataPanel();
91
92	// the control panel
93	ControlPanel control = new ControlPanel(data);
94
95	// the main frame (passed the two panels)
96	Conient client = new Conient(data, control);
97	conientFrame = (Frame) client;
98	Conient.addMessage("Conient {an i-scream Client} (c) 2001 The i-scream Project (http://www.i-scream.org.uk)");
99
100	Conient.addMessage("Conient ready.");
101
102	}
103
104	/**
105	* A static accessor, allowing components of the system
106	* to get hold of the root frame of the system.
107	*
108	* see conientFrame attribute for details.
109	*
110	* @return the root Conient frame
111	*/
112	public static Frame getFrame() {
113	return conientFrame;
114	}
115
116	//---CONSTRUCTORS---
117
118	/**
119	* Creates a new Swing Client Frame
120	*/
121	private Conient(JSplitPane data, ControlPanel control) {
122	// set up the Frame
123	super("Conient {an i-scream Client}");
124	setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT);
125	setJMenuBar(control.getMenuBar());
126
127	// set what happens when the X in the corner is clicked
128	addWindowListener(new WindowAdapter() {
129	public void windowClosing(WindowEvent e) {System.exit(0);}
130	});
131
132	// add the control pane to the top border
133	getContentPane().add(control, "North");
134	// add the data pane to the centre
135	getContentPane().add(data);
136
137	// setup the status panel
138	JPanel bottom = new JPanel();
139	bottom.setLayout(new BorderLayout());
140	_messages.setEditable(false);
141	_messages.setRows(3);
142	JScrollPane messagesPane = new JScrollPane(_messages);
143	messagesPane.setBorder(new TitledBorder(new LineBorder(new Color(0, 0, 102)), " Messages "));
144	bottom.add(messagesPane, "Center");
145	JPanel statusPanel = new JPanel();
146	JPanel linkPanel = new JPanel();
147	linkPanel.setLayout(new GridLayout(1,2));
148	linkPanel.add(_controlStatus);
149	linkPanel.add(_dataStatus);
150	statusPanel.setLayout(new GridLayout(2,1));
151	statusPanel.add(linkPanel);
152	statusPanel.add(_queueStatus);
153	bottom.add(statusPanel, "South");
154
155	// add the status panel to the bottom border
156	getContentPane().add(bottom, "South");
157
158	// a nice icon for the window
159	setIconImage((new ImageIcon(getClass().getResource("/resources/server.gif"))).getImage());
160
161	// and just because we can, a silly splash screen
162	// of the dudes that did this funky jibble
163	Splash splash = new Splash();
164	splash.show();
165	// wait
166	try {
167	Thread.sleep(DISPLAY_SPLASH_TIME_SECONDS * 1000);
168	} catch (InterruptedException e) {
169	// don't do anything, we don't care
170	}
171	//loose the window
172	splash.dispose();
173	splash = null;
174	// show the main window
175	show();
176	}
177
178	//---PUBLIC METHODS---
179
180	//---PRIVATE METHODS---
181
182	//---ACCESSOR/MUTATOR METHODS---
183
184	/**
185	* Sets the control link status.
186	*
187	* @param status the message
188	*/
189	public static void setControlStatus(String status) {
190	_controlStatus.setText("Control Link: " + status);
191	_controlStatus.repaint();
192	}
193
194	/**
195	* Sets the data link status.
196	*
197	* @param status the message
198	*/
199	public static void setDataStatus(String status) {
200	_dataStatus.setText("Data Link: " + status);
201	_dataStatus.repaint();
202	}
203
204	/**
205	* Updates the queue status.
206	*
207	* @param currentQueue
208	* @param numElements
209	*/
210	public static void setQueueStatus(int currentQueue, int numElements) {
211	_queueStatus.setText("Data Queue : " + currentQueue + " Packets Recieved : " + numElements);
212	_queueStatus.repaint();
213	}
214
215	/**
216	* Adds a system message to the messages list
217	*
218	* @param message the new message
219	*/
220	public static void addMessage(String message) {
221	_messages.insert(message + "\n", 0);
222	}
223
224	//---ATTRIBUTES---
225
226	//---STATIC ATTRIBUTES---
227
228	/**
229	* Displays information about the data link
230	*/
231	static JLabel _controlStatus = new JLabel("Control Link: Disconnected", JLabel.LEFT);
232	{
233	_controlStatus.setBorder(new EtchedBorder(EtchedBorder.LOWERED));
234	}
235
236	/**
237	* Displays information about the data link
238	*/
239	static JLabel _dataStatus = new JLabel("Data Link: Disconnected", JLabel.LEFT);
240	{
241	_dataStatus.setBorder(new EtchedBorder(EtchedBorder.LOWERED));
242	}
243
244	/**
245	* Displays information about the inbound data queue.
246	*/
247	static JLabel _queueStatus = new JLabel(" ", JLabel.LEFT);
248	{
249	_queueStatus.setBorder(new EtchedBorder(EtchedBorder.LOWERED));
250	}
251
252	/**
253	* The place where system messages are written.
254	*/
255	static JTextArea _messages = new JTextArea();
256	{
257	_messages.setLineWrap(true);
258	}
259
260	/**
261	* Holds a reference to the root frame for Conient
262	* This is only used by dialogs (specifically the configurationn
263	* dialog) so that it can be modal, please use the accessor.
264	*/
265	private static Frame conientFrame;
266
267	//---INNER CLASSES----
268
269	/**
270	* An inner class to display a splash screen
271	*/
272	private class Splash extends JWindow {
273
274	/**
275	* Constructs a new splash screen
276	*/
277	public Splash() {
278	setCursor(Cursor.getPredefinedCursor(Cursor.WAIT_CURSOR));
279	JPanel splash = new JPanel();
280	splash.setBackground(Color.black);
281	JLabel image = new JLabel((new ImageIcon(getClass().getResource("/resources/i-scream-splash.gif"))));
282	splash.add(image);
283	setContentPane(splash);
284	Dimension screen = getToolkit().getScreenSize();
285	pack();
286	setLocation((screen.width - getSize().width) / 2,
287	(screen.height - getSize().height) / 2);
288
289
290	}
291	}
292	}