public abstract class ALcyFormatWrapper extends ALcyFormat
Convenience class to wrap an ALcyFormat
: one only has to overwrite those
methods that are required. This is also known as the decorator design pattern.
Note that wrapping an abstract class can be cumbersome because methods might be
added to the abstract class in a newer version of the API. The advantage of extending from this
ALcyFormatWrapper
is that if methods are ever added to ALcyFormat
,
they will also be added here.
Modifier | Constructor and Description |
---|---|
protected |
ALcyFormatWrapper(ALcyFormat aFormat)
Creates a wrapper for the specified
ALcyFormat . |
Modifier and Type | Method and Description |
---|---|
void |
createAll()
Creates all the instances of the concepts of this class by calling all the abstract factory
methods, and performs some validity checks on the created values.
|
protected ILcyAsynchronousPaintHintProvider |
createAsynchronousPaintHintProvider()
Creates a
ILcyAsynchronousPaintHintProvider for this format. |
protected ILcdBalloonContentProvider[] |
createBalloonContentProviders()
Creates the
ILcdBalloonContentProvider s for this format. |
protected ILcyCustomizerPanelFactory[] |
createDataPropertyValueCustomizerPanelFactories()
Creates the
ILcyCustomizerPanelFactory factories that can create
ILcyCustomizerPanel instances to change the value of a single
data property of the domain objects created by the model decoders of this format. |
protected String[][] |
createDataSourceHandlerFileTypeDescriptorGroups()
Creates file type descriptor groups for all decoders.
|
protected ALcyFileTypeDescriptor[] |
createDataSourceHandlerFileTypeDescriptors()
Creates the
ALcyFileTypeDescriptor instances corresponding to the
ALcyFileTypeDescriptor instances created by this format. |
protected ALcyDataSourceHandler[] |
createDataSourceHandlers()
Creates
ALcyDataSourceHandler (s) that are more general
than ALcyFileTypeDescriptor s. |
protected ALcyDefaultModelDescriptorFactory[] |
createDefaultModelDescriptorFactories()
Creates the
ALcyDefaultModelDescriptorFactory s for this data format. |
protected ILcyCustomizerPanelFactory[] |
createDomainObjectCustomizerPanelFactories()
Creates the
ILcyCustomizerPanelFactory factories that can create
ILcyCustomizerPanel instances for the domain objects created by the model decoders
of this format. |
protected ALcyWorkspaceObjectCodec[] |
createDomainObjectCustomizerPanelWorkspaceCodecs()
Creates the
ALcyWorkspaceObjectCodec codecs for the
ILcyCustomizerPanel instances for the domain objects created by the model
decoders of this format. |
protected ALcyWorkspaceObjectCodec[] |
createDomainObjectWorkspaceCodecs()
Creates the
ALcyWorkspaceObjectCodec that can encode and decode the
ILcyCustomizerPanel instances for the domain objects produced by the model decoders
of this format. |
protected ALcyFormatBarFactory |
createFormatBarFactory()
Creates the
ALcyFormatBarFactory that can create a bar to manipulate layers
of this format. |
protected ILcyCustomizerPanelFactory[] |
createGXYLayerCustomizerPanelFactories()
Creates the
ILcyCustomizerPanelFactory factories that can create
ILcyCustomizerPanel instances for the layers created by the layer factories of
this format. |
protected ALcyWorkspaceObjectCodec[] |
createGXYLayerCustomizerPanelWorkspaceCodecs()
Creates the
ALcyWorkspaceObjectCodec codecs for the
ILcyCustomizerPanel instances for the layers created by the layer factories of this
format. |
protected ALcyFileTypeDescriptor[] |
createGXYLayerDecoderFileTypeDescriptors()
Creates
ALcyFileTypeDescriptor s for the ILcdGXYLayerDecoder s. |
protected ILcdGXYLayerDecoder[] |
createGXYLayerDecoders()
Creates the
ILcdGXYLayerDecoder decoders that can decode layers for models
created by the model decoders of this format. |
protected ALcyFileTypeDescriptor[] |
createGXYLayerEncoderFileTypeDescriptors()
Creates
ALcyFileTypeDescriptor s for the ILcdGXYLayerEncoder s. |
protected ILcdGXYLayerEncoder[] |
createGXYLayerEncoders()
Creates the
ILcdGXYLayerEncoder encoders for the layers created by the layer
factories of this format. |
protected ILcdGXYLayerFactory |
createGXYLayerFactory()
Creates a
ILcdGXYLayerFactory for this format. |
protected ALcyLayerSelectionTransferHandler[] |
createGXYLayerSelectionTransferHandlers()
Creates the
ALcyLayerSelectionTransferHandler transfer handlers that can
transfer the selection of the 2D layers created by the layer factories of this format. |
protected ILcyLayerStyleProvider |
createGXYLayerStyleProvider()
Creates the style provider that can retrieve and encode the style of the layers created by the
layer factory of this format.
|
protected ILcyGXYLayerTypeProvider |
createGXYLayerTypeProvider()
Creates an
ILcyGXYLayerTypeProvider for this format. |
protected ALcyWorkspaceObjectCodec[] |
createGXYLayerWorkspaceCodecs()
Creates the
ALcyWorkspaceObjectCodec codecs that can encode and decode the
layers created by the layer factories of this format. |
protected ILcyGXYLabelPlacementHintProvider |
createLabelPlacementHintProvider()
Creates the
ILcyLabelPlacementHintProvider that can create a
TLcyGXYLabelPlacementHint for layers of this format. |
protected ILcdLayerHeightProviderFactory |
createLayerHeightProviderFactory()
Creates the
ILcdLayerHeightProviderFactory that can create an
ILcdHeightProvider for this format. |
protected ILcdLayerMeasureProviderFactory |
createLayerMeasureProviderFactory()
Creates the
ILcdLayerMeasureProviderFactory for this format. |
protected ILcyModelContentTypeProvider |
createModelContentTypeProvider()
Creates an
ILcyModelContentTypeProvider for this format. |
protected ILcyCustomizerPanelFactory[] |
createModelCustomizerPanelFactories()
Creates the
ILcyCustomizerPanelFactory (s) that can create
ILcyCustomizerPanel instances to customize the models
produced by the model decoders and model factories of this format. |
protected ALcyWorkspaceObjectCodec[] |
createModelCustomizerPanelWorkspaceCodecs()
Creates the
ALcyWorkspaceObjectCodec that can encode and decode the
ILcyCustomizerPanel instances for the models produced by this format. |
protected String[][] |
createModelDecoderFileTypeDescriptorGroups()
Creates file type descriptor groups for all decoders.
|
protected ALcyFileTypeDescriptor[] |
createModelDecoderFileTypeDescriptors()
Creates the
ALcyFileTypeDescriptor instances corresponding to the
ILcdModelDecoder instances created by this format. |
protected ILcdModelDecoder[] |
createModelDecoders()
Creates the
ILcdModelDecoder decoders for this data format. |
protected ILcyCustomizerPanelFactory[] |
createModelEncoderCustomizerPanelFactories()
Creates the
ILcyCustomizerPanelFactory instances for the
ILcdModelEncoder instances created by this class. |
protected ALcyWorkspaceObjectCodec[] |
createModelEncoderCustomizerPanelWorkspaceCodecs()
Creates the
ALcyWorkspaceObjectCodec codecs for the
ILcyCustomizerPanel that customize the model encoder
instances created by this class. |
protected ALcyFileTypeDescriptor[] |
createModelEncoderFileTypeDescriptors()
Creates the array of
ALcyFileTypeDescriptor instances for the
ILcdModelEncoder instances created by this format. |
protected ILcdModelEncoder[] |
createModelEncoders()
Creates the model encoders for this data format.
|
protected ILcdModelFactory |
createModelFactory()
Creates the
ILcdModelFactory for this data format. |
protected ILcdModelHeightProviderFactory |
createModelHeightProviderFactory()
Creates the
ILcdModelHeightProviderFactory that can create an
ILcdHeightProvider for this format. |
protected ILcdModelMeasureProviderFactory |
createModelMeasureProviderFactory()
Creates the
ILcdModelMeasureProviderFactory for this format. |
protected ILcyCustomizerPanelFactory[] |
createModelMetaDataCustomizerPanelFactories()
Creates the
ILcyCustomizerPanelFactory (s) that can create
ILcyCustomizerPanel instances to customize the meta data of the models
produced by the model decoders and model factories of this format. |
protected ALcyWorkspaceObjectCodec[] |
createModelMetaDataCustomizerPanelWorkspaceCodecs()
Creates the
ALcyWorkspaceObjectCodec codecs that can encode and decode the
ILcyCustomizerPanel instances used to customize the meta data of the
models produced by this format. |
protected ALcyWorkspaceObjectCodec[] |
createModelWorkspaceCodecs()
Creates the
ALcyWorkspaceObjectCodec codecs that can encode and decode the
ILcdModel instances produces by the model decoders of this format. |
ALcyFormat |
getFormat()
Returns the wrapped
ALcyFormat . |
String |
getLongPrefix()
Returns the long prefix of this format that can be used, for instance, to derive UID's.
|
ILcyLucyEnv |
getLucyEnv()
Returns the
ILcyLucyEnv backend with which this ALcyFormat is
associated. |
String |
getShortPrefix()
Returns the short prefix of this format that can be used, for instance, to derive keys for a
ALcyProperties instance. |
boolean |
isGXYLayerOfFormat(ILcdGXYLayer aGXYLayer)
Returns
true if and only if the given layer is a layer of the current data
format. |
boolean |
isModelOfFormat(ILcdModel aModel)
Returns true if and only if the given model is a model of the current data format.
|
createGXYLayerOfFormatFilter, createLayerContextOfFormatFilter, createModelContextOfFormatFilter, createModelOfFormatFilter, getAsynchronousPaintHintProvider, getBalloonContentProviders, getDataPropertyValueCustomizerPanelFactories, getDataSourceHandlerFileTypeDescriptorGroups, getDataSourceHandlerFileTypeDescriptors, getDataSourceHandlers, getDefaultModelDescriptorFactories, getDomainObjectCustomizerPanelFactories, getDomainObjectCustomizerPanelWorkspaceCodecs, getDomainObjectWorkspaceCodecs, getFormatBarFactory, getGXYLayerCustomizerPanelFactories, getGXYLayerCustomizerPanelWorkspaceCodecs, getGXYLayerDecoderFileTypeDescriptors, getGXYLayerDecoders, getGXYLayerEncoderFileTypeDescriptors, getGXYLayerEncoders, getGXYLayerFactory, getGXYLayerSelectionTransferHandlers, getGXYLayerStyleProvider, getGXYLayerTypeProvider, getGXYLayerWorkspaceCodecs, getLabelPlacementHintProvider, getLayerHeightProviderFactory, getLayerMeasureProviderFactory, getModelContentTypeProvider, getModelCustomizerPanelFactories, getModelCustomizerPanelWorkspaceCodecs, getModelDecoderFileTypeDescriptorGroups, getModelDecoderFileTypeDescriptors, getModelDecoders, getModelEncoderCustomizerPanelFactories, getModelEncoderCustomizerPanelWorkspaceCodecs, getModelEncoderFileTypeDescriptors, getModelEncoders, getModelFactory, getModelHeightProviderFactory, getModelMeasureProviderFactory, getModelMetaDataCustomizerPanelFactories, getModelMetaDataCustomizerPanelWorkspaceCodecs, getModelWorkspaceCodecs, toString
protected ALcyFormatWrapper(ALcyFormat aFormat)
Creates a wrapper for the specified ALcyFormat
.
aFormat
- The ALcyFormat
to decorate. Must not be null
.public ALcyFormat getFormat()
Returns the wrapped ALcyFormat
.
ALcyFormat
. Never null
.public ILcyLucyEnv getLucyEnv()
ALcyFormat
Returns the ILcyLucyEnv
backend with which this ALcyFormat
is
associated.
getLucyEnv
in class ALcyFormat
ILcyLucyEnv
backend. Must not be null
.public String getLongPrefix()
ALcyFormat
Returns the long prefix of this format that can be used, for instance, to derive UID's. Typically this would be the fully qualified name of the addon.
getLongPrefix
in class ALcyFormat
null
.public String getShortPrefix()
ALcyFormat
Returns the short prefix of this format that can be used, for instance, to derive keys for a
ALcyProperties
instance. This would typically be the short classname of the
addon.
getShortPrefix
in class ALcyFormat
null
.public void createAll()
ALcyFormat
Creates all the instances of the concepts of this class by calling all the abstract factory
methods, and performs some validity checks on the created values. All created instances can
later on be retrieved by calling the appropriate get<Concept>
methods.
createAll
in class ALcyFormat
public boolean isModelOfFormat(ILcdModel aModel)
ALcyFormat
isModelOfFormat
in class ALcyFormat
aModel
- The model to check.true
if and only if the given model is a model of the current data
format.protected ILcyModelContentTypeProvider createModelContentTypeProvider()
ALcyFormat
Creates an ILcyModelContentTypeProvider
for this format.
createModelContentTypeProvider
in class ALcyFormat
ILcyModelContentTypeProvider
for this data format. May be
null
.TLcySafeGuardFormatWrapper
protected ILcdModelFactory createModelFactory()
ALcyFormat
Creates the ILcdModelFactory
for this data format. All newly created models of
the add-on are expected to be constructed through this factory.
createModelFactory
in class ALcyFormat
ILcdModelFactory
for this data format. May be null
.protected ALcyDefaultModelDescriptorFactory[] createDefaultModelDescriptorFactories()
ALcyFormat
Creates the ALcyDefaultModelDescriptorFactory
s for this data format.
The default implementation returns a zero-length array.
createDefaultModelDescriptorFactories
in class ALcyFormat
ALcyDefaultModelDescriptorFactory
(or multiple) for this data format.
Must not be null
, but the array may have length 0
.protected ILcdModelDecoder[] createModelDecoders()
ALcyFormat
Creates the ILcdModelDecoder
decoders for this data format.
It's also the responsibility of this method to make sure that the given lucy environment listens to status events from the decoder. This method should not register the decoder to the lucy env.
Note that TLcdStatusInputStreamFactory
might be useful to implement this
method.
createModelDecoders
in class ALcyFormat
ILcdModelDecoder
(or multiple) for this data format. Must not be
null
, but the array may have length 0
.TLcdStatusInputStreamFactory
protected ALcyFileTypeDescriptor[] createModelDecoderFileTypeDescriptors()
ALcyFormat
Creates the ALcyFileTypeDescriptor
instances corresponding to the
ILcdModelDecoder
instances created by this format.
createModelDecoderFileTypeDescriptors
in class ALcyFormat
ALcyFileTypeDescriptor
instances. Must not be
null
. Its length should be equal to the length of the array created by
createModelDecoders
. It may contain null
.protected String[][] createModelDecoderFileTypeDescriptorGroups()
ALcyFormat
Creates file type descriptor groups for all decoders. The groups may be empty, but the group count must equal the decoder count.
createModelDecoderFileTypeDescriptorGroups
in class ALcyFormat
ALcyFileTypeDescriptor
instances of the ILcdModelDecoder
s. The first dimension must be equal to
the length of the array of ILcdModelDecoder
instances created by this
format. It must not contain null
, but may contain empty arrays.protected ILcdModelEncoder[] createModelEncoders()
ALcyFormat
Creates the model encoders for this data format. It is the responsibility of this method to ensure that the given lucy environment listens to status events from the encoder. This method should not register the encoder to the lucy env.
Note that TLcdStatusOutputStreamFactory
might be useful to implement this
method.
createModelEncoders
in class ALcyFormat
ILcdModelEncoder
instances. Must not be null
, but
may have length 0
. Must not contain null
.TLcdStatusOutputStreamFactory
protected ALcyFileTypeDescriptor[] createModelEncoderFileTypeDescriptors()
ALcyFormat
Creates the array of ALcyFileTypeDescriptor
instances for the
ILcdModelEncoder
instances created by this format.
createModelEncoderFileTypeDescriptors
in class ALcyFormat
ALcyFileTypeDescriptor
instances. Must not be
null
and its length must be equal to the length of the array of
ILcdModelEncoder
instances created by this format. May contain
null
.ALcyFormat.createModelEncoders()
protected ILcyCustomizerPanelFactory[] createModelEncoderCustomizerPanelFactories()
ALcyFormat
Creates the ILcyCustomizerPanelFactory
instances for the
ILcdModelEncoder
instances created by this class.
The created ILcyCustomizerPanel
s should work with instances of TLcyModelEncoderContext
in their
setObject
method.
Hint: When overriding this method, you should also consider overriding ALcyFormat.createModelEncoderCustomizerPanelWorkspaceCodecs()
.
This is needed if your ILcyCustomizerPanel
s need to store any specific state in the workspace.
createModelEncoderCustomizerPanelFactories
in class ALcyFormat
ILcyCustomizerPanelFactory
instances. Must not be
null
but may have length 0
. Must not contain
null
.TLcySafeGuardFormatWrapper
protected ALcyWorkspaceObjectCodec[] createModelEncoderCustomizerPanelWorkspaceCodecs()
ALcyFormat
Creates the ALcyWorkspaceObjectCodec
codecs for the
ILcyCustomizerPanel
that customize the model encoder
instances created by this class.
createModelEncoderCustomizerPanelWorkspaceCodecs
in class ALcyFormat
ALcyWorkspaceObjectCodec
instances. Must not be
null
, but may have length 0
. Must not contain
null
.TLcySafeGuardFormatWrapper
protected ALcyWorkspaceObjectCodec[] createModelCustomizerPanelWorkspaceCodecs()
ALcyFormat
Creates the ALcyWorkspaceObjectCodec
that can encode and decode the
ILcyCustomizerPanel
instances for the models produced by this format.
createModelCustomizerPanelWorkspaceCodecs
in class ALcyFormat
ALcyWorkspaceObjectCodec
instances. Must not be
null
but may have length 0
. Must not contain
null
.TLcySafeGuardFormatWrapper
protected ALcyWorkspaceObjectCodec[] createModelWorkspaceCodecs()
ALcyFormat
Creates the ALcyWorkspaceObjectCodec
codecs that can encode and decode the
ILcdModel
instances produces by the model decoders of this format.
createModelWorkspaceCodecs
in class ALcyFormat
ALcyWorkspaceObjectCodec
instances. Must not be
null
, but may have length 0
. Must not contain
null
.TLcySafeGuardFormatWrapper
protected ALcyWorkspaceObjectCodec[] createDomainObjectWorkspaceCodecs()
ALcyFormat
Creates the ALcyWorkspaceObjectCodec
that can encode and decode the
ILcyCustomizerPanel
instances for the domain objects produced by the model decoders
of this format.
createDomainObjectWorkspaceCodecs
in class ALcyFormat
ALcyWorkspaceObjectCodec
instances. Must not be
null
but may have length 0
. Must not contain
null
.TLcySafeGuardFormatWrapper
protected ILcyCustomizerPanelFactory[] createDomainObjectCustomizerPanelFactories()
ALcyFormat
Creates the ILcyCustomizerPanelFactory
factories that can create
ILcyCustomizerPanel
instances for the domain objects created by the model decoders
of this format.
The created ILcyCustomizerPanel
s should work with instances of TLcyDomainObjectContext
in their
setObject
method.
Hint: When overriding this method, you should also consider overriding ALcyFormat.createDomainObjectCustomizerPanelWorkspaceCodecs()
.
This is needed if your ILcyCustomizerPanel
s need to store any specific state in the workspace.
createDomainObjectCustomizerPanelFactories
in class ALcyFormat
ILcyCustomizerPanelFactory
instances. Must not be
null
but may have length 0
. Must not contain
null
.TLcySafeGuardFormatWrapper
protected ILcyCustomizerPanelFactory[] createModelCustomizerPanelFactories()
ALcyFormat
Creates the ILcyCustomizerPanelFactory
(s) that can create
ILcyCustomizerPanel
instances to customize the models
produced by the model decoders and model factories of this format.
The created ILcyCustomizerPanel
s should work with instances of TLcyModelContext
in their setObject
method.
Hint: When overriding this method, you should also consider overriding ALcyFormat.createModelCustomizerPanelWorkspaceCodecs()
.
This is needed if your ILcyCustomizerPanel
s need to store any specific state in the workspace.
createModelCustomizerPanelFactories
in class ALcyFormat
ILcyCustomizerPanelFactory
instances. Must not be
null
but may have length 0
. Must not contain
null
.TLcySafeGuardFormatWrapper
protected ILcyCustomizerPanelFactory[] createModelMetaDataCustomizerPanelFactories()
ALcyFormat
Creates the ILcyCustomizerPanelFactory
(s) that can create
ILcyCustomizerPanel
instances to customize the meta data of the models
produced by the model decoders and model factories of this format.
The created ILcyCustomizerPanel
s should work with instances of TLcyModelMetaDataContext
in their
setObject
method.
Hint: When overriding this method, you should also consider overriding ALcyFormat.createModelMetaDataCustomizerPanelWorkspaceCodecs()
.
This is needed if your ILcyCustomizerPanel
s need to store any specific state in the workspace.
createModelMetaDataCustomizerPanelFactories
in class ALcyFormat
ILcyCustomizerPanelFactory
instances. Must not be
null
but may have length 0
. Must not contain
null
.TLcySafeGuardFormatWrapper
protected ILcyGXYLayerTypeProvider createGXYLayerTypeProvider()
ALcyFormat
Creates an ILcyGXYLayerTypeProvider
for this format.
createGXYLayerTypeProvider
in class ALcyFormat
ILcyGXYLayerTypeProvider
for this data format. May be
null
.TLcySafeGuardFormatWrapper
protected ILcdGXYLayerFactory createGXYLayerFactory()
ALcyFormat
Creates a ILcdGXYLayerFactory
for this format.
createGXYLayerFactory
in class ALcyFormat
ILcdGXYLayerFactory
for this data format. May be null
.TLcySafeGuardFormatWrapper
protected ILcyAsynchronousPaintHintProvider createAsynchronousPaintHintProvider()
ALcyFormat
Creates a ILcyAsynchronousPaintHintProvider
for this format.
createAsynchronousPaintHintProvider
in class ALcyFormat
ILcyAsynchronousPaintHintProvider
for the layers created by the layer
factories of this format. May be null
.TLcySafeGuardFormatWrapper
protected ILcdGXYLayerDecoder[] createGXYLayerDecoders()
ALcyFormat
Creates the ILcdGXYLayerDecoder
decoders that can decode layers for models
created by the model decoders of this format.
The default implementation returns a zero-length array.
It is the responsibility of this method to make sure that the lucy environment listens to status events from the decoder. This method should not register the decoder to the lucy env.
Note that TLcdStatusInputStreamFactory
might be useful to implement this
method.
createGXYLayerDecoders
in class ALcyFormat
null
, but may have length
0
. It must not contain null
.TLcySafeGuardFormatWrapper
protected ALcyFileTypeDescriptor[] createGXYLayerDecoderFileTypeDescriptors()
ALcyFormat
Creates ALcyFileTypeDescriptor
s for the ILcdGXYLayerDecoder
s. The
length of the returned array must be equal to that of ALcyFormat.createGXYLayerDecoders()
.
An example usage of these ALcyFileTypeDescriptor
instances could be to determine
whether a style file is located next to source file of a layer, and apply that style when
such a layer is created. Most of the default Lucy formats have such a mechanism in place in
their layer factory: they look for a style file with the same name as the source file, but
with an extension as specified by a non-null
ALcyFileTypeDescriptor
.
The default implementation returns a zero-length array.
createGXYLayerDecoderFileTypeDescriptors
in class ALcyFormat
ALcyFileTypeDescriptor
instances. Must not be null
and its length must be equal to the length of the array of layer decoders created by
this format. May contain null
.protected ILcdGXYLayerEncoder[] createGXYLayerEncoders()
ALcyFormat
Creates the ILcdGXYLayerEncoder
encoders for the layers created by the layer
factories of this format.
The default implementation returns a zero-length array.
It is the responsibility of this method to make sure that the lucy environment listens to status events from the encoder. This method should not register the encoder to the lucy env.
Note that TLcdStatusOutputStreamFactory
might be useful to implement this
method.
createGXYLayerEncoders
in class ALcyFormat
ILcdGXYLayerEncoder
instances. Must not be null
but may have length 0
. Must not contain null
.TLcySafeGuardFormatWrapper
,
TLcdStatusOutputStreamFactory
protected ALcyFileTypeDescriptor[] createGXYLayerEncoderFileTypeDescriptors()
ALcyFormat
Creates ALcyFileTypeDescriptor
s for the ILcdGXYLayerEncoder
s. The
length of the returned array must be equal to that of ALcyFormat.createGXYLayerEncoders()
.
An example usage of these ALcyFileTypeDescriptor
instances is the File | Save layer style
action which is available in Lucy. It allows to save the style of a layer to a file ending with
an extension as specified by these ALcyFileTypeDescriptor
s. When no
ALcyFileTypeDescriptor
s are available (or only null
ALcyFileTypeDescriptor
s) it will not be possible to save
the layer style to file.
The default implementation returns a zero-length array.
createGXYLayerEncoderFileTypeDescriptors
in class ALcyFormat
ALcyFileTypeDescriptor
instances. Must not be null
and its length must be equal to the length of the array of layer encoders created by
this format. May contain null
.ALcyFormat.createGXYLayerEncoders()
protected ALcyWorkspaceObjectCodec[] createGXYLayerWorkspaceCodecs()
ALcyFormat
Creates the ALcyWorkspaceObjectCodec
codecs that can encode and decode the
layers created by the layer factories of this format.
The default implementation returns a zero-length array.
createGXYLayerWorkspaceCodecs
in class ALcyFormat
ALcyWorkspaceObjectCodec
instances. Must not be
null
but may have length 0
. Must not contain
null
.TLcySafeGuardFormatWrapper
protected ILcyCustomizerPanelFactory[] createGXYLayerCustomizerPanelFactories()
ALcyFormat
Creates the ILcyCustomizerPanelFactory
factories that can create
ILcyCustomizerPanel
instances for the layers created by the layer factories of
this format.
The created ILcyCustomizerPanel
s should work with instances of TLcyLayerContext
in their
setObject
method.
The default implementation returns a zero-length array.
Hint: When overriding this method, you should also consider overriding ALcyFormat.createGXYLayerCustomizerPanelWorkspaceCodecs()
.
This is needed if your ILcyCustomizerPanel
s need to store any specific state in the workspace.
createGXYLayerCustomizerPanelFactories
in class ALcyFormat
ILcyCustomizerPanelFactory
instances. Must not be
null
but may have length 0
. Must not contain
null
.TLcySafeGuardFormatWrapper
public boolean isGXYLayerOfFormat(ILcdGXYLayer aGXYLayer)
ALcyFormat
Returns true
if and only if the given layer is a layer of the current data
format.
isGXYLayerOfFormat
in class ALcyFormat
aGXYLayer
- The layer to check.true
if and only if the given layer is a layer of the current data
format.protected ALcyLayerSelectionTransferHandler[] createGXYLayerSelectionTransferHandlers()
ALcyFormat
Creates the ALcyLayerSelectionTransferHandler
transfer handlers that can
transfer the selection of the 2D layers created by the layer factories of this format.
The default implementation returns a zero-length array.
createGXYLayerSelectionTransferHandlers
in class ALcyFormat
ALcyLayerSelectionTransferHandler
instances. Must not be
null
but may have length 0
. Must not contain
null
.TLcySafeGuardFormatWrapper
protected ALcyFormatBarFactory createFormatBarFactory()
ALcyFormat
Creates the ALcyFormatBarFactory
that can create a bar to manipulate layers
of this format.
The default implementation returns null
.
createFormatBarFactory
in class ALcyFormat
ALcyFormatBarFactory
. May be null
.TLcySafeGuardFormatWrapper
protected ILcdModelHeightProviderFactory createModelHeightProviderFactory()
ALcyFormat
Creates the ILcdModelHeightProviderFactory
that can create an
ILcdHeightProvider
for this format.
The default implementation returns null
.
createModelHeightProviderFactory
in class ALcyFormat
ILcdModelHeightProviderFactory
. May be null
.TLcySafeGuardFormatWrapper
protected ILcdLayerHeightProviderFactory createLayerHeightProviderFactory()
ALcyFormat
Creates the ILcdLayerHeightProviderFactory
that can create an
ILcdHeightProvider
for this format.
The default implementation returns null
.
createLayerHeightProviderFactory
in class ALcyFormat
ILcdLayerHeightProviderFactory
. May be null
.TLcySafeGuardFormatWrapper
protected ILcyGXYLabelPlacementHintProvider createLabelPlacementHintProvider()
ALcyFormat
ILcyLabelPlacementHintProvider
that can create a
TLcyGXYLabelPlacementHint
for layers of this format.
The default implementation returns null
.
createLabelPlacementHintProvider
in class ALcyFormat
ILcyLabelPlacementHintProvider
. May be null
.TLcySafeGuardFormatWrapper
protected ILcyLayerStyleProvider createGXYLayerStyleProvider()
ALcyFormat
createGXYLayerStyleProvider
in class ALcyFormat
null
protected ALcyWorkspaceObjectCodec[] createGXYLayerCustomizerPanelWorkspaceCodecs()
ALcyFormat
Creates the ALcyWorkspaceObjectCodec
codecs for the
ILcyCustomizerPanel
instances for the layers created by the layer factories of this
format.
createGXYLayerCustomizerPanelWorkspaceCodecs
in class ALcyFormat
ALcyWorkspaceObjectCodec
instances. Must not be
null
, but may have length 0
. Must not contain
null
.TLcySafeGuardFormatWrapper
protected ALcyWorkspaceObjectCodec[] createDomainObjectCustomizerPanelWorkspaceCodecs()
ALcyFormat
Creates the ALcyWorkspaceObjectCodec
codecs for the
ILcyCustomizerPanel
instances for the domain objects created by the model
decoders of this format.
createDomainObjectCustomizerPanelWorkspaceCodecs
in class ALcyFormat
ALcyWorkspaceObjectCodec
instances. Must not be
null
, but may have length 0
. Must not contain
null
.TLcySafeGuardFormatWrapper
protected ALcyWorkspaceObjectCodec[] createModelMetaDataCustomizerPanelWorkspaceCodecs()
ALcyFormat
Creates the ALcyWorkspaceObjectCodec
codecs that can encode and decode the
ILcyCustomizerPanel
instances used to customize the meta data of the
models produced by this format.
createModelMetaDataCustomizerPanelWorkspaceCodecs
in class ALcyFormat
ALcyWorkspaceObjectCodec
instances. Must not be
null
but may have length 0
. Must not contain
null
.TLcySafeGuardFormatWrapper
protected String[][] createDataSourceHandlerFileTypeDescriptorGroups()
ALcyFormat
Creates file type descriptor groups for all decoders. The groups may be empty, but the group count must equal the decoder count.
createDataSourceHandlerFileTypeDescriptorGroups
in class ALcyFormat
ALcyFileTypeDescriptor
instances of the ALcyFileTypeDescriptor
s. The first dimension must be equal to
the length of the array of ALcyFileTypeDescriptor
instances created by this
format. It must not contain null
, but may contain empty arrays.protected ALcyFileTypeDescriptor[] createDataSourceHandlerFileTypeDescriptors()
ALcyFormat
Creates the ALcyFileTypeDescriptor
instances corresponding to the
ALcyFileTypeDescriptor
instances created by this format.
createDataSourceHandlerFileTypeDescriptors
in class ALcyFormat
ALcyFileTypeDescriptor
instances. Must not be
null
. Its length should be equal to the length of the array created by
createDataSourceHandlers
. It may contain null
.protected ALcyDataSourceHandler[] createDataSourceHandlers()
ALcyFormat
Creates ALcyDataSourceHandler
(s) that are more general
than ALcyFileTypeDescriptor
s.
createDataSourceHandlers
in class ALcyFormat
ALcyDataSourceHandler
instances. Must not be
null
but may have length 0
. Must not contain
null
.protected ILcyCustomizerPanelFactory[] createDataPropertyValueCustomizerPanelFactories()
ALcyFormat
Creates the ILcyCustomizerPanelFactory
factories that can create
ILcyCustomizerPanel
instances to change the value of a single
data property of the domain objects created by the model decoders of this format.
These customizer panels can for instance be used in the Table view or the Object properties.
The created ILcyCustomizerPanel
s should work with instances of TLcdDataPropertyValueContext
in their
setObject
method.
The default implementation returns a zero-length array.
createDataPropertyValueCustomizerPanelFactories
in class ALcyFormat
ILcyCustomizerPanelFactory
instances. Must not be
null
but may have length 0
. Must not contain
null
.protected ILcdBalloonContentProvider[] createBalloonContentProviders()
ALcyFormat
Creates the ILcdBalloonContentProvider
s for this format.
The default implementation returns an empty array.
createBalloonContentProviders
in class ALcyFormat
ILcdBalloonContentProvider
s for this format. Must not be
null
. The array may be empty but not contain null
.protected ILcdModelMeasureProviderFactory createModelMeasureProviderFactory()
ALcyFormat
Creates the ILcdModelMeasureProviderFactory
for this format.
The default implementation returns null
.
createModelMeasureProviderFactory
in class ALcyFormat
ILcdModelMeasureProviderFactory
for this format. Can be null
.ALcyFormat.getModelMeasureProviderFactory()
protected ILcdLayerMeasureProviderFactory createLayerMeasureProviderFactory()
ALcyFormat
Creates the ILcdLayerMeasureProviderFactory
for this format.
The default implementation returns null
.
createLayerMeasureProviderFactory
in class ALcyFormat
ILcdLayerMeasureProviderFactory
for this format. Can be null
.ALcyFormat.getLayerMeasureProviderFactory()