com.supermap.data

类 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()

方法概要

限定符和类型	方法和说明
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 - 目标数据集

返回:

是否导入成功