public interface Deprecable
Deprecated
annotation.
This interface is for identifying deprecated data rather than language constructs.
Example:
When an error is discovered in the definition of a Coordinate Reference System (CRS) in the EPSG
database, the EPSG maintainers do not change the data. Instead, they deprecate the erroneous definition
and create a new one with a new EPSG code. The isDeprecated()
method in this interface allows
users to identify CRS instances created from such deprecated database records, for example in order to log
a warning when data are projected to a deprecated CRS.
Some examples of deprecated instances are:
org.apache.sis.referencing.AbstractIdentifiedObject
(typically a CRS)
which has been built from a deprecated EPSG code.org.apache.sis.referencing.NamedIdentifier
containing the legacy name
of an object which has been renamed.Defined in the sis-utility module
Modifier and Type | Method and Description |
---|---|
InternationalString |
getRemarks()
If this instance is deprecated, the reason or the alternative to use.
|
boolean |
isDeprecated()
Returns
true if this instance is deprecated. |
boolean isDeprecated()
true
if this instance is deprecated.true
if this instance is deprecated.InternationalString getRemarks()
null
if none. Shall be the
reason for deprecation or the alternative to use if this instance
is deprecated.Copyright © 2010–2013 The Apache Software Foundation. All rights reserved.