/interpreter/tags/at2-build060407/src/edu/vub/at/actors/net/cmd/CMDProvideService.java

http://ambienttalk.googlecode.com/ · Java · 72 lines · 20 code · 7 blank · 45 comment · 0 complexity · 030b5fa6f3dee6d79ede4a37469f7bee MD5 · raw file

  1. /**
  2. * AmbientTalk/2 Project
  3. * CMDProvideService.java created on 22-feb-2007 at 20:24:31
  4. * (c) Programming Technology Lab, 2006 - 2007
  5. * Authors: Tom Van Cutsem & Stijn Mostinckx
  6. *
  7. * Permission is hereby granted, free of charge, to any person
  8. * obtaining a copy of this software and associated documentation
  9. * files (the "Software"), to deal in the Software without
  10. * restriction, including without limitation the rights to use,
  11. * copy, modify, merge, publish, distribute, sublicense, and/or
  12. * sell copies of the Software, and to permit persons to whom the
  13. * Software is furnished to do so, subject to the following
  14. * conditions:
  15. *
  16. * The above copyright notice and this permission notice shall be
  17. * included in all copies or substantial portions of the Software.
  18. *
  19. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  20. * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
  21. * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  22. * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
  23. * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
  24. * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  25. * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  26. * OTHER DEALINGS IN THE SOFTWARE.
  27. */
  28. package edu.vub.at.actors.net.cmd;
  29. import edu.vub.at.actors.natives.ELVirtualMachine;
  30. import edu.vub.at.actors.natives.Packet;
  31. import edu.vub.at.actors.net.comm.Address;
  32. import edu.vub.at.actors.net.comm.CommunicationBus;
  33. /**
  34. * A CMDProvideService message is sent asynchronously to all connected VMs when
  35. * an actor on the sender VM provided a new publication. Connected VMs are notified
  36. * of this such that they can match this new publication with local subscriptions.
  37. *
  38. * SENDER: the VM that provides a new publication
  39. * RECEIVER: all connected VMs
  40. * MODE: ASYNCHRONOUS, MULTICAST
  41. * PROPERTIES: the subscription info: topic and provided service object
  42. * REPLY: none
  43. *
  44. * @author tvcutsem
  45. */
  46. public class CMDProvideService extends VMCommand {
  47. private final Packet serializedTopic_;
  48. private final Packet serializedService_;
  49. public CMDProvideService(Packet topic, Packet service) {
  50. super("provideService");
  51. serializedTopic_ = topic;
  52. serializedService_ = service;
  53. }
  54. public void send(CommunicationBus dispatcher) {
  55. dispatcher.sendAsyncMulticast(this);
  56. }
  57. /**
  58. * When a remote VM receives the notification, it checks whether any local subscriptions
  59. * can be matched with the new published service.
  60. */
  61. public void uponReceiptBy(ELVirtualMachine remoteHost, Address senderAddress) {
  62. // notify local discovery actor of the new provided service
  63. remoteHost.discoveryActor_.event_remotePublication(serializedTopic_, serializedService_);
  64. }
  65. }