Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Exceptions
• Deprecated Methods

Deprecated Interfaces

Cloneable
The need for this interface in GeoAPI is weaker than it was at the begining of this project, since the interfaces which were originally extending Cloneable do not extend it anymore today. Consequently this interface will be removed and the handling of the Cloneable issue left to implementors.

Format
In favor of migrating to ISO 19123 definition for Coverage.

GridCoverageProcessor
Need to be replaced by a mechanism better aligned on WCPS specification.

GridCoverageReader
In favor of migrating to ISO 19123 definition for Coverage.

GridCoverageWriter
In favor of migrating to ISO 19123 definition for Coverage.

GridPacking
In favor of migrating to ISO 19123 definition for Coverage.

GridRange
Replaced by GridEnvelope.

WebServiceClient
Legacy code of deegree 1.x.

WebServiceResponse
Legacy code of deegree 1.x.

Deprecated Classes

ByteInValuePacking
In favor of migrating to ISO 19123 definition for Coverage.

ColorInterpretation
No replacement.

SimpleEnumerationType
The name doesn't said what is the difference between this class and CodeList. Furthermore, according ISO 19103, enumeration and code list are not the same thing. This base class is closer to a code list than an enumeration.

UnlimitedInteger
ISO uses this type only for the multiplicity of associations in UML models, which is not something that we try to represent in GeoAPI. Even if we wanted this information, custom class can not be used in Java annotations.

ValueInBytePacking
In favor of migrating to ISO 19123 definition for Coverage.

WebServiceEvent
Legacy code of deegree 1.x.

Deprecated Exceptions

GridNotEditableException
No replacement.

IncompatibleOperationException
This GeoAPI extension is not used in any GeoAPI interface.

NoSuchEnumerationException
Not used.

Deprecated Methods

org.opengis.geometry.coordinate.GeometryFactory.createDirectPosition()
Moved to PositionFactory

org.opengis.geometry.coordinate.GeometryFactory.createDirectPosition(double[])
Moved to PositionFactory

org.opengis.geometry.coordinate.GeometryFactory.createMultiPrimitive()
This method is temporary. It will move to some MultiPrimitive factory when the creation of Geometry interfaces will be completed. See GEO-1 on JIRA.

org.opengis.webservice.WebService.doService(WebServiceEvent)
The WebServiceEvent class is marked as deprecated.

org.opengis.display.canvas.CanvasEvent.getChange(CanvasState)
This method does not said is the change is computed from the old or the new state. If we need this functionality, then the method should move to CanvasState.

org.opengis.coverage.SampleDimension.getColorInterpretation()
No replacement.

org.opengis.coverage.grid.GridCoverage.getDataBlock(GridRange, boolean[])
We should use some higher level construct instead (multi-dimensional array or something similar).

org.opengis.coverage.grid.GridCoverage.getDataBlock(GridRange, byte[])
We should use some higher level construct instead (multi-dimensional array or something similar).

org.opengis.coverage.grid.GridCoverage.getDataBlock(GridRange, double[])
We should use some higher level construct instead (multi-dimensional array or something similar).

org.opengis.coverage.grid.GridCoverage.getDataBlock(GridRange, float[])
We should use some higher level construct instead (multi-dimensional array or something similar).

org.opengis.coverage.grid.GridCoverage.getDataBlock(GridRange, int[])
We should use some higher level construct instead (multi-dimensional array or something similar).

org.opengis.coverage.grid.GridCoverage.getDataBlock(GridRange, short[])
We should use some higher level construct instead (multi-dimensional array or something similar).

org.opengis.coverage.processing.Operation.getDescription()
Return type need to be changed, maybe to InternationalString.

org.opengis.util.ProgressListener.getDescription()
Replaced by getTask().toString()

org.opengis.coverage.processing.Operation.getDocURL()
To be replaced by a method returning a Citation.

org.opengis.coverage.grid.GridRange.getLength(int)
Renamed as GridEnvelope.getSpan(int).

org.opengis.coverage.grid.GridRange.getLower()
Renamed as GridEnvelope.getLow().

org.opengis.coverage.grid.GridRange.getLower(int)
Renamed as GridEnvelope.getLow(int).

org.opengis.geometry.Precision.getMaximumSignificantDigits()
This is redundant with Precision.getScale().

org.opengis.filter.spatial.BBOX.getMaxX()
please use getExpression2(), to check for a literal BoundingBox.getMaximum(0)

org.opengis.filter.spatial.BBOX.getMaxY()
please use getExpression2(), to check for a literal BoundingBox.getMaximum(1)

org.opengis.filter.spatial.BBOX.getMinX()
please use getExpression2(), to check for a literal BoundingBox.getMinimum(0)

org.opengis.filter.spatial.BBOX.getMinY()
please use getExpression2(), to check for a literal BoundingBox.getMinimum(1)

org.opengis.coverage.grid.GridCoverage.getPackedDataBlock(GridRange)
We should use some higher level construct instead (multi-dimensional array or something similar).

org.opengis.coverage.SampleDimension.getPalette()
No replacement.

org.opengis.coverage.SampleDimension.getPaletteInterpretation()
No replacement.

org.opengis.filter.spatial.BBOX.getPropertyName()
Please check getExpression1(), if it is a PropertyName

org.opengis.webservice.WebServiceRequest.getRequestParameter()
should be replaced by a factory class.

org.opengis.filter.spatial.BBOX.getSRS()
please use getExpression2(), if it is a literal BoundingBox.getCoordinateReferenceSystem()

org.opengis.coverage.grid.GridRange.getUpper()
Replaced as GridEnvelope.getHigh() with 1 added to all ordinate values.

org.opengis.coverage.grid.GridRange.getUpper(int)
Renamed as GridEnvelope.getHigh(int) + 1.

org.opengis.coverage.processing.Operation.getVendor()
To be replaced by getName().getAuthority().

org.opengis.coverage.processing.Operation.getVersion()
Replacement to be determined.

org.opengis.geometry.coordinate.PointArray.length()
Please use List.size()

org.opengis.geometry.coordinate.PointArray.positions()
use this

org.opengis.coverage.grid.GridCoverage.setDataBlock(GridRange, boolean[])
We should use some higher level construct instead (multi-dimensional array or something similar).

org.opengis.coverage.grid.GridCoverage.setDataBlock(GridRange, byte[])
We should use some higher level construct instead (multi-dimensional array or something similar).

org.opengis.coverage.grid.GridCoverage.setDataBlock(GridRange, double[])
We should use some higher level construct instead (multi-dimensional array or something similar).

org.opengis.coverage.grid.GridCoverage.setDataBlock(GridRange, float[])
We should use some higher level construct instead (multi-dimensional array or something similar).

org.opengis.coverage.grid.GridCoverage.setDataBlock(GridRange, int[])
We should use some higher level construct instead (multi-dimensional array or something similar).

org.opengis.coverage.grid.GridCoverage.setDataBlock(GridRange, short[])
We should use some higher level construct instead (multi-dimensional array or something similar).

org.opengis.util.ProgressListener.setDescription(String)
Replaced by setTask

org.opengis.geometry.primitive.Point.setPosition(DirectPosition)
Renamed as Point.setDirectPosition(org.opengis.geometry.DirectPosition) for consistency with Point.getDirectPosition().