OpenSim
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Events Macros
GroupsModule.cs
Go to the documentation of this file.
1 /*
2  * Copyright (c) Contributors, http://opensimulator.org/
3  * See CONTRIBUTORS.TXT for a full list of copyright holders.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are met:
7  * * Redistributions of source code must retain the above copyright
8  * notice, this list of conditions and the following disclaimer.
9  * * Redistributions in binary form must reproduce the above copyright
10  * notice, this list of conditions and the following disclaimer in the
11  * documentation and/or other materials provided with the distribution.
12  * * Neither the name of the OpenSimulator Project nor the
13  * names of its contributors may be used to endorse or promote products
14  * derived from this software without specific prior written permission.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY
17  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
18  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
19  * DISCLAIMED. IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY
20  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
21  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
22  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
23  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
25  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26  */
27 
28 using System;
29 using System.Collections.Generic;
30 using System.Reflection;
31 using log4net;
32 using Nini.Config;
33 using OpenMetaverse;
34 using OpenSim.Framework;
35 using OpenSim.Region.Framework.Interfaces;
36 using OpenSim.Region.Framework.Scenes;
37 
38 using Mono.Addins;
39 
40 namespace OpenSim.Region.CoreModules.Avatar.Groups
41 {
42  [Extension(Path = "/OpenSim/RegionModules", NodeName = "RegionModule", Id = "GroupsModule")]
44  {
45  private static readonly ILog m_log =
46  LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType);
47 
48  private Dictionary<UUID, GroupMembershipData> m_GroupMap =
49  new Dictionary<UUID, GroupMembershipData>();
50 
51  private Dictionary<UUID, IClientAPI> m_ClientMap =
52  new Dictionary<UUID, IClientAPI>();
53 
54  private UUID opensimulatorGroupID =
55  new UUID("00000000-68f9-1111-024e-222222111123");
56 
57  private List<Scene> m_SceneList = new List<Scene>();
58 
59  private static GroupMembershipData osGroup =
60  new GroupMembershipData();
61 
62  private bool m_Enabled = false;
63 
64  #region ISharedRegionModule Members
65 
66  public void Initialise(IConfigSource config)
67  {
68  IConfig groupsConfig = config.Configs["Groups"];
69 
70  if (groupsConfig == null)
71  {
72  m_log.Info("[GROUPS]: No configuration found. Using defaults");
73  }
74  else
75  {
76  m_Enabled = groupsConfig.GetBoolean("Enabled", false);
77  if (!m_Enabled)
78  {
79  m_log.Info("[GROUPS]: Groups disabled in configuration");
80  return;
81  }
82 
83  if (groupsConfig.GetString("Module", "Default") != "Default")
84  {
85  m_Enabled = false;
86  return;
87  }
88  }
89 
90  }
91 
92  public void AddRegion(Scene scene)
93  {
94  if (!m_Enabled)
95  return;
96 
97  lock (m_SceneList)
98  {
99  if (!m_SceneList.Contains(scene))
100  {
101  if (m_SceneList.Count == 0)
102  {
103  osGroup.GroupID = opensimulatorGroupID;
104  osGroup.GroupName = "OpenSimulator Testing";
105  osGroup.GroupPowers =
106  (uint)(GroupPowers.AllowLandmark |
107  GroupPowers.AllowSetHome);
108  m_GroupMap[opensimulatorGroupID] = osGroup;
109  }
110  m_SceneList.Add(scene);
111  }
112  }
113 
114  scene.EventManager.OnNewClient += OnNewClient;
115  scene.EventManager.OnClientClosed += OnClientClosed;
116  // scene.EventManager.OnIncomingInstantMessage += OnGridInstantMessage;
117  }
118 
119  public void RemoveRegion(Scene scene)
120  {
121  if (!m_Enabled)
122  return;
123 
124  lock (m_SceneList)
125  {
126  if (m_SceneList.Contains(scene))
127  m_SceneList.Remove(scene);
128  }
129 
130  scene.EventManager.OnNewClient -= OnNewClient;
131  scene.EventManager.OnClientClosed -= OnClientClosed;
132  }
133 
134  public void RegionLoaded(Scene scene)
135  {
136  }
137 
138  public void PostInitialise()
139  {
140  }
141 
142  public void Close()
143  {
144  if (!m_Enabled)
145  return;
146 
147 // m_log.Debug("[GROUPS]: Shutting down group module.");
148 
149  lock (m_ClientMap)
150  {
151  m_ClientMap.Clear();
152  }
153 
154  lock (m_GroupMap)
155  {
156  m_GroupMap.Clear();
157  }
158  }
159 
160  public string Name
161  {
162  get { return "GroupsModule"; }
163  }
164 
165  public Type ReplaceableInterface
166  {
167  get { return null; }
168  }
169 
170  #endregion
171 
172  private void OnNewClient(IClientAPI client)
173  {
174  // Subscribe to instant messages
175 // client.OnInstantMessage += OnInstantMessage;
176  client.OnAgentDataUpdateRequest += OnAgentDataUpdateRequest;
177  client.OnUUIDGroupNameRequest += HandleUUIDGroupNameRequest;
178  lock (m_ClientMap)
179  {
180  if (!m_ClientMap.ContainsKey(client.AgentId))
181  {
182  m_ClientMap.Add(client.AgentId, client);
183  }
184  }
185 
186  GroupMembershipData[] updateGroups = new GroupMembershipData[1];
187  updateGroups[0] = osGroup;
188 
189  client.SendGroupMembership(updateGroups);
190  }
191 
192  private void OnAgentDataUpdateRequest(IClientAPI remoteClient,
193  UUID AgentID, UUID SessionID)
194  {
195  UUID ActiveGroupID;
196  string ActiveGroupName;
197  ulong ActiveGroupPowers;
198 
199  string firstname = remoteClient.FirstName;
200  string lastname = remoteClient.LastName;
201 
202  string ActiveGroupTitle = "I IZ N0T";
203 
204  ActiveGroupID = osGroup.GroupID;
205  ActiveGroupName = osGroup.GroupName;
206  ActiveGroupPowers = osGroup.GroupPowers;
207 
208  remoteClient.SendAgentDataUpdate(AgentID, ActiveGroupID, firstname,
209  lastname, ActiveGroupPowers, ActiveGroupName,
210  ActiveGroupTitle);
211  }
212 
213 // private void OnInstantMessage(IClientAPI client, GridInstantMessage im)
214 // {
215 // }
216 
217 // private void OnGridInstantMessage(GridInstantMessage msg)
218 // {
219 // // Trigger the above event handler
220 // OnInstantMessage(null, msg);
221 // }
222 
223  private void HandleUUIDGroupNameRequest(UUID id,IClientAPI remote_client)
224  {
225  string groupnamereply = "Unknown";
226  UUID groupUUID = UUID.Zero;
227 
228  lock (m_GroupMap)
229  {
230  if (m_GroupMap.ContainsKey(id))
231  {
232  GroupMembershipData grp = m_GroupMap[id];
233  groupnamereply = grp.GroupName;
234  groupUUID = grp.GroupID;
235  }
236  }
237  remote_client.SendGroupNameReply(groupUUID, groupnamereply);
238  }
239 
240  private void OnClientClosed(UUID agentID, Scene scene)
241  {
242  lock (m_ClientMap)
243  {
244  if (m_ClientMap.ContainsKey(agentID))
245  {
246 // IClientAPI cli = m_ClientMap[agentID];
247 // if (cli != null)
248 // {
249 // //m_log.Info("[GROUPS]: Removing all reference to groups for " + cli.Name);
250 // }
251 // else
252 // {
253 // //m_log.Info("[GROUPS]: Removing all reference to groups for " + agentID.ToString());
254 // }
255  m_ClientMap.Remove(agentID);
256  }
257  }
258  }
259  }
260 }
void Initialise(IConfigSource config)
This is called to initialize the region module. For shared modules, this is called exactly once...
Definition: GroupsModule.cs:66
void Close()
This is the inverse to Initialise. After a Close(), this instance won't be usable anymore...
void PostInitialise()
This is called exactly once after all the shared region-modules have been instanciated and IRegionMod...
void RemoveRegion(Scene scene)
This is called whenever a Scene is removed. For shared modules, this can happen several times...
void AddRegion(Scene scene)
This is called whenever a Scene is added. For shared modules, this can happen several times...
Definition: GroupsModule.cs:92
Interactive OpenSim region server
Definition: OpenSim.cs:55
void RegionLoaded(Scene scene)
This will be called once for every scene loaded. In a shared module this will be multiple times in on...