1 files changed, 127 insertions, 0 deletions
diff --git a/java/src/Ice/Application.java b/java/src/Ice/Application.java
new file mode 100644
index 00000000000..a4f7cf93624
--- /dev/null
+++ b/java/src/Ice/Application.java
@@ -0,0 +1,127 @@
+// **********************************************************************
+//
+// Copyright (c) 2001
+// MutableRealms, Inc.
+// Huntsville, AL, USA
+//
+// All Rights Reserved
+//
+// **********************************************************************
+
+package Ice;
+
+public class Application
+{
+    public
+    Application()
+    {
+    }
+
+    //
+    // This main() must be called by the global main(). main()
+    // initializes the Communicator, calls run(), and destroys
+    // the Communicator upon return from run(). It thereby handles
+    // all exceptions properly, i.e., error messages are printed
+    // if exceptions propagate to main(), and the Communicator is
+    // always destroyed, regardless of exceptions.
+    //
+    public final int
+    main(String appName, String[] args)
+    {
+        main(args, null);
+    }
+
+    public final int
+    main(String appName, String[] args, String configFile)
+    {
+        if (_communicator != null)
+        {
+            System.err.println(appName + ": only one instance of the "
+                               "Application class can be used");
+            return 1;
+        }
+
+        _appName = appName;
+
+        int status = 0;
+
+        try
+        {
+            if (configFile != null)
+            {
+                Properties properties =
+                    Util.createPropertiesFromFile(args, configFile);
+                _communicator = Util.initializeWithProperties(properties);
+            }
+            else
+            {
+                _communicator = Util.initialize(args);
+            }
+            status = run(args);
+        }
+        catch(LocalException ex)
+        {
+            System.err.println(_appName + ": " + ex);
+            ex.printStackTrace();
+            status = 1;
+        }
+        catch(Exception ex)
+        {
+            System.err.println(_appName + ": unknown exception");
+            ex.printStackTrace();
+            status = 1;
+        }
+
+        if (_communicator != null)
+        {
+            try
+            {
+                _communicator.destroy();
+            }
+            catch(LocalException ex)
+            {
+                System.err.println(_appName + ": " + ex);
+                ex.printStackTrace();
+                status = 1;
+            }
+            catch(Exception ex)
+            {
+                System.err.println(_appName + ": unknown exception");
+                ex.printStackTrace();
+                status = 1;
+            }
+            _communicator = null;
+        }
+
+        return status;
+    }
+
+    public abstract int
+    run(String[] args);
+
+    //
+    // Return the application name, i.e., argv[0].
+    //
+    public static String
+    appName()
+    {
+        return _appName;
+    }
+
+    //
+    // One limitation of this class is that there can only be one
+    // Application instance, with one global Communicator, accessible
+    // with this communicator() operation. This limitiation is due to
+    // how the signal handling functions below operate. If you require
+    // multiple Communicators, then you cannot use this Application
+    // framework class.
+    //
+    public static Communicator
+    communicator()
+    {
+        return _communicator;
+    }
+
+    private static String _appName;
+    private static Communicator _communicator;
+}