interface DiffGeneratorInterface in Entity Share 8.3

Builds a diff from field item list.

Hierarchy

• interface \Drupal\Component\Plugin\PluginInspectionInterface
  • interface \Drupal\entity_share_diff\DiffGenerator\DiffGeneratorInterface

File

modules/entity_share_diff/src/DiffGenerator/DiffGeneratorInterface.php, line 14

Namespace

Drupal\entity_share_diff\DiffGenerator

interface DiffGeneratorInterface extends PluginInspectionInterface {

  /**
   * Builds an array of strings.
   *
   * This method is responsible for transforming a FieldItemListInterface object
   * into an array of strings. The resulted array of strings is then compared by
   * the Diff component with another such array of strings and the result
   * represents the difference between two entity fields.
   *
   * Example of FieldItemListInterface built into an array of strings:
   * @code
   * array(
   *   0 => "This is an example string",
   *   1 => "Field values or properties",
   * )
   * @endcode
   *
   * @param \Drupal\Core\Field\FieldItemListInterface $field_items
   *   Represents an entity field.
   *
   * @return mixed
   *   An array of strings to be compared. If an empty array is returned it
   *   means that a field is either empty or no properties need to be compared
   *   for that field.
   *
   * @see \Drupal\entity_share_diff\Plugin\DiffGenerator\CoreFieldDiffParser
   */
  public function build(FieldItemListInterface $field_items);

  /**
   * Returns if the plugin can be used for the provided field.
   *
   * @param \Drupal\Core\Field\FieldStorageDefinitionInterface $field_definition
   *   The field definition that should be checked.
   *
   * @return bool
   *   TRUE if the plugin can be used, FALSE otherwise.
   */
  public static function isApplicable(FieldStorageDefinitionInterface $field_definition);

}

Members

Name	Modifiers	Type	Description	Overrides
DiffGeneratorInterface::build	public	function	Builds an array of strings.	8
DiffGeneratorInterface::isApplicable	public static	function	Returns if the plugin can be used for the provided field.	1
PluginInspectionInterface::getPluginDefinition	public	function	Gets the definition of the plugin implementation.	4
PluginInspectionInterface::getPluginId	public	function	Gets the plugin_id of the plugin instance.	2