org.geotools.data.coverage.grid
Interface GridCoverageWriter


Deprecated. You should use the interfaces provided with GeoApi instead.

public interface GridCoverageWriter

Support for writing grid coverages into a persistent store. Instance of GridCoverageWriter are obtained through a call to GridCoverageExchange.getWriter(java.lang.Object, org.geotools.data.coverage.grid.Format). Grid coverages are usually added to the output stream in a sequential order.

Version:
2.0
Author:
OpenGIS® consortium
See Also:
GridCoverageExchange.getWriter(java.lang.Object, org.geotools.data.coverage.grid.Format), ImageWriter

Method Summary
 void dispose()
          Deprecated. Allows any resources held by this object to be released.
 java.lang.Object getDestination()
          Deprecated. Returns the output destination.
 Format getFormat()
          Deprecated. Returns the format handled by this GridCoverageWriter.
 java.lang.String[] getMetadataNames()
          Deprecated. Returns the list of metadata keywords associated with the output destination as a whole (not associated with any particular grid coverage).
 void setCurrentSubname(java.lang.String name)
          Deprecated. Set the name for the next grid coverage to write within the output destination.
 void setMetadataValue(java.lang.String name, java.lang.String value)
          Deprecated. Sets the metadata value for a given metadata name.
 void write(org.opengis.coverage.grid.GridCoverage coverage, org.opengis.parameter.ParameterValueGroup parameters)
          Deprecated. Writes the specified grid coverage.
 

Method Detail

getFormat

public Format getFormat()
Deprecated. 
Returns the format handled by this GridCoverageWriter.


getDestination

public java.lang.Object getDestination()
Deprecated. 
Returns the output destination. This is the object passed to the GridCoverageExchange.getWriter(java.lang.Object, org.geotools.data.coverage.grid.Format) method. It can be a String, an OutputStream, a FileChannel, etc.


getMetadataNames

public java.lang.String[] getMetadataNames()
Deprecated. 
Returns the list of metadata keywords associated with the output destination as a whole (not associated with any particular grid coverage). If no metadata is allowed, the array will be empty.

Returns:
The list of metadata keywords for the output destination.
Throws:
java.io.IOException - if an error occurs during reading or writing.

setMetadataValue

public void setMetadataValue(java.lang.String name,
                             java.lang.String value)
                      throws java.io.IOException,
                             org.opengis.coverage.MetadataNameNotFoundException
Deprecated. 
Sets the metadata value for a given metadata name.

Parameters:
name - Metadata keyword for which to set the metadata.
value - The metadata value for the given metadata name.
Throws:
java.io.IOException - if an error occurs during writing.
org.opengis.coverage.MetadataNameNotFoundException - if the specified metadata name is not handled for this format.

setCurrentSubname

public void setCurrentSubname(java.lang.String name)
                       throws java.io.IOException
Deprecated. 
Set the name for the next grid coverage to write within the output destination. The subname can been fetch later at reading time.

Throws:
java.io.IOException - if an error occurs during writing.

write

public void write(org.opengis.coverage.grid.GridCoverage coverage,
                  org.opengis.parameter.ParameterValueGroup parameters)
           throws java.lang.IllegalArgumentException,
                  java.io.IOException
Deprecated. 
Writes the specified grid coverage.

Parameters:
coverage - The grid coverage to write.
parameters - An optional set of parameters. Should be any or all of the parameters returned by Format.getWriteParameters().
Throws:
org.opengis.parameter.InvalidParameterNameException - if a parameter in parameters doesn't have a recognized name.
org.opengis.parameter.InvalidParameterValueException - if a parameter in parameters doesn't have a valid value.
org.opengis.parameter.ParameterNotFoundException - if a parameter was required for the operation but was not provided in the parameters list.
org.opengis.coverage.grid.FileFormatNotCompatibleWithGridCoverageException - if the grid coverage can't be exported in the writer format.
java.io.IOException - if the export failed for some other input/output reason, including IIOException if an error was thrown by the underlying image library.
java.lang.IllegalArgumentException

dispose

public void dispose()
             throws java.io.IOException
Deprecated. 
Allows any resources held by this object to be released. The result of calling any other method subsequent to a call to this method is undefined. It is important for applications to call this method when they know they will no longer be using this GridCoverageWriter. Otherwise, the writer may continue to hold on to resources indefinitely.

Throws:
java.io.IOException - if an error occured while disposing resources (for example while flushing data and closing a file).


Copyright © GeoTools. All Rights Reserved.