README.txt

   1 Light Weight Event System .Net Binding (LWES.net)\r
   2 \r
   3 COPYRIGHT© 2009, Phillip Clark (cerebralkungfu[at*g mail[dot*com)\r
   4   original .NET implementation\r
   5  \r
   6 LWES.net is free software: you can redistribute it and/or modify\r
   7 it under the terms of the Lesser GNU General Public License as published by\r
   8 the Free Software Foundation, either version 3 of the License, or\r
   9 (at your option) any later version.\r
  10 \r
  11 LWES.net is distributed in the hope that it will be useful,\r
  12 but WITHOUT ANY WARRANTY; without even the implied warranty of\r
  13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\r
  14 Lesser GNU General Public License for more details.\r
  15 \r
  16 You should have received a copy of the Lesser GNU General Public License\r
  17 along with LWES.net.  If not, see <http://www.gnu.org/licenses/>.\r
  18 \r
  19 __________________\r
  20 2009-08-21 Version 0.1.3520.28281 ALPHA - Dropped the dependency on the \r
  21         CommonServiceLocator\r
  22         \r
  23         I've chosen to remove the dependency on the CommonServiceLocator since the same\r
  24         result can be achieved by introducing an adapter strategy (Org.Lwes.IoCAdapter). \r
  25         This approach is similar, but for developers downloading the source, they will be \r
  26         able to compile and go without regard to whether the codeplex library is already \r
  27         on their machine. I made this choice because I switch back and forth between two \r
  28         computers with quite different setups. Frankly I got tired of fixing the reference \r
  29         to the external library.\r
  30         \r
  31         VMs: My previous commentary talked a bit about issues related to virtual machine's \r
  32         virtual network connections. Since I wrote those notes I've had complete success \r
  33         by disabling the virtual network connections and using only bridged connections\r
  34         to the underlying (physical) network. ~Phillip (cerebralkungfu)\r
  35 __________________\r
  36 2009-08-13 Version 0.1.* ALPHA - Happy Birthday to me: LWES .NET Binding (LWES.net).\r
  37         \r
  38         This is the initial check-in - it remains a work in progress. I've been working\r
  39         with this code for a couple of weeks, un-protected by version control, so it \r
  40         was time to pull the trigger.\r
  41         \r
  42         The project requires Visual Studio .NET 2008 and .NET 3.0 (or above). \r
  43         Be warned: I HAVE NOT tested all possible configurations! Also note that\r
  44         your network and firewall settings may prevent some of the tests from\r
  45         succeeding. \r
  46         \r
  47         I noticed during development that when I was debugging from a computer that\r
  48         hosts VMWare the virtual device driver prevented the mutlicast traffic from\r
  49         being sent. I was debugging the java TestListener on Ubuntu Linux and couldn't\r
  50         "hear" the multicast events from my Vista64 box until I uninstalled VMWare. \r
  51         My approach was probably too dramatic - you probably won't have to uninstall \r
  52         VMWare, particularly if you've got more patience than I did but I didn't feel \r
  53         like taking the time to figure it out.\r
  54         \r
  55         I also noticed anomolies when using     Sun's VirtualBox, to get the multicast \r
  56         traffic to be reliably transmitted between guest and host I had to bridge \r
  57         a physical adapters so the guest OS     has its own IP addy on the network. \r
  58         The virtual host-only network does not handle multicast traffic properly.\r
  59         \r
  60         Test code targets the built in VSTS. I made this choice based on one simple \r
  61         fact: any developer using Visual Studio .NET 2008 will have the least \r
  62         resistance      getting the solution to build/and run tests. At some point I may \r
  63         put up some NUnit tests since that is my framework of choice (but don't hold \r
  64         me to it).\r
  65         \r
  66         Some of the tests make use of the MOQ for mocking, it can be found \r
  67         at http://code.google.com/p/moq/\r
  68         \r
  69         The IoC support built into this API requires the CommonServiceLocator found \r
  70         at http://www.codeplex.com/CommonServiceLocator. You'll find links to your\r
  71         favorite IoC container among the links on that page.\r
  72                 \r
  73         I have begun a journaler implementation that will use file-based rollover\r
  74         logs for storing raw events.\r
  75         \r
  76         Feel free to offer suggestions or assistance.\r
  77         \r
  78         ~Phillip (cerebralkungfu)\r
  79