HelpSource/Classes/AbstractServerAction.schelp

   1 class:: AbstractServerAction
   2 summary:: register actions to be taken for a server
   3 related:: Classes/Server, Classes/ServerBoot, Classes/ServerTree, Classes/ServerQuit
   4 categories:: Control
   5
   6 description::
   7
   8 This is an strong::abstract superclass:: for singletons like link::Classes/ServerQuit::, which provides a place for registering functions and objects for events that should happen when something happens in the server.
   9 No direct call to AbstractServerAction is required.
  10
  11 note:: not fully working on linux and windows.
  12 Setting the computer to sleep on these systems causes the actions to be called.
  13 As to date in linux, JACK does not survive a sleep, it nevertheless behaves correctly for the time being.
  14 ::
  15
  16 ClassMethods::
  17
  18 method::functionSelector
  19 Subclasses return specific function selectors for objects that implement this as interface.
  20 Selectors are:
  21 list::
  22 ## doOnServerBoot - link::Classes/ServerBoot::
  23 ## doOnServerQuit - link::Classes/ServerQuit::
  24 ## doOnServerTree - link::Classes/ServerTree::
  25 ::
  26
  27 not for registry with a server, but analogous are:
  28 list::
  29 ## doOnCmdPeriod - link::Classes/CmdPeriod::
  30 ## doOnStartUp - link::Classes/StartUp::
  31 ## doOnShutDown - link::Classes/ShutDown::
  32 ::
  33
  34 method::add
  35 Add an action or object for registry.
  36
  37 argument::object
  38 Can either be a link::Classes/Function:: to be evaluated (as first arg the server is passed in), or an link::Classes/Object:: that implements the message returned by link::#-functionSelector::. strong::One object is only registered once::, so that multiple additions don't cause multiple calls.
  39
  40 argument::server
  41 Server for which to register. If the symbol strong::\default:: is passed in, the action is called for the current default server. If the symbol strong::\all:: is passed in, the action is called for all current servers. If server is nil, it is added to \default.
  42
  43 method::remove
  44 Remove an item or object from registry. If server is nil, remove from strong::default:: key.
  45
  46 method::removeServer
  47 Remove all items that are registered for a given server.
  48
  49 Examples::
  50
  51 code::
  52 // ServerBoot
  53 s.boot;
  54 f = { |server| "------------The server '%' has booted.------------\n".postf(server) };
  55 ServerBoot.add(f, \default);
  56 s.quit; // quit the server and observe the post
  57 s.boot;
  58 ServerBoot.remove(f, \default); // remove it again
  59 s.quit;
  60 s.boot;// no post.
  61 ServerBoot.add(f, Server.internal);
  62 Server.internal.quit;
  63 Server.internal.boot;
  64 ServerBoot.removeAll; // clear all
  65 ::
  66
  67 code::
  68 // ServerQuit
  69 s.boot;
  70 f = { |server| "------------The server '%' has quit.------------\n".postf(server) };
  71 ServerQuit.add(f, \default);
  72 s.quit; // quit the server and observe the post
  73 s.boot;
  74 ServerQuit.remove(f, \default); // remove it again
  75 s.quit; // no post.
  76 ServerQuit.add(f, Server.internal);
  77 Server.internal.boot;
  78 Server.internal.quit;
  79 ServerQuit.removeAll; // clear all
  80 ::
  81
  82 code::
  83 // ServerTree
  84 s.quit;
  85 f = { |server| "-------The server '%' has initialised tree.-------\n".postf(server) };
  86 g = { |server| 10.do { Group(server).postln } };
  87 ServerBoot.add(f, \default);
  88 ServerTree.add(g, \default);
  89 s.boot; // boot and see how the actions are evaluated in order
  90 // "cmd-period" (or equivalent) resends the groups.
  91
  92 ServerBoot.removeAll; // clear all
  93 ServerTree.removeAll; // clear all
  94 ::