I have the following code in my application:
using (var database = new Database()) {
var poll = // Some database query code.
foreach (Question question
All others already wrote what the correct design of your Database
class should be, so I won't repeat that. However, I didn't see any explanation why what you want to is not possible. So here it goes.
What you want to do is detect, during the call to Dispose
, that this method is called in the context of an exception. When you would be able to do this, developers won't have to call Commit
explicitly. However, the problem here is that there is no way to reliable detect this in .NET. While there are mechanisms to query the last thrown error (like HttpServerUtility.GetLastError), these mechanisms are host specific (so ASP.NET has an other mechanism as a windows forms for instance). And while you could write an implementation for a specific host implementation, for instance an implementation that would only work under ASP.NET, there is another more important problem: what if your Database
class is used, or created within the context of an exception? Here is an example:
try
{
// do something that might fail
}
catch (Exception ex)
{
using (var database = new Database())
{
// Log the exception to the database
database.Add(ex);
}
}
When your Database
class is used in the context of an Exception
, as in the example above, how is your Dispose
method supposed to know that it still must commit? I can think of ways to go around this, but it will quite fragile and error prone. To give an example.
During creation of the Database
, you could check whether it is called in the context of an exception, and if that’s the case, store that exception. During the time Dispose
is called, you check whether the last thrown exception differs from the cached exception. If it differs, you should rollback. If not, commit.
While this seems a nice solution, what about this code example?
var logger = new Database();
try
{
// do something that might fail
}
catch (Exception ex)
{
logger.Add(ex);
logger.Dispose();
}
In the example you see that a Database
instance is created before the try block. Therefore is can not correctly detect that it sould not roll back. While this might be a contrived example, it shows the difficulties you will face when trying to design your class in a way no explicit call to Commit
is needed.
In the end you will be making your Database
class hard to design, hard to maintain, and you'll never really get it right.
As all others already said, a design that needs an explicit Commit
or Complete
call, would be easier to implement, easier to get right, easier to maintain, and gives usage code that is more readable (for instance, because it looks what developers expect).
Last note, if you're worried about developers forgetting to call this Commit
method: you can do some checking in the Dispose
method to see whether it is called without Commit
is called and write to the console or set a breakpoint while debugging. Coding such a solution would still be much easier than trying to get rid of the Commit
at all.
Update:
Adrian wrote an intersting alternative to using HttpServerUtility.GetLastError. As Adrian notes, you can use Marshal.GetExceptionPointers()
which is a generic way that would work on most hosts. Please note that this solution has the same drawbacks explained above and that calling the Marshal
class is only possible in full trust
Sound like you need TransactionScope
http://msdn.microsoft.com/en-us/library/system.transactions.transactionscope.aspx
As others have said, your use of the Disposable pattern for this purpose is what is causing you the problems. If the pattern is working against you, then I would change the pattern. By making a commit the default behaviour of the using block, you are assuming that every use of a database results in a commit, which clearly is not the case - especially if an error occurs. An explicit commit, possibly combined with a try/catch block would work better.
However, if you really want to keep your use of the pattern as is, you can use:
bool isInException = Marshal.GetExceptionPointers() != IntPtr.Zero
|| Marshal.GetExceptionCode() != 0;
in your Displose implementation to determine if an exception has been thrown (more details here).
You could inherit from the Database class and then override the Dispose() method (making sure to close the db resources), this could then raise a custom event to which you can subscribe in your code.
You should wrap the contents of your using block in a try/catch and roll back the transaction in the catch block:
using (var database = new Database()) try
{
var poll = // Some database query code.
foreach (Question question in poll.Questions) {
foreach (Answer answer in question.Answers) {
database.Remove(answer);
}
// This is a sample line that simulate an error.
throw new Exception("deu pau");
database.Remove(question);
}
database.Remove(poll);
}
catch( /*...Expected exception type here */ )
{
database.Rollback();
}
Look at the design for TransactionScope in System.Transactions. Their method requires you to call Complete() on the transaction scope to commit the transaction. I would consider designing your Database class to follow the same pattern:
using (var db = new Database())
{
... // Do some work
db.Commit();
}
You might want to introduce the concept of transactions outside of your Database object though. What happens if consumers want to use your class and do not want to use transactions and have everything auto commit?