/* * Copyright (c) Contributors, http://opensimulator.org/ * See CONTRIBUTORS.TXT for a full list of copyright holders. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the OpenSim Project nor the * names of its contributors may be used to endorse or promote products * derived from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ using System; using System.Collections.Generic; using libsecondlife; //using System.Reflection; //using log4net; namespace OpenSim.Framework.Communications.Cache { public class InventoryFolderImpl : InventoryFolderBase { //private static readonly ILog m_log = LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType); public static readonly string PATH_DELIMITER = "/"; /// /// Items that are contained in this folder /// public Dictionary Items = new Dictionary(); /// /// Child folders that are contained in this folder /// public Dictionary SubFolders = new Dictionary(); // Constructors public InventoryFolderImpl(InventoryFolderBase folderbase) { Owner = folderbase.Owner; ID = folderbase.ID; Name = folderbase.Name; ParentID = folderbase.ParentID; Type = folderbase.Type; Version = folderbase.Version; } public InventoryFolderImpl() { } /// /// Create a new subfolder. This exists only in the cache. /// /// /// /// /// The newly created subfolder. Returns null if the folder already exists public InventoryFolderImpl CreateChildFolder(LLUUID folderID, string folderName, ushort type) { lock (SubFolders) { if (!SubFolders.ContainsKey(folderID)) { InventoryFolderImpl subFold = new InventoryFolderImpl(); subFold.Name = folderName; subFold.ID = folderID; subFold.Type = (short) type; subFold.ParentID = this.ID; subFold.Owner = Owner; SubFolders.Add(subFold.ID, subFold); return subFold; } } return null; } /// /// Delete all the folders and items in this folder. /// public void Purge() { foreach (InventoryFolderImpl folder in SubFolders.Values) { folder.Purge(); } SubFolders.Clear(); Items.Clear(); } /// /// Returns the item if it exists in this folder or in any of this folder's descendant folders /// /// /// null if the item is not found public InventoryItemBase FindItem(LLUUID itemID) { lock (Items) { if (Items.ContainsKey(itemID)) { return Items[itemID]; } } lock (SubFolders) { foreach (InventoryFolderImpl folder in SubFolders.Values) { InventoryItemBase item = folder.FindItem(itemID); if (item != null) { return item; } } } return null; } /// /// Deletes an item if it exists in this folder or any children /// /// /// public bool DeleteItem(LLUUID itemID) { bool found = false; lock (Items) { if (Items.ContainsKey(itemID)) { Items.Remove(itemID); return true; } } lock (SubFolders) { foreach (InventoryFolderImpl folder in SubFolders.Values) { found = folder.DeleteItem(itemID); if (found == true) { break; } } } return found; } /// /// Returns the folder requested if it is this folder or is a descendent of this folder. The search is depth /// first. /// /// The requested folder if it exists, null if it does not. public InventoryFolderImpl FindFolder(LLUUID folderID) { if (folderID == ID) return this; lock (SubFolders) { foreach (InventoryFolderImpl folder in SubFolders.Values) { InventoryFolderImpl returnFolder = folder.FindFolder(folderID); if (returnFolder != null) return returnFolder; } } return null; } /// /// Find a folder given a PATH_DELIMITOR delimited path starting from this folder /// /// This method does not handle paths that contain multiple delimitors /// /// FIXME: We do not yet handle situations where folders have the same name. We could handle this by some /// XPath like expression /// /// FIXME: Delimitors which occur in names themselves are not currently escapable. /// /// /// The path to the required folder. It this is empty then this folder itself is returned. /// /// null if the folder is not found public InventoryFolderImpl FindFolderByPath(string path) { if (path == string.Empty) return this; string[] components = path.Split(new string[] { PATH_DELIMITER }, 2, StringSplitOptions.None); lock (SubFolders) { foreach (InventoryFolderImpl folder in SubFolders.Values) { if (folder.Name == components[0]) if (components.Length > 1) return folder.FindFolderByPath(components[1]); else return folder; } } // We didn't find a folder with the given name return null; } /// /// Find an item given a PATH_DELIMITOR delimited path starting from this folder. /// /// This method does not handle paths that contain multiple delimitors /// /// FIXME: We do not yet handle situations where folders or items have the same name. We could handle this by some /// XPath like expression /// /// FIXME: Delimitors which occur in names themselves are not currently escapable. /// /// /// The path to the required item. /// /// null if the item is not found public InventoryItemBase FindItemByPath(string path) { string[] components = path.Split(new string[] { PATH_DELIMITER }, 2, StringSplitOptions.None); if (components.Length == 1) { lock (Items) { foreach (InventoryItemBase item in Items.Values) { if (item.Name == components[0]) return item; } } } else { lock (SubFolders) { foreach (InventoryFolderImpl folder in SubFolders.Values) { if (folder.Name == components[0]) return folder.FindItemByPath(components[1]); } } } // We didn't find an item or intermediate folder with the given name return null; } /// /// Return a copy of the list of child items in this folder /// public List RequestListOfItems() { List itemList = new List(); lock (Items) { foreach (InventoryItemBase item in Items.Values) { itemList.Add(item); } } //m_log.DebugFormat("[INVENTORY FOLDER IMPL]: Found {0} items", itemList.Count); return itemList; } /// /// Return a copy of the list of child folders in this folder. /// public List RequestListOfFolders() { List folderList = new List(); lock (SubFolders) { foreach (InventoryFolderBase folder in SubFolders.Values) { folderList.Add(folder); } } return folderList; } } }