Custom Hooks in TierDeveloper

 by: Ann Morris

Custom Hooks is another powerful and most demanding feature provided by TierDeveloper. Custom Hooks work like database triggers. It could be your own business logic that you can activate before or after performing some database action(s). PreHooks and PostHooks are two ways, provided by TierDeveloper, through which you can embed your own logic in the generated code. Pre hook methods are called before the database access is performed whereas post hook methods are called after the database operations are performed.

Custom hooks can be specified wherever database access is performed. It includes standard operations, query methods, bulk operations and custom operations. User can generate skeleton code for custom hooks of the selected methods or he/she can use his/her own hooks class.

For your convenience and better understanding I have listed sample code here which shows how TierDeveloper embed custom hooks in the generated code. It is pretty self-explanatory.

public void UpdateCustomerInfo(Customers objInfo)
{
try
{
.................
.................

CustomersHooks hooks  new CustomersHooks();
status  hooks.PreUpdateCustomerInfo((System.Data.SqlClient.SqlConnection)getConnection(), objInfo);

if (status ! CustomersHooks.SUCCESSCONTINUE)
{
SetStatus(status  CustomersHooks.FAILNONCONTINUE ? EStatus.eFail : EStatus.eSuccess);
ReleaseCommand();
return;
}

AddCmdParameter("@CompanyName", TDevFramework.EDataType.eVarchar, objInfo.CompanyName, TDevFramework.EParamDirection.eInput, objInfo.IsNull("CompanyName"));
.................
.................
.................

ExecuteNonQuery();

status  hooks.PostUpdateCustomerInfo((System.Data.SqlClient.SqlConnection)getConnection(), objInfo);

if (status ! CustomersHooks.SUCCESSCONTINUE)
{
.................
.................
return;
}

SetStatus(EStatus.eSuccess);
ReleaseCommand();
}
catch (Exception e)
{
.................
.................
throw e;
}
}

public class CustomersHooks
{
public const int SUCCESSCONTINUE  0;
public const int SUCCESSNONCONTINUE  1;
public const int FAILNONCONTINUE  2;

public int PreUpdateCustomerInfo( System.Data.SqlClient.SqlConnection Conn, Customers objInfo)
{
//........... 
//......... Put your own code here
return SUCCESSCONTINUE;
}

public int PostUpdateCustomerInfo( System.Data.SqlClient.SqlConnection Conn, Customers objInfo)
{
 //............... 
 // .... .... put your own code here.
return SUCCESSCONTINUE;
}
}