Run without Gee
[gregoa/zavai.git] / src / core.vala
1 /*
2  * app - zavai main window
3  *
4  * Copyright (C) 2009  Enrico Zini <enrico@enricozini.org>
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software
18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
19  */
20
21 using GLib;
22
23 namespace zavai {
24
25 public interface Resource : Object {
26     /**
27      * Shut down this resource.
28      *
29      * Normally one does nothing here, but it is important to give resources a
30      * chance to do cleanup when the program quits.
31      * 
32      * This can be used for tasks like closing the tags on a GPX track,
33      * releasing a FSO resource, restoring mixer settings and so on.
34      */
35     public abstract void shutdown();
36 }
37
38 public abstract class Service : Object, Resource {
39     public string name { get; construct; }
40
41     bool _started;
42     public bool started {
43         get { return _started; }
44         set { _started = value; }
45         default = false;
46     }
47
48     public signal void toggled(bool new_state);
49
50     protected class Request
51     {
52         public string requestor;
53         public int count;
54         public Request(string requestor)
55         {
56             this.requestor = requestor;
57             count = 1;
58         }
59     }
60
61     protected List<Request> requests;
62
63     construct
64     {
65         requests = null;
66         zavai.registry.register(this);
67     }
68
69     public void shutdown()
70     {
71         stop();
72     }
73
74     /// Activate the service
75     protected virtual void start()
76     {
77         if (!started)
78         {
79             zavai.log.info("Service " + name + " started\n");
80             started = true;
81             toggled(started);
82         }
83     }
84
85     /// Deactivate the service
86     protected virtual void stop()
87     {
88         if (started)
89         {
90             zavai.log.info("Service " + name + " stopped\n");
91             started = false;
92             toggled(started);
93         }
94     }
95
96     /**
97       Request a resource using the given ID.
98      *
99      * If it is the first time the resource is requested, start it and
100      * return true. Else, take note of the request and return false.
101      *
102      * If a resource is requested multiple times with the same ID, it will
103      * need to be released multiple times with that ID.
104      */
105     public bool request(string id)
106     {
107         bool res = (requests == null);
108         bool got = false;
109         for (weak List<Request> i = requests; i != null; i = i.next)
110             if (i.data.requestor == id)
111             {
112                 ++i.data.count;
113                 got = true;
114                 break;
115             }
116         if (!got)
117             requests.prepend(new Request(id));
118         if (res) start();
119         return res;
120     }
121
122     /**
123      * Release a resource using the given ID.
124      *
125      * If after the call nothing is requesting the resource, stop it and
126      * return true. Else, take note of the release and return false.
127      *
128      * If a resource is requested multiple times with the same ID, it will
129      * need to be released multiple times with that ID.
130      */
131     public bool release(string id)
132     {
133         weak List<Request> el = null;
134         for (weak List<Request> i = requests; i != null; i = i.next)
135             if (i.data.requestor == id)
136             {
137                 el = i;
138                 break;
139             }
140
141         if (el == null)
142             return false;
143
144         requests.delete_link(el);
145
146         if (requests != null)
147             return false;
148
149         stop();
150         return true;
151     }
152 }
153
154 }