Class WebComponentBinding<C extends Component>
java.lang.Object
com.vaadin.flow.server.webcomponent.WebComponentBinding<C>
- Type Parameters:
C
- type of the exported component
- All Implemented Interfaces:
Serializable
Represents a single instance of a exported web component instance embedded
onto a host page. Contains a unique
Component
instance and property
value hosts tied to the specific web component instance. Facilitates property
updates from the client to the component
.- Since:
- 2.0
- Author:
- Vaadin Ltd.
- See Also:
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
bindProperty
(PropertyConfigurationImpl<C, ? extends Serializable> propertyConfiguration, boolean overrideDefault, elemental.json.JsonValue startingValue) Adds a property tothis
web component binding based on thepropertyConfiguration
.Retrieves the boundComponent
instance.Class<? extends Serializable>
getPropertyType
(String propertyName) Retrieve the type of a property's value.boolean
hasProperty
(String propertyName) Does the component binding have a property identified by given name.void
Calls the bound change handlers defined viaPropertyConfiguration.onChange(SerializableBiConsumer)
for each bound property with the current value of the property.void
updateProperty
(String propertyName, elemental.json.JsonValue jsonValue) Updates a property bound to thecomponent
.void
updateProperty
(String propertyName, Serializable value) Updates a property bound to thecomponent
.
-
Constructor Details
-
WebComponentBinding
Constructs a newWebComponentBinding
. The boundComponent
is given viacomponent
parameter. The web component properties are bound by callingbindProperty(PropertyConfigurationImpl, boolean, elemental.json.JsonValue)
;- Parameters:
component
- component which exposesproperties
as web component. Notnull
- Throws:
NullPointerException
- ifcomponent
isnull
-
-
Method Details
-
updateProperty
Updates a property bound to thecomponent
. If the property has an attached listener, thevalue
is also delivered to the listener. If thevalue
isnull
, the property is set to its default value (which could benull
).- Parameters:
propertyName
- name of the property, notnull
value
- new value to set for the property- Throws:
NullPointerException
- ifpropertyName
isnull
IllegalArgumentException
- if no bound property can be found forpropertyName
-
updateProperty
Updates a property bound to thecomponent
. Converts thejsonValue
into the correct type if able and then callsupdateProperty(String, java.io.Serializable)
.- Parameters:
propertyName
- name of the property, notnull
jsonValue
- new value to set for the property- Throws:
NullPointerException
- ifpropertyName
isnull
IllegalArgumentException
- if no bound property can be found forpropertyName
IllegalArgumentException
- if thejsonValue
cannot be converted to the type of the property identified bypropertyName
.
-
getComponent
Retrieves the boundComponent
instance.- Returns:
component
instance
-
getPropertyType
Retrieve the type of a property's value.- Parameters:
propertyName
- name of the property- Returns:
- property type
-
hasProperty
Does the component binding have a property identified by given name.- Parameters:
propertyName
- name of the property- Returns:
- has property
-
updatePropertiesToComponent
public void updatePropertiesToComponent()Calls the bound change handlers defined viaPropertyConfiguration.onChange(SerializableBiConsumer)
for each bound property with the current value of the property. -
bindProperty
public void bindProperty(PropertyConfigurationImpl<C, ? extends Serializable> propertyConfiguration, boolean overrideDefault, elemental.json.JsonValue startingValue) Adds a property tothis
web component binding based on thepropertyConfiguration
. If a property with an existing name is bound, the previous binding is removed.- Parameters:
propertyConfiguration
- property configuration, notnull
overrideDefault
- set totrue
if the property should be initialized withstartingValue
instead of default value found inPropertyData
startingValue
- starting value for the property. Can benull
.overrideDefault
must betrue
for this value to have any effect- Throws:
NullPointerException
- ifpropertyConfiguration
isnull
-