Package oracle.spatial.georaster.sql

Class SdoGeoRaster

  • public class SdoGeoRaster
extends java.lang.Object
    SdoGeoRaster is a Java class which contains a pair of rasterID and rasterDataTable information. Combined with a connection (a database), SdoGeoRaster can uniquely identify a GeoRaster object in the target database.

    SdoGeoRaster can be constructed from a STRUCT object. 

        public SdoGeoRaster(STRUCT georaster) throws Exception
    
 or from a pair of rasterID and rasterDataTable.
 
    public SdoGeoRaster(String rasterDataTable, NUMBER rasterID)
    
 SdoGeoRaster can also be constructed from a JGeoRaster object:
 
    public SdoGeoRaster(JGeoRaster jeor)

    Compared with JGeoRaster object, SdoGeoRaster is a lightweight Java mapping of a GeoRaster object, because it only contains a pair of rasterID and rasterDataTable information without any other overhead; instead, when a JGeoRaster object is constructed, it needs to fetch and parse a GeoRaster metadata XML string, construct internal metadata objects structure, and initialize some necessary attributes for later data and image processing.

    SdoGeoRaster is usually used with class SdoGeorPKG to wrap the GeoRaster PL/SQL API on the Java side. For example: 

         public void changeFormatCopy(SdoGeoRaster source,String storageParam,SdoGeoRaster target,double[] bgValues) throws Exception

    • Constructor Summary

      Constructors 
      Modifier Constructor Description
      protected SdoGeoRaster()  
        SdoGeoRaster​(java.lang.String rasterDataTable, oracle.sql.NUMBER rasterID)
      Constructs an SdoGeoRaster object using the given rasterDataTable and rasterID.
        SdoGeoRaster​(JGeoRaster jgeor)
      Constructs an SdoGeoRaster object using the given JGeoRaster object.
        SdoGeoRaster​(oracle.sql.STRUCT georaster)
      Constructs an SdoGeoRaster object using the given STRUCT.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      java.lang.String getRasterDataTable()
      Returns the raster data table where the current GeoRaster object is stored.
      oracle.sql.NUMBER getRasterID()
      Returns the raster ID assigned to the current GeoRaster object.
      void setRasterDataTable​(java.lang.String rasterDataTable)
      Sets the raster data table of the current GeoRaster object.
      void setRasterID​(oracle.sql.NUMBER rasterID)
      Sets the raster ID of the current GeoRaster object.

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • SdoGeoRaster

        protected SdoGeoRaster()

      • SdoGeoRaster

        public SdoGeoRaster​(oracle.sql.STRUCT georaster)
             throws java.lang.Exception
        Constructs an SdoGeoRaster object using the given STRUCT.
        Parameters:
        georaster - a STRUCT object, which is used to initiate the SdoGeoRaster object
        Throws:
        java.lang.Exception

      • SdoGeoRaster

        public SdoGeoRaster​(java.lang.String rasterDataTable,
                    oracle.sql.NUMBER rasterID)
        Constructs an SdoGeoRaster object using the given rasterDataTable and rasterID.
        Parameters:
        rasterDataTable - raster data table
        rasterID - raster ID number

      • SdoGeoRaster

        public SdoGeoRaster​(JGeoRaster jgeor)
        Constructs an SdoGeoRaster object using the given JGeoRaster object.
        Parameters:
        jgeor - a JGeoRaster object, which is used to initiate SdoGeoRaster object

    • Method Detail

      • getRasterDataTable

        public java.lang.String getRasterDataTable()
        Returns the raster data table where the current GeoRaster object is stored.
        Returns:
        the raster data table where the current GeoRaster object is stored.

      • getRasterID

        public oracle.sql.NUMBER getRasterID()
        Returns the raster ID assigned to the current GeoRaster object.
        Returns:
        the raster ID assigned to the current GeoRaster object.

      • setRasterID

        public void setRasterID​(oracle.sql.NUMBER rasterID)
                 throws GeoRasterException
        Sets the raster ID of the current GeoRaster object.
        Parameters:
        rasterID - the raster ID assigned to the current GeoRaster object
        Throws:
        GeoRasterException

      • setRasterDataTable

        public void setRasterDataTable​(java.lang.String rasterDataTable)
                        throws GeoRasterException
        Sets the raster data table of the current GeoRaster object.
        Parameters:
        rasterDataTable - the raster data table where the current GeoRaster object is stored
        Throws:
        GeoRasterException