Package io.jmix.mapsflowui.component.model.layer

Class VectorLayer

java.lang.Object

io.jmix.mapsflowui.kit.component.model.MapObservableObject

io.jmix.mapsflowui.kit.component.model.layer.Layer<S>

io.jmix.mapsflowui.kit.component.model.layer.BaseVectorLayer<AbstractVectorSource>

io.jmix.mapsflowui.component.model.layer.VectorLayer

All Implemented Interfaces:

BaseVectorLayer.HasBackground, BaseVectorLayer.HasBaseVectorLayerOptions, BaseVectorLayer.HasDeclutter, BaseVectorLayer.HasRenderBuffer, BaseVectorLayer.HasUpdateWhileAnimating, BaseVectorLayer.HasUpdateWhileInteracting, HasStyles, HasBaseLayerOptions, Serializable, org.springframework.beans.factory.Aware, org.springframework.context.ApplicationContextAware

public class VectorLayer
extends BaseVectorLayer<AbstractVectorSource>
implements org.springframework.context.ApplicationContextAware, BaseVectorLayer.HasBaseVectorLayerOptions, HasStyles

Layer for rendering vector data (e.g. geometries).

For more details see: VectorLayer docs

See Also:

• VectorSource
• DataVectorSource
• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class io.jmix.mapsflowui.kit.component.model.layer.BaseVectorLayer

BaseVectorLayer.HasBackground, BaseVectorLayer.HasBaseVectorLayerOptions, BaseVectorLayer.HasDeclutter, BaseVectorLayer.HasRenderBuffer, BaseVectorLayer.HasUpdateWhileAnimating, BaseVectorLayer.HasUpdateWhileInteracting

Nested classes/interfaces inherited from class io.jmix.mapsflowui.kit.component.model.MapObservableObject

MapObservableObject.ObjectChangeEvent

Field Summary

Fields

Modifier and Type	Field	Description
protected org.springframework.context.ApplicationContext	applicationContext

Fields inherited from class io.jmix.mapsflowui.kit.component.model.layer.BaseVectorLayer

styles

Fields inherited from class io.jmix.mapsflowui.kit.component.model.layer.Layer

id, options, source

Fields inherited from class io.jmix.mapsflowui.kit.component.model.MapObservableObject

children, dirty, eventBus, listener, metaProperties, parent, removedChildren, syncId

Constructor Summary

Constructors

Constructor	Description
VectorLayer()

Method Summary

Modifier and Type	Method	Description
void	addStyles(Style... styles)	Adds styles that should be merged with default.
protected VectorLayerOptions	createOptions()
String	getBackground()
Boolean	getDeclutter()
Double	getRenderBuffer()
<S extends AbstractVectorSource> S	getSource()
List<Style>	getStyles()
protected String	getType()
Boolean	getUpdateWhileAnimating()
Boolean	getUpdateWhileInteracting()
void	removeAllStyles()	Clears list of styles.
void	removeStyles(Style... styles)	Removes provided styles from layer.
void	setApplicationContext(org.springframework.context.ApplicationContext applicationContext)
void	setBackground(String color)	Sets the background color for the layer.
void	setDeclutter(Boolean declutter)	Sets whether declutter images and texts.
void	setRenderBuffer(Double renderBuffer)	Sets the buffer in pixels around the viewport extent used by the renderer when getting features from the vector source for the rendering or hit-detection.
void	setSource(AbstractVectorSource source)	Sets source to the layer.
void	setUpdateWhileAnimating(Boolean updateWhileAnimating)	Sets whether feature batches will be recreated during animations.
void	setUpdateWhileInteracting(Boolean updateWhileInteracting)	Sets whether feature batches will be recreated during interactions.
VectorLayer	withBackground(String color)	See setBackground(String).
VectorLayer	withClassName(String className)	See Layer.setClassName(String).
VectorLayer	withDeclutter(Boolean declutter)	See setDeclutter(Boolean).
VectorLayer	withExtent(Extent extent)	See Layer.setExtent(Extent).
VectorLayer	withId(String id)	See Layer.setId(String).
VectorLayer	withMaxZoom(Double maxZoom)	See Layer.setMaxZoom(Double).
VectorLayer	withMinZoom(Double minZoom)	See Layer.setMinZoom(Double).
VectorLayer	withOpacity(Double opacity)	See Layer.setOpacity(Double).
VectorLayer	withRenderBuffer(Double renderBuffer)	See setRenderBuffer(Double).
VectorLayer	withSource(AbstractVectorSource source)	See Layer.setSource(Source).
VectorLayer	withStyles(Style... styles)	See addStyles(Style...).
VectorLayer	withUpdateWhileAnimating(Boolean updateWhileAnimating)	See setUpdateWhileAnimating(Boolean).
VectorLayer	withUpdateWhileInteracting(Boolean updateWhileInteracting)	See setUpdateWhileInteracting(Boolean).
VectorLayer	withVisible(Boolean visible)	See Layer.setVisible(Boolean).
VectorLayer	withZIndex(Integer zIndex)	See Layer.setZIndex(Integer).

Methods inherited from class io.jmix.mapsflowui.kit.component.model.layer.BaseVectorLayer

getOptions

Methods inherited from class io.jmix.mapsflowui.kit.component.model.layer.Layer

getClassName, getExtent, getId, getMaxZoom, getMinZoom, getOpacity, getVisible, getZIndex, setClassName, setExtent, setId, setMaxZoom, setMinZoom, setOpacity, setVisible, setZIndex

Methods inherited from class io.jmix.mapsflowui.kit.component.model.MapObservableObject

addChild, addListener, clearRemovedChildren, clearRemovedChildrenInDepth, equals, fireChangeEvent, getChildren, getEventBus, getMetaProperties, getRemovedChildren, getSyncId, hashCode, isDirty, isDirtyInDepth, markAsDirty, markAsDirtyInDepth, removeChild, setMapObjectChangeListener, setMetaProperty, setParent, unmarkDirtyInDepth

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Details

applicationContext

protected org.springframework.context.ApplicationContext applicationContext

Constructor Details

VectorLayer

public VectorLayer()

Method Details

createOptions

protected VectorLayerOptions createOptions()

Specified by:

createOptions in class Layer<AbstractVectorSource>

getType

protected String getType()

Specified by:

getType in class MapObservableObject

setApplicationContext

public void setApplicationContext(org.springframework.context.ApplicationContext applicationContext)

Specified by:

setApplicationContext in interface org.springframework.context.ApplicationContextAware

withId

public VectorLayer withId(String id)

Description copied from class: Layer

See Layer.setId(String).

Overrides:

withId in class Layer<AbstractVectorSource>

Parameters:

id - id to set or null to unset value

Returns:

current instance

getSource

public <S extends AbstractVectorSource> S getSource()

Specified by:

getSource in class Layer<AbstractVectorSource>

Type Parameters:

S - the source type

Returns:

the layer source or null if not set

setSource

public void setSource(AbstractVectorSource source)

Sets source to the layer.

For more details see: #setSource docs

The following sources supported:

• VectorSource
• DataVectorSource

Overrides:

setSource in class Layer<AbstractVectorSource>

Parameters:

source - source to set

withSource

public VectorLayer withSource(AbstractVectorSource source)

See Layer.setSource(Source).

The following sources supported:

• VectorSource
• DataVectorSource

Overrides:

withSource in class Layer<AbstractVectorSource>

Parameters:

source - source to set

Returns:

current instance

getRenderBuffer

public Double getRenderBuffer()

Specified by:

getRenderBuffer in interface BaseVectorLayer.HasRenderBuffer

Overrides:

getRenderBuffer in class BaseVectorLayer<AbstractVectorSource>

Returns:

the render buffer in pixels, null value means that default value is used: 100

setRenderBuffer

public void setRenderBuffer(Double renderBuffer)

Description copied from interface: BaseVectorLayer.HasRenderBuffer

Sets the buffer in pixels around the viewport extent used by the renderer when getting features from the vector source for the rendering or hit-detection. The hit detection only checks features that are within a certain distance of the given position. For large icons, the actual geometry of a feature might be too far away and is not considered. Recommended value: the size of the largest symbol, line width or label.

Note, render buffer is set only at creation time and cannot be changed at runtime.

For more details see: BaseVectorLayer docs

Specified by:

setRenderBuffer in interface BaseVectorLayer.HasRenderBuffer

Overrides:

setRenderBuffer in class BaseVectorLayer<AbstractVectorSource>

Parameters:

renderBuffer - the buffer in pixels

withRenderBuffer

public VectorLayer withRenderBuffer(Double renderBuffer)

See setRenderBuffer(Double).

Parameters:

renderBuffer -

Returns:

current instance

getDeclutter

public Boolean getDeclutter()

Specified by:

getDeclutter in interface BaseVectorLayer.HasDeclutter

Overrides:

getDeclutter in class BaseVectorLayer<AbstractVectorSource>

Returns:

whether declutter images and texts, null value means that default value is used: false

setDeclutter

public void setDeclutter(Boolean declutter)

Description copied from interface: BaseVectorLayer.HasDeclutter

Sets whether declutter images and texts. Decluttering is applied to all image and text styles of all vector layers that have set this to true. The priority is defined by the z-index of the layer, the Style.withZIndex(Integer) of the style and the render order of features. Higher z-index means higher priority. Within the same z-index, a feature rendered before another has higher priority.

As an optimization decluttered features from layers with the same Layer.setClassName(String) are rendered above the Fill and Stroke styles of all of those layers regardless of z-index. To opt out of this behavior and place declutterd features with their own layer configure the layer with a className other than 'ol-layer'.

The default value is false.

Note, declutter is set only at creation time and cannot be changed at runtime.

For more details see: BaseVectorLayer docs

Specified by:

setDeclutter in interface BaseVectorLayer.HasDeclutter

Overrides:

setDeclutter in class BaseVectorLayer<AbstractVectorSource>

Parameters:

declutter - whether declutter images and texts

withDeclutter

public VectorLayer withDeclutter(Boolean declutter)

See setDeclutter(Boolean).

Parameters:

declutter -

Returns:

current instance

getBackground

public String getBackground()

Specified by:

getBackground in interface BaseVectorLayer.HasBackground

Overrides:

getBackground in class BaseVectorLayer<AbstractVectorSource>

Returns:

background color for the layer or null if not set

setBackground

public void setBackground(String color)

Description copied from interface: BaseVectorLayer.HasBackground

Sets the background color for the layer. If not specified, no background will be rendered.

Note, background color is set only at creation time and cannot be changed at runtime.

For more details see: BaseVectorLayer docs

Specified by:

setBackground in interface BaseVectorLayer.HasBackground

Overrides:

setBackground in class BaseVectorLayer<AbstractVectorSource>

Parameters:

color - color to set

withBackground

public VectorLayer withBackground(String color)

See setBackground(String).

Parameters:

color -

Returns:

current instance

getUpdateWhileAnimating

public Boolean getUpdateWhileAnimating()

Specified by:

getUpdateWhileAnimating in interface BaseVectorLayer.HasUpdateWhileAnimating

Overrides:

getUpdateWhileAnimating in class BaseVectorLayer<AbstractVectorSource>

Returns:

whether feature batches will be recreated during animations, null value means that default value is used: false

setUpdateWhileAnimating

public void setUpdateWhileAnimating(Boolean updateWhileAnimating)

Description copied from interface: BaseVectorLayer.HasUpdateWhileAnimating

Sets whether feature batches will be recreated during animations. This means that no vectors will be shown clipped, but the setting will have a performance impact for large amounts of vector data. When set to false, batches will be recreated when no animation is active.

The default value is false.

Note, "updateWhileAnimating" is set only at creation time and cannot be changed at runtime. For more details see: BaseVectorLayer docs

Specified by:

setUpdateWhileAnimating in interface BaseVectorLayer.HasUpdateWhileAnimating

Overrides:

setUpdateWhileAnimating in class BaseVectorLayer<AbstractVectorSource>

Parameters:

updateWhileAnimating - whether feature batches will be recreated during animations

withUpdateWhileAnimating

public VectorLayer withUpdateWhileAnimating(Boolean updateWhileAnimating)

See setUpdateWhileAnimating(Boolean).

Parameters:

updateWhileAnimating -

Returns:

getUpdateWhileInteracting

public Boolean getUpdateWhileInteracting()

Specified by:

getUpdateWhileInteracting in interface BaseVectorLayer.HasUpdateWhileInteracting

Overrides:

getUpdateWhileInteracting in class BaseVectorLayer<AbstractVectorSource>

Returns:

whether feature batches will be recreated during interactions, null value means that default value is used: false

setUpdateWhileInteracting

public void setUpdateWhileInteracting(Boolean updateWhileInteracting)

Description copied from interface: BaseVectorLayer.HasUpdateWhileInteracting

Sets whether feature batches will be recreated during interactions. The default value is false.

For instance, if the user moves map by mouse, the features that were not visible will be drawn after the user releases the pressed mouse. To enable always drawing features, set property to true.

Note, "updateWhileInteracting" is set only at creation time and cannot be changed at runtime.

For more details see: BaseVectorLayer docs

Specified by:

setUpdateWhileInteracting in interface BaseVectorLayer.HasUpdateWhileInteracting

Overrides:

setUpdateWhileInteracting in class BaseVectorLayer<AbstractVectorSource>

Parameters:

updateWhileInteracting - whether feature batches will be recreated during interactions

withUpdateWhileInteracting

public VectorLayer withUpdateWhileInteracting(Boolean updateWhileInteracting)

See setUpdateWhileInteracting(Boolean).

Parameters:

updateWhileInteracting -

Returns:

current instance

withClassName

public VectorLayer withClassName(String className)

Description copied from class: Layer

See Layer.setClassName(String).

Overrides:

withClassName in class Layer<AbstractVectorSource>

Parameters:

className - CSS class name

Returns:

current instance

withOpacity

public VectorLayer withOpacity(Double opacity)

Description copied from class: Layer

See Layer.setOpacity(Double).

Overrides:

withOpacity in class Layer<AbstractVectorSource>

Parameters:

opacity - opacity of the layer

Returns:

current instance

withVisible

public VectorLayer withVisible(Boolean visible)

Description copied from class: Layer

See Layer.setVisible(Boolean).

Overrides:

withVisible in class Layer<AbstractVectorSource>

Parameters:

visible - whether layer should be visible

Returns:

current instance

withExtent

public VectorLayer withExtent(Extent extent)

Description copied from class: Layer

See Layer.setExtent(Extent).

Overrides:

withExtent in class Layer<AbstractVectorSource>

Parameters:

extent - extent at which the layer is visible

Returns:

current instance

withZIndex

public VectorLayer withZIndex(Integer zIndex)

Description copied from class: Layer

See Layer.setZIndex(Integer).

Overrides:

withZIndex in class Layer<AbstractVectorSource>

Parameters:

zIndex - z-index for layer rendering

Returns:

current instance

withMinZoom

public VectorLayer withMinZoom(Double minZoom)

Description copied from class: Layer

See Layer.setMinZoom(Double).

Overrides:

withMinZoom in class Layer<AbstractVectorSource>

Parameters:

minZoom - zoom level (exclusive) above which layer will be visible

Returns:

current instance

withMaxZoom

public VectorLayer withMaxZoom(Double maxZoom)

Description copied from class: Layer

See Layer.setMaxZoom(Double).

Overrides:

withMaxZoom in class Layer<AbstractVectorSource>

Parameters:

maxZoom - zoom level (inclusive) at which layer will be visible

Returns:

current instance

addStyles

public void addStyles(Style... styles)

Description copied from class: BaseVectorLayer

Adds styles that should be merged with default. Layer's styles are applied for all added features, except features with own style.

Specified by:

addStyles in interface HasStyles

Overrides:

addStyles in class BaseVectorLayer<AbstractVectorSource>

Parameters:

styles - styles to add

withStyles

public VectorLayer withStyles(Style... styles)

See addStyles(Style...).

Parameters:

styles - styles to add

Returns:

current instance

getStyles

public List<Style> getStyles()

Specified by:

getStyles in interface HasStyles

Overrides:

getStyles in class BaseVectorLayer<AbstractVectorSource>

Returns:

layer's styles or empty list

removeStyles

public void removeStyles(Style... styles)

Description copied from class: BaseVectorLayer

Removes provided styles from layer.

Specified by:

removeStyles in interface HasStyles

Overrides:

removeStyles in class BaseVectorLayer<AbstractVectorSource>

Parameters:

styles - styles to remove

removeAllStyles

public void removeAllStyles()

Description copied from class: BaseVectorLayer

Clears list of styles.

Specified by:

removeAllStyles in interface HasStyles

Overrides:

removeAllStyles in class BaseVectorLayer<AbstractVectorSource>