/// <summary>
/// Generates the document map based on the <see cref="CurrentFiles"/>.
/// </summary>
public virtual DocumentMap GenerateMap()
{
EntryCreator.Reset();
DocumentMap map = this.UseObservableCollection ? new ObservableDocumentMap() : new DocumentMap();
int fileCounter = 1;
// For each of the documentedfiles generate the document map and add
// it to the parent node of the document map
for (int i = 0; i < this.CurrentFiles.Count; i++)
{
if (!this.CurrentFiles[i].IsCompiled)
{
continue;
}
Entry assemblyEntry = this.GenerateDocumentForAssembly(map, this.CurrentFiles[i], ref fileCounter);
if (assemblyEntry.Children.Count > 0)
{
map.Add(assemblyEntry);
}
}
map.Sort();
map.NumberOfEntries = this.EntryCreator.Created;
return(map);
}
/// <summary>
/// Searches the top level elements for the specified <paramref name="name"/>.
/// </summary>
/// <param name="name">The name.</param>
/// <returns>The Entry if found else null.</returns>
protected Entry Find(DocumentMap map, string name)
{
Entry found = null;
for (int i = 0; i < map.Count; i++)
{
found = map[i].Name == name ? map[i] : null;
if (found != null)
{
break;
}
}
return(found);
}
/// <summary>
/// Finds the entry in the document map with the specified key.
/// </summary>
/// <param name="key">The key to search for.</param>
/// <param name="checkChildren">Wether or not to check the child entries</param>
/// <returns>The entry that relates to the key or null if not found</returns>
protected Entry FindByKey(DocumentMap map, long key, string subKey, bool checkChildren)
{
Entry found = null;
for (int i = 0; i < map.Count; i++)
{
found = map[i].FindByKey(key, subKey, checkChildren);
if (found != null)
{
break;
}
}
return(found);
}
/// <summary>
/// Generates a document map grouping related namespaces.
/// </summary>
public override DocumentMap GenerateMap()
{
EntryCreator.Reset();
DocumentMap map = UseObservableCollection ? new ObservableDocumentMap() : new DocumentMap();
int fileCounter = 1;
// For each of the documentedfiles generate the document map and add
// it to the parent node of the document map
for (int i = 0; i < CurrentFiles.Count; i++)
{
if (!CurrentFiles[i].IsCompiled)
{
continue;
}
GenerateDocumentForAssembly(map, CurrentFiles[i], ref fileCounter);
}
map.Sort();
bool dontGroupNamespaces = true;
List <string> counter = new List <string>();
List <Entry> namespaceContainers = new List <Entry>();
if (map.Count > 10)
{
// calculate the best level to create groups from or if there is no best place
dontGroupNamespaces = false;
float parentPercentage = 0, currentPercentage = 0;
int currentLevel = 0;
do
{
counter.Clear();
for (int dmI = 0; dmI < map.Count; dmI++)
{
string[] parts = map[dmI].Name.Split('.');
string currentNamespace = parts.Length > currentLevel?string.Join(".", parts, 0, currentLevel + 1) : string.Join(".", parts);
if (!counter.Contains(currentNamespace))
{
counter.Add(currentNamespace);
}
}
currentPercentage = counter.Count / ((float)map.Count);
if (parentPercentage < 0.1 && currentPercentage > 0.65 && currentLevel > 0)
{
dontGroupNamespaces = true;
break;
}
currentLevel++;
parentPercentage = counter.Count / ((float)map.Count);
}while (counter.Count / ((float)map.Count) < 0.1306);
}
if (!dontGroupNamespaces)
{
// create all the top level groupings
int id = 0;
for (int cI = 0; cI < counter.Count; cI++)
{
Entry namespaceContainer = EntryCreator.Create(EntryTypes.NamespaceContainer, counter[cI], null);
namespaceContainer.Key = id++;
if (string.IsNullOrEmpty(counter[cI]))
{
// this is the no name namespace
namespaceContainer.SubKey = "No Namespace";
}
else
{
namespaceContainer.SubKey = counter[cI] + "Namespaces";
}
namespaceContainers.Add(namespaceContainer);
}
// add all the namespaces to the groupings
for (int namespaceI = 0; namespaceI < map.Count; namespaceI++)
{
for (int containersI = namespaceContainers.Count; containersI > 0; containersI--)
{
if (map[namespaceI].Name.Contains(namespaceContainers[containersI - 1].Name))
{
map[namespaceI].Parent = namespaceContainers[containersI - 1];
namespaceContainers[containersI - 1].Children.Add(map[namespaceI]);
break;
}
}
}
}
if (namespaceContainers.Count > 1)
{
map.Clear();
for (int i = 0; i < namespaceContainers.Count; i++)
{
namespaceContainers[i].Name += " Namespaces";
map.Add(namespaceContainers[i]);
}
}
map.NumberOfEntries = EntryCreator.Created;
return(map);
}
protected override Entry GenerateDocumentForAssembly(DocumentMap map, DocumentedAssembly current, ref int fileCounter)
{
AssemblyDef assembly = GetAssemblyDef(current);
ICommentSource xmlComments = GetXmlCommentFile(current);
Entry assemblyEntry = EntryCreator.Create(assembly, System.IO.Path.GetFileName(current.FileName), xmlComments);
current.UniqueId = assembly.UniqueId = fileCounter++;
assemblyEntry.Key = assembly.GetGloballyUniqueId();
assemblyEntry.IsSearchable = false;
Entry namespaceEntry = null;
// Add the namespaces to the document map
Dictionary <string, List <TypeDef> > typesInNamespaces = assembly.GetTypesInNamespaces();
foreach (KeyValuePair <string, List <TypeDef> > currentNamespace in typesInNamespaces)
{
if (currentNamespace.Value.Count == 0)
{
continue;
}
string namespaceSubKey = BuildSubkey(currentNamespace);
namespaceEntry = Find(map, namespaceSubKey);
if (namespaceEntry == null)
{
string displayName = currentNamespace.Key;
if (string.IsNullOrEmpty(currentNamespace.Key))
{
displayName = "None";
}
namespaceEntry = EntryCreator.Create(currentNamespace, displayName, xmlComments);
namespaceEntry.Key = assemblyEntry.Key;
namespaceEntry.SubKey = namespaceSubKey;
namespaceEntry.IsSearchable = false;
}
// Add the types from that namespace to its map
foreach (TypeDef currentType in currentNamespace.Value)
{
if (currentType.IsCompilerGenerated || currentType.Name[0] == '<')
{
continue;
}
PreEntryAddedEventArgs e = new PreEntryAddedEventArgs(currentType);
this.OnPreEntryAdded(e);
if (!e.Filter)
{
Entry typeEntry = EntryCreator.Create(currentType, currentType.GetDisplayName(false), xmlComments, namespaceEntry);
typeEntry.Key = currentType.GetGloballyUniqueId();
typeEntry.IsSearchable = true;
// For some elements we will not want to load the child objects
// this is currently for System.Enum derived values.
if
(
currentType.InheritsFrom != null && currentType.InheritsFrom.GetFullyQualifiedName() == "System.Enum" ||
currentType.IsDelegate)
{
// Ignore children
}
else
{
this.GenerateTypeMap(currentType, typeEntry, xmlComments);
typeEntry.Children.Sort();
}
namespaceEntry.Children.Add(typeEntry);
}
}
if (namespaceEntry.Children.Count > 0)
{
namespaceEntry.Children.Sort();
// we still need to add here otherwise we get duplicate namespaces.
assemblyEntry.Children.Add(namespaceEntry);
if (!map.Contains(namespaceEntry))
{
map.Add(namespaceEntry);
}
else
{
// update the type list is the contianing namespace
KeyValuePair <string, List <TypeDef> > original = (KeyValuePair <string, List <TypeDef> >)namespaceEntry.Item;
original.Value.AddRange(currentNamespace.Value);
}
}
}
// we are not interested in assemblies being used here so make them childless
return(this.EntryCreator.Create(null, string.Empty, null));
}
protected override Entry GenerateDocumentForAssembly(DocumentMap map, DocumentedAssembly current, ref int fileCounter)
{
AssemblyDef assembly = AssemblyDef.Create(current.FileName);
current.LoadedAssembly = assembly;
XmlCommentFile commentFile = new XmlCommentFile(current.XmlFileName, new FileSystem());
commentFile.Load();
ICommentSource xmlComments = commentFile; // not nice having to call load then cast we wil have to fix this
Entry assemblyEntry = this.EntryCreator.Create(assembly, System.IO.Path.GetFileName(current.FileName), xmlComments);
current.UniqueId = assembly.UniqueId = fileCounter++;
assemblyEntry.Key = assembly.GetGloballyUniqueId();
assemblyEntry.IsSearchable = false;
// Add the namespaces to the document map
Dictionary <string, List <TypeDef> > typesInNamespaces = assembly.GetTypesInNamespaces();
foreach (KeyValuePair <string, List <TypeDef> > currentNamespace in typesInNamespaces)
{
if (string.IsNullOrEmpty(currentNamespace.Key) || currentNamespace.Value.Count == 0)
{
continue;
}
string namespaceSubKey = this.BuildSubkey(currentNamespace);
Entry namespaceEntry = this.FindByKey(map, assemblyEntry.Key, namespaceSubKey, false);
if (namespaceEntry == null)
{
namespaceEntry = this.EntryCreator.Create(currentNamespace, currentNamespace.Key, xmlComments, assemblyEntry);
namespaceEntry.Key = assemblyEntry.Key;
namespaceEntry.SubKey = namespaceSubKey;
namespaceEntry.IsSearchable = false;
}
// Add the types from that namespace to its map
foreach (TypeDef currentType in currentNamespace.Value)
{
if (currentType.Name.StartsWith("<"))
{
continue;
}
PreEntryAddedEventArgs e = new PreEntryAddedEventArgs(currentType);
this.OnPreEntryAdded(e);
if (!e.Filter)
{
Entry typeEntry = this.EntryCreator.Create(currentType, currentType.GetDisplayName(false), xmlComments, namespaceEntry);
typeEntry.Key = currentType.GetGloballyUniqueId();
typeEntry.IsSearchable = true;
// For some elements we will not want to load the child objects
// this is currently for System.Enum derived values.
if (
currentType.InheritsFrom != null && currentType.InheritsFrom.GetFullyQualifiedName() == "System.Enum" ||
currentType.IsDelegate)
{
// Ignore children
}
else
{
this.GenerateTypeMap(currentType, typeEntry, xmlComments);
typeEntry.Children.Sort();
}
namespaceEntry.Children.Add(typeEntry);
}
}
if (namespaceEntry.Children.Count > 0)
{
assemblyEntry.Children.Add(namespaceEntry);
namespaceEntry.Children.Sort();
}
}
assemblyEntry.Children.Sort();
return(assemblyEntry);
}
/// <summary>
/// Updates the document map based on the current <see cref="Assemblies"/> and <see cref="Settings"/>.
/// </summary>
public void UpdateDocumentMap()
{
_map = _mapper.GenerateMap();
}