Package org.gdal.gdal

Class MajorObject

java.lang.Object
org.gdal.gdal.MajorObject
Direct Known Subclasses:
Band, Dataset, DataSource, Driver, Driver, Layer, Network

public class MajorObject
extends java.lang.Object
Class used for object with metadata.

The MajorObject class is a binding for the C++ GDALMajorObject class.

  • Method Summary

    Modifier and Type Method Description
    void delete()  
    java.lang.String GetDescription()
    Fetch object description.
    java.util.Hashtable GetMetadata_Dict()
    Fetch metadata.
    java.util.Hashtable GetMetadata_Dict​(java.lang.String domain)
    Fetch metadata.
    java.util.Vector GetMetadata_List()
    Fetch metadata.
    java.util.Vector GetMetadata_List​(java.lang.String domain)
    Fetch metadata.
    java.util.Vector GetMetadataDomainList()  
    java.lang.String GetMetadataItem​(java.lang.String name)
    Fetch single metadata item.
    java.lang.String GetMetadataItem​(java.lang.String name, java.lang.String domain)
    Fetch single metadata item.
    void SetDescription​(java.lang.String newDescription)
    Set object description.
    int SetMetadata​(java.lang.String metadataString)
    Set metadata.
    int SetMetadata​(java.lang.String metadataString, java.lang.String domain)
    Set metadata.
    int SetMetadata​(java.util.Hashtable metadata)
    Set metadata.
    int SetMetadata​(java.util.Hashtable metadata, java.lang.String domain)
    Set metadata.
    int SetMetadata​(java.util.Vector metadata)
    Set metadata.
    int SetMetadata​(java.util.Vector metadata, java.lang.String domain)
    Set metadata.
    int SetMetadataItem​(java.lang.String name, java.lang.String value)
    Set single metadata item.
    int SetMetadataItem​(java.lang.String name, java.lang.String value, java.lang.String domain)
    Set single metadata item.

    Methods inherited from class java.lang.Object

    equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Method Details

    • delete

      public void delete()
    • SetMetadata

      public int SetMetadata​(java.util.Hashtable metadata, java.lang.String domain)
      Set metadata.

      The metadata is set into the domain specified.

      Parameters:
      metadata - the metadata as a table of (key, value) tuples to apply
      domain - the domain of interest. Use "" or null for the default domain.
      Returns:
      gdalconst.CE_None on success, gdalconst.CE_Failure on failure and gdalconst.CE_Warning if the metadata has been accepted, but is likely not maintained persistently by the underlying object between sessions.
    • SetMetadata

      public int SetMetadata​(java.util.Hashtable metadata)
      Set metadata.

      The metadata is set into the default domain

      Returns:
      gdalconst.CE_None on success, gdalconst.CE_Failure on failure and gdalconst.CE_Warning if the metadata has been accepted, but is likely not maintained persistently by the underlying object between sessions.
      Since:
      Java bindings 1.7.0
    • GetDescription

      public java.lang.String GetDescription()
      Fetch object description.

      The semantics of the returned description are specific to the derived type. For Dataset object it is the dataset name. For Band object it is actually a description (if supported) or "".

      Returns:
      description
    • SetDescription

      public void SetDescription​(java.lang.String newDescription)
      Set object description.

      The semantics of the returned description are specific to the derived type. For Dataset object it is the dataset name. For Band object it is actually a description (if supported) or "". Normally application code should not set the "description" for GDALDatasets. It is handled internally.

      Parameters:
      newDescription - new description
    • GetMetadataDomainList

      public java.util.Vector GetMetadataDomainList()
    • GetMetadata_Dict

      public java.util.Hashtable GetMetadata_Dict​(java.lang.String domain)
      Fetch metadata. Returns metadata as (key, value) tuples in the result table
      Parameters:
      domain - the domain of interest. Use "" or null for the default domain.
      Returns:
      null or a hash table with metadata
    • GetMetadata_Dict

      public java.util.Hashtable GetMetadata_Dict()
      Fetch metadata. Returns metadata from the default domain as (key, value) tuples in the result table
      Returns:
      null or a hash table with metadata
      Since:
      Java bindings 1.7.0
    • GetMetadata_List

      public java.util.Vector GetMetadata_List​(java.lang.String domain)
      Fetch metadata. Returns metadata as a vector of strings of the format "KEY=VALUE".
      Parameters:
      domain - the domain of interest. Use "" or null for the default domain.
      Returns:
      null or a vector of strings
    • GetMetadata_List

      public java.util.Vector GetMetadata_List()
      Fetch metadata.

      Returns metadata from the default domain as a vector of strings of the format "KEY=VALUE".

      Returns:
      null or a vector of strings
      Since:
      Java bindings 1.7.0
    • SetMetadata

      public int SetMetadata​(java.util.Vector metadata, java.lang.String domain)
      Set metadata.

      The metadata is set into the domain specified.

      Parameters:
      metadata - the metadata to apply as a vector of strings of the format "KEY=VALUE".
      domain - the domain of interest. Use "" or null for the default domain.
      Returns:
      gdalconst.CE_None on success, gdalconst.CE_Failure on failure and gdalconst.CE_Warning if the metadata has been accepted, but is likely not maintained persistently by the underlying object between sessions.
      Since:
      Java bindings 1.7.0
    • SetMetadata

      public int SetMetadata​(java.util.Vector metadata)
      Set metadata.

      The metadata is set into the default domain

      Parameters:
      metadata - the metadata to apply as a vector of strings of the format "KEY=VALUE".
      Returns:
      gdalconst.CE_None on success, gdalconst.CE_Failure on failure and gdalconst.CE_Warning if the metadata has been accepted, but is likely not maintained persistently by the underlying object between sessions.
      Since:
      Java bindings 1.7.0
    • SetMetadata

      public int SetMetadata​(java.lang.String metadataString, java.lang.String domain)
      Set metadata.

      The metadata is set into the domain specified.

      Parameters:
      metadataString - the metadata to apply as a string of the format "KEY=VALUE".
      domain - the domain of interest. Use "" or null for the default domain.
      Returns:
      gdalconst.CE_None on success, gdalconst.CE_Failure on failure and gdalconst.CE_Warning if the metadata has been accepted, but is likely not maintained persistently by the underlying object between sessions.
    • SetMetadata

      public int SetMetadata​(java.lang.String metadataString)
      Set metadata.

      The metadata is set into the default domain

      Parameters:
      metadataString - the metadata to apply as a string of the format "KEY=VALUE".
      Returns:
      gdalconst.CE_None on success, gdalconst.CE_Failure on failure and gdalconst.CE_Warning if the metadata has been accepted, but is likely not maintained persistently by the underlying object between sessions.
      Since:
      Java bindings 1.7.0
    • GetMetadataItem

      public java.lang.String GetMetadataItem​(java.lang.String name, java.lang.String domain)
      Fetch single metadata item.
      Parameters:
      name - the key for the metadata item to fetch.
      domain - the domain to fetch for, use null for the default domain.
      Returns:
      null on failure to find the key, or the value string on success.
    • GetMetadataItem

      public java.lang.String GetMetadataItem​(java.lang.String name)
      Fetch single metadata item.

      The metadata item is searched into the default domain.

      Parameters:
      name - the key for the metadata item to fetch.
      Returns:
      null on failure to find the key, or the value string on success.
      Since:
      Java bindings 1.7.0
    • SetMetadataItem

      public int SetMetadataItem​(java.lang.String name, java.lang.String value, java.lang.String domain)
      Set single metadata item.
      Parameters:
      name - the key for the metadata item to fetch.
      value - the value to assign to the key.
      domain - the domain to set within, use null for the default domain.
      Returns:
      gdalconst.CE_None on success, or an error code on failure.
    • SetMetadataItem

      public int SetMetadataItem​(java.lang.String name, java.lang.String value)
      Set single metadata item.

      The metadata item is set into the default domain.

      Parameters:
      name - the key for the metadata item to fetch.
      value - the value to assign to the key.
      Returns:
      gdalconst.CE_None on success, or an error code on failure.
      Since:
      Java bindings 1.7.0