Drupal\tripal\TripalField\Interfaces\TripalFieldItemInterface Interface Reference

Inheritance diagram for Drupal\tripal\TripalField\Interfaces\TripalFieldItemInterface:

Collaboration diagram for Drupal\tripal\TripalField\Interfaces\TripalFieldItemInterface:

Public Member Functions
	tripalStorageId ()
	tripalValuesTemplate ($field_definition, $default_value=NULL)
	tripalLoad ($field_item, $field_name, $prop_types, $prop_values, $entity)
	tripalSave ($field_item, $field_name, $prop_types, $prop_values, $entity)
	tripalClear ($field_item, $field_name, $prop_types, $prop_values, $entity)

Static Public Member Functions
static	tripalTypes ($field_definition)

Member Function Documentation

tripalClear()

Drupal\tripal\TripalField\Interfaces\TripalFieldItemInterface::tripalClear	(		$field_item,
			$field_name,
			$prop_types,
			$prop_values,
			$entity
	)

Clears all field values from the given entity.

This is to prevent Drupal from storing field values when they are being stored in the Tripal field storage backend.

Parameters

\Drupal\tripal\TripalField\Interfaces\TripalFieldItemInterface	$field_item	The field item for which properties should be saved.
string	$field_name	The name of the field.
array	$prop_types	Array of \Drupal\tripal\TripalStorage\StoragePropertyType objects.
array	$prop_values	Array of \Drupal\tripal\TripalStorage\StoragePropertyValue objects.
\Drupal\tripal\TripalStorage\TripalEntityBase	$entity	The entity.

Implemented in Drupal\tripal\TripalField\TripalFieldItemBase.

tripalLoad()

Drupal\tripal\TripalField\Interfaces\TripalFieldItemInterface::tripalLoad	(		$field_item,
			$field_name,
			$prop_types,
			$prop_values,
			$entity
	)

Loads the values from the given array of properties to the given entity.

Parameters

\Drupal\tripal\TripalField\Interfaces\TripalFieldItemInterface	$field_item	The field item for which properties should be saved.
string	$field_name	The name of the field.
array	$prop_types	Array of \Drupal\tripal\TripalStorage\StoragePropertyType objects.
array	$prop_values	Array of \Drupal\tripal\TripalStorage\StoragePropertyValue objects.
\Drupal\tripal\TripalStorage\TripalEntityBase	$entity	The entity.

Implemented in Drupal\tripal\TripalField\TripalFieldItemBase.

tripalSave()

Drupal\tripal\TripalField\Interfaces\TripalFieldItemInterface::tripalSave	(		$field_item,
			$field_name,
			$prop_types,
			$prop_values,
			$entity
	)

Saves the values to the given array of properties from the given entity.

Parameters

\Drupal\tripal\TripalField\Interfaces\TripalFieldItemInterface	$field_item	The field item for which properties should be saved.
string	$field_name	The name of the field.
array	$prop_types	Array of \Drupal\tripal\TripalStorage\StoragePropertyType objects.
array	$prop_values	Array of \Drupal\tripal\TripalStorage\StoragePropertyValue objects.
\Drupal\tripal\TripalStorage\TripalEntityBase	$entity	The entity.

Implemented in Drupal\tripal\TripalField\TripalFieldItemBase.

tripalStorageId()

Drupal\tripal\TripalField\Interfaces\TripalFieldItemInterface::tripalStorageId

(

)

Returns the tripal storage plugin id for this field.

Returns

string The tripal storage plugin id.

Implemented in Drupal\tripal\TripalField\TripalFieldItemBase.

tripalTypes()

static Drupal\tripal\TripalField\Interfaces\TripalFieldItemInterface::tripalTypes (   $field_definition )

static

Returns the property types required by this field.

Parameters

object

$field_definition

The field configuration object. This can be an instance of: \Drupal\field\Entity\FieldStorageConfig or \Drupal\field\Entity\FieldConfig

Returns

array Array of \Drupal\tripal\TripalStorage\StoragePropertyTypeBase property types.

Implemented in Drupal\tripal_chado\Plugin\Field\FieldType\ChadoUnitTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoTextTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoSynonymTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoStudyTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoStringTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoStockTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoSourceDataTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoSequenceTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoSequenceLengthTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoSequenceChecksumTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoPubTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoProtocolTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoProjectTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoOrganismTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoLinkerPropertyTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoIntegerTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoFeatureTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoFeatureMapTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoDbxrefTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoContactTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoBooleanTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoBiomaterialTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoAssayTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoArrayDesignTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoAnalysisTypeDefault, Drupal\tripal_chado\Plugin\Field\FieldType\ChadoAdditionalTypeTypeDefault, Drupal\tripal\Plugin\Field\FieldType\TripalTextTypeItem, Drupal\tripal\Plugin\Field\FieldType\TripalStringTypeItem, Drupal\tripal\Plugin\Field\FieldType\TripalIntegerTypeItem, and Drupal\tripal\Plugin\Field\FieldType\TripalBooleanTypeItem.

tripalValuesTemplate()

Drupal\tripal\TripalField\Interfaces\TripalFieldItemInterface::tripalValuesTemplate	(		$field_definition,
			$default_value = NULL
	)

Returns an array of StoragePropertyValue objects.

This array seves as as "template" for loading, storing and finding fields in the underlying data store. Each fiels' property types will have a corresponding value in this array. If the $deafult_value is provided then the property whose key is returend by the mainPropertyName() function will get set.

Fields normally do not need to implement this function. However, if the $default_value argument is used and the default value is not the value stored in the underlying datastore (e.g., the value is a combination of all of the property values), then the implementing function can override this function to split the value and set the values for the other properties.

Parameters

object	$field_definition	The field configuration object. This can be an instance of: \Drupal\field\Entity\FieldStorageConfig or \Drupal\field\Entity\FieldConfig
	$default_value	Optional. If a value is provided then then the property whose key is returned by the mainPropertyName() function will get set to the value provided.

Returns

array Array of \Drupal\tripal\TripalStorage\StoragePropertyValue property value templates.

Implemented in Drupal\tripal\TripalField\TripalFieldItemBase.

---

The documentation for this interface was generated from the following file:

• tripal/src/TripalField/Interfaces/TripalFieldItemInterface.php