TLcdGML2ModelEncoder (LuciadLightspeed API documentation)

java.lang.Object
- com.luciad.format.xml.bind.schema.ALcdXMLModelEncoder
- - com.luciad.format.gml2.xml.TLcdGML2ModelEncoder

All Implemented Interfaces:: ILcdOutputStreamFactoryCapable, ILcdModelEncoder, Serializable

@LcdService(service=ILcdModelEncoder.class,
            priority=20000)
public class TLcdGML2ModelEncoder
extends ALcdXMLModelEncoder

This model encoder encodes Geography Markup Language (GML) version 2.x.

Output files

File	Description
.gml, .gml2, *.xml	GML 2 data file
*.xsd	Application schema (XML Schema)

Supported file transfer protocols

This model encoder supports all transfer protocols that are supported by the outputStreamFactory of this encoder.

Supported models for saving

This model encoder can save all models decoded by the TLcdGML2ModelDecoder and models having a TLcdGML2ModelDescriptor.

Supported models for exporting

This model encoder can save all models having ILcdShape/ILcdDataObject elements. Nested features are also supported.

The following shapes are supported:

Java class	GML geometry type
ILcdPoint	gml:PointType
ILcdPolyline	gml:LineStringType
ILcdPolygon	gml:PolygonType
ILcdShapeList	gml:MultiGeometryType

The following feature classes are supported:

Java class	XSD type
Boolean	xsd:boolean
Byte	xsd:byte
Short	xsd:short
Integer	xsd:int
Long	xsd:long
Float	xsd:float
Double	xsd:double

Supported model references

This model encoder supports all model references which can be formatted by the TLcdOGCModelReferenceFormatter.

Useful settings

A default target namespace can be configured on this model encoder. This namespace will be the namespace of all the application schemas that are generated during export of non-GML2 models.

Sample code


 ILcdModelEncoder encoder = new TLcdGML2ModelEncoder();
 encoder.export(model, "world.gml2");

Thread safety

The encoding of models is thread-safe, as long as no properties are changed during the encoding.

Supported versions and specifications

GML 2.1

Known limitations

Since:: 9.0
See Also:: Serialized Form

Constructor Summary

Constructors
Constructor and Description

TLcdGML2ModelEncoder()
Creates a new TLcdGML2ModelEncoder, ready to use.

Constructors
Constructor and Description
`TLcdGML2ModelEncoder()` Creates a new `TLcdGML2ModelEncoder`, ready to use.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`canExport(ILcdModel aModel, String aDestinationName)` Returns whether this encoder can export the specified model to the specified destination.
`boolean`	`canSave(ILcdModel aModel)` Returns whether this model encoder can save the specified model to the location it originally came from.
`protected String`	`createSchemaLocation(String aNamespaceURI, String aDefaultSchemaLocation, String aDestinationName)` Returns a schema location for the specified namespace URI to be encoded in the "xsi:schemaLocations" attribute in the generated XML documents.
`void`	`export(ILcdModel aModel, Result aDestination)` Exports the given model to a destination result.
`void`	`export(ILcdModel aModel, String aDestinationName)` Exports the specified model to the specified destination.
`void`	`exportSchema(ILcdModel aModel, String aDestinationName)` Exports the XML schema for the specified model to the specified destination.
`String`	`getDefaultTargetNamespace()` Returns the default target application schema namespace.
`String`	`getDisplayName()` Returns a short, displayable name for the format this `ILcdModelEncoder` encodes to.
`EntityResolver2`	`getEntityResolver()` Returns the `org.xml.sax.ext.EntityResolver2` that is used for creating input sources for XSD schemas.
`ILcdModelReferenceFormatter`	`getModelReferenceFormatter()` Returns the model reference formatter that is used to format `ILcdModelReference` instances when encoding an srsName.
`ILcdOutputStreamFactory`	`getOutputStreamFactory()` Returns the `ILcdOutputStreamFactory` that is used for creating output streams.
`XMLOutputFactory`	`getXMLOutputFactory()` Returns the `javax.xml.stream.XMLOutputFactory` that is used by this encoder for creating `javax.xml.stream.XMLStreamWriter` instances.
`boolean`	`isAutoEncodeSchema()` Returns `true` if the schema is automatically encoded when a model is encoded, `false` otherwise.
`void`	`save(ILcdModel aModel)` Saves the model to the location where it originally came from.
`void`	`setAutoEncodeSchema(boolean aAutoEncodeSchema)` Sets whether a schema is to be encoded automatically when a model is encoded.
`void`	`setDefaultTargetNamespace(String aTargetNamespace)` Sets the default target application schema namespace.
`void`	`setEntityResolver(EntityResolver2 aEntityResolver)` Sets the `org.xml.sax.ext.EntityResolver2` to be used for creating input sources for XSD schemas.
`void`	`setModelReferenceFormatter(ILcdModelReferenceFormatter aModelReferenceFormatter)` Sets the formatter that is used to format `ILcdModelReference` instances when encoding an srsName.
`void`	`setOutputStreamFactory(ILcdOutputStreamFactory aOutputStreamFactory)` Sets the `ILcdOutputStreamFactory` to be used for creating output streams.
`void`	`setXMLOutputFactory(XMLOutputFactory aXMLOutputFactory)` Sets the `javax.xml.stream.XMLOutputFactory` to be used by this encoder for creating `javax.xml.stream.XMLStreamWriter` instances.
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - TLcdGML2ModelEncoder
```
public TLcdGML2ModelEncoder()
```
    Creates a new TLcdGML2ModelEncoder, ready to use.
- Method Detail
  - canSave
```
public boolean canSave(ILcdModel aModel)
```
    Description copied from interface: ILcdModelEncoder
    
    Returns whether this model encoder can save the specified model to the location it originally came from. Often this will only be a simple test, for example checking the type of the model's model descriptor.
    
    Parameters:
    
    aModel - the model to be verified.
    
    Returns:
    
    true if this encoder can save the model in the location where it originally came from, false otherwise.
    
    See Also:
    
    ILcdModelEncoder.save(com.luciad.model.ILcdModel)
  - getDisplayName
```
public String getDisplayName()
```
    Description copied from interface: ILcdModelEncoder
    
    Returns a short, displayable name for the format this ILcdModelEncoder encodes to.
    
    Returns:
    
    the displayable name of this ILcdModelEncoder.
  - getEntityResolver
```
public EntityResolver2 getEntityResolver()
```
    Description copied from class: ALcdXMLModelEncoder
    
    Returns the org.xml.sax.ext.EntityResolver2 that is used for creating input sources for XSD schemas.
    
    Specified by:
    
    getEntityResolver in class ALcdXMLModelEncoder
    
    Returns:
    
    the entity resolver to be used for creating input sources for XSD schemas.
  - getOutputStreamFactory
```
public ILcdOutputStreamFactory getOutputStreamFactory()
```
    Description copied from class: ALcdXMLModelEncoder
    
    Returns the ILcdOutputStreamFactory that is used for creating output streams.
    
    Specified by:
    
    getOutputStreamFactory in interface ILcdOutputStreamFactoryCapable
    
    Specified by:
    
    getOutputStreamFactory in class ALcdXMLModelEncoder
    
    Returns:
    
    the ILcdOutputStreamFactory that is used for creating output streams.
    
    See Also:
    
    ALcdXMLModelEncoder.setOutputStreamFactory(com.luciad.io.ILcdOutputStreamFactory)
  - getXMLOutputFactory
```
public XMLOutputFactory getXMLOutputFactory()
```
    Description copied from class: ALcdXMLModelEncoder
    
    Returns the javax.xml.stream.XMLOutputFactory that is used by this encoder for creating javax.xml.stream.XMLStreamWriter instances.
    
    Specified by:
    
    getXMLOutputFactory in class ALcdXMLModelEncoder
    
    Returns:
    
    the javax.xml.stream.XMLOutputFactory that is used by this encoder for creating javax.xml.stream.XMLStreamWriter instances.
  - save
```
public void save(ILcdModel aModel)
          throws IllegalArgumentException,
                 IOException
```
    Description copied from interface: ILcdModelEncoder
    
    Saves the model to the location where it originally came from.
    
    Parameters:
    
    aModel - the model to be saved.
    
    Throws:
    
    IllegalArgumentException - if the model cannot be saved by this encoder (!canSave(aModel)).
    
    IOException - if an I/O error occurs during encoding.
  - setEntityResolver
```
public void setEntityResolver(EntityResolver2 aEntityResolver)
```
    Description copied from class: ALcdXMLModelEncoder
    
    Sets the org.xml.sax.ext.EntityResolver2 to be used for creating input sources for XSD schemas. This entity resolver is only used for retrieving runtime extension schemas.
    
    Specified by:
    
    setEntityResolver in class ALcdXMLModelEncoder
    
    Parameters:
    
    aEntityResolver - the entity resolver to be used for creating input sources for XSD schemas.
  - setOutputStreamFactory
```
public void setOutputStreamFactory(ILcdOutputStreamFactory aOutputStreamFactory)
```
    Description copied from class: ALcdXMLModelEncoder
    
    Sets the ILcdOutputStreamFactory to be used for creating output streams. This output stream factory is used for output streams for both the data files and the XSD schemas.
    
    Specified by:
    
    setOutputStreamFactory in interface ILcdOutputStreamFactoryCapable
    
    Specified by:
    
    setOutputStreamFactory in class ALcdXMLModelEncoder
    
    Parameters:
    
    aOutputStreamFactory - the output stream factory to be used by this model encoder.
    
    See Also:
    
    ALcdXMLModelEncoder.setOutputStreamFactory(com.luciad.io.ILcdOutputStreamFactory)
  - setXMLOutputFactory
```
public void setXMLOutputFactory(XMLOutputFactory aXMLOutputFactory)
```
    Description copied from class: ALcdXMLModelEncoder
    
    Sets the javax.xml.stream.XMLOutputFactory to be used by this encoder for creating javax.xml.stream.XMLStreamWriter instances.
    
    Specified by:
    
    setXMLOutputFactory in class ALcdXMLModelEncoder
    
    Parameters:
    
    aXMLOutputFactory - the javax.xml.stream.XMLOutputFactory to be used by this encoder for creating javax.xml.stream.XMLStreamWriter instances.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - getDefaultTargetNamespace
```
public String getDefaultTargetNamespace()
```
    Returns the default target application schema namespace. This is the namespace in which all generated elements and types generated specifically for the exported document will be declared. If null (the default), a namespace will be generated.
    
    Returns:
    
    the default namespace for generated application schemas, or null if a namespace is generated.
  - setDefaultTargetNamespace
```
public void setDefaultTargetNamespace(String aTargetNamespace)
```
    Sets the default target application schema namespace. This is the namespace in which all generated elements and types generated specifically for the exported document will be declared. If null (the default), a namespace will be generated.
    
    Parameters:
    
    aTargetNamespace - the default namespace for generated application schemas.
  - isAutoEncodeSchema
```
public boolean isAutoEncodeSchema()
```
    Returns true if the schema is automatically encoded when a model is encoded, false otherwise.
    
    Returns:
    
    true if the schema is automatically encoded when a model is encoded, false otherwise.
  - setAutoEncodeSchema
```
public void setAutoEncodeSchema(boolean aAutoEncodeSchema)
```
    Sets whether a schema is to be encoded automatically when a model is encoded. When set to true, this means that two output streams will be created when the save or export method is called, one for the destination file and one for the schema.
    
    Parameters:
    
    aAutoEncodeSchema - whether a schema is to be encoded automatically when a model is encoded.
  - createSchemaLocation
```
protected String createSchemaLocation(String aNamespaceURI,
                                      String aDefaultSchemaLocation,
                                      String aDestinationName)
```
    Returns a schema location for the specified namespace URI to be encoded in the "xsi:schemaLocations" attribute in the generated XML documents. The default implementation just returns the default location which is passed. This might be a local source however, which can be unwanted in some cases (e.g. a WFS server).
    
    Parameters:
    
    aNamespaceURI - the namespace URI for which to create a schema location.
    
    aDefaultSchemaLocation - the default schema location, if known by the encoder.
    
    aDestinationName - the name of the document being saved or exported, which will refer in its "xsi:schemaLocations" attribute to this schema location.
    
    Returns:
    
    a schema location for the specified namespace URI, which has a useful meaning in the encoded document.
  - canExport
```
public boolean canExport(ILcdModel aModel,
                         String aDestinationName)
```
    Description copied from interface: ILcdModelEncoder
    
    Returns whether this encoder can export the specified model to the specified destination. This method will typically check whether the contents of the specified model are compatible with the format this encoder is written for.
    
    Parameters:
    
    aModel - the model to be verified.
    
    aDestinationName - the location where the model should be exported to.
    
    Returns:
    
    true if this encoder can export the specified model to the specified location, false otherwise.
    
    See Also:
    
    ILcdModelEncoder.export(com.luciad.model.ILcdModel, java.lang.String)
  - export
```
public void export(ILcdModel aModel,
                   String aDestinationName)
            throws IOException
```
    Description copied from interface: ILcdModelEncoder
    
    Exports the specified model to the specified destination.
    
    Parameters:
    
    aModel - the model to be exported.
    
    aDestinationName - the location where the model should be saved. Typically, this is a name for the output file, but it can also point to a file containing the required properties to create a set of data files.
    
    Throws:
    
    IOException - if an I/O error occurs during encoding.
  - export
```
public void export(ILcdModel aModel,
                   Result aDestination)
            throws IOException
```
    Exports the given model to a destination result.
    
    Overrides:
    
    export in class ALcdXMLModelEncoder
    
    Parameters:
    
    aModel - the model to export
    
    aDestination - the destination
    
    Throws:
    
    IOException - if an I/O error occurs during encoding.
    
    UnsupportedOperationException - in case the encoder is not able to write to the given result
    
    See Also:
    
    ILcdModelEncoder.export(ILcdModel, String)
  - exportSchema
```
public void exportSchema(ILcdModel aModel,
                         String aDestinationName)
                  throws IOException
```
    Exports the XML schema for the specified model to the specified destination.
    
    Parameters:
    
    aModel - the model for which to generate and export an XML Schema.
    
    aDestinationName - the destination to which the XML schema should be saved.
    
    Throws:
    
    IOException - if an exception occurs during exporting.
  - getModelReferenceFormatter
```
public ILcdModelReferenceFormatter getModelReferenceFormatter()
```
    Returns the model reference formatter that is used to format ILcdModelReference instances when encoding an srsName.
    
    Returns:
    
    the model reference formatter of this encoder
  - setModelReferenceFormatter
```
public void setModelReferenceFormatter(ILcdModelReferenceFormatter aModelReferenceFormatter)
```
    Sets the formatter that is used to format ILcdModelReference instances when encoding an srsName.
    
    Parameters:
    
    aModelReferenceFormatter - the model reference formatter for this encoder

LuciadLightspeedClass TLcdGML2ModelEncoder

Output files

Supported file transfer protocols

Supported models for saving

Supported models for exporting

Supported model references

Useful settings

Sample code

Thread safety

Supported versions and specifications

Known limitations

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

TLcdGML2ModelEncoder

Method Detail

canSave

getDisplayName

getEntityResolver

getOutputStreamFactory

getXMLOutputFactory

save

setEntityResolver

setOutputStreamFactory

setXMLOutputFactory

toString

getDefaultTargetNamespace

setDefaultTargetNamespace

isAutoEncodeSchema

setAutoEncodeSchema

createSchemaLocation

canExport

export

export

exportSchema

getModelReferenceFormatter

setModelReferenceFormatter