/// <summary>
/// Retrieves the entity of the specified type with the provided unique key.
/// </summary>
/// <param name="uniqueKey">The unique key of the entity to retrieve.</param>
/// <returns>The entity with the provided unique key.</returns>
public virtual IEntity Retrieve(string uniqueKey)
{
IEntity entity = Retrieve("UniqueKey", uniqueKey);
if (RequireAuthorisation && entity != null)
{
AuthoriseRetrieveStrategy.New(TypeName).EnsureAuthorised(entity);
}
React(entity);
return(entity);
}
/// <summary>
/// Retrieves the entity of the specified type with the provided ID.
/// </summary>
/// <param name="entityID">The ID of the entity to retrieve.</param>
/// <returns>The entity with the provided ID.</returns>
public virtual IEntity Retrieve(Guid entityID)
{
IEntity entity = Retrieve("ID", entityID);
if (RequireAuthorisation && entity != null)
{
AuthoriseRetrieveStrategy.New(TypeName).EnsureAuthorised(entity);
}
React(entity);
return(entity);
}
/// <summary>
/// Retrieves the entity of the specified type with the provided unique key.
/// </summary>
/// <param name="uniqueKey">The unique key of the entity to retrieve.</param>
/// <returns>The entity with the provided unique key.</returns>
public virtual T Retrieve <T>(string uniqueKey)
where T : IEntity
{
T entity = (T)Retrieve("UniqueKey", uniqueKey);
if (RequireAuthorisation && entity != null)
{
AuthoriseRetrieveStrategy.New <T>().EnsureAuthorised(entity);
}
React(entity);
return(entity);
}
/// <summary>
/// Retrieves the entity of the specified type with the provided ID.
/// </summary>
/// <param name="entityID">The ID of the entity to retrieve.</param>
/// <returns>The entity with the provided ID.</returns>
public virtual T Retrieve <T>(Guid entityID)
where T : IEntity
{
T entity = (T)Retrieve("ID", entityID);
if (RequireAuthorisation && entity != null)
{
AuthoriseRetrieveStrategy.New <T>().EnsureAuthorised(entity);
}
React(entity);
return(entity);
}
/// <summary>
/// Retrieves the entity matching the provided filter group.
/// </summary>
/// <param name="group"></param>
/// <returns></returns>
public virtual IEntity Retrieve(FilterGroup group)
{
IEntity entity = DataAccess.Data.Reader.GetEntity(group);
if (RequireAuthorisation && entity != null)
{
AuthoriseRetrieveStrategy.New(TypeName).EnsureAuthorised(entity);
}
AssignStrategies(entity);
React(entity);
return(entity);
}
/// <summary>
/// Retrieves the entity with a references that matches the provided parameters.
/// </summary>
/// <param name="propertyName">The name of the property containing the references.</param>
/// <param name="referencedEntityType">The type of the entity being referenced.</param>
/// <param name="referencedEntityID">The ID of the entity being referenced.</param>
/// <returns>The entity matching the provided parameters.</returns>
public virtual T RetrieveWithReference <T>(string propertyName, string referencedEntityType, Guid referencedEntityID)
where T : IEntity
{
T entity = (T)DataAccess.Data.Reader.GetEntityWithReference <T>(propertyName, EntityState.GetType(referencedEntityType), referencedEntityID);
if (RequireAuthorisation && entity != null)
{
AuthoriseRetrieveStrategy.New <T>().EnsureAuthorised(entity);
}
AssignStrategies(entity);
React(entity);
return(entity);
}
/// <summary>
/// Retrieves the entity with a references that matches the provided parameters.
/// </summary>
/// <param name="type">The type of entity containing the references.</param>
/// <param name="propertyName">The name of the property containing the references.</param>
/// <param name="referencedEntityType">The type of the entity being referenced.</param>
/// <param name="referencedEntityID">The ID of the entity being referenced.</param>
/// <returns>The entity matching the provided parameters.</returns>
public virtual IEntity RetrieveWithReference(Type type, string propertyName, string referencedEntityType, Guid referencedEntityID)
{
IEntity entity = (IEntity)Reflector.InvokeGenericMethod(this,
"RetrieveWithReference",
new Type[] { EntityState.GetType(referencedEntityType) },
new object[] { propertyName, referencedEntityType, referencedEntityID });
if (RequireAuthorisation && entity != null)
{
AuthoriseRetrieveStrategy.New(type.Name).EnsureAuthorised(entity);
}
React(entity);
return(entity);
}
/// <summary>
/// Retrieves the entity of the specified type with the specified property matching the provided value.
/// </summary>
/// <param name="parameters">The parameters to use as filters when retrieving the entities. Corresponds with properties and their values.</param>
/// <returns>The entity with the specified property matching the provided value.</returns>
public virtual IEntity Retrieve(Dictionary <string, object> parameters)
{
IEntity entity = DataAccess.Data.Reader.GetEntity(EntityState.Entities[TypeName].GetEntityType(),
parameters);
if (RequireAuthorisation && entity != null)
{
AuthoriseRetrieveStrategy.New(TypeName).EnsureAuthorised(entity);
}
AssignStrategies(entity);
React(entity);
return(entity);
}
/// <summary>
/// Retrieves the entity of the specified type with the specified property matching the provided value.
/// </summary>
/// <param name="parameters">The parameters to use as filters when retrieving the entities. Corresponds with properties and their values.</param>
/// <returns>The entity with the specified property matching the provided value.</returns>
public virtual T Retrieve <T>(Dictionary <string, object> parameters)
where T : IEntity
{
T entity = DataAccess.Data.Reader.GetEntity <T>(parameters);
if (RequireAuthorisation && entity != null)
{
AuthoriseRetrieveStrategy.New <T>().EnsureAuthorised(entity);
}
AssignStrategies(entity);
React(entity);
return(entity);
}
/// <summary>
/// Retrieves the entity of the specified type with the specified property matching the provided value.
/// </summary>
/// <param name="propertyName">The name of the property to match to the provided value.</param>
/// <param name="value">The name of the value to match to the specified property.</param>
/// <returns>The entity with the specified property matching the provided value.</returns>
public virtual T Retrieve <T>(string propertyName, object value)
where T : IEntity
{
T entity = DataAccess.Data.Reader.GetEntity <T>(propertyName, value);
if (entity != null)
{
if (RequireAuthorisation)
{
AuthoriseRetrieveStrategy.New <T>().EnsureAuthorised(entity);
}
AssignStrategies(entity);
React(entity);
}
return(entity);
}
/// <summary>
/// Retrieves the entity of the specified type with the specified property matching the provided value.
/// </summary>
/// <param name="propertyName">The name of the property to match to the provided value.</param>
/// <param name="value">The name of the value to match to the specified property.</param>
/// <returns>The entity with the specified property matching the provided value.</returns>
public virtual IEntity Retrieve(string propertyName, object value)
{
IEntity entity = DataAccess.Data.Reader.GetEntity(EntityState.GetType(TypeName),
propertyName,
value);
if (entity != null)
{
if (RequireAuthorisation && entity != null)
{
AuthoriseRetrieveStrategy.New(TypeName).EnsureAuthorised(entity);
}
AssignStrategies(entity);
React(entity);
}
return(entity);
}
