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: tdb1 $
 * @version $Id: Core.java,v 1.9 2000/11/16 18:00:36 tdb1 Exp $
 */
class Core {

//---FINAL ATTRIBUTES---

    /**
     * The current CVS revision of this class
     */
    public static final String REVISION = "$Revision: 1.9 $";
    
    /**
     * 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);
            
            // start and bind each server in turn

            // create the logger (either Screen or File)
            ScreenLoggerServant loggerRef = new ScreenLoggerServant(Integer.parseInt(System.getProperty("uk.ac.ukc.iscream.Verbosity")));
            //FileLoggerServant loggerRef = new FileLoggerServant("core.log");
            // and advertise it to the naming context
            objRef = poa.servant_to_reference(loggerRef);
            ncRef.bind(ncRef.to_name("iscream.Logger"), objRef);
            
            // get a ref to the logger servant as a Logger reference
            Logger logRef = LoggerHelper.narrow(objRef);
            
            // create the Configurator
            ConfiguratorServant configuratorRef = new ConfiguratorServant(System.getProperty("uk.ac.ukc.iscream.ConfigurationLocation"), poa, logRef);
            
            // and advertise it to the naming context
            objRef = poa.servant_to_reference(configuratorRef);
            ncRef.bind(ncRef.to_name("iscream.Configurator"), 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("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
            } else {
                System.err.println("CORE ERROR: " + e);
                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.java <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---

}
Revision:	1.10
Committed:	Thu Nov 16 19:28:03 2000 UTC (23 years, 6 months ago) by ajm
Branch:	MAIN
Changes since 1.9:	+163 -117 lines
Log Message:	Added the ability of the system to load a properties file to set ORB, logger and configurator settings on startup. Added ability to specifiy the name of the default properties file Added usage information
#	User	Rev	Content
1	ajm	1.10	//---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: tdb1 $
20			* @version $Id: Core.java,v 1.9 2000/11/16 18:00:36 tdb1 Exp $
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: 1.9 $";
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			// create the logger (either Screen or File)
96			ScreenLoggerServant loggerRef = new ScreenLoggerServant(Integer.parseInt(System.getProperty("uk.ac.ukc.iscream.Verbosity")));
97			//FileLoggerServant loggerRef = new FileLoggerServant("core.log");
98			// and advertise it to the naming context
99			objRef = poa.servant_to_reference(loggerRef);
100			ncRef.bind(ncRef.to_name("iscream.Logger"), objRef);
101
102			// get a ref to the logger servant as a Logger reference
103			Logger logRef = LoggerHelper.narrow(objRef);
104
105			// create the Configurator
106			ConfiguratorServant configuratorRef = new ConfiguratorServant(System.getProperty("uk.ac.ukc.iscream.ConfigurationLocation"), poa, logRef);
107
108			// and advertise it to the naming context
109			objRef = poa.servant_to_reference(configuratorRef);
110			ncRef.bind(ncRef.to_name("iscream.Configurator"), objRef);
111
112			// start the POA off
113			poa.the_POAManager().activate();
114
115			logRef.write(toString, Logger.SYSINIT, "started");
116
117			// now we are running, we just need to serve
118			// so we ask the orb to block for us until it has finished
119			orb.run();
120
121			// if there was a problem then we'll get to here
122			} catch (Exception e) {
123
124			// there is already another CORE of the same name registered
125			if ( e instanceof org.omg.CosNaming.NamingContextPackage.AlreadyBound) {
126			System.err.println("ERROR: Another I-Scream CORE is already registered under the same name.");
127
128			// otherwise we don't know what happened
129			// so print the error and do a stack trace
130			} else {
131			System.err.println("CORE ERROR: " + e);
132			e.printStackTrace(System.out);
133			}
134			}
135			}
136
137			/**
138			* A simple method to print the usage of this class.
139			* It never returns, but instead exits to the system
140			* with a value 1, to indicate the system did not start
141			* properly.
142			*/
143			public static void usage() {
144			System.out.println("USAGE: java Core.java <option>");
145			System.out.println("WHERE <option>:");
146			System.out.println(" -l <filename> - the location of initial system properties");
147			System.out.println(" -h - this help screen");
148			System.exit(1);
149			}
150
151			//---CONSTRUCTORS---
152
153			//---PUBLIC METHODS---
154
155			//---PRIVATE METHODS---
156
157			//---ACCESSOR/MUTATOR METHODS---
158
159			//---ATTRIBUTES---
160
161			//---STATIC ATTRIBUTES---
162
163			}