I am a little confused on how to go about using the RESTful server API in SilverStripe 3. I have just starting learning and the following has confused me.
All content on our site is stored in a database. Each class that is a child of the DataObject class will have its own table in our database.
Every object of such a class will correspond to a row in that table – this is our "data object", the "model" of Model-View-Controller. A page type has a data object that represents all the data for our page. Rather than inheriting directly from DataObject, it inherits from SiteTree. We generally create a "Page" data object, and subclass this for all other page types. This allows us to define behavior that is consistent across all pages in our site.
I have done this to set up pages but now I am learning about the RESTful server API and it says to create an object that extends DataObject.
Forgive my ignorance but would extending SiteTree not be the same thing?
Very confused so would appreciate some enlightenment.
As commented above, if you extend SiteTree, then you are extending DataObject, but getting a lot of overhead. Some of this overhead may be useful to you, as SiteTree provides Versioning, Hierarchies and other nice tricks which make it a good class for Pages in your site.
However, if you are wanting to manage a lot of objects, or if you aren’t using the Hierarchy or Versioning models, or if you just want to customize how the objects are presented or managed in the CMS, then it is better to extend DataObject directly. There are various tutorials on this on the SilverStripe documentation site, and on SSBits
This may also be useful to you.
Once you have your DataObject subclass working well for you, you can start to add the RestfulServer capabilities to it. The most basic way to do this is to add a static property to your class:
More information about using RestfulServer is available here