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.12 by ajm, Mon Nov 20 17:11:44 2000 UTC vs.
Revision 1.24 by tdb, Wed Mar 14 23:25:29 2001 UTC

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

Diff Legend

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