DataConversion

java.lang.Object
- com.supermap.data.DataConversion

```
public class DataConversion
extends java.lang.Object
```
数据转换类。

提供数据的导入和导出功能。支持将移动端将SHP、MIF、DWG、DXF、tif/tiff、KML、KMZ、GPX数据导入到数据源中进行显示和编辑，也可以将移动端的数据导出为 SHP、MIF、DWG、DXF、tif/tiff、KML、KMZ、GPX格式用于与服务端或其他终端进行数据交互。

构造器概要

构造器
构造器和说明

DataConversion()

构造器
构造器和说明
`DataConversion()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static boolean`	`exportCSV(java.lang.String filepath, Dataset dataset)` 导出CSV文件, 文件已经存在，则导出失败
`static boolean`	`exportDWG(java.lang.String filepath, Dataset dataset)` 将指定数据集导出为dwg文件
`static boolean`	`exportDXF(java.lang.String filepath, Dataset dataset)` 将指定数据集导出为dxf文件
`static boolean`	`exportGPX(java.lang.String filepath, DatasetVector dataset)` 导出GPX文件, 文件已经存在，则导出失败
`static boolean`	`exportKML(java.lang.String filepath, Dataset dataset)` 导出kml文件 KML只支持矢量数据集进行导出数据集投影必须为地理坐标系WGS-1984
`static boolean`	`exportKMZ(java.lang.String filepath, Dataset dataset)` 导出kmz文件 KMZ只支持矢量数据集进行导出数据集投影必须为地理坐标系WGS-1984
`static boolean`	`exportMIF(java.lang.String filepath, Dataset dataset)` 导出MIF文件。
`static boolean`	`exportSHP(java.lang.String filepath, Dataset dataset)` 导出SHP文件。
`static boolean`	`exportTIF(java.lang.String filepath, Dataset dataset)` 将数据集导出为tif/tiff影像数据文件。
`static boolean`	`importCSV(ImportSettingCSV setting)` 根据CSV导入设置参数导入CSV数据。
`static boolean`	`importCSV(java.lang.String filepath, Datasource datasource)` 导入CSV文件
`static boolean`	`importDWG(ImportSettingDWG setting)` 根据导入参数，导入DWG数据
`static boolean`	`importDWG(java.lang.String filepath, Datasource datasource, boolean inverseBlackWhite)` 导入dwg文件到数据源，并保存为CAD数据集
`static boolean`	`importDWG(java.lang.String filepath, Datasource datasource, boolean inverseBlackWhite, boolean importAsCAD)` 导入dwg文件到数据源，并保存为CAD复合数据集或多个简单数据集
`static boolean`	`importDXF(ImportSettingDXF setting)` 根据导入参数，导入DXF数据
`static boolean`	`importDXF(java.lang.String filepath, Datasource datasource, boolean inverseBlackWhite)` 导入dxf文件到数据源，并保存为CAD数据集
`static boolean`	`importDXF(java.lang.String filepath, Datasource datasource, boolean inverseBlackWhite, boolean importAsCAD)` 导入dxf文件到数据源，并保存为CAD复合数据集或多个简单数据集
`static boolean`	`importGPX(java.lang.String filepath, Datasource datasource, java.lang.String targetDatasetName)` 导入GPX文件
`static boolean`	`importIMG(ImportSettingIMG setting)` 根据IMG导入设置参数导入IMG数据。
`static boolean`	`importIMG(java.lang.String filepath, Datasource datasource)` 将IMG影像以多波段模式导入到数据源。
`static boolean`	`importIMG(java.lang.String filepath, Datasource datasource, java.lang.String targetDatasetName)` 导入IMG影像到数据源。
`static boolean`	`importKML(java.lang.String filepath, Datasource datasource, java.lang.String targetDatasetName, boolean importAsCAD)` 导入kml文件
`static boolean`	`importKMZ(java.lang.String filepath, Datasource datasource, java.lang.String targetDatasetName, boolean importAsCAD)` 导入kmz文件
`static boolean`	`importMIF(java.lang.String filepath, Datasource datasource)` 导入MIF文件。
`static boolean`	`importSHP(ImportSettingSHP setting)` 根据shp参数导入shp数据
`static boolean`	`importSHP(java.lang.String filepath, Datasource datasource)` 导入SHP文件。
`static boolean`	`importTIF(ImportSettingTIF setting)` 根据导入参数，导入TIF影像数据
`static boolean`	`importTIF(java.lang.String filepath, Datasource datasource)` 导入tif/tiff影像数据文件到数据源，保存为影像数据集
`static boolean`	`importTIF(java.lang.String filepath, Datasource datasource, java.lang.String targetDatasetName, boolean bImportingAsGrid)` 导入tif影像到数据源, 可设置是否保存为栅格数据集
`static void`	`setConvertCharset(Charset charset)` 设置要导入或导出的文件原始字符集类型（非存储字符集）。
`static void`	`setImportEmptyDataset(boolean bImportEmptyDataset)` 设置是否导入为空数据集。

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - DataConversion
```
public DataConversion()
```
- 方法详细资料
  - importSHP
```
public static boolean importSHP(java.lang.String filepath,
                                Datasource datasource)
                         throws java.lang.Exception
```
    导入SHP文件。
    
    参数:
    
    filepath - 文件绝对路径，包含文件名以及文件类型后缀。
    
    datasource - 目标数据源。
    
    返回:
    
    如果导入成功返回 true，否则返回 false。
    
    抛出:
    
    java.lang.Exception - 参数错误时,抛出IllegalArgumentException; 如指定的文件不存在。
  - importSHP
```
public static boolean importSHP(ImportSettingSHP setting)
```
    根据shp参数导入shp数据
    
    参数:
    
    setting - shp设置参数
    
    返回:
    
    导入是否成功
  - importMIF
```
public static boolean importMIF(java.lang.String filepath,
                                Datasource datasource)
                         throws java.lang.Exception
```
    导入MIF文件。
    
    参数:
    
    filepath - 文件绝对路径，包含文件名以及文件类型后缀。
    
    datasource - 目标数据源。
    
    返回:
    
    如果导入成功返回 true，否则返回 false。
    
    抛出:
    
    java.lang.Exception - 参数错误时,抛出IllegalArgumentException; 如指定的文件不存在。
  - exportSHP
```
public static boolean exportSHP(java.lang.String filepath,
                                Dataset dataset)
                         throws java.lang.Exception
```
    导出SHP文件。
    
    参数:
    
    filepath - 导出文件绝对路径，包含文件名以及文件类型后缀。
    
    dataset - 用于导出的数据集。
    
    返回:
    
    如果导出成功返回 true，否则返回 false。
    
    抛出:
    
    java.lang.Exception - 参数错误时,抛出IllegalArgumentException; 如指定的目录不存在。
  - exportMIF
```
public static boolean exportMIF(java.lang.String filepath,
                                Dataset dataset)
                         throws java.lang.Exception
```
    导出MIF文件。
    
    参数:
    
    filepath - 导出文件绝对路径，包含文件名以及文件类型后缀。
    
    dataset - 用于导出的数据集。
    
    返回:
    
    如果导出成功返回 true，否则返回 false。
    
    抛出:
    
    java.lang.Exception - 参数错误时,抛出IllegalArgumentException; 如指定的目录不存在。
  - setConvertCharset
```
public static void setConvertCharset(Charset charset)
```
    设置要导入或导出的文件原始字符集类型（非存储字符集）。
    
    参数:
    
    charset - 字符集类型，默认为 GB18030。
  - importTIF
```
public static boolean importTIF(java.lang.String filepath,
                                Datasource datasource)
                         throws java.lang.Exception
```
    导入tif/tiff影像数据文件到数据源，保存为影像数据集
    
    参数:
    
    filepath - tif/tiff影像文件绝对路径，包含文件名以及文件类型后缀
    
    datasource - 数据源，用于存放导入结果数据集
    
    返回:
    
    导入成功返回true，否则返回false
    
    抛出:
    
    java.lang.Exception - 参数异常时，抛出异常
  - exportTIF
```
public static boolean exportTIF(java.lang.String filepath,
                                Dataset dataset)
                         throws java.lang.Exception
```
    将数据集导出为tif/tiff影像数据文件。
    
    参数:
    
    filepath - 指定的tif/tiff文件导出路径，该路径为绝对路径，包含文件名以及文件类型后缀
    
    dataset - 需要导出的影像数据集
    
    返回:
    
    导出成功返回true，否则返回false
    
    抛出:
    
    java.lang.Exception - 导出的文件必须是tif/tiff格式，否则会抛出异常
  - importDWG
```
public static boolean importDWG(java.lang.String filepath,
                                Datasource datasource,
                                boolean inverseBlackWhite)
                         throws java.lang.Exception
```
    导入dwg文件到数据源，并保存为CAD数据集
    
    参数:
    
    filepath - dwg文件绝对路径，包含文件名以及文件类型后缀
    
    datasource - 目标数据源
    
    inverseBlackWhite - 是否黑白反色
    
    返回:
    
    导入成功返回true, 否则返回false
    
    抛出:
    
    java.lang.Exception - 参数错误，文件类型不正确，抛出异常
  - exportDWG
```
public static boolean exportDWG(java.lang.String filepath,
                                Dataset dataset)
                         throws java.lang.Exception
```
    将指定数据集导出为dwg文件
    
    参数:
    
    filepath - 输出文件的绝对路径，包含文件名以及文件类型后缀
    
    dataset - 源数据集
    
    返回:
    
    导出成功返回true,否则返回false
    
    抛出:
    
    java.lang.Exception - 参数错误，文件类型不正确，抛出异常
  - importDXF
```
public static boolean importDXF(java.lang.String filepath,
                                Datasource datasource,
                                boolean inverseBlackWhite)
                         throws java.lang.Exception
```
    导入dxf文件到数据源，并保存为CAD数据集
    
    参数:
    
    filepath - dxf文件绝对路径，包含文件名以及文件类型后缀
    
    datasource - 目标数据源
    
    inverseBlackWhite - 是否黑白反色
    
    返回:
    
    导入成功返回true, 否则返回false
    
    抛出:
    
    java.lang.Exception - 参数错误，文件类型不正确，抛出异常
  - exportDXF
```
public static boolean exportDXF(java.lang.String filepath,
                                Dataset dataset)
                         throws java.lang.Exception
```
    将指定数据集导出为dxf文件
    
    参数:
    
    filepath - 输出文件绝对路径，包含文件名以及文件类型后缀
    
    dataset - 源数据集
    
    返回:
    
    导出成功返回true,否则返回false
    
    抛出:
    
    java.lang.Exception - 参数错误，文件类型不正确，抛出异常
  - importDXF
```
public static boolean importDXF(java.lang.String filepath,
                                Datasource datasource,
                                boolean inverseBlackWhite,
                                boolean importAsCAD)
                         throws java.lang.Exception
```
    导入dxf文件到数据源，并保存为CAD复合数据集或多个简单数据集
    
    参数:
    
    filepath - dxf文件绝对路径，包含文件名以及文件类型后缀
    
    datasource - 目标数据源
    
    inverseBlackWhite - 是否黑白反色
    
    importAsCAD - true表示存为单个CAD复合数据集，false表示保存为多个简单数据集
    
    返回:
    
    导入成功返回true, 否则返回false
    
    抛出:
    
    java.lang.Exception - 参数错误，文件类型不正确，抛出异常
  - importDWG
```
public static boolean importDWG(java.lang.String filepath,
                                Datasource datasource,
                                boolean inverseBlackWhite,
                                boolean importAsCAD)
                         throws java.lang.Exception
```
    导入dwg文件到数据源，并保存为CAD复合数据集或多个简单数据集
    
    参数:
    
    filepath - dwg文件绝对路径，包含文件名以及文件类型后缀
    
    datasource - 目标数据源
    
    inverseBlackWhite - 是否黑白反色
    
    importAsCAD - true表示存为单个CAD复合数据集，false表示保存为多个简单数据集
    
    返回:
    
    导入成功返回true, 否则返回false
    
    抛出:
    
    java.lang.Exception - 参数错误，文件类型不正确，抛出异常
  - importKML
```
public static boolean importKML(java.lang.String filepath,
                                Datasource datasource,
                                java.lang.String targetDatasetName,
                                boolean importAsCAD)
                         throws java.lang.Exception
```
    导入kml文件
    
    参数:
    
    filepath - 导入文件路径名
    
    datasource - 目标数据源
    
    targetDatasetName - 目标数据集名称
    
    importAsCAD - 是否导入为复合数据集，默认导入为复合数据集
    
    返回:
    
    导入成功返回true, 否则返回false
    
    抛出:
    
    java.lang.Exception - 参数错误，文件类型不正确，抛出异常
  - exportKML
```
public static boolean exportKML(java.lang.String filepath,
                                Dataset dataset)
                         throws java.lang.Exception
```
```
 导出kml文件
 KML只支持矢量数据集进行导出
 数据集投影必须为地理坐标系WGS-1984
 
```
    参数:
    
    filepath - 导出文件路径名
    
    dataset - 目标数据集s
    
    返回:
    
    导出成功返回true, 否则返回false
    
    抛出:
    
    java.lang.Exception - 参数错误，文件类型不正确，抛出异常
  - importKMZ
```
public static boolean importKMZ(java.lang.String filepath,
                                Datasource datasource,
                                java.lang.String targetDatasetName,
                                boolean importAsCAD)
                         throws java.lang.Exception
```
    导入kmz文件
    
    参数:
    
    filepath - 导入文件路径名
    
    datasource - 目标数据源
    
    targetDatasetName - 目标数据集名称
    
    importAsCAD - 是否导入为复合数据集，默认导入为复合数据集
    
    返回:
    
    导入成功返回true, 否则返回false
    
    抛出:
    
    java.lang.Exception - 参数错误，文件类型不正确，抛出异常
  - exportKMZ
```
public static boolean exportKMZ(java.lang.String filepath,
                                Dataset dataset)
                         throws java.lang.Exception
```
```
 导出kmz文件
 KMZ只支持矢量数据集进行导出
 数据集投影必须为地理坐标系WGS-1984
 
```
    参数:
    
    filepath - 导出文件路径名
    
    dataset - 目标数据集
    
    返回:
    
    导出成功返回true, 否则返回false
    
    抛出:
    
    java.lang.Exception - 参数错误，文件类型不正确，抛出异常
  - importTIF
```
public static boolean importTIF(java.lang.String filepath,
                                Datasource datasource,
                                java.lang.String targetDatasetName,
                                boolean bImportingAsGrid)
                         throws java.lang.Exception
```
    导入tif影像到数据源, 可设置是否保存为栅格数据集
    
    参数:
    
    filepath - tif数据文件路径
    
    datasource - 目标数据源
    
    targetDatasetName - 目标数据集名称
    
    bImportingAsGrid - 是否导入为栅格数据集，false则导入影像数据集
    
    返回:
    
    导入成功返回true，否则返回false
    
    抛出:
    
    java.lang.Exception - 参数错误，文件类型不正确，抛出异常
  - importGPX
```
public static boolean importGPX(java.lang.String filepath,
                                Datasource datasource,
                                java.lang.String targetDatasetName)
                         throws java.io.IOException
```
    导入GPX文件
    
    参数:
    
    filepath - 导入文件路径名
    
    datasource - 目标数据源
    
    targetDatasetName - 目标数据集名称
    
    返回:
    
    导入成功返回true，否则返回false
    
    抛出:
    
    java.io.IOException - 参数空指针异常等
  - exportGPX
```
public static boolean exportGPX(java.lang.String filepath,
                                DatasetVector dataset)
                         throws java.lang.Exception
```
    导出GPX文件, 文件已经存在，则导出失败
    
    参数:
    
    filepath - GPX只支持矢量数据集进行导出
    
    dataset - 数据集投影必须为地理坐标系WGS-1984
    
    返回:
    
    导出成功返回true，否则返回false
    
    抛出:
    
    java.lang.Exception - 参数空指针异常等
  - importDXF
```
public static boolean importDXF(ImportSettingDXF setting)
                         throws java.lang.Exception
```
    根据导入参数，导入DXF数据
    
    参数:
    
    setting - 导入参数
    
    返回:
    
    是否导入成功
    
    抛出:
    
    java.lang.Exception - 参数空指针异常等
  - importDWG
```
public static boolean importDWG(ImportSettingDWG setting)
                         throws java.lang.Exception
```
    根据导入参数，导入DWG数据
    
    参数:
    
    setting - 导入参数
    
    返回:
    
    是否导入成功
    
    抛出:
    
    java.lang.Exception - 参数空指针异常等
  - importTIF
```
public static boolean importTIF(ImportSettingTIF setting)
```
    根据导入参数，导入TIF影像数据
    
    参数:
    
    setting - 导入参数
    
    返回:
    
    是否导入成功
  - importIMG
```
public static boolean importIMG(java.lang.String filepath,
                                Datasource datasource)
                         throws java.lang.Exception
```
    将IMG影像以多波段模式导入到数据源。影像不支持单波段8位。
    
    参数:
    
    filepath - IMG数据文件路径
    
    datasource - 目标数据源
    
    返回:
    
    是否导入成功
    
    抛出:
    
    java.lang.Exception - 参数异常
  - importIMG
```
public static boolean importIMG(java.lang.String filepath,
                                Datasource datasource,
                                java.lang.String targetDatasetName)
                         throws java.lang.Exception
```
    导入IMG影像到数据源。影像不支持单波段8位。
    
    参数:
    
    filepath - IMG数据文件路径
    
    datasource - 目标数据源
    
    targetDatasetName - 目标数据集名称
    
    返回:
    
    是否导入成功
    
    抛出:
    
    java.lang.Exception - 参数异常
  - importIMG
```
public static boolean importIMG(ImportSettingIMG setting)
```
    根据IMG导入设置参数导入IMG数据。影像不支持单波段8位。
    
    参数:
    
    setting - IMG导入设置参数
    
    返回:
    
    是否导入成功
  - setImportEmptyDataset
```
public static void setImportEmptyDataset(boolean bImportEmptyDataset)
```
    设置是否导入为空数据集。默认不导入 , 如果导入数据为空, 导入时将返回false。目前暂时只支持shp文件。
    
    参数:
    
    bImportEmptyDataset - 是否导入空的数据集，true表示导入，false表示不导入
  - importCSV
```
public static boolean importCSV(java.lang.String filepath,
                                Datasource datasource)
```
    导入CSV文件
    
    参数:
    
    filepath - CSV文件绝对路径，包含文件名以及文件类型后缀
    
    datasource - 目标数据源
    
    返回:
    
    是否导入成功
  - importCSV
```
public static boolean importCSV(ImportSettingCSV setting)
```
    根据CSV导入设置参数导入CSV数据。
    
    参数:
    
    setting - CSV导入设置参数
    
    返回:
    
    是否导入成功
  - exportCSV
```
public static boolean exportCSV(java.lang.String filepath,
                                Dataset dataset)
```
    导出CSV文件, 文件已经存在，则导出失败
    
    参数:
    
    filepath - 导出文件路径名
    
    dataset - 目标数据集
    
    返回:
    
    是否导入成功

类 DataConversion

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

DataConversion

方法详细资料

importSHP

importSHP

importMIF

exportSHP

exportMIF

setConvertCharset

importTIF

exportTIF

importDWG

exportDWG

importDXF

exportDXF

importDXF

importDWG

importKML

exportKML

importKMZ

exportKMZ

importTIF

importGPX

exportGPX

importDXF

importDWG

importTIF

importIMG

importIMG

importIMG

setImportEmptyDataset

importCSV

importCSV

exportCSV