/// <summary>
/// Creates <see cref="IHierarchyItemAsync"/> instance by path.
/// </summary>
/// <param name="path">Item relative path including query string.</param>
/// <returns>Instance of corresponding <see cref="IHierarchyItemAsync"/> or null if item is not found.</returns>
public override async Task <IHierarchyItemAsync> GetHierarchyItemAsync(string path)
{
path = path.Trim(new[] { ' ', '/' });
//remove query string.
int ind = path.IndexOf('?');
if (ind > -1)
{
path = path.Remove(ind);
}
IHierarchyItemAsync item = null;
// Return items from [DAVLocation]/acl/ folder and subfolders.
item = await AclFactory.GetAclItemAsync(this, path);
if (item != null)
{
return(item);
}
// Return items from [DAVLocation]/addressbooks/ folder and subfolders.
item = CardDavFactory.GetCardDavItem(this, path);
if (item != null)
{
return(item);
}
// Return folder that corresponds to [DAVLocation] path. If no DavLocation is defined in config file this is a website root.
item = DavLocationFolder.GetDavLocationFolder(this, path);
if (item != null)
{
return(item);
}
item = await DavFolder.GetFolderAsync(this, path);
if (item != null)
{
return(item);
}
item = await DavFile.GetFileAsync(this, path);
if (item != null)
{
return(item);
}
Logger.LogDebug("Could not find item that corresponds to path: " + path);
return(null); // no hierarchy item that corresponds to path parameter was found in the repository
}
/// <summary>
/// Resolves path to instance of <see cref="IHierarchyItem"/>.
/// This method is called by WebDAV engine to resolve paths it encounters
/// in request.
/// </summary>
/// <param name="path">Relative path to the item including query string.</param>
/// <returns><see cref="IHierarchyItem"/> instance if item is found, <c>null</c> otherwise.</returns>
public override async Task <IHierarchyItemAsync> GetHierarchyItemAsync(string path)
{
path = path.Trim(new[] { ' ', '/' });
//remove query string.
int ind = path.IndexOf('?');
if (ind > -1)
{
path = path.Remove(ind);
}
IHierarchyItemAsync item = null;
// Return items from [DAVLocation]/acl/ folder and subfolders.
item = await AclFactory.GetAclItemAsync(this, path);
if (item != null)
{
return(item);
}
// Return items from [DAVLocation]/addressbooks/ folder and subfolders.
item = await CardDavFactory.GetCardDavItemAsync(this, path);
if (item != null)
{
return(item);
}
// Return folder that corresponds to [DAVLocation] path. If no DavLocation section is defined in web.config/app.config [DAVLocation] is a website root.
string davLocation = DavLocationFolder.DavLocationFolderPath.Trim('/');
if (davLocation.Equals(path, StringComparison.InvariantCultureIgnoreCase))
{
return(new DavLocationFolder(this));
}
// Return any folders above [DAVLocation] path.
// Root folder with ICalendarDiscovery/IAddressbookDiscovery implementation is required for calendars and address books discovery by CalDAV/CardDAV clients.
// All other folders are returned just for folders structure browsing convenience using WebDAV clients during dev time, not required by CalDAV/CardDAV clients.
if (davLocation.StartsWith(path, StringComparison.InvariantCultureIgnoreCase))
{
int childFolderPathLength = (davLocation + "/").IndexOf('/', path.Length + 1);
string childFolderPath = davLocation.Substring(0, childFolderPathLength);
return(new LogicalFolder(this, path, new [] { new LogicalFolder(this, childFolderPath) }));
}
Logger.LogDebug("Could not find item that corresponds to path: " + path);
return(null); // no hierarchy item that corresponds to path parameter was found in the repository
}
