OpenSim
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Events Macros
RemoteAssetServiceConnector.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 log4net;
29 using Mono.Addins;
30 using System;
31 using System.Collections.Generic;
32 using System.Reflection;
33 using Nini.Config;
34 using OpenSim.Framework;
35 using OpenSim.Services.Connectors;
36 using OpenSim.Region.Framework.Interfaces;
37 using OpenSim.Region.Framework.Scenes;
38 using OpenSim.Services.Interfaces;
39 
40 namespace OpenSim.Region.CoreModules.ServiceConnectorsOut.Asset
41 {
42  [Extension(Path = "/OpenSim/RegionModules", NodeName = "RegionModule", Id = "RemoteAssetServicesConnector")]
45  {
46  private static readonly ILog m_log =
47  LogManager.GetLogger(
48  MethodBase.GetCurrentMethod().DeclaringType);
49 
50  private bool m_Enabled = false;
51  private IImprovedAssetCache m_Cache;
52 
53  public Type ReplaceableInterface
54  {
55  get { return null; }
56  }
57 
58  public string Name
59  {
60  get { return "RemoteAssetServicesConnector"; }
61  }
62 
63  public override void Initialise(IConfigSource source)
64  {
65  IConfig moduleConfig = source.Configs["Modules"];
66  if (moduleConfig != null)
67  {
68  string name = moduleConfig.GetString("AssetServices", "");
69  if (name == Name)
70  {
71  IConfig assetConfig = source.Configs["AssetService"];
72  if (assetConfig == null)
73  {
74  m_log.Error("[ASSET CONNECTOR]: AssetService missing from OpenSim.ini");
75  return;
76  }
77 
78  m_Enabled = true;
79 
80  base.Initialise(source);
81 
82  m_log.Info("[ASSET CONNECTOR]: Remote assets enabled");
83  }
84  }
85  }
86 
87  public void PostInitialise()
88  {
89  }
90 
91  public void Close()
92  {
93  }
94 
95  public void AddRegion(Scene scene)
96  {
97  if (!m_Enabled)
98  return;
99 
100  scene.RegisterModuleInterface<IAssetService>(this);
101  }
102 
103  public void RemoveRegion(Scene scene)
104  {
105  }
106 
107  public void RegionLoaded(Scene scene)
108  {
109  if (!m_Enabled)
110  return;
111 
112  if (m_Cache == null)
113  {
114  m_Cache = scene.RequestModuleInterface<IImprovedAssetCache>();
115 
116  // Since we are a shared module and scene data is not
117  // available for every method, the cache must be shared, too
118  //
119  if (!(m_Cache is ISharedRegionModule))
120  m_Cache = null;
121  else
122  SetCache(m_Cache);
123 
124  }
125 
126  m_log.InfoFormat("[ASSET CONNECTOR]: Enabled remote assets for region {0}", scene.RegionInfo.RegionName);
127 
128  if (m_Cache != null)
129  {
130  m_log.InfoFormat("[ASSET CONNECTOR]: Enabled asset caching for region {0}", scene.RegionInfo.RegionName);
131  }
132  }
133  }
134 }
void Close()
This is the inverse to Initialise. After a Close(), this instance won't be usable anymore...
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 PostInitialise()
This is called exactly once after all the shared region-modules have been instanciated and IRegionMod...
void AddRegion(Scene scene)
This is called whenever a Scene is added. For shared modules, this can happen several times...
Non-texture assets
void RemoveRegion(Scene scene)
This is called whenever a Scene is removed. For shared modules, this can happen several times...