X-Git-Url: http://git.tdb.fi/?p=libs%2Fcore.git;a=blobdiff_plain;f=source%2Fcore%2Fapplication.h;h=d0985be900fb493714760ab07335d06faaa87298;hp=5f3968ac4018faa2c6f3f8b1e3e3fb8f77f1ef64;hb=55a73ee19194aec4179955aed78798c120fb99af;hpb=e1ea831a640fba534e7e42e399f04cdf681ef8d3

diff --git a/source/core/application.h b/source/core/application.h
index 5f3968a..d0985be 100644
--- a/source/core/application.h
+++ b/source/core/application.h
@@ -1,82 +1,111 @@
-/*
-This file is part of libmspframework
-Copyright © 2006 Mikko Rasa, Mikkosoft Productions
-Distributed under the LGPL
-*/
-#ifndef MSP_FRAMEWORK_APPLICATION_H_
-#define MSP_FRAMEWORK_APPLICATION_H_
+#ifndef MSP_CORE_APPLICATION_H_
+#define MSP_CORE_APPLICATION_H_
 
-#include "event.h"
-#include "poller.h"
-#include "types.h"
+#include <stdexcept>
+#include <string>
 
 namespace Msp {
 
 /**
-Base class for applications.  Inherit the main class from this and add a static
-member of type RegApp<MainClass>.
+Base class for applications.  See also RegisteredApplication.
 */
 class Application
 {
-public:
-	Poller::Slot &add_pollable(Pollable *, short);
-	EventManager::Event &create_event();
-	virtual ~Application();
-
-	static int run(int, char **);
-	static void usage(const char *, bool);
 protected:
-	enum TickMode
+	class Starter
 	{
-		NONE,       /// No ticks
-		AFTER_POLL, /// One tick after each poll
-		IDLE        /// Constant torrent of ticks
-	};
-	
-	class RegBase
-	{
-	public:
-		virtual Application *create_app(int, char **)=0;
-		virtual void usage(const char *, bool)=0;
-		virtual ~RegBase() { }
 	protected:
-		RegBase();
-	};
-
-	template<typename T>
-	class RegApp: public RegBase
-	{
+		Starter();
 	public:
-		Application *create_app(int argc, char **argv) { return new T(argc, argv); }
-		void usage(const char *a, bool b) { T::usage(a,b); }
+		virtual ~Starter() { }
+
+		virtual Application *create_app(int, char **) = 0;
 	};
 
 	bool done;
-	int  exit_code;
+	int exit_code;
+
+private:
+	static Starter *starter_;
+	static Application *app_;
+	static const char *argv0_;
+	static std::string name_;
+	static void *data_;
+
+	Application(const Application &);
+	Application &operator=(const Application &);
+protected:
+	Application(const std::string & = std::string());
+public:
+	virtual ~Application() { }
+
+	/** Constructs an instance of the registered application class and runs it.
+	If the application throws a usage_error, a help message is printed.  The
+	GetOpt class will throw such exceptions automatically in error conditions.
+
+	This function can only be called once.  The global main() function provided
+	by the library normally does it automatically at program startup. */
+	static int run(int, char **, void * =0, void (*)(void *) = 0);
+
+	/** Sets application startup info, including argv[0] value and platform-
+	specific data.
+
+	This function can only be called once, and is normally called by
+	Application::run(). */
+	static void set_startup_info(const char *, void *);
 
-	Application();
+	static void *get_data() { return data_; }
+	static const char *get_argv0() { return argv0_; }
+	static const std::string &get_name() { return name_; }
+
+protected:
+	/** Default main loop.  Calls tick() repeatedly until exit() is called.  A
+	custom main loop should monitor the done member variable and return
+	exit_code. */
 	virtual int main();
+
+	/** Sets the specified signal to be delivered to the sighandler member
+	function. */
 	void catch_signal(int);
-	void set_tick_mode(TickMode);
+
+	/** Causes the application to exit gracefully with the given exit code. */
 	void exit(int);
+
 	virtual void tick() { }
 	virtual void sighandler(int) { }
+
 private:
-	TickMode     tick_mode_;
-	Poller       *poller_;
-	EventManager *ev_mgr_;
-	ThreadHandle main_tid;
+	/** Static wrapper function to call a member function of the Application
+	instance. */
+	static void sighandler_(int);
+};
 
-	Application(const Application &);
-	Application &operator=(const Application &);
 
-	static RegBase *reg_app_;
-	static Application *app_;
+/**
+Registers the class to be used for program startup.  The main application class
+should be derived from this.
+*/
+template<typename T>
+class RegisteredApplication: public Application
+{
+private:
+	class Starter: public Application::Starter
+	{
+	public:
+		Application *create_app(int argc, char **argv) { return new T(argc, argv); }
+	};
 
-	static void sighandler_(int);
-	static void sigalrm_(int) { }
+	static Starter starter_;
+
+protected:
+	RegisteredApplication(const std::string &n = std::string()):
+		Application(n)
+	{ (void)starter_; }  // Force the starter into existence
 };
 
+template<typename T>
+typename RegisteredApplication<T>::Starter RegisteredApplication<T>::starter_;
+
 } // namespace Msp
 
 #endif