1. interface
  2. Drupal
  3. \
  4. Core
  5. \
  6. TypedData
  7. \
  8. TraversableTypedDataInterface

TraversableTypedDataInterface

interface TraversableTypedDataInterface implements TypedDataInterface, Traversable (View source)

An interface for typed data objects that can be traversed.

Methods

static 
createInstance(DataDefinitionInterface $definition, string|null $name = NULL, TraversableTypedDataInterface $parent = NULL)

Constructs a TypedData object given its definition and context.

from  TypedDataInterface
DataDefinitionInterface
getDataDefinition()

Gets the data definition.

from  TypedDataInterface
mixed
getValue()

Gets the data value.

from  TypedDataInterface
setValue(mixed|null $value, bool $notify = TRUE)

Sets the data value.

from  TypedDataInterface
string
getString()

Returns a string representation of the data.

from  TypedDataInterface
array
getConstraints()

Gets a list of validation constraints.

from  TypedDataInterface
ConstraintViolationListInterface
validate()

Validates the currently set data value.

from  TypedDataInterface
$this
applyDefaultValue(bool $notify = TRUE)

Applies the default value.

from  TypedDataInterface
string|int|null
getName()

Returns the name of a property or item.

from  TypedDataInterface
TraversableTypedDataInterface|null
getParent()

Returns the parent data structure; i.e. either complex data or a list.

from  TypedDataInterface
TraversableTypedDataInterface
getRoot()

Returns the root of the typed data tree.

from  TypedDataInterface
string
getPropertyPath()

Returns the property path of the data.

from  TypedDataInterface
setContext(string|null $name = NULL, TraversableTypedDataInterface $parent = NULL)

Sets the context of a property or item via a context aware parent.

from  TypedDataInterface
onChange($name)

React to changes to a child property or item.

Details

in TypedDataInterface at line 32
static createInstance(DataDefinitionInterface $definition, string|null $name = NULL, TraversableTypedDataInterface $parent = NULL)

Constructs a TypedData object given its definition and context.

When \Drupal\Core\Config\TypedConfigManager has been fixed to use class-based definitions, type-hint $definition to DataDefinitionInterface. https://www.drupal.org/node/1928868

Parameters

DataDefinitionInterface $definition

The data definition.
string|null $name

(optional) The name of the created property, or NULL if it is the root of a typed data tree. Defaults to NULL.
TraversableTypedDataInterface $parent

(optional) The parent object of the data property, or NULL if it is the root of a typed data tree. Defaults to NULL.

See also

TypedDataManager::create

in TypedDataInterface at line 40
DataDefinitionInterface getDataDefinition()

Gets the data definition.

Return Value

DataDefinitionInterface

The data definition object.

in TypedDataInterface at line 48
mixed getValue()

Gets the data value.

Return Value

mixed

The data value.

in TypedDataInterface at line 66
setValue(mixed|null $value, bool $notify = TRUE)

Sets the data value.

Parameters

mixed|null $value

The value to set in the format as documented for the data type or NULL to unset the data value.
bool $notify

(optional) Whether to notify the parent object of the change. Defaults to TRUE. If a property is updated from a parent object, set it to FALSE to avoid being notified again.

Exceptions

InvalidArgumentException
ReadOnlyException

in TypedDataInterface at line 74
string getString()

Returns a string representation of the data.

Return Value

string

The string representation of the data.

in TypedDataInterface at line 83
array getConstraints()

Gets a list of validation constraints.

Return Value

array

Array of constraints, each being an instance of \Symfony\Component\Validator\Constraint.

in TypedDataInterface at line 92
ConstraintViolationListInterface validate()

Validates the currently set data value.

Return Value

ConstraintViolationListInterface

A list of constraint violations. If the list is empty, validation succeeded.

in TypedDataInterface at line 105
$this applyDefaultValue(bool $notify = TRUE)

Applies the default value.

Parameters

bool $notify

(optional) Whether to notify the parent object of the change. Defaults to TRUE. If a property is updated from a parent object, set it to FALSE to avoid being notified again.

Return Value

$this

Returns itself to allow for chaining.

in TypedDataInterface at line 115
string|int|null getName()

Returns the name of a property or item.

Return Value

string|int|null

If the data is a property of some complex data, the name of the property. If the data is an item of a list, the name is the numeric position of the item in the list, starting with 0. Otherwise, NULL is returned.

in TypedDataInterface at line 124
TraversableTypedDataInterface|null getParent()

Returns the parent data structure; i.e. either complex data or a list.

Return Value

TraversableTypedDataInterface|null

The parent data structure, either complex data or a list; or NULL if this is the root of the typed data tree.

in TypedDataInterface at line 135
TraversableTypedDataInterface getRoot()

Returns the root of the typed data tree.

Returns the root data for a tree of typed data objects; e.g. for an entity field item the root of the tree is its parent entity object.

Return Value

TraversableTypedDataInterface

The root data structure, either complex data or a list.

in TypedDataInterface at line 147
string getPropertyPath()

Returns the property path of the data.

The trail of property names relative to the root of the typed data tree, separated by dots; e.g. 'field_text.0.format'.

Return Value

string

The property path relative to the root of the typed tree, or an empty string if this is the root.

in TypedDataInterface at line 161
setContext(string|null $name = NULL, TraversableTypedDataInterface $parent = NULL)

Sets the context of a property or item via a context aware parent.

This method is supposed to be called by the factory only.

Parameters

string|null $name

(optional) The name of the property or the delta of the list item, or NULL if it is the root of a typed data tree. Defaults to NULL.
TraversableTypedDataInterface $parent

(optional) The parent object of the data property, or NULL if it is the root of a typed data tree. Defaults to NULL.

at line 18
onChange($name)

React to changes to a child property or item.

Note that this is invoked after any changes have been applied.

Parameters

$name

The name of the property or the delta of the list item which is changed.