...
Ví dụ Interface: Magento\Catalog\Api\ProductRepositoryInterface
| Code Block | ||
|---|---|---|
| ||
public function delete(\Magento\Catalog\Api\Data\ProductInterface $product); |
Ví dụ Model implements Interface: Magento\Catalog\Model\ProductRepository
| Code Block | ||
|---|---|---|
| ||
public function delete(\Magento\Catalog\Api\Data\ProductInterface $product)
{
$sku = $product->getSku();
$productId = $product->getId();
try {
unset($this->instances[$product->getSku()]);
unset($this->instancesById[$product->getId()]);
$this->resourceModel->delete($product);
} catch (ValidatorException $e) {
throw new CouldNotSaveException(__($e->getMessage()));
} catch (\Exception $e) {
throw new \Magento\Framework\Exception\StateException(
__('Unable to remove product %1', $sku)
);
}
unset($this->instances[$sku]);
unset($this->instancesById[$productId]);
return true;
}
|
Việc model nào ứng với interface nào được cấu hình trong file etc/di.xml của magento 2.
| Code Block | ||
|---|---|---|
| ||
<preference for="Magento\Catalog\Api\ProductRepositoryInterface" type="Magento\Catalog\Model\ProductRepository" /> |
...
Khi bạn truyền các tiêu chí tìm kiếm và gọi hàm getList (), một search results interface được trả về với kết quả tìm kiếm. Trong một search results interface thường chứa hàm getItems trả về một mảng các data entites (thực thể dữ liệu). Ví dụ, Hàm getItems () trong CustomerSearchResultsInterface trả về một mảng của các thực thể dữ liệu CustomerInterface. GroupSearchResultsInterface, hàm getItems () trả về một mảng các thực thể dữ liệu GroupInterface.
| Code Block | ||
|---|---|---|
| ||
/**
* Copyright © 2016 Magento. All rights reserved.
* See COPYING.txt for license details.
*/
namespace Magento\Customer\Api\Data;
/**
* Interface for customer search results.
* @api
*/
interface CustomerSearchResultsInterface extends \Magento\Framework\Api\SearchResultsInterface
{
/**
* Get customers list.
*
* @return \Magento\Customer\Api\Data\CustomerInterface[]
*/
public function getItems();
/**
* Set customers list.
*
* @param \Magento\Customer\Api\Data\CustomerInterface[] $items
* @return $this
*/
public function setItems(array $items);
}
|
...
Sau đây là một ví dụ về CustomerRepositoryInterface:
| Code Block | ||
|---|---|---|
| ||
<?php
/**
*
* Copyright © 2016 Magento. All rights reserved.
* See COPYING.txt for license details.
*/
namespace Magento\Customer\Api;
/**
* Customer CRUD interface.
* @api
*/
interface CustomerRepositoryInterface
{
/**
* Create or update a customer.
*
* @param \Magento\Customer\Api\Data\CustomerInterface $customer
* @param string $passwordHash
* @return \Magento\Customer\Api\Data\CustomerInterface
* @throws \Magento\Framework\Exception\InputException If bad input is provided
* @throws \Magento\Framework\Exception\State\InputMismatchException If the provided email is already used
* @throws \Magento\Framework\Exception\LocalizedException
*/
public function save(\Magento\Customer\Api\Data\CustomerInterface $customer, $passwordHash = null);
/**
* Retrieve customer.
*
* @param string $email
* @param int|null $websiteId
* @return \Magento\Customer\Api\Data\CustomerInterface
* @throws \Magento\Framework\Exception\NoSuchEntityException If customer with the specified email does not exist.
* @throws \Magento\Framework\Exception\LocalizedException
*/
public function get($email, $websiteId = null);
/**
* Get customer by customer ID.
*
* @param int $customerId
* @return \Magento\Customer\Api\Data\CustomerInterface
* @throws \Magento\Framework\Exception\NoSuchEntityException If customer with the specified ID does not exist.
* @throws \Magento\Framework\Exception\LocalizedException
*/
public function getById($customerId);
/**
* Retrieve customers which match a specified criteria.
*
* This call returns an array of objects, but detailed information about each object’s attributes might not be
* included. See http://devdocs.magento.com/codelinks/attributes.html#CustomerRepositoryInterface to determine
* which call to use to get detailed information about all attributes for an object.
*
* @param \Magento\Framework\Api\SearchCriteriaInterface $searchCriteria
* @return \Magento\Customer\Api\Data\CustomerSearchResultsInterface
* @throws \Magento\Framework\Exception\LocalizedException
*/
public function getList(\Magento\Framework\Api\SearchCriteriaInterface $searchCriteria);
/**
* Delete customer.
*
* @param \Magento\Customer\Api\Data\CustomerInterface $customer
* @return bool true on success
* @throws \Magento\Framework\Exception\LocalizedException
*/
public function delete(\Magento\Customer\Api\Data\CustomerInterface $customer);
/**
* Delete customer by ID.
*
* @param int $customerId
* @return bool true on success
* @throws \Magento\Framework\Exception\NoSuchEntityException
* @throws \Magento\Framework\Exception\LocalizedException
*/
public function deleteById($customerId);
}
|
...
Sau đây là ví dụ về CustomerMetadataInterface:
| Code Block | ||
|---|---|---|
| ||
<?php
/**
* Copyright © 2016 Magento. All rights reserved.
* See COPYING.txt for license details.
*/
namespace Magento\Customer\Api;
/**
* Interface for retrieval information about customer attributes metadata.
* @api
*/
interface CustomerMetadataInterface extends MetadataInterface
{
const ATTRIBUTE_SET_ID_CUSTOMER = 1;
const ENTITY_TYPE_CUSTOMER = 'customer';
const DATA_INTERFACE_NAME = 'Magento\Customer\Api\Data\CustomerInterface';
}
|
...
resource: dùng để xác thực, anonymous là bỏ qua xác thực
Ví dụ:
| Code Block | ||
|---|---|---|
| ||
<?xml version="1.0"?>
<!--
/**
* Copyright © 2016 Magento. All rights reserved.
* See COPYING.txt for license details.
*/
-->
<routes xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Webapi:etc/webapi.xsd">
<!-- Managing shipping guest information -->
<route url="/V1/guest-carts/:cartId/shipping-information" method="POST">
<service class="Magento\Checkout\Api\GuestShippingInformationManagementInterface" method="saveAddressInformation"/>
<resources>
<resource ref="anonymous" />
</resources>
</route>
</routes>
|
...