server/core/Core.java

//---PACKAGE DECLARATION---

//---IMPORTS---
import uk.ac.ukc.iscream.core.*;
import org.omg.CORBA.*;
import org.omg.CosNaming.*;
import org.omg.PortableServer.*;
import java.util.*;
import java.io.*;

/**
 * The main class for the CORE of the I-Scream system.
 * The main method of this class initialises the ORB
 * and then starts and registers CORE I-Scream services
 * with the name service.  At which point it essentially
 * finishs its role and the started services continue to
 * serve requests from the I-Scream system.
 *
 * @author  $Author: ajm4 $
 * @version $Id: Core.java,v 1.14 2000/11/20 21:10:09 ajm4 Exp $
 */
class Core {

//---FINAL ATTRIBUTES---

    /**
     * The current CVS revision of this class
     */
    public static final String REVISION = "$Revision: 1.14 $";
    
    /**
     * The toString() of this class
     * As it won't be instatiated, this is needed.
     */
    public static final String toString = "CORE(" + REVISION.substring(11, REVISION.length() - 2) + ")";
    
    /**
     * The default location of the properties file for the system
     */
    public static final String DEFAULTPROPERTIES = "default.properties";
    
//---STATIC METHODS---

    /**
     * The main method which starts the CORE
     * Currently the args are passed direct to the ORB,
     * so any ORB paramaters could go there.
     *
     * @param args the command line arguments
     */
    public static void main(String[] args) {
        System.out.println("--- I-Scream ---");
                
        // get the command line args
        String defaultProperties = DEFAULTPROPERTIES;
        if (args.length > 0) {
            if (args[0].equals("-l")) {
                defaultProperties = args[1];
            } else if (args[0].equals("-h")) {
                usage();
            } else {
                usage();
            }            
        }

        // load the default properties file into the system properties
        System.out.println(toString + ": initialising - using " + defaultProperties);
        try {
            Properties initProperties = new Properties(System.getProperties());
            initProperties.load(new FileInputStream(new File(defaultProperties)));
            System.setProperties(initProperties);


        } catch (Exception e) {
            System.err.println(toString + ": ERROR " + e.getMessage());
            usage();
        }

        // continue to bring the system up
        System.out.println(toString + ": coming up");        
        try {
            // start the ORB
            ORB orb = ORB.init(args, null);
            
            // get the Root POA
            org.omg.CORBA.Object objRef = orb.resolve_initial_references("RootPOA");
            POA poa = POAHelper.narrow(objRef);
            
            // get a hook to the name service
            objRef = orb.resolve_initial_references("NameService");
            NamingContextExt ncRef = NamingContextExtHelper.narrow(objRef);
            
            // check we got it
            if (ncRef == null) {
                throw new Exception("Unable to locate CORBA Naming Service for configured ORB!");
            }
            
            // start and bind each server in turn
            
            // work out which logger to use
            String whichLogger = System.getProperty("uk.ac.ukc.iscream.LoggerClass", defaultLogger);
           
            // construct the relevant LoggerImpl
            LoggerImpl loggerImplRef = (LoggerImpl) ClassLoader.getSystemClassLoader().loadClass(whichLogger).newInstance();
            
            // setup and bind the LoggerServant
            LoggerServant loggerRef = new LoggerServant(loggerImplRef);
            objRef = poa.servant_to_reference(loggerRef);
            ncRef.bind(ncRef.to_name("iscream.Logger"), objRef);
            
            // get a reference to the servant as a Logger
            Logger logRef = LoggerHelper.narrow(objRef);

            // create the Configurator
            ConfigurationManagerServant configManRef = new ConfigurationManagerServant(poa, logRef);
            
            // and advertise it to the naming context
            objRef = poa.servant_to_reference(configManRef);
            ncRef.bind(ncRef.to_name("iscream.ConfigurationManager"), objRef);
            
            // start the POA off
            poa.the_POAManager().activate();
                        
            logRef.write(toString, Logger.SYSINIT, "started");
            
            // now we are running, we just need to serve
            // so we ask the orb to block for us until it has finished
            orb.run();
            
        // if there was a problem then we'll get to here    
        } catch (Exception e) {
            
            // there is already another CORE of the same name registered
            if ( e instanceof org.omg.CosNaming.NamingContextPackage.AlreadyBound) {
                System.err.println("CORE ERROR: Another I-Scream CORE is already registered under the same name.");
            
            // otherwise we don't know what happened
            // so print the error and do a stack trace if debug is enabled
            } else {
                System.err.println("CORE ERROR: " + e.getMessage());
                if (Integer.parseInt(System.getProperty("uk.ac.ukc.iscream.Verbosity")) == Logger.DEBUG) {
                    System.err.println("*** DEBUG ENABLED - printing stack trace ***");
                    e.printStackTrace(System.out);
                }
            }
        }
    }
    
    /** 
     * A simple method to print the usage of this class.
     * It never returns, but instead exits to the system
     * with a value 1, to indicate the system did not start
     * properly.
     */
    public static void usage() {
        System.out.println("USAGE: java Core <option>");
        System.out.println("WHERE <option>:");
        System.out.println("      -l <filename> - the location of initial system properties");
        System.out.println("      -h            - this help screen");
        System.exit(1);
    }

//---CONSTRUCTORS---

//---PUBLIC METHODS---

//---PRIVATE METHODS---

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

//---ATTRIBUTES---
    
//---STATIC ATTRIBUTES---
   
    /**
     * Default logger, to be used when one is not provided
     * in the configuration.
     */
    private static final String defaultLogger = "ScreenLogger";
    
    /**
     * Default configPath, to be used when one is not provided
     * in the configuration.
     */
    private static final String defaultConfigPath = ".";

}
Revision:	1.15
Committed:	Tue Nov 21 15:08:42 2000 UTC (23 years, 5 months ago) by tdb
Branch:	MAIN
Changes since 1.14:	+4 -4 lines
Log Message:	ajm4: Changes to the configuration system to support hierarchical includes.
#	User	Rev	Content
1	tdb	1.13	//---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	tdb	1.15	* @author $Author: ajm4 $
20			* @version $Id: Core.java,v 1.14 2000/11/20 21:10:09 ajm4 Exp $
21	tdb	1.13	*/
22			class Core {
23
24			//---FINAL ATTRIBUTES---
25
26			/**
27			* The current CVS revision of this class
28			*/
29	tdb	1.15	public static final String REVISION = "$Revision: 1.14 $";
30	tdb	1.13
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	ajm	1.14	// check we got it
94			if (ncRef == null) {
95			throw new Exception("Unable to locate CORBA Naming Service for configured ORB!");
96			}
97
98	tdb	1.13	// 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);
113
114			// create the Configurator
115			ConfigurationManagerServant configManRef = new ConfigurationManagerServant(poa, logRef);
116
117			// and advertise it to the naming context
118			objRef = poa.servant_to_reference(configManRef);
119			ncRef.bind(ncRef.to_name("iscream.ConfigurationManager"), objRef);
120
121			// start the POA off
122			poa.the_POAManager().activate();
123
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	ajm	1.14	System.err.println("CORE ERROR: Another I-Scream CORE is already registered under the same name.");
136	tdb	1.13
137			// otherwise we don't know what happened
138	ajm	1.14	// so print the error and do a stack trace if debug is enabled
139	tdb	1.13	} else {
140	ajm	1.14	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	tdb	1.13	}
146			}
147			}
148
149			/**
150			* A simple method to print the usage of this class.
151			* It never returns, but instead exits to the system
152			* with a value 1, to indicate the system did not start
153			* properly.
154			*/
155			public static void usage() {
156	tdb	1.15	System.out.println("USAGE: java Core <option>");
157	tdb	1.13	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);
161			}
162
163			//---CONSTRUCTORS---
164
165			//---PUBLIC METHODS---
166
167			//---PRIVATE METHODS---
168
169			//---ACCESSOR/MUTATOR METHODS---
170
171			//---ATTRIBUTES---
172
173			//---STATIC ATTRIBUTES---
174
175			/**
176			* Default logger, to be used when one is not provided
177			* in the configuration.
178			*/
179			private static final String defaultLogger = "ScreenLogger";
180
181			/**
182			* Default configPath, to be used when one is not provided
183			* in the configuration.
184			*/
185			private static final String defaultConfigPath = ".";
186
187			}