All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
Module.cpp
Go to the documentation of this file.
1 /* Copyright (C) 2008 National Institute For Space Research (INPE) - Brazil.
2 
3  This file is part of the TerraLib - a Framework for building GIS enabled applications.
4 
5  TerraLib is free software: you can redistribute it and/or modify
6  it under the terms of the GNU Lesser General Public License as published by
7  the Free Software Foundation, either version 3 of the License,
8  or (at your option) any later version.
9 
10  TerraLib is distributed in the hope that it will be useful,
11  but WITHOUT ANY WARRANTY; without even the implied warranty of
12  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13  GNU Lesser General Public License for more details.
14 
15  You should have received a copy of the GNU Lesser General Public License
16  along with TerraLib. See COPYING. If not, write to
17  TerraLib Team at <terralib-team@terralib.org>.
18  */
19 
20 /*!
21  \file terralib/gdal/Module.h
22 
23  \brief The TerraLib OGR driver is a plugin.
24 */
25 
26 // TerraLib
27 #include "../common/Logger.h"
28 #include "../plugin/PluginInfo.h"
29 #include "../common/Translator.h"
30 #include "../dataaccess/datasource/DataSourceCapabilities.h"
31 #include "../dataaccess/datasource/DataSourceFactory.h"
32 #include "../dataaccess/datasource/DataSourceManager.h"
33 #include "Config.h"
34 #include "DataSourceFactory.h"
35 #include "Module.h"
36 #include "RasterFactory.h"
37 #include "Utils.h"
38 
39 // GDAL
40 #include <gdal_priv.h>
41 
43  : te::plugin::Plugin(pluginInfo)
44 {
45 }
46 
48 {
49 }
50 
52 {
53  if(m_initialized)
54  return;
55 
56  std::string gdal_data;
57 
58  char* tDir = getenv("TERRALIB_HOME");
59  std::string teDir;
60 
61  if(tDir != 0)
62  teDir = std::string(tDir);
63 
64  if(!teDir.empty())
65  gdal_data = teDir + "/share/gdal-data";
66  //}
67 
68  if(gdal_data.empty())
69  gdal_data = TERRALIB_GDAL_DATA;
70 
71  if( ! gdal_data.empty() )
72  {
73  CPLSetConfigOption("GDAL_DATA", gdal_data.c_str());
74  }
75  CPLSetConfigOption("GDAL_PAM_ENABLED", "NO");
76 
78 
79  GDALAllRegister();
80 
82 
83  // DataType Capabilites
85  dataTypeCapabilities.setSupportRaster(true);
86 
87  // DataSetType Capabilites
89 
90  // DataSet Capabilities
92  dataSetCapabilities.setSupportEfficientDataSetSize(true);
93 
94  // Query Capabilities
96 
97  // DataSouce Capabilities
99  capabilities.setSupportAll();
100  capabilities.setSupportTransactions(false);
101  capabilities.setDataTypeCapabilities(dataTypeCapabilities);
102  capabilities.setDataSetTypeCapabilities(dataSetTypeCapabilities);
103  capabilities.setDataSetCapabilities(dataSetCapabilities);
104  capabilities.setQueryCapabilities(queryCapabilities);
106 
107  // Supported file extensions capability
108 
109  std::set< std::string > supportedExtensionsSet;
110  for( std::map< std::string, DriverMetadata >::const_iterator it =
111  GetGDALDriversMetadata().begin() ; it !=
112  GetGDALDriversMetadata().end() ; ++it )
113  {
114  if( !it->second.m_extension.empty() )
115  {
116  if( supportedExtensionsSet.find( it->second.m_extension ) ==
117  supportedExtensionsSet.end() )
118  {
119  supportedExtensionsSet.insert( it->second.m_extension );
120  }
121  }
122  }
123 
124  std::string supportedExtensionsStr;
125  for( std::set< std::string >::const_iterator it = supportedExtensionsSet.begin() ;
126  it != supportedExtensionsSet.end() ; ++it )
127  {
128  if( !supportedExtensionsStr.empty() )
129  {
130  supportedExtensionsStr.append( ";" );
131  }
132  supportedExtensionsStr.append( *it );
133  }
134 
135  capabilities.addSpecificCapability( "SUPPORTED_EXTENSIONS", supportedExtensionsStr );
136 
138 
139  // initializing the static mutex
140  getStaticMutex();
141 
142  TE_LOG_TRACE(TE_TR("TerraLib GDAL driver startup!"));
143 
144  m_initialized = true;
145 }
146 
148 {
149  if(!m_initialized)
150  return;
151 
152 //! it finalizes the GDAL factory support.
154 
156 
157 //! free GDAL registered drivers
159 
160  TE_LOG_TRACE(TE_TR("TerraLib GDAL driver shutdown!"));
161 
162  m_initialized = false;
163 }
164 
166 
#define TE_LOG_TRACE(msg)
Use this tag in order to log a message to a specified logger with the TRACE level.
Definition: Logger.h:137
A class that informs what kind of constraint and index is supported by a given data source...
void startup()
This method will be called by TerraLib to startup some plugin's functionality.
Definition: Module.cpp:51
Utilitary functions to access GDAL and match some of its concepts to TerraLib concepts.
void setDataSetTypeCapabilities(const DataSetTypeCapabilities &capabilities)
void addSpecificCapability(const std::string &key, const std::string &value)
static void initialize()
It initializes the factory: the singleton instance will be registered in the abstract factory DataSou...
const std::map< std::string, DriverMetadata > & GetGDALDriversMetadata()
Returns metadata from all registered GDAL drivers (key: driver name).
Definition: Utils.cpp:918
static void setCapabilities(const te::da::DataSourceCapabilities &capabilities)
Definition: DataSource.cpp:155
te::da::QueryCapabilities queryCapabilities
A class that represents the known capabilities of a specific data source, i.e. this class informs all...
void setAccessPolicy(const te::common::AccessPolicy &accessPolicy)
Module(const te::plugin::PluginInfo &pluginInfo)
Plugin constructor.
Definition: Module.cpp:42
~Module()
Destructor.
Definition: Module.cpp:47
A class that informs what the dataset implementation of a given data source can perform.
#define TE_TR(message)
It marks a string in order to get translated.
Definition: Translator.h:347
te::da::DataSource * Build()
void setQueryCapabilities(const QueryCapabilities &capabilities)
te::da::DataSetTypeCapabilities dataSetTypeCapabilities
#define TE_GDAL_DRIVER_IDENTIFIER
Definition: Config.h:38
void setSupportTransactions(const bool &support)
A class that represents the supported data types of a specific data source.
te::da::DataTypeCapabilities dataTypeCapabilities
#define PLUGIN_CALL_BACK_IMPL(PLUGIN_CLASS_NAME)
This macro should be used by C++ plugins in order to declare the exportable/callable DLL function...
Definition: Config.h:57
A class that informs the query support of a given data source.
void shutdown()
This method will be called by TerraLib to shutdown plugin's functionality.
Definition: Module.cpp:147
static DataSourceManager & getInstance()
It returns a reference to the singleton instance.
te::da::DataSourceCapabilities capabilities
void setSupportRaster(const bool &support)
The TerraLib GDAL driver is a plugin.
Definition: Module.h:42
te::da::DataSetCapabilities dataSetCapabilities
void setDataSetCapabilities(const DataSetCapabilities &capabilities)
This is the concrete factory for GDAL rasters.
A factory for data sources.
void setDataTypeCapabilities(const DataTypeCapabilities &capabilities)
static void add(const std::string &dsType, FactoryFnctType f)
static void finalize()
It finalizes the factory: the singleton instance will be destroyed and will be unregistered from the ...
The basic information about a plugin.
Definition: PluginInfo.h:61
static void remove(const std::string &dsType)
TEGDALEXPORT boost::mutex & getStaticMutex()
Returns a reference to a static mutex initialized when this module is initialized.
Definition: Utils.cpp:912
The TerraLib OGR driver is a plugin.
Configuration flags for the GDAL Driver of TerraLib.
void setSupportEfficientDataSetSize(const bool &support)