Hydrators are responsible for moving data into (hydration) and out of (extraction) an object. For their use in this library, hydrators are used for extraction only, and not hydration.
This library works around a Hydrator Manager that has a configuration of hydrators mapped to the classes they hydrate. The hydrators are individually composed classes thereby allowing any markup you desire, but the recommendation is to stick to the HAL specification.
The hydrator manager is used to extract a class using a mapped hydrator.
It is possible to have two fully separate hydrator managers.
As you extract data from classes using a hydrator you will be creating HAL Resources. The Resource object is the common object used to compose a HAL response. Resource objects hold the object data (the state), links, and embedded data which can also be a Resource. Collections of resources can create an array as a response, such as a paginated collection.
When you’re ready to turn a resource into HAL JSON you will have a tree of resources.
Because it is possible to have multiple hydrator managers, an instance of the hydrator manager is assigned to each hydrator and resource. For this reason it is necessary that classes involved in HAL in Laravel extend from abstract classes.
This is documentation for Hypertext Application Language for Laravel. If you find this useful please add your ★ star to the project.