public RequireSettings RegisterResource(string resourceType, string resourceName)
{
if (resourceType == null)
{
throw new ArgumentNullException(nameof(resourceType));
}
if (resourceName == null)
{
throw new ArgumentNullException(nameof(resourceName));
}
RequireSettings settings;
var key = new ResourceTypeName(resourceType, resourceName);
if (!_required.TryGetValue(key, out settings))
{
settings = new RequireSettings {
Type = resourceType, Name = resourceName
};
_required[key] = settings;
}
_builtResources[resourceType] = null;
return(settings);
}
protected virtual void ExpandDependencies(ResourceDefinition resource, RequireSettings settings, OrderedDictionary allResources)
{
if (resource == null)
{
return;
}
// Settings is given so they can cascade down into dependencies. For example, if Foo depends on Bar, and Foo's required
// location is Head, so too should Bar's location.
// forge the effective require settings for this resource
// (1) If a require exists for the resource, combine with it. Last settings in gets preference for its specified values.
// (2) If no require already exists, form a new settings object based on the given one but with its own type/name.
settings = allResources.Contains(resource)
? ((RequireSettings)allResources[resource]).Combine(settings)
: new RequireSettings {
Type = resource.Type, Name = resource.Name
}.Combine(settings);
if (resource.Dependencies != null)
{
var dependencies = from d in resource.Dependencies
let segments = d.Split('-')
let name = segments[0]
let version = segments.Length > 1 ? segments[1] : null
select FindResource(new RequireSettings { Type = resource.Type, Name = name, Version = version });
foreach (var dependency in dependencies)
{
if (dependency == null)
{
continue;
}
ExpandDependencies(dependency, settings, allResources);
}
}
allResources[resource] = settings;
}
public IHtmlContent RenderFootScript(RequireSettings settings)
{
var htmlBuilder = new HtmlContentBuilder();
var footScripts = this.GetRequiredResources("script");
var first = true;
foreach (var context in footScripts.Where(r => r.Settings.Location == ResourceLocation.Foot))
{
if (!first)
{
htmlBuilder.AppendHtml(Environment.NewLine);
}
first = false;
htmlBuilder.AppendHtml(context.GetHtmlContent(settings, "/"));
}
foreach (var context in GetRegisteredFootScripts())
{
if (!first)
{
htmlBuilder.AppendHtml(Environment.NewLine);
}
first = false;
htmlBuilder.AppendHtml(context);
}
return(htmlBuilder);
}
public void RenderHeadScript(IHtmlContentBuilder builder, RequireSettings settings)
{
var headScripts = this.GetRequiredResources("script");
var first = true;
foreach (var context in headScripts.Where(r => r.Settings.Location == ResourceLocation.Head))
{
if (!first)
{
builder.AppendHtml(Environment.NewLine);
}
first = false;
builder.AppendHtml(context.GetHtmlContent(settings, "/"));
}
foreach (var context in GetRegisteredHeadScripts())
{
if (!first)
{
builder.AppendHtml(Environment.NewLine);
}
first = false;
builder.AppendHtml(context);
}
}
public RequireSettings Combine(RequireSettings other)
{
var settings = (new RequireSettings
{
Name = Name,
Type = Type
}).AtLocation(Location).AtLocation(other.Location)
.WithBasePath(BasePath).WithBasePath(other.BasePath)
.UseCdn(CdnMode).UseCdn(other.CdnMode)
.UseDebugMode(DebugMode).UseDebugMode(other.DebugMode)
.UseCulture(Culture).UseCulture(other.Culture)
.UseCondition(Condition).UseCondition(other.Condition)
.UseVersion(Version).UseVersion(other.Version)
.Define(InlineDefinition).Define(other.InlineDefinition);
settings._attributes = MergeAttributes(other);
return(settings);
}
public void RenderStylesheet(IHtmlContentBuilder builder, RequireSettings settings)
{
var first = true;
var styleSheets = this.GetRequiredResources("stylesheet");
foreach (var context in styleSheets)
{
if (!first)
{
builder.AppendHtml(Environment.NewLine);
}
first = false;
builder.AppendHtml(context.GetHtmlContent(settings, "/"));
}
}
private Dictionary <string, string> MergeAttributes(RequireSettings other)
{
// efficiently merge the two dictionaries, taking into account that one or both may not exist
// and that attributes in 'other' should overridde attributes in this, even if the value is null.
if (_attributes == null)
{
return(other._attributes == null ? null : new Dictionary <string, string>(other._attributes));
}
if (other._attributes == null)
{
return(new Dictionary <string, string>(_attributes));
}
var mergedAttributes = new Dictionary <string, string>(_attributes);
foreach (var pair in other._attributes)
{
mergedAttributes[pair.Key] = pair.Value;
}
return(mergedAttributes);
}
public IHtmlContent RenderStylesheet(RequireSettings settings)
{
var htmlBuilder = new HtmlContentBuilder();
var first = true;
var styleSheets = this.GetRequiredResources("stylesheet");
foreach (var context in styleSheets)
{
if (!first)
{
htmlBuilder.AppendHtml(Environment.NewLine);
}
first = false;
htmlBuilder.AppendHtml(context.GetHtmlContent(settings, "/"));
}
return(htmlBuilder);
}
public IHtmlContent GetHtmlContent(RequireSettings baseSettings, string appPath)
{
var combinedSettings = baseSettings == null ? Settings : baseSettings.Combine(Settings);
var tagBuilder = Resource.GetTagBuilder(combinedSettings, appPath);
if (String.IsNullOrEmpty(combinedSettings.Condition))
{
return(tagBuilder);
}
var builder = new HtmlContentBuilder();
if (combinedSettings.Condition == NotIE)
{
builder.AppendHtml("<!--[if " + combinedSettings.Condition + "]>-->");
}
else
{
builder.AppendHtml("<!--[if " + combinedSettings.Condition + "]>");
}
builder.AppendHtml(tagBuilder);
if (!string.IsNullOrEmpty(combinedSettings.Condition))
{
if (combinedSettings.Condition == NotIE)
{
builder.AppendHtml("<!--<![endif]-->");
}
else
{
builder.AppendHtml("<![endif]-->");
}
}
return(builder);
}
public IHtmlContent GetHtmlContent(RequireSettings baseSettings, string appPath)
{
var combinedSettings = baseSettings == null ? Settings : baseSettings.Combine(Settings);
var tagBuilder = Resource.GetTagBuilder(combinedSettings, appPath);
if (String.IsNullOrEmpty(combinedSettings.Condition))
{
return tagBuilder;
}
var builder = new HtmlContentBuilder();
if (combinedSettings.Condition == NotIE)
{
builder.AppendHtml("<!--[if " + combinedSettings.Condition + "]>-->");
}
else
{
builder.AppendHtml("<!--[if " + combinedSettings.Condition + "]>");
}
builder.AppendHtml(tagBuilder);
if (!string.IsNullOrEmpty(combinedSettings.Condition))
{
if (combinedSettings.Condition == NotIE)
{
builder.AppendHtml("<!--<![endif]-->");
}
else
{
builder.AppendHtml("<![endif]-->");
}
}
return builder;
}
public TagBuilder GetTagBuilder(RequireSettings settings, string applicationPath)
{
string url;
// Url priority:
if (settings.DebugMode)
{
url = settings.CdnMode
? Coalesce(UrlCdnDebug, UrlDebug, UrlCdn, Url)
: Coalesce(UrlDebug, Url, UrlCdnDebug, UrlCdn);
}
else
{
url = settings.CdnMode
? Coalesce(UrlCdn, Url, UrlCdnDebug, UrlDebug)
: Coalesce(Url, UrlDebug, UrlCdn, UrlCdnDebug);
}
if (String.IsNullOrEmpty(url))
{
url = null;
}
if (!String.IsNullOrEmpty(settings.Culture))
{
string nearestCulture = FindNearestCulture(settings.Culture);
if (!String.IsNullOrEmpty(nearestCulture))
{
url = Path.ChangeExtension(url, nearestCulture + Path.GetExtension(url));
}
}
if (url.StartsWith("~/", StringComparison.Ordinal))
{
// For tilde slash paths, drop the leading ~ to make it work with the underlying IFileProvider.
url = url.Substring(1);
}
var tagBuilder = new TagBuilder(TagName);
if (!String.IsNullOrEmpty(CdnIntegrity) && url != null && url == UrlCdn)
{
tagBuilder.Attributes["integrity"] = CdnIntegrity;
tagBuilder.Attributes["crossorigin"] = "anonymous";
}
else if (!String.IsNullOrEmpty(CdnDebugIntegrity) && url != null && url == UrlCdnDebug)
{
tagBuilder.Attributes["integrity"] = CdnDebugIntegrity;
tagBuilder.Attributes["crossorigin"] = "anonymous";
}
if (_resourceAttributes.ContainsKey(Type))
{
tagBuilder.MergeAttributes(_resourceAttributes[Type]);
}
if (Attributes != null)
{
tagBuilder.MergeAttributes(Attributes);
}
if (settings.HasAttributes)
{
tagBuilder.MergeAttributes(settings.Attributes);
}
if (!String.IsNullOrEmpty(FilePathAttributeName))
{
if (!String.IsNullOrEmpty(url))
{
tagBuilder.MergeAttribute(FilePathAttributeName, url, true);
}
}
return(tagBuilder);
}
public TagBuilder GetTagBuilder(RequireSettings settings, string applicationPath)
{
string url;
if (!_urlResolveCache.TryGetValue(settings, out url))
{
// Url priority:
if (settings.DebugMode)
{
url = settings.CdnMode
? Coalesce(UrlCdnDebug, UrlDebug, UrlCdn, Url)
: Coalesce(UrlDebug, Url, UrlCdnDebug, UrlCdn);
}
else
{
url = settings.CdnMode
? Coalesce(UrlCdn, Url, UrlCdnDebug, UrlDebug)
: Coalesce(Url, UrlDebug, UrlCdn, UrlCdnDebug);
}
if (String.IsNullOrEmpty(url))
{
url = null;
}
if (!String.IsNullOrEmpty(settings.Culture))
{
string nearestCulture = FindNearestCulture(settings.Culture);
if (!String.IsNullOrEmpty(nearestCulture))
{
url = Path.ChangeExtension(url, nearestCulture + Path.GetExtension(url));
}
}
if (url.StartsWith("~/", StringComparison.Ordinal))
{
// For tilde slash paths, drop the leading ~ to make it work with the underlying IFileProvider.
url = url.Substring(1);
}
_urlResolveCache[settings] = url;
}
var tagBuilder = new TagBuilder(TagName);
if (!String.IsNullOrEmpty(CdnIntegrity) && url != null && url == UrlCdn)
{
tagBuilder.Attributes["integrity"] = CdnIntegrity;
tagBuilder.Attributes["crossorigin"] = "anonymous";
}
else if (!String.IsNullOrEmpty(CdnDebugIntegrity) && url != null && url == UrlCdnDebug)
{
tagBuilder.Attributes["integrity"] = CdnDebugIntegrity;
tagBuilder.Attributes["crossorigin"] = "anonymous";
}
if (_resourceAttributes.ContainsKey(Type))
{
tagBuilder.MergeAttributes(_resourceAttributes[Type]);
}
if (Attributes != null)
{
tagBuilder.MergeAttributes(Attributes);
}
if (settings.Attributes != null)
{
tagBuilder.MergeAttributes(settings.Attributes);
}
if (!String.IsNullOrEmpty(FilePathAttributeName))
{
if (!String.IsNullOrEmpty(url))
{
tagBuilder.MergeAttribute(FilePathAttributeName, url, true);
}
}
return tagBuilder;
}
private ResourceDefinition FindResource(RequireSettings settings, bool resolveInlineDefinitions)
{
// find the resource with the given type and name
// that has at least the given version number. If multiple,
// return the resource with the greatest version number.
// If not found and an inlineDefinition is given, define the resource on the fly
// using the action.
var name = settings.Name ?? "";
var type = settings.Type;
ResourceDefinition resource;
var resources = (from p in ResourceManifests
from r in p.GetResources(type)
where name.Equals(r.Key, StringComparison.OrdinalIgnoreCase)
select r.Value).SelectMany(x => x);
if (!String.IsNullOrEmpty(settings.Version))
{
// Specific version, filter
var upper = GetUpperBoundVersion(new Version(settings.Version));
resources = from r in resources
let version = r.Version != null ? new Version(r.Version) : null
where version < upper
select r;
}
resource = (from r in resources
let version = r.Version != null ? new Version(r.Version) : null
orderby version descending
select r).FirstOrDefault();
if (resource == null && _dynamicManifest != null)
{
resources = (from r in _dynamicManifest.GetResources(type)
where name.Equals(r.Key, StringComparison.OrdinalIgnoreCase)
select r.Value).SelectMany(x => x);
if (!String.IsNullOrEmpty(settings.Version))
{
// Specific version, filter
var upper = GetUpperBoundVersion(new Version(settings.Version));
resources = from r in resources
let version = r.Version != null ? new Version(r.Version) : null
where version < upper
select r;
}
resource = (from r in resources
let version = r.Version != null ? new Version(r.Version) : null
orderby version descending
select r).FirstOrDefault();
}
if (resolveInlineDefinitions && resource == null)
{
// Does not seem to exist, but it's possible it is being
// defined by a Define() from a RequireSettings somewhere.
if (ResolveInlineDefinitions(settings.Type))
{
// if any were defined, now try to find it
resource = FindResource(settings, false);
}
}
return(resource);
}
public ResourceDefinition FindResource(RequireSettings settings)
{
return(FindResource(settings, true));
}
public RequireSettings Combine(RequireSettings other)
{
var settings = (new RequireSettings
{
Name = Name,
Type = Type
}).AtLocation(Location).AtLocation(other.Location)
.WithBasePath(BasePath).WithBasePath(other.BasePath)
.UseCdn(CdnMode).UseCdn(other.CdnMode)
.UseDebugMode(DebugMode).UseDebugMode(other.DebugMode)
.UseCulture(Culture).UseCulture(other.Culture)
.UseCondition(Condition).UseCondition(other.Condition)
.UseVersion(Version).UseVersion(other.Version)
.Define(InlineDefinition).Define(other.InlineDefinition);
settings._attributes = MergeAttributes(other);
return settings;
}
private Dictionary<string, string> MergeAttributes(RequireSettings other)
{
// efficiently merge the two dictionaries, taking into account that one or both may not exist
// and that attributes in 'other' should overridde attributes in this, even if the value is null.
if (_attributes == null)
{
return other._attributes == null ? null : new Dictionary<string, string>(other._attributes);
}
if (other._attributes == null)
{
return new Dictionary<string, string>(_attributes);
}
var mergedAttributes = new Dictionary<string, string>(_attributes);
foreach (var pair in other._attributes)
{
mergedAttributes[pair.Key] = pair.Value;
}
return mergedAttributes;
}