|
public static CreateEntityModel ( IComponent component, |
||
| component | IComponent | The DD4T Component. |
| baseModelType | The (base) type for the Entity Model. | |
| localization | Sdl.Web.Common.Configuration.Localization | The context |
| return | ||
/// <summary>
/// Gets an Entity Model for a given Entity Identifier.
/// </summary>
/// <param name="id">The Entity Identifier in format ComponentID-TemplateID.</param>
/// <param name="localization">The context Localization.</param>
/// <returns>The Entity Model.</returns>
/// <exception cref="DxaItemNotFoundException">If no Entity Model exists for the given URL.</exception>
/// <remarks>
/// Since we can't obtain CT metadata for DCPs, we obtain the View Name from the CT Title.
/// </remarks>
public virtual EntityModel GetEntityModel(string id, Localization localization)
{
using (new Tracer(id, localization))
{
string[] idParts = id.Split('-');
if (idParts.Length != 2)
{
throw new DxaException(String.Format("Invalid Entity Identifier '{0}'. Must be in format ComponentID-TemplateID.", id));
}
string componentUri = string.Format("tcm:{0}-{1}", localization.LocalizationId, idParts[0]);
string templateUri = string.Format("tcm:{0}-{1}-32", localization.LocalizationId, idParts[1]);
IComponentPresentationFactory componentPresentationFactory = DD4TFactoryCache.GetComponentPresentationFactory(localization);
IComponentPresentation dcp;
if (!componentPresentationFactory.TryGetComponentPresentation(out dcp, componentUri, templateUri))
{
throw new DxaItemNotFoundException(id, localization.LocalizationId);
}
EntityModel result = ModelBuilderPipeline.CreateEntityModel(dcp, localization);
if (result.XpmMetadata != null)
{
// Entity Models requested through this method are per definition "query based" in XPM terminology.
result.XpmMetadata["IsQueryBased"] = true;
}
return(result);
}
}
protected virtual object MapRichText(RichTextData richTextData, Type targetType, ILocalization localization)
{
IList <IRichTextFragment> fragments = new List <IRichTextFragment>();
foreach (object fragment in richTextData.Fragments)
{
string htmlFragment = fragment as string;
if (htmlFragment == null)
{
// Embedded Entity Model (for Media Items)
MediaItem mediaItem = (MediaItem)ModelBuilderPipeline.CreateEntityModel((EntityModelData)fragment, typeof(MediaItem), localization);
mediaItem.IsEmbedded = true;
if (mediaItem.MvcData == null)
{
mediaItem.MvcData = mediaItem.GetDefaultView(localization);
}
fragments.Add(mediaItem);
}
else
{
// HTML fragment.
fragments.Add(new RichTextFragment(htmlFragment));
}
}
RichText richText = new RichText(fragments);
if (targetType == typeof(RichText))
{
return(richText);
}
return(richText.ToString());
}
/// <summary>
/// Populates a Dynamic List by executing the query it specifies.
/// </summary>
/// <param name="dynamicList">The Dynamic List which specifies the query and is to be populated.</param>
/// <param name="localization">The context Localization.</param>
public void PopulateDynamicList(DynamicList dynamicList, Localization localization)
{
using (new Tracer(dynamicList, localization))
{
SimpleBrokerQuery simpleBrokerQuery = dynamicList.GetQuery(localization) as SimpleBrokerQuery;
if (simpleBrokerQuery == null)
{
throw new DxaException($"Unexpected result from {dynamicList.GetType().Name}.GetQuery: {dynamicList.GetQuery(localization)}");
}
BrokerQuery brokerQuery = new BrokerQuery(simpleBrokerQuery);
string[] componentUris = brokerQuery.ExecuteQuery().ToArray();
Log.Debug($"Broker Query returned {componentUris.Length} results. HasMore={brokerQuery.HasMore}");
if (componentUris.Length > 0)
{
Type resultType = dynamicList.ResultType;
ComponentMetaFactory componentMetaFactory = new ComponentMetaFactory(localization.GetCmUri());
dynamicList.QueryResults = componentUris
.Select(c => ModelBuilderPipeline.CreateEntityModel(CreateEntityModelData(componentMetaFactory.GetMeta(c)), resultType, localization))
.ToList();
}
dynamicList.HasMore = brokerQuery.HasMore;
}
}
protected virtual object MapRichText(RichTextData richTextData, Type targetType, Localization localization)
{
IList <IRichTextFragment> fragments = new List <IRichTextFragment>();
foreach (object fragment in richTextData.Fragments)
{
string htmlFragment = fragment as string;
if (htmlFragment == null)
{
var entityModelData = (EntityModelData)fragment;
EntityModel embeddedItem = ModelBuilderPipeline.CreateEntityModel(entityModelData,
entityModelData.BinaryContent != null ? typeof(MediaItem) : typeof(EntityModel), localization);
if (embeddedItem.MvcData == null)
{
embeddedItem.MvcData = embeddedItem.GetDefaultView(localization);
}
embeddedItem.IsEmbedded = true;
fragments.Add(embeddedItem);
}
else
{
// HTML fragment.
fragments.Add(new RichTextFragment(htmlFragment));
}
}
RichText richText = new RichText(fragments);
if (targetType == typeof(RichText))
{
return(richText);
}
return(richText.ToString());
}
protected virtual object MapComponentLink(EntityModelData entityModelData, Type targetType, Localization localization)
{
if (targetType == typeof(Link))
{
return(new Link
{
Id = entityModelData.Id,
Url = GetLinkUrl(entityModelData, localization)
});
}
if (targetType == typeof(string))
{
return(GetLinkUrl(entityModelData, localization));
}
if (!typeof(EntityModel).IsAssignableFrom(targetType))
{
throw new DxaException($"Cannot map Component Link to property of type '{targetType.Name}'.");
}
if (string.IsNullOrWhiteSpace(entityModelData.SchemaId))
{
return(null);
}
return(ModelBuilderPipeline.CreateEntityModel(entityModelData, targetType, localization));
}
/// <summary>
/// Populates a Dynamic List by executing the query it specifies.
/// </summary>
/// <param name="dynamicList">The Dynamic List which specifies the query and is to be populated.</param>
/// <param name="localization">The context Localization.</param>
public override void PopulateDynamicList(DynamicList dynamicList, Localization localization)
{
using (new Tracer(dynamicList, localization))
{
SimpleBrokerQuery simpleBrokerQuery = dynamicList.GetQuery(localization) as SimpleBrokerQuery;
if (simpleBrokerQuery == null)
{
throw new DxaException($"Unexpected result from {dynamicList.GetType().Name}.GetQuery: {dynamicList.GetQuery(localization)}");
}
// get our cursor indexer for this list
var cursors = CursorIndexer.GetCursorIndexer(dynamicList.Id);
// given our start index into the paged list we need to translate that to a cursor
int start = simpleBrokerQuery.Start;
simpleBrokerQuery.Cursor = cursors[start];
// the cursor retrieved may of came from a different start index so we update start
int startIndex = cursors.StartIndex;
simpleBrokerQuery.Start = startIndex;
dynamicList.Start = startIndex;
var cachedDynamicList = SiteConfiguration.CacheProvider.GetOrAdd(
$"PopulateDynamicList-{dynamicList.Id}-{simpleBrokerQuery.GetHashCode()}", // key
CacheRegions.BrokerQuery,
() =>
{
var brokerQuery = new GraphQLQueryProvider();
var components = brokerQuery.ExecuteQueryItems(simpleBrokerQuery).ToList();
Log.Debug($"Broker Query returned {components.Count} results. HasMore={brokerQuery.HasMore}");
if (components.Count > 0)
{
Type resultType = dynamicList.ResultType;
dynamicList.QueryResults = components
.Select(
c =>
ModelBuilderPipeline.CreateEntityModel(
CreateEntityModelData((Component)c), resultType,
localization))
.ToList();
}
dynamicList.HasMore = brokerQuery.HasMore;
if (brokerQuery.HasMore)
{
// update cursor
cursors[simpleBrokerQuery.Start + simpleBrokerQuery.PageSize] = brokerQuery.Cursor;
}
return(dynamicList);
});
dynamicList.QueryResults = cachedDynamicList.QueryResults;
dynamicList.HasMore = cachedDynamicList.HasMore;
}
}
/// <summary>
/// Gets an Entity Model for a given Entity Identifier.
/// </summary>
/// <param name="id">The Entity Identifier in format ComponentID-TemplateID.</param>
/// <param name="localization">The context Localization.</param>
/// <returns>The Entity Model.</returns>
/// <exception cref="DxaItemNotFoundException">If no Entity Model exists for the given URL.</exception>
/// <remarks>
/// Since we can't obtain CT metadata for DCPs, we obtain the View Name from the CT Title.
/// </remarks>
public virtual EntityModel GetEntityModel(string id, Localization localization)
{
using (new Tracer(id, localization))
{
string[] idParts = id.Split('-');
if (idParts.Length != 2)
{
throw new DxaException(String.Format("Invalid Entity Identifier '{0}'. Must be in format ComponentID-TemplateID.", id));
}
string componentUri = localization.GetCmUri(idParts[0]);
string templateUri = localization.GetCmUri(idParts[1], (int)ItemType.ComponentTemplate);
IComponentPresentationFactory componentPresentationFactory = DD4TFactoryCache.GetComponentPresentationFactory(localization);
IComponentPresentation dcp;
if (!componentPresentationFactory.TryGetComponentPresentation(out dcp, componentUri, templateUri))
{
throw new DxaItemNotFoundException(id, localization.Id);
}
EntityModel result;
if (CacheRegions.IsViewModelCachingEnabled)
{
EntityModel cachedEntityModel = SiteConfiguration.CacheProvider.GetOrAdd(
string.Format("{0}-{1}", id, localization.Id), // key
CacheRegions.EntityModel,
() => ModelBuilderPipeline.CreateEntityModel(dcp, localization),
dependencies: new[] { componentUri }
);
// Don't return the cached Entity Model itself, because we don't want dynamic logic to modify the cached state.
result = (EntityModel)cachedEntityModel.DeepCopy();
}
else
{
result = ModelBuilderPipeline.CreateEntityModel(dcp, localization);
}
if (result.XpmMetadata != null)
{
// Entity Models requested through this method are per definition "query based" in XPM terminology.
result.XpmMetadata["IsQueryBased"] = true;
}
return(result);
}
}
protected virtual RegionModel CreateRegionModel(RegionModelData regionModelData, ILocalization localization)
{
MvcData mvcData = CreateMvcData(regionModelData.MvcData, "Region");
Type regionModelType = ModelTypeRegistry.GetViewModelType(mvcData);
RegionModel result = (RegionModel)regionModelType.CreateInstance(regionModelData.Name);
result.ExtensionData = regionModelData.ExtensionData;
result.HtmlClasses = regionModelData.HtmlClasses;
result.MvcData = mvcData;
result.XpmMetadata = localization.IsXpmEnabled ? regionModelData.XpmMetadata : null;
if (regionModelData.Regions != null)
{
IEnumerable <RegionModel> nestedRegionModels = regionModelData.Regions.Select(data => CreateRegionModel(data, localization));
result.Regions.UnionWith(nestedRegionModels);
result.IsVolatile |= result.Regions.Any(region => region.IsVolatile);
}
if (regionModelData.Entities != null)
{
foreach (EntityModelData entityModelData in regionModelData.Entities)
{
EntityModel entityModel;
try
{
entityModel = ModelBuilderPipeline.CreateEntityModel(entityModelData, null, localization);
// indicate to region model that this region is potentially volatile if it contains a volatile entity
result.IsVolatile |= entityModel.IsVolatile;
entityModel.MvcData.RegionName = regionModelData.Name;
}
catch (Exception ex)
{
// If there is a problem mapping an Entity, we replace it with an ExceptionEntity which holds the error details and carry on.
Log.Error(ex);
entityModel = new ExceptionEntity(ex);
}
result.Entities.Add(entityModel);
}
}
return(result);
}
private EntityModel LoadEntityModel(string id, Localization localization)
{
using (new Tracer(id, localization))
{
EntityModelData entityModelData = SiteConfiguration.ModelServiceProvider.GetEntityModelData(id, localization);
if (entityModelData == null)
{
throw new DxaItemNotFoundException(id);
}
EntityModel result = ModelBuilderPipeline.CreateEntityModel(entityModelData, null, localization);
if (result.XpmMetadata != null)
{
// Entity Models requested through this method are per definition "query based" in XPM terminology.
result.XpmMetadata["IsQueryBased"] = true; // TODO TSI-24: Do this in Model Service (or CM-side?)
}
return(result);
}
}
/// <summary>
/// Gets an Entity Model for a given Entity Identifier.
/// </summary>
/// <param name="id">The Entity Identifier in format ComponentID-TemplateID.</param>
/// <param name="localization">The context Localization.</param>
/// <returns>The Entity Model.</returns>
/// <exception cref="DxaItemNotFoundException">If no Entity Model exists for the given URL.</exception>
/// <remarks>
/// Since we can't obtain CT metadata for DCPs, we obtain the View Name from the CT Title.
/// </remarks>
public virtual EntityModel GetEntityModel(string id, Localization localization)
{
using (new Tracer(id, localization))
{
string[] idParts = id.Split('-');
if (idParts.Length != 2)
{
throw new DxaException(String.Format("Invalid Entity Identifier '{0}'. Must be in format ComponentID-TemplateID.", id));
}
string componentUri = string.Format("tcm:{0}-{1}", localization.LocalizationId, idParts[0]);
string templateUri = string.Format("tcm:{0}-{1}-32", localization.LocalizationId, idParts[1]);
IComponentPresentationFactory componentPresentationFactory = DD4TFactoryCache.GetComponentPresentationFactory(localization);
IComponentPresentation dcp;
if (!componentPresentationFactory.TryGetComponentPresentation(out dcp, componentUri, templateUri))
{
throw new DxaItemNotFoundException(id);
}
return(ModelBuilderPipeline.CreateEntityModel(dcp, localization));
}
}
protected virtual RegionModel CreateRegionModel(RegionModelData regionModelData, ILocalization localization)
{
MvcData mvcData = CreateMvcData(regionModelData.MvcData, "Region");
Type regionModelType = ModelTypeRegistry.GetViewModelType(mvcData);
RegionModel result = (RegionModel)regionModelType.CreateInstance(regionModelData.Name);
result.ExtensionData = regionModelData.ExtensionData;
result.HtmlClasses = regionModelData.HtmlClasses;
result.MvcData = mvcData;
result.XpmMetadata = localization.IsXpmEnabled ? regionModelData.XpmMetadata : null;
result.SchemaId = regionModelData.SchemaId;
if (!string.IsNullOrEmpty(regionModelData.SchemaId))
{
SemanticSchema semanticSchema = SemanticMapping.GetSchema(regionModelData.SchemaId, localization);
Type modelType = ModelTypeRegistry.GetViewModelType(mvcData);
MappingData mappingData = new MappingData
{
SourceViewModel = regionModelData,
ModelType = modelType,
PropertyValidation = new Validation
{
MainSchema = semanticSchema,
InheritedSchemas = GetInheritedSemanticSchemas(regionModelData, localization)
},
Fields = null,
MetadataFields = regionModelData.Metadata,
Localization = localization
};
MapSemanticProperties(result, mappingData);
}
if (regionModelData.Regions != null)
{
IEnumerable <RegionModel> nestedRegionModels = regionModelData.Regions.Select(data => CreateRegionModel(data, localization));
result.Regions.UnionWith(nestedRegionModels);
result.IsVolatile |= result.Regions.Any(region => region.IsVolatile);
}
if (regionModelData.Entities != null)
{
foreach (EntityModelData entityModelData in regionModelData.Entities)
{
EntityModel entityModel;
try
{
entityModel = ModelBuilderPipeline.CreateEntityModel(entityModelData, null, localization);
// indicate to region model that this region is potentially volatile if it contains a volatile entity
result.IsVolatile |= entityModel.IsVolatile;
entityModel.MvcData.RegionName = regionModelData.Name;
}
catch (Exception ex)
{
// If there is a problem mapping an Entity, we replace it with an ExceptionEntity which holds the error details and carry on.
Log.Error(ex);
entityModel = new ExceptionEntity(ex);
}
result.Entities.Add(entityModel);
}
}
return(result);
}
