Contratos de servicio de Magento
Esencialmente, los contratos de servicio son solo un conjunto de interfaces y clases que protegen la integridad de los datos y ocultan la lógica empresarial. La razón por la cual los clientes querrán usar esto es que el contrato permite que el servicio evolucione sin afectar a sus usuarios.
La razón por la cual esta actualización es importante es porque cambia la forma en que los usuarios interactúan con diferentes módulos. En Magento 1, no había buenas formas de interactuar con otros módulos. Con los contratos de servicio en Magento 2, puede acceder y manipular datos fácilmente, sin tener que preocuparse por la estructura del sistema.
Arquitectura de contrato de servicio
La capa de servicio tiene dos tipos de interfaz diferentes: interfaces de datos e interfaces de servicio. Las interfaces de datos son objetos que preservan la integridad de los datos mediante el uso de los siguientes patrones:
They’re read-only, since they only define constants and getters.
Getter functions can contain no parameters.
A getter function can only return a simple object type (string, integer, Boolean), a simple type array, and another data interface.
Mixed types can’t be returned by getter functions.
Data entity builders are the only way to populate and modify data interfaces.
Las interfaces de servicio proporcionan un conjunto de métodos públicos que un cliente puede usar. Hay tres subtipos de interfaces de servicio:
Repository Interfaces
Management Interfaces
Metadata Interfaces
Interfaces de repositorio
Las interfaces de repositorio aseguran que un usuario pueda acceder a entidades de datos persistentes. Por ejemplo, las entidades de datos persistentes dentro del Módulo del cliente son Consumidor, Dirección y Grupo. Esto nos da tres interfaces diferentes:
CustomerRepositoryInterface
AddressRepositoryInterface
GroupRepositoryInterface
Los métodos que tienen estas interfaces son:
Save – If there’s no ID, creates a new record, and updates what’s existing if there is one.
Get – Looks for the IDs in the database and returns a certain data entity interface.
GetList – Finds all data entities that correspond with the search criteria, then gives access to the matches by returning the search result interface.
Delete – Deletes the selected entity
DeleteById – Deletes the entity when you only have its key.
Interfaces de gestión
Estas interfaces contienen diferentes funciones de administración que no están relacionadas con los repositorios. Aquí hay unos ejemplos:
AccountManagementInterface contains functions such as createAccount(), isEmailAvailable(), changePassword(), and activate().
AddressManagementInterface checks whether an address is valid by using the validate() function.
El número de patrones crece constantemente y, a medida que lo hace, es probable que se les agreguen algunas de estas funciones.
Interfaces de metadatos
Las interfaces de metadatos proporcionan información sobre todos los atributos definidos para una entidad específica. Esto también incluye atributos personalizados, a los que puede acceder con la función getCustomAttribute ($ name). Estos atributos personalizados incluyen:
EAV attributes – Defined via the administration interface for a local site. They can differ according to the site, which means that they can’t be represented in the data entity interface written in PHP.
Extension attributes, for which the extension modules are used.
Referencia:
https://www.interactivated.me/uk/blog/service-contracts-magento-2/