IgnoreResouceNotFoundExceptionImpl(
bool ignoreResouceNotFoundException)
{
StashClient <KeyDataExplicit> clientWithExtra = null;
KeyDataExplicit dataWritten = null;
try
{
clientWithExtra = StashConfiguration.GetClient <KeyDataExplicit>();
clientWithExtra.CreateTableIfNotExist();
var
clientMin = StashConfiguration.GetClient <KeyDataExplicit>(
new StashClientOptions {
IgnoreResourceNotFoundException = ignoreResouceNotFoundException,
OverrideEntitySetName = instance => typeof(KeyDataExplicit).Name,
OverrideEntitySetNameIsDynamic = false,
});
dataWritten = new KeyDataExplicit {
PartitionKey = "ResourceNotFound",
RowKey = Guid.NewGuid().ToString()
};
clientWithExtra.Insert(dataWritten);
var
dataRead = clientMin.Get(
dataWritten.PartitionKey,
dataWritten.RowKey + "X");
// we should reach here only if ignoreResouceNotFoundException is true
Assert.IsTrue(ignoreResouceNotFoundException);
Assert.IsTrue(dataRead == null);
}
catch (StashException stashEx)
{
Assert.IsTrue(
!ignoreResouceNotFoundException &&
stashEx.Error == StashError.UnexpectedRuntime);
}
catch (Exception ex)
{
Assert.Fail();
}
clientWithExtra.Delete(dataWritten);
}
MissingMembersInTypeImpl(
bool ignoreMissingProperties)
{
StashClient <MissingMembersInType> clientWithExtra = null;
MissingMembersInType dataWritten = null;
try
{
clientWithExtra = StashConfiguration.GetClient <MissingMembersInType>();
clientWithExtra.CreateTableIfNotExist();
var
clientMin = StashConfiguration.GetClient <KeyDataExplicit>(
new StashClientOptions {
IgnoreMissingProperties = ignoreMissingProperties,
OverrideEntitySetName = instance => typeof(MissingMembersInType).Name,
OverrideEntitySetNameIsDynamic = false,
});
dataWritten = new MissingMembersInType {
PartitionKey = "MissingMember",
RowKey = Guid.NewGuid().ToString(),
Int0 = 0,
Int1 = 1,
Int2 = 2
};
clientWithExtra.Insert(dataWritten);
var
dataRead = clientMin.Get(dataWritten.PartitionKey, dataWritten.RowKey);
// we should reach here only if ignoring missing properties
Assert.IsTrue(ignoreMissingProperties);
}
catch (StashException stashEx)
{
Assert.IsTrue(
!ignoreMissingProperties &&
stashEx.Error == StashError.MissingMembersInType);
}
catch (Exception ex)
{
Assert.Fail();
}
clientWithExtra.Delete(dataWritten);
}
DoWhiteSpaceInKeys()
{
StashClient <WhiteSpacesInData>
client = StashConfiguration.GetClient <WhiteSpacesInData>();
client.CreateTableIfNotExist();
const string
partitionKey = " " + _partitionKey; // prefix
string
rowKey = Guid.NewGuid().ToString() + " "; // suffix
const string stringField = " ";
const string stringField2 = " X ";
client.Insert(
new WhiteSpacesInData {
PartitionKey = partitionKey,
RowKey = rowKey,
StringField = stringField,
StringField2 = stringField2
});
var
data =
client
.CreateQuery()
.Where(x => x.PartitionKey == partitionKey && x.RowKey == rowKey)
.FirstOrDefault();
data =
client
.CreateQuery()
.FirstOrDefault(x => x.PartitionKey == partitionKey && x.RowKey == rowKey);
Assert.IsTrue(data != null);
Assert.IsTrue(data.PartitionKey == partitionKey);
Assert.IsTrue(data.RowKey == rowKey);
Assert.IsTrue(data.StringField == "");
Assert.IsTrue(data.StringField2 == stringField2);
client.Delete(data);
}
GetClientWithPopulate(
Guid pKey,
int count)
{
StashClient <KeyDataExplicit>
client = StashConfiguration.GetClient <KeyDataExplicit>();
client.CreateTableIfNotExist();
while (count-- > 0)
{
client.Insert(
new KeyDataExplicit {
PartitionKey = pKey.ToString(),
RowKey = Guid.NewGuid().ToString()
});
}
return(client);
}
Tutorial_08_Context()
{
//----------------------------------------------------------------------------------------------------------
// Create Stash Client and get a new context
StashClient <Employee>
client = StashConfiguration.GetClient <Employee>();
client.CreateTableIfNotExist();
StashContext <Employee>
context = client.GetContext();
//----------------------------------------------------------------------------------------------------------
// Create instances of the class, place in the context and commit the changes.
const
int insertCount = 10;
string departmentDev = Guid.NewGuid().ToString();
// create n employees and insert into the context
Enumerable
.Range(1, insertCount)
.Select(
idx =>
{
Employee
employee = new Employee {
Department = departmentDev,
EmployeeId = Guid.NewGuid().ToString(),
Name = "John Doe",
SkillLevel = 8,
DateOfBirth = new DateTime(1990 - idx, 1, 1)
};
// update the private field
employee.SetAnnualSalary();
return(employee);
})
.ToList()
.ForEach(
item => context.Insert(item));
// validate the the context now contains n items with the correct state.
int contextInsertCount = context
.GetTrackedEntities(EntityState.Inserted)
.Count;
Assert.IsTrue(contextInsertCount == insertCount);
// commit the context
// CommitStrategy.Serial, commits each insert as a single request
// This is the default strategy and need not be passed in - context.Commit() would work the same
context.Commit(CommitStrategy.Serial);
// On a successful commit, the state of the entity changes to EntityState.Unchanged.
// validate that the context contains n items with the correct state
int contextUnchangedState = context
.GetTrackedEntities(EntityState.Unchanged)
.Count;
Assert.IsTrue(contextInsertCount == contextUnchangedState);
//----------------------------------------------------------------------------------------------------------
// The context continues to hold on to the entities so it is often a good idea to either clear the context
// if the entities are no longer needed or better still to just create a new context.
//----------------------------------------------------------------------------------------------------------
// Get a new context and query for the rows we inserted earlier by using the same partition key,
// departmentDev
context = client.GetContext();
context.CreateQuery().Where(emp => emp.Department == departmentDev).ToList();
// Confirm we have the corrent number of items in the context
Assert.IsTrue(context.GetTrackedEntities().Count == insertCount);
// Make changes to this collection of employees in the context, modifying some and deleting the others.
int entityIdx = 0;
int updateCount = 0;
int deleteCount = 0;
context
.GetTrackedEntities()
.ForEach(
entityDescriptor =>
{
Employee
employee = entityDescriptor.Entity;
if (entityIdx % 3 == 0)
{
context.Delete(employee); // delete every 3rd one
++deleteCount;
}
else // update the others
{
++employee.SkillLevel;
employee.SetAnnualSalary(); // change the salary of of the employee
context.Update(employee); // and update in the context
++updateCount;
}
++entityIdx;
});
// Commit the context, this time use the Parallel strategy.
// The Parallel strategy will perform all requests in parallel. In the event of an error,
// a single aggregate StashAggregateException is returned containing one or more of the errors.
context.Commit(CommitStrategy.Parallel);
// Performing a delete will remove an entity form the context. Validate this.
Assert.IsTrue(context.GetTrackedEntities().Count == insertCount - deleteCount);
//----------------------------------------------------------------------------------------------------------
// Now delete all the other entities in the context
context.GetTrackedEntities().ForEach(
entityDescriptor => context.Delete(entityDescriptor.Entity));
// Commit the context, this time use the batch strategy.
// In a nutshell, Batch is a mode supported by Azure table storage which allows,
// a number and size limited request to be made.
// Batch is only allowed on entities within the same Partition and has an all or none success guarantee.
context.Commit(CommitStrategy.Batch);
// If all were deleted successfully the context should not be tracking any entities.
Assert.IsTrue(context.GetTrackedEntities().Count == 0);
//----------------------------------------------------------------------------------------------------------
// So far so good. This concludes this part of the tutorial. Go Stash!
}
Tutorial_09_CompositeKeys()
{
//----------------------------------------------------------------------------------------------------------
// Create Stash Client
StashClient <EmployeeCompensation>
client = StashConfiguration.GetClient <EmployeeCompensation>();
client.CreateTableIfNotExist();
//----------------------------------------------------------------------------------------------------------
// Populate the table with 10 years of salary information
int
nbrOfYears = 10;
DateTime
today = DateTime.Now.ToUniversalTime();
DateTime
hireDate = today.AddYears(-nbrOfYears);
Guid
employeeId = Guid.NewGuid();
// Insert 10 years of data, such that each year the salary goes up by 5000.
for (int yr = 0; yr < nbrOfYears; ++yr)
{
client.Insert(
new EmployeeCompensation {
EmployeeId = employeeId,
CompDate = new CompensationEvent {
CompensationType = CompensatationTypeValue.Salary,
Date = hireDate.AddYears(yr)
},
Amount = 65000 + (yr * 5000)
});
}
//----------------------------------------------------------------------------------------------------------
// Populate the table with the last 12 months of commission information
int
nbrOfMths = 12;
// Insert 12 months of data, such that each year the commission goes up by 50.
for (int mth = 0; mth < nbrOfMths; ++mth)
{
client.Insert(
new EmployeeCompensation {
EmployeeId = employeeId,
CompDate = new CompensationEvent {
CompensationType = CompensatationTypeValue.Commission,
Date = today.AddMonths(-mth)
},
Amount = 1000 + (mth * 50)
});
}
//----------------------------------------------------------------------------------------------------------
// Get the last salary
EmployeeCompensation
employeeCompensation =
client
.CreateQuery()
.Where(e =>
e.EmployeeId == employeeId &&
e.CompDate == new CompensationEvent
{
CompensationType = CompensatationTypeValue.Salary
})
// no need to specify the latest date, we get the first row, which
// has the latest date.
.Take(1) // first row
.FirstOrDefault();
// verify we got the last date and last salary amount
Assert.IsTrue(employeeCompensation.CompDate.Date.Date == hireDate.Date.AddYears((nbrOfYears - 1)));
Assert.IsTrue(employeeCompensation.Amount == 65000 + ((nbrOfYears - 1) * 5000));
// How does this work?
// Stash converts the "Compensation Type == 'S'" into
// "RowKey >= 'S' and RowKey < 'T'" and asks to only return the first one (Take(1))
// In this case the last dated event is the first row, since the date is morphed
// to the number of days before an arbitrary end date, such that the morphed date is
// effectively in reverse order
//----------------------------------------------------------------------------------------------------------
// Get all the commissions
List <EmployeeCompensation>
commissions =
client
.CreateQuery()
.Where(e =>
e.EmployeeId == employeeId &&
e.CompDate == new CompensationEvent
{
CompensationType = CompensatationTypeValue.Commission
})
// no need to specify the date, we get all the commissions
// for the employee because again the query mapped the '==' to a range '>= and <'.
.ToList();
Assert.IsTrue(commissions.Count == nbrOfMths);
//----------------------------------------------------------------------------------------------------------
// Get commissions for the 4 months, prior to the last 4 months
commissions =
client
.CreateQuery()
.Where(e =>
e.EmployeeId == employeeId &&
e.CompDate >= new CompensationEvent
{
CompensationType = CompensatationTypeValue.Commission,
Date = today.AddDays(-5).AddMonths(-8)
} &&
e.CompDate <= new CompensationEvent
{
CompensationType = CompensatationTypeValue.Commission,
Date = today.AddDays(-5).AddMonths(-4)
}
)
.ToList();
Assert.IsTrue(commissions.Count == 4);
// How does this work?
// Stash converts the query from a '>= X && < Y' to
// < X && >= Y because the morpher indicated that 'IsCollationEquivalent' was false.
// otherwise this query would have returned no rows because the range is inverted.
//----------------------------------------------------------------------------------------------------------
}
Tutorial_06_Collections()
{
//----------------------------------------------------------------------------------------------------------
// Create a Stash Client
StashClient <EmployeeSkills>
client = StashConfiguration.GetClient <EmployeeSkills>();
client.CreateTableIfNotExist();
//----------------------------------------------------------------------------------------------------------
// Lets create an instance of the class we what to 'stash'
const
string departmentDev = "Dev";
const
string ssn = "123456789";
EmployeeSkills
dataWritten = new EmployeeSkills {
Department = departmentDev,
EmployeeId = Guid.NewGuid().ToString(),
Name = "John Doe",
SkillLevel = 8,
DateOfBirth = new DateTime(1990, 1, 1),
SSN = ssn,
Salutation = Salutation.Ms
};
// update the private field
dataWritten.SetAnnualSalary();
// Populate Languages, certification and salary history
dataWritten.Languages = new List <ProgramingLanguages> {
ProgramingLanguages.Assembly,
ProgramingLanguages.VisualBasic
};
const
string cert0 = "MSSQL",
cert1 = "MSCPP",
cert2 = "MSRP";
dataWritten.Certifications = new ArrayList {
cert0,
cert1,
cert2
};
dataWritten.SalaryHistory = new SalaryInfo[] {
new SalaryInfo {
DateStart = new DateTime(2009, 1, 1),
DateEnd = new DateTime(2010, 1, 1),
Salary = 100000
},
new SalaryInfo {
DateStart = new DateTime(2010, 1, 1),
DateEnd = new DateTime(2012, 1, 1),
Salary = 110000
},
};
dataWritten.MysteryNumbers = new int[] { 3, 2, 1, 0 };
//----------------------------------------------------------------------------------------------------------
// Stash it
client.Insert(dataWritten);
//----------------------------------------------------------------------------------------------------------
// Read back the data
EmployeeSkills
dataRead = client.Get(dataWritten.Department, dataWritten.EmployeeId);
//----------------------------------------------------------------------------------------------------------
// Verify we got back what we put in
Assert.IsTrue(dataWritten.Equals(dataRead));
//----------------------------------------------------------------------------------------------------------
// Verify exactly what was written to table storage by using the Generic Pool class we wrote
// earlier.
// set this up to target the correct table storage entity set
StashClient <GenericPool>
clientGenericPool = StashConfiguration.GetClient <GenericPool>(
new StashClientOptions {
OverrideEntitySetName = o => "EmployeeSkills",
OverrideEntitySetNameIsDynamic = false,
Feedback = StashConfiguration.TraceFeedback,
});
GenericPool
dataPool = clientGenericPool.Get(
dataRead.Department,
dataRead.EmployeeId);
// All collection items are suffixed with the index base 0, in the format "_000".
// Because the "_" is used for demarcating collection indexes, explicit defined members are not allowed
// to have the embedded "_" character in the table property name.
// Test for languages
Assert.IsTrue(
dataPool.Pool.Where(
kv =>
kv.Key == "Languages_000" &&
((ProgramingLanguages)kv.Value == ProgramingLanguages.Assembly)).ToList().Count == 1);
Assert.IsTrue(
dataPool.Pool.Where(
kv =>
kv.Key == "Languages_001" &&
((ProgramingLanguages)kv.Value == ProgramingLanguages.VisualBasic)).ToList().Count == 1);
// Test for certification
Assert.IsTrue(
dataPool.Pool.Where(
kv =>
kv.Key == "Certifications_000" &&
((string)kv.Value == cert0)).ToList().Count == 1);
Assert.IsTrue(
dataPool.Pool.Where(
kv =>
kv.Key == "Certifications_001" &&
((string)kv.Value == cert1)).ToList().Count == 1);
Assert.IsTrue(
dataPool.Pool.Where(
kv =>
kv.Key == "Certifications_002" &&
((string)kv.Value == cert2)).ToList().Count == 1);
// Test salary history - key only
Assert.IsTrue(
dataPool.Pool.Where(
kv =>
kv.Key == "SalaryHistory_000").ToList().Count == 1);
Assert.IsTrue(
dataPool.Pool.Where(
kv =>
kv.Key == "SalaryHistory_001").ToList().Count == 1);
// Mystery numbers ... well they were persisted using the DataContract Serializer
// and persisted as XML as a single table property.
Assert.IsTrue(
dataPool.Pool.Where(
kv =>
kv.Key == "MysteryNumbers").ToList().Count == 1);
//----------------------------------------------------------------------------------------------------------
// now delete the entity
client.Delete(
departmentDev,
dataWritten.EmployeeId);
//----------------------------------------------------------------------------------------------------------
// And verify that it was actually deleted
// by attempting to read back the data
var queryable = from imp in client.CreateQuery()
where imp.Department == dataWritten.Department &&
imp.EmployeeId == dataWritten.EmployeeId
select imp;
Assert.IsTrue(queryable.ToList().Count == 0);
//----------------------------------------------------------------------------------------------------------
// So far so good. This concludes this part of the tutorial. Go Stash!
}
Tutorial_01_Implicit_JobApplicant()
{
//----------------------------------------------------------------------------------------------------------
// Create the Stash Client.
// Our helper class offers various flavors of this.
StashClient <JobApplicant>
client = StashConfiguration.GetClient <JobApplicant>();
//----------------------------------------------------------------------------------------------------------
// Create the corresponding table or confirm that it exists
// The table name can be inferred using various methods. In this case it is inferred from the class name,
// 'JobApplicant'.
client.CreateTableIfNotExist();
//----------------------------------------------------------------------------------------------------------
// Create an instance of the class we want to Stash
JobApplicant
dataWritten = new JobApplicant {
PartitionKey = "A",
RowKey = Guid.NewGuid().ToString(),
Name = "John Doe",
Skill_Level = 1
};
//----------------------------------------------------------------------------------------------------------
// Stash it
client.Insert(dataWritten);
//----------------------------------------------------------------------------------------------------------
// Read back the data, using the partition and row key, no need to use LINQ here.
JobApplicant
dataRead = client.Get(dataWritten.PartitionKey, dataWritten.RowKey);
//----------------------------------------------------------------------------------------------------------
// Verify we got back what we put in
Assert.IsTrue(dataWritten.Equals(dataRead));
//----------------------------------------------------------------------------------------------------------
// Lets change the SkillLevel and Update
dataWritten.Skill_Level += 1;
client.Update(dataWritten);
//----------------------------------------------------------------------------------------------------------
// Read back the data but this time lets use LINQ
dataRead = client.CreateQuery()
.Where(imp => imp.PartitionKey == dataWritten.PartitionKey &&
imp.RowKey == dataWritten.RowKey)
.FirstOrDefault();
//----------------------------------------------------------------------------------------------------------
// Again verify that we got back what we put in
Assert.IsTrue(dataWritten.Equals(dataRead));
//----------------------------------------------------------------------------------------------------------
// now delete the entity
client.Delete(dataWritten);
//----------------------------------------------------------------------------------------------------------
// And verify that it was actually deleted
// by attempting to read back the data
var queryable = from imp in client.CreateQuery()
where imp.PartitionKey == dataWritten.PartitionKey &&
imp.RowKey == dataWritten.RowKey
select imp;
Assert.IsTrue(queryable.ToList().Count == 0);
//----------------------------------------------------------------------------------------------------------
// So far so good. This concludes this part of the tutorial. Go Stash!
}
Tutorial_03_Explicit_Employee()
{
//----------------------------------------------------------------------------------------------------------
// Create the Stash Client.
StashClient <Employee>
client = StashConfiguration.GetClient <Employee>();
//----------------------------------------------------------------------------------------------------------
// Create the underlying table if it does not already exists
client.CreateTableIfNotExist();
//----------------------------------------------------------------------------------------------------------
// Create an instance of the class
const
string departmentDev = "Dev";
Employee
dataWritten = new Employee {
Department = departmentDev,
EmployeeId = Guid.NewGuid().ToString(),
Name = "John Doe",
SkillLevel = 8,
DateOfBirth = new DateTime(1990, 1, 1)
};
// update the private field
dataWritten.SetAnnualSalary();
//----------------------------------------------------------------------------------------------------------
// Stash it
client.Insert(dataWritten);
// Note: On inserts, updates and merges, the ETag is overwritten from the ETag returned to keep the data
// in sync.
//----------------------------------------------------------------------------------------------------------
// And read it back
Employee
dataRead = client.Get(dataWritten.Department, dataWritten.EmployeeId);
//----------------------------------------------------------------------------------------------------------
// Verify we got back what we put in
Assert.IsTrue(dataWritten.Equals(dataRead));
// Verify that the 2 ETags are identical
Assert.IsTrue(dataRead.ETagInternal == dataWritten.ETagInternal);
//----------------------------------------------------------------------------------------------------------
// Change the Skill level and update the Stash
dataWritten.SkillLevel += 1;
dataWritten.SetAnnualSalary();
client.Update(dataWritten);
//----------------------------------------------------------------------------------------------------------
// Read back the data but this time lets use LINQ
Employee
dataReadUpdated = client.CreateQuery()
.Where(imp => imp.Department == departmentDev &&
imp.EmployeeId == dataWritten.EmployeeId)
.FirstOrDefault();
//----------------------------------------------------------------------------------------------------------
// Again verify that we got back what we put in
Assert.IsTrue(dataWritten.Equals(dataReadUpdated));
// Verify that the 2 ETags are identical
Assert.IsTrue(dataWritten.ETagInternal == dataReadUpdated.ETagInternal);
//----------------------------------------------------------------------------------------------------------
// now attempt to update the data read the first time around
// this should fail and throw an exception since the data was updated since the row was last read and
// so has a stale ETag.
// Uses the implied update mode here by default. That is, if the StashETag attribute is applied to a
// member in the class, implies ETag must match,
bool isSuccess;
try
{
client.Update(dataRead);
isSuccess = false;
}
catch (Exception ex)
{
Assert.IsTrue((ex as StashException).Error == StashError.ETagMatchFailed);
isSuccess = true;
}
Assert.IsTrue(isSuccess);
//----------------------------------------------------------------------------------------------------------
// attempt to update it again but this time ignore ETag matching. This should succeed.
// and dataRead has the latest ETag
client.UpdateUnconditional(dataRead);
//----------------------------------------------------------------------------------------------------------
// now attempt to delete the entity using the data written entity
// this should fail and throw an exception since the data was recently updated and so has a new ETag
// Uses the implied update mode here by default. That is, if the StashETag attribute is applied to a
// member in the class, implies ETag must match,
try
{
client.Delete(dataReadUpdated);
isSuccess = false;
}
catch (Exception ex)
{
Assert.IsTrue((ex as StashException).Error == StashError.ETagMatchFailed);
isSuccess = true;
}
Assert.IsTrue(isSuccess);
//----------------------------------------------------------------------------------------------------------
// now delete the entity unconditionally without the need for ETag Matching.
// Can instead also use client.DeleteUnconditional here too.
client.Delete(dataRead, ETagMatch.Unconditional);
//----------------------------------------------------------------------------------------------------------
// And verify that it was actually deleted
// by attempting to read back the data
var queryable = from imp in client.CreateQuery()
where imp.Department == dataWritten.Department &&
imp.EmployeeId == dataWritten.EmployeeId
select imp;
Assert.IsTrue(queryable.ToList().Count == 0);
//----------------------------------------------------------------------------------------------------------
// Essentially the ETag gist is this.
// Define and decorate a member in your type with an ETag if you want to optimistic concurrency support.
// Stash will keep you ETag in sync across inserts, updates and merges.
// There are multiple ways to implicitly override ETag matching if that is what is wanted.
// The implicit way to disable optimistic concurrency support is not to define an ETag member.
//----------------------------------------------------------------------------------------------------------
// So far so good. This concludes this part of the tutorial. Go Stash!
}
Tutorial_04_DictionaryPool()
{
//----------------------------------------------------------------------------------------------------------
// Create a Stash Client for the Employee class
StashClient <Employee>
clientEmployee = StashConfiguration.GetClient <Employee>();
clientEmployee.CreateTableIfNotExist();
//----------------------------------------------------------------------------------------------------------
// Create an StashClient for the generic pool class,
// Since we want to read and write to the Employee table, notice how we setup the correct EntityName in
// the StashClientOptions. Otherwise the azure table implied would be "GenericPool".
//
// The call back method of naming the table has flexible capabilities. It can be used to determine
// the table name dynamically based on the data in the object instance.
// In this case it is used statically and called only once.
StashClient <GenericPool>
clientGenericPool = StashConfiguration.GetClient <GenericPool>(
new StashClientOptions {
OverrideEntitySetName = o => "Employee",
OverrideEntitySetNameIsDynamic = false,
Feedback = StashConfiguration.TraceFeedback,
});
//----------------------------------------------------------------------------------------------------------
// Stash an Employee
const
string departmentDev = "Dev";
Employee
dataEmployee = new Employee {
Department = departmentDev,
EmployeeId = Guid.NewGuid().ToString(),
Name = "John Doe",
SkillLevel = 8,
DateOfBirth = new DateTime(1990, 1, 1)
};
dataEmployee.SetAnnualSalary();
clientEmployee.Insert(dataEmployee);
//----------------------------------------------------------------------------------------------------------
// and read it back thru the GenericPool
GenericPool
dataPool = clientGenericPool.Get(
dataEmployee.Department,
dataEmployee.EmployeeId);
//----------------------------------------------------------------------------------------------------------
// Verify we got back what we put in via the Employee type.
Assert.IsTrue(
dataPool.PrimaryKey == dataEmployee.Department &&
dataPool.SecondaryKey == dataEmployee.EmployeeId &&
dataPool.Pool["AnnualSalary"].Equals(dataEmployee.GetAnnualSalary()) &&
dataPool.Pool["Birthday"].Equals(dataEmployee.DateOfBirth) &&
dataPool.Pool["SkillLevel"].Equals(dataEmployee.SkillLevel) &&
dataPool.Pool["Name"].Equals(dataEmployee.Name) &&
dataPool.Pool.Count == 4 + 1); // + 1 to the ETag
//----------------------------------------------------------------------------------------------------------
// Make a few changes and update
dataPool.Pool["Name"] = "Lucifure"; // name change
dataPool.Pool["Unique"] = Guid.NewGuid(); // new field
clientGenericPool.Update(dataPool);
// Note: Updates, Merges etc keep the original objects in sync with the latest ETags.
// Even if an ETag is not specified for the type, if the type supports a Pool,
// the ETag is maintained and synched in the pool
//----------------------------------------------------------------------------------------------------------
// Read back the data
GenericPool
dataPoolRead = clientGenericPool.CreateQuery()
.Where(imp => imp.PrimaryKey == dataEmployee.Department &&
imp.SecondaryKey == dataEmployee.EmployeeId)
.FirstOrDefault();
//----------------------------------------------------------------------------------------------------------
// and verify that we got back what we put in
Assert.IsTrue(
dataPool.PrimaryKey == dataPoolRead.PrimaryKey &&
dataPool.SecondaryKey == dataPoolRead.SecondaryKey &&
StashHelper.DictionaryEquals(
dataPool.Pool,
dataPoolRead.Pool));
//----------------------------------------------------------------------------------------------------------
// Merge can be performed very efficiently with a StashPool. Only include the tables properties
// to be merge in the dictionary. No need to null out members or defined nullable value type members.
// Create a new pool with just the objects of interest
Dictionary <string, object>
pool = new Dictionary <string, object>();
// save the current etag (for now and later)
string
etagPreMerge = dataPoolRead.Pool[Literal.ETag].ToString();
pool["Name"] = "Stash"; // new value to merge
pool[Literal.ETag] = etagPreMerge; // get the ETag too
// create a new pool object for merging.
GenericPool
dataPoolMerged = new GenericPool {
PrimaryKey = dataPoolRead.PrimaryKey,
SecondaryKey = dataPoolRead.SecondaryKey,
Pool = pool
};
clientGenericPool.Merge(dataPoolMerged, ETagMatch.Must); // force ETag matching.
// read back and verify
GenericPool
dataPoolMergedRead = clientGenericPool.Get(
dataPoolMerged.PrimaryKey,
dataPoolMerged.SecondaryKey);
// validate
Assert.IsTrue(dataPoolMergedRead.Pool.Count == dataPoolRead.Pool.Count &&
dataPoolMergedRead.Pool["Name"] as String == "Stash");
//----------------------------------------------------------------------------------------------------------
// attempt to merge again, replacing the current ETag with the old one.
bool isSuccess;
try
{
// use the defunct etag to exhibit this
dataPoolMerged.Pool[Literal.ETag] = etagPreMerge;
clientGenericPool.Merge(dataPoolMerged);
isSuccess = false;
}
catch (Exception ex)
{
// Merge fails because the ETag was old and did not match.
Assert.IsTrue((ex as StashException).Error == StashError.ETagMatchFailed);
isSuccess = true;
}
Assert.IsTrue(isSuccess);
//----------------------------------------------------------------------------------------------------------
// attempt to merge yet again, this time by disabling ETag matching.
clientGenericPool.Merge(dataPoolMerged, ETagMatch.Unconditional);
//----------------------------------------------------------------------------------------------------------
// now attempt to delete the entity
try
{
clientGenericPool.Delete(dataPoolMergedRead); // Implicit ETag matching, will make this fail too
// because the last update changed the ETag
isSuccess = false;
}
catch (Exception ex)
{
Assert.IsTrue((ex as StashException).Error == StashError.ETagMatchFailed);
isSuccess = true;
}
Assert.IsTrue(isSuccess);
//----------------------------------------------------------------------------------------------------------
// Do an unconditional delete
clientGenericPool.DeleteUnconditional(dataPoolMergedRead);
//----------------------------------------------------------------------------------------------------------
// And verify that it was actually deleted
// by attempting to read back the data
var queryable = from emp in clientEmployee.CreateQuery()
where emp.Department == dataEmployee.Department &&
emp.EmployeeId == dataEmployee.EmployeeId
select emp;
Assert.IsTrue(queryable.ToList().Count == 0);
//----------------------------------------------------------------------------------------------------------
// So far so good. This concludes this part of the tutorial. Go Stash!
}
Tutorial_07_LargeData()
{
//----------------------------------------------------------------------------------------------------------
// Create Stash Client
StashClient <EmployeeResume>
client = StashConfiguration.GetClient <EmployeeResume>();
client.CreateTableIfNotExist();
//----------------------------------------------------------------------------------------------------------
// Lets create an instance of the class we what to 'stash'
const
string departmentDev = "Dev";
EmployeeResume
dataWritten = new EmployeeResume {
Department = departmentDev,
EmployeeId = Guid.NewGuid().ToString(),
// 1 char = 2 bytes so this random string is 2.5 time the size of a table property
Text = BuildString((int)(32 * 1024 * 2.5)),
// almost 2 time the size of a table property
Photograph = new byte[(int)(64 * 1024 * 1.9)],
};
// generate random bytes for the photograph
(new Random()).NextBytes(dataWritten.Photograph);
//----------------------------------------------------------------------------------------------------------
// Stash it
client.Insert(dataWritten);
//----------------------------------------------------------------------------------------------------------
// Read back the data
EmployeeResume
dataRead = client.Get(dataWritten.Department, dataWritten.EmployeeId);
//----------------------------------------------------------------------------------------------------------
// Verify we got back what we put in
Assert.IsTrue(dataWritten.Equals(dataRead));
//----------------------------------------------------------------------------------------------------------
// Verify exactly what was written to table storage by using the Generic Pool class we wrote
// earlier.
// set this up to target the correct table storage entity set
StashClient <GenericPool>
clientGenericPool = StashConfiguration.GetClient <GenericPool>(
new StashClientOptions {
OverrideEntitySetName = o => typeof(EmployeeResume).Name,
OverrideEntitySetNameIsDynamic = false,
Feedback = StashConfiguration.TraceFeedback,
});
GenericPool
dataPool = clientGenericPool.Get(
dataRead.Department,
dataRead.EmployeeId);
// All split items are suffixed with the index base A, in the format "_A".
// Because the "_" is used for demarcating collection indexes, explicit defined members are not allowed
// to have the embedded "_" character in the table property name.
// Test for Text
Assert.IsTrue(
dataPool.Pool.Where(
kv =>
kv.Key.IndexOf("Text_") == 0).ToList().Count == 3);
Assert.IsTrue(
dataPool.Pool.Where(
kv =>
kv.Key.IndexOf("Photograph_") == 0).ToList().Count == 2);
//----------------------------------------------------------------------------------------------------------
// now delete the entity
client.Delete(
departmentDev,
dataWritten.EmployeeId);
//----------------------------------------------------------------------------------------------------------
// And verify that it was actually deleted
// by attempting to read back the data
var queryable = from imp in client.CreateQuery()
where imp.Department == dataWritten.Department &&
imp.EmployeeId == dataWritten.EmployeeId
select imp;
Assert.IsTrue(queryable.ToList().Count == 0);
//----------------------------------------------------------------------------------------------------------
// So far so good. This concludes this part of the tutorial. Go Stash!
}
Tutorial_05_Morphing_EmployeeInfo()
{
//----------------------------------------------------------------------------------------------------------
// Create a Stash Client
StashClient <EmployeeInfo>
client = StashConfiguration.GetClient <EmployeeInfo>();
client.CreateTableIfNotExist();
//----------------------------------------------------------------------------------------------------------
// Create an instance of the class we what to Stash
const
string departmentDev = "Dev";
const
string ssn = "123456789";
EmployeeInfo
dataWritten = new EmployeeInfo {
Department = departmentDev,
EmployeeId = Guid.NewGuid().ToString(),
Name = "John Doe",
SkillLevel = 8,
DateOfBirth = new DateTime(1990, 1, 1),
SSN = ssn,
Salutation = Salutation.Dr
};
// update the private field
dataWritten.SetAnnualSalary();
//----------------------------------------------------------------------------------------------------------
// Stash it
client.Insert(dataWritten);
//----------------------------------------------------------------------------------------------------------
// Read back the data
EmployeeInfo
dataRead = client.Get(dataWritten.Department, dataWritten.EmployeeId);
//----------------------------------------------------------------------------------------------------------
// Verify we got back what we put in
Assert.IsTrue(dataWritten.Equals(dataRead));
//----------------------------------------------------------------------------------------------------------
// Now let us verify exactly what was written to table storage by using the Generic Pool class we wrote
// earlier.
// set this up to target the correct table storage entity set
StashClient <GenericPool>
clientGenericPool = StashConfiguration.GetClient <GenericPool>(
new StashClientOptions {
OverrideEntitySetName = o => "EmployeeInfo",
OverrideEntitySetNameIsDynamic = false,
Feedback = StashConfiguration.TraceFeedback,
});
GenericPool
dataPool = clientGenericPool.Get(
dataRead.Department,
dataRead.EmployeeId);
// validate that the SSN value got morphed in to a byte[]
Assert.IsTrue(dataPool.Pool["SSN"].GetType() == typeof(byte[]));
//----------------------------------------------------------------------------------------------------------
// Change the Skill level and update the Stash
dataWritten.SkillLevel += 1;
dataWritten.SetAnnualSalary();
// force an unconditional update since, dataWritten does not have a ETag.
// Optionally copy over the ETag from dataRead.
client.Update(dataWritten, ETagMatch.Unconditional);
//----------------------------------------------------------------------------------------------------------
// Read back the data but this time lets use LINQ
dataRead = client.CreateQuery()
.Where(imp => imp.Department == departmentDev &&
imp.EmployeeId == dataWritten.EmployeeId)
.FirstOrDefault();
//----------------------------------------------------------------------------------------------------------
// Again verify that we got back what we put in
Assert.IsTrue(dataWritten.Equals(dataRead));
//----------------------------------------------------------------------------------------------------------
// now delete the entity
client.Delete(
departmentDev,
dataWritten.EmployeeId);
//----------------------------------------------------------------------------------------------------------
// And verify that it was actually deleted
// by attempting to read back the data
var queryable = from imp in client.CreateQuery()
where imp.Department == dataWritten.Department &&
imp.EmployeeId == dataWritten.EmployeeId
select imp;
Assert.IsTrue(queryable.ToList().Count == 0);
//----------------------------------------------------------------------------------------------------------
// So far so good. This concludes this part of the tutorial. Go Stash!
}
Tutorial_02_Hybrid_TempHire()
{
//----------------------------------------------------------------------------------------------------------
// Create the Stash Client.
StashClient <TempHire>
client = StashConfiguration.GetClient <TempHire>();
//----------------------------------------------------------------------------------------------------------
// Create a table with the class name ('TempEmployee') or confirm that it exists
client.CreateTableIfNotExist();
//----------------------------------------------------------------------------------------------------------
// Create an instance of the class we what to Stash
TempHire
dataWritten = new TempHire {
PartitionKey = "B",
RowKey = Guid.NewGuid().ToString(),
Name = "Jill Doe",
Skill_Level = 5,
DateOfBirth = new DateTime(1990, 1, 1)
};
// update the private field
dataWritten.SetHourlyPay();
//----------------------------------------------------------------------------------------------------------
// Stash it
client.Insert(dataWritten);
//----------------------------------------------------------------------------------------------------------
// Read back the data
TempHire
dataRead = client.Get(dataWritten.PartitionKey, dataWritten.RowKey);
//----------------------------------------------------------------------------------------------------------
// Verify we got back what we put in
Assert.IsTrue(dataWritten.Equals(dataRead));
//----------------------------------------------------------------------------------------------------------
// Lets change the Skill level and update the Stash
dataWritten.Skill_Level += 1;
dataWritten.SetHourlyPay();
client.Update(dataWritten);
//----------------------------------------------------------------------------------------------------------
// Read back the data but this time lets use LINQ
dataRead = client.CreateQuery()
.Where(imp => imp.PartitionKey == dataWritten.PartitionKey &&
imp.RowKey == dataWritten.RowKey)
.FirstOrDefault();
//----------------------------------------------------------------------------------------------------------
// Again verify that we got back what we put in
Assert.IsTrue(dataWritten.Equals(dataRead));
//----------------------------------------------------------------------------------------------------------
// now delete the entity
client.Delete(
dataWritten.PartitionKey,
dataWritten.RowKey);
//----------------------------------------------------------------------------------------------------------
// And verify that it was actually deleted
// by attempting to read back the data
var queryable = from imp in client.CreateQuery()
where imp.PartitionKey == dataWritten.PartitionKey &&
imp.RowKey == dataWritten.RowKey
select imp;
Assert.IsTrue(queryable.ToList().Count == 0);
//----------------------------------------------------------------------------------------------------------
// So far so good. This concludes this part of the tutorial. Go Stash!
}