Subsonic 3.0 General Questions

Question

Ok,

I was eagerly awaiting the release of subsonic 3.0 to use as my low-level data layer, and now its out. I'm currently using the ActiveRecord templates (having tried both the repository and advanced templates) and I have one HUGE request and a few questions:

Request: Other than bug fixes, Rob please spend the time to provide documentation. I don't mean 5 examples, I mean API complete documentation. Here's why:

I'm testing subsonic by writing ASP.NET MembershipProvider and RoleProvider classes and simple questions continually slow me up using subsonic:

Q. Assuming I have a class 'User' and I update/save/delete a record using

user.Save();

I need information on how to get success/failure? Do I look for an exception on failure or can I get a count of 'affected' records (old school?)

Q. If I get an exception, which exception(s) can I expect?

I'll have more issues, but I really believe a good functional API documentation would solve the problem.

If the answer is 'read the source code', then I'm sure you're going to chase quite a few developers away from subsonic. I really want to use the library, but the point is "use" the library, not reverse engineer it.

-Jeff

Answer 1

Q. I need information on how to get success/failure? Do I look for an exception on failure or can I get a count of 'affected' records (old school?)

If it doesn't throw an exception then it's worked

Q. If I get an exception, which exception(s) can I expect?

You can expect a DbException

Answer 2

We don't use custom exceptions. I spent 5 weeks writing docs - so yah I did spend some time on this. You could also find your answer there as well: http://subsonicproject.com/docs

Answer 3

3.0 is a little too buggy for me so far. I think I am going back to 2.x for now, thanks for all the hard work though.