ViewVC Help

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

root/i-scream/projects/cms/source/server/uk/org/iscream/cms/server/core/Core.java

Comparing projects/cms/source/server/uk/org/iscream/cms/server/core/Core.java (file contents):
Revision 1.14 by ajm, Mon Nov 20 21:10:09 2000 UTC vs.
Revision 1.29 by tdb, Sun Aug 1 10:40:54 2004 UTC

#	Line 1 | Line 1
1	+	/*
2	+	* i-scream central monitoring system
3	+	* http://www.i-scream.org
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.server.core;
23
24		//---IMPORTS---
25	<	import uk.ac.ukc.iscream.core.*;
26	<	import org.omg.CORBA.*;
6	<	import org.omg.CosNaming.*;
7	<	import org.omg.PortableServer.*;
8	<	import java.util.*;
9	<	import java.io.*;
25	>	import uk.org.iscream.cms.util.*;
26	>	import uk.org.iscream.cms.server.componentmanager.*;
27
28		/**
29		* The main class for the CORE of the I-Scream system.
30	<	* The main method of this class initialises the ORB
31	<	* and then starts and registers CORE I-Scream services
32	<	* with the name service.  At which point it essentially
30	>	* This class is the component for CORE I-Scream services
31	>	* namely the Logger and the ConfigurationManager.
32	>	* It registers and starts them, at which point it essentially
33		* finishs its role and the started services continue to
34		* serve requests from the I-Scream system.
35		*
36		* @author  $Author$
37		* @version $Id$
38		*/
39	<	class Core {
39	>	public class Core implements Component {
40
41		//---FINAL ATTRIBUTES---
42
#	Line 29 | Line 46 | class Core {
46		public static final String REVISION = "$Revision$";
47
48		/**
49	<	* The toString() of this class
50	<	* As it won't be instatiated, this is needed.
49	>	* The friendly name for this component, used by
50	>	* all related classes.
51		*/
52	<	public static final String toString = "CORE(" + REVISION.substring(11, REVISION.length() - 2) + ")";
52	>	public static final String NAME = "Core";
53
37	–	/**
38	–	* The default location of the properties file for the system
39	–	*/
40	–	public static final String DEFAULTPROPERTIES = "default.properties";
41	–
54		//---STATIC METHODS---
55
56	+	//---CONSTRUCTORS---
57	+
58	+	//---PUBLIC METHODS---
59	+
60		/**
61	<	* The main method which starts the CORE
61	>	* This method starts the CORE
62		* Currently the args are passed direct to the ORB,
63		* so any ORB paramaters could go there.
64		*
49	–	* @param args the command line arguments
65		*/
66	<	public static void main(String[] args) {
67	<	System.out.println("--- I-Scream ---");
68	<
69	<	// get the command line args
70	<	String defaultProperties = DEFAULTPROPERTIES;
71	<	if (args.length > 0) {
72	<	if (args[0].equals("-l")) {
73	<	defaultProperties = args[1];
74	<	} else if (args[0].equals("-h")) {
60	<	usage();
61	<	} else {
62	<	usage();
63	<	}
64	<	}
65	<
66	<	// load the default properties file into the system properties
67	<	System.out.println(toString + ": initialising - using " + defaultProperties);
66	>	public void start() throws ComponentStartException {
67	>	// start and bind each server in turn
68	>
69	>	// work out which logger to use
70	>	String whichLogger = System.getProperty("uk.org.iscream.cms.server.LoggerClass");
71	>	String loggerPackage = System.getProperty("uk.org.iscream.cms.server.LoggerPackage");
72	>
73	>	// construct the relevant LoggerImpl
74	>	LoggerImpl loggerImplRef = null;
75		try {
76	<	Properties initProperties = new Properties(System.getProperties());
70	<	initProperties.load(new FileInputStream(new File(defaultProperties)));
71	<	System.setProperties(initProperties);
72	<
73	<
76	>	loggerImplRef = (LoggerImpl) ClassLoader.getSystemClassLoader().loadClass(loggerPackage + "." + whichLogger).newInstance();
77		} catch (Exception e) {
78	<	System.err.println(toString + ": ERROR " + e.getMessage());
79	<	usage();
78	>	// if anything goes wrong we throw a failed start exception
79	>	throw new ComponentStartException("unable to load logging class");
80		}
81
82	<	// continue to bring the system up
83	<	System.out.println(toString + ": coming up");
84	<	try {
82	<	// start the ORB
83	<	ORB orb = ORB.init(args, null);
84	<
85	<	// get the Root POA
86	<	org.omg.CORBA.Object objRef = orb.resolve_initial_references("RootPOA");
87	<	POA poa = POAHelper.narrow(objRef);
88	<
89	<	// get a hook to the name service
90	<	objRef = orb.resolve_initial_references("NameService");
91	<	NamingContextExt ncRef = NamingContextExtHelper.narrow(objRef);
92	<
93	<	// check we got it
94	<	if (ncRef == null) {
95	<	throw new Exception("Unable to locate CORBA Naming Service for configured ORB!");
96	<	}
97	<
98	<	// start and bind each server in turn
99	<
100	<	// work out which logger to use
101	<	String whichLogger = System.getProperty("uk.ac.ukc.iscream.LoggerClass", defaultLogger);
102	<
103	<	// construct the relevant LoggerImpl
104	<	LoggerImpl loggerImplRef = (LoggerImpl) ClassLoader.getSystemClassLoader().loadClass(whichLogger).newInstance();
105	<
106	<	// setup and bind the LoggerServant
107	<	LoggerServant loggerRef = new LoggerServant(loggerImplRef);
108	<	objRef = poa.servant_to_reference(loggerRef);
109	<	ncRef.bind(ncRef.to_name("iscream.Logger"), objRef);
110	<
111	<	// get a reference to the servant as a Logger
112	<	Logger logRef = LoggerHelper.narrow(objRef);
82	>	// setup and bind the LoggerServant
83	>	LoggerServant loggerRef = new LoggerServant(loggerImplRef);
84	>	_refman.bindToOrb(loggerRef, "iscream.Logger");
85
86	<	// create the Configurator
87	<	ConfigurationManagerServant configManRef = new ConfigurationManagerServant(poa, logRef);
88	<
89	<	// and advertise it to the naming context
90	<	objRef = poa.servant_to_reference(configManRef);
91	<	ncRef.bind(ncRef.to_name("iscream.ConfigurationManager"), objRef);
92	<
93	<	// start the POA off
94	<	poa.the_POAManager().activate();
95	<
124	<	logRef.write(toString, Logger.SYSINIT, "started");
125	<
126	<	// now we are running, we just need to serve
127	<	// so we ask the orb to block for us until it has finished
128	<	orb.run();
129	<
130	<	// if there was a problem then we'll get to here
131	<	} catch (Exception e) {
132	<
133	<	// there is already another CORE of the same name registered
134	<	if ( e instanceof org.omg.CosNaming.NamingContextPackage.AlreadyBound) {
135	<	System.err.println("CORE ERROR: Another I-Scream CORE is already registered under the same name.");
136	<
137	<	// otherwise we don't know what happened
138	<	// so print the error and do a stack trace if debug is enabled
139	<	} else {
140	<	System.err.println("CORE ERROR: " + e.getMessage());
141	<	if (Integer.parseInt(System.getProperty("uk.ac.ukc.iscream.Verbosity")) == Logger.DEBUG) {
142	<	System.err.println("*** DEBUG ENABLED - printing stack trace ***");
143	<	e.printStackTrace(System.out);
144	<	}
145	<	}
146	<	}
86	>	// get a reference to the servant as a Logger
87	>	_logger = _refman.getLogger();
88	>
89	>	// create the Configurator
90	>	ConfigurationManagerServant configManRef = new ConfigurationManagerServant();
91	>
92	>	// and advertise it to the naming context
93	>	_refman.bindToOrb(configManRef, "iscream.ConfigurationManager");
94	>
95	>	_logger.write(toString(), Logger.SYSINIT, "started");
96		}
97
98	<	/**
99	<	* A simple method to print the usage of this class.
100	<	* It never returns, but instead exits to the system
101	<	* with a value 1, to indicate the system did not start
102	<	* properly.
98	>	/**
99	>	* Does a dependency check. Used mainly at startup to
100	>	* see if the required dependencies (components) are up
101	>	* and running.
102	>	*
103	>	* @return a boolean value, true if the depdencies are satisfied
104		*/
105	<	public static void usage() {
106	<	System.out.println("USAGE: java Core.java <option>");
107	<	System.out.println("WHERE <option>:");
158	<	System.out.println("      -l <filename> - the location of initial system properties");
159	<	System.out.println("      -h            - this help screen");
160	<	System.exit(1);
105	>	public boolean depCheck() {
106	>	// the core has no depedencies
107	>	return true;
108		}
109	+
110	+	/**
111	+	* Overrides the {@link java.lang.Object#toString() Object.toString()}
112	+	* method to provide clean logging (every class should have this).
113	+	*
114	+	* This uses the uk.org.iscream.cms.util.NameFormat class
115	+	* to format the toString()
116	+	*
117	+	* @return the name of this class and its CVS revision
118	+	*/
119	+	public String toString() {
120	+	return FormatName.getName(
121	+	_name,
122	+	getClass().getName(),
123	+	REVISION);
124	+	}
125
163	–	//---CONSTRUCTORS---
164	–
165	–	//---PUBLIC METHODS---
166	–
126		//---PRIVATE METHODS---
127
128		//---ACCESSOR/MUTATOR METHODS---
129
130		//---ATTRIBUTES---
131	<
173	<	//---STATIC ATTRIBUTES---
174	<
131	>
132		/**
133	<	* Default logger, to be used when one is not provided
134	<	* in the configuration.
133	>	* This is the friendly identifier of the
134	>	* component this class is running in.
135	>	* eg, a Filter may be called "filter1",
136	>	* If this class does not have an owning
137	>	* component,  a name from the configuration
138	>	* can be placed here.  This name could also
139	>	* be changed to null for utility classes.
140		*/
141	<	private static final String defaultLogger = "ScreenLogger";
142	<
141	>	private String _name = Core.NAME;
142	>
143		/**
144	<	* Default configPath, to be used when one is not provided
145	<	* in the configuration.
144	>	* This holds a reference to the
145	>	* system logger that is being used.
146		*/
147	<	private static final String defaultConfigPath = ".";
147	>	private Logger _logger;
148	>
149	>	/**
150	>	* A reference to the reference manager in use
151	>	*/
152	>	private ReferenceManager _refman = ReferenceManager.getInstance();
153	>
154	>	//---STATIC ATTRIBUTES---
155
156		}

Diff Legend

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