OpenSim
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Events Macros
LocalNeighbourServiceConnector.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 Mono.Addins;
33 using Nini.Config;
34 using OpenMetaverse;
35 using OpenSim.Framework;
36 using OpenSim.Server.Base;
37 using OpenSim.Region.Framework.Interfaces;
38 using OpenSim.Region.Framework.Scenes;
39 using OpenSim.Services.Interfaces;
40 
41 namespace OpenSim.Region.CoreModules.ServiceConnectorsOut.Neighbour
42 {
43  [Extension(Path = "/OpenSim/RegionModules", NodeName = "RegionModule", Id = "LocalNeighbourServicesConnector")]
46  {
47  private static readonly ILog m_log =
48  LogManager.GetLogger(
49  MethodBase.GetCurrentMethod().DeclaringType);
50 
51  private List<Scene> m_Scenes = new List<Scene>();
52 
53  private bool m_Enabled = false;
54 
56  {
57  }
58 
59  public LocalNeighbourServicesConnector(List<Scene> scenes)
60  {
61  m_Scenes = scenes;
62  }
63 
64  #region ISharedRegionModule
65 
66  public Type ReplaceableInterface
67  {
68  get { return null; }
69  }
70 
71  public string Name
72  {
73  get { return "LocalNeighbourServicesConnector"; }
74  }
75 
76  public void Initialise(IConfigSource source)
77  {
78  IConfig moduleConfig = source.Configs["Modules"];
79  if (moduleConfig != null)
80  {
81  string name = moduleConfig.GetString("NeighbourServices", this.Name);
82  if (name == Name)
83  {
84  // m_Enabled rules whether this module registers as INeighbourService or not
85  m_Enabled = true;
86  m_log.Info("[NEIGHBOUR CONNECTOR]: Local neighbour connector enabled");
87  }
88  }
89  }
90 
91  public void Close()
92  {
93  }
94 
95  public void AddRegion(Scene scene)
96  {
97  m_Scenes.Add(scene);
98 
99  if (!m_Enabled)
100  return;
101 
102  scene.RegisterModuleInterface<INeighbourService>(this);
103  }
104 
105  public void RegionLoaded(Scene scene)
106  {
107  m_log.Info("[NEIGHBOUR CONNECTOR]: Local neighbour connector enabled for region " + scene.RegionInfo.RegionName);
108  }
109 
110  public void PostInitialise()
111  {
112  }
113 
114  public void RemoveRegion(Scene scene)
115  {
116  // Always remove
117  if (m_Scenes.Contains(scene))
118  m_Scenes.Remove(scene);
119  }
120 
121  #endregion ISharedRegionModule
122 
123  #region INeighbourService
124 
125  public OpenSim.Services.Interfaces.GridRegion HelloNeighbour(ulong regionHandle, RegionInfo thisRegion)
126  {
127  uint x, y;
128  Util.RegionHandleToRegionLoc(regionHandle, out x, out y);
129 
130  foreach (Scene s in m_Scenes)
131  {
132  if (s.RegionInfo.RegionHandle == regionHandle)
133  {
134  m_log.DebugFormat("[LOCAL NEIGHBOUR SERVICE CONNECTOR]: HelloNeighbour from region {0} to neighbour {1} at {2}-{3}",
135  thisRegion.RegionName, s.Name, x, y );
136 
137  //m_log.Debug("[NEIGHBOUR CONNECTOR]: Found region to SendHelloNeighbour");
138  return s.IncomingHelloNeighbour(thisRegion);
139  }
140  }
141  //m_log.DebugFormat("[NEIGHBOUR CONNECTOR]: region handle {0} not found", regionHandle);
142  return null;
143  }
144 
145  #endregion INeighbourService
146  }
147 }
void PostInitialise()
This is called exactly once after all the shared region-modules have been instanciated and IRegionMod...
void Initialise(IConfigSource source)
This is called to initialize the region module. For shared modules, this is called exactly once...
void RemoveRegion(Scene scene)
This is called whenever a Scene is removed. For shared modules, this can happen several times...
void RegionLoaded(Scene scene)
This will be called once for every scene loaded. In a shared module this will be multiple times in on...
void Close()
This is the inverse to Initialise. After a Close(), this instance won't be usable anymore...
Interactive OpenSim region server
Definition: OpenSim.cs:55
OpenSim.Services.Interfaces.GridRegion HelloNeighbour(ulong regionHandle, RegionInfo thisRegion)
void AddRegion(Scene scene)
This is called whenever a Scene is added. For shared modules, this can happen several times...