MapGuide Stuido提供了非常友好的用户界面来创建一个要素源,使用起来也非常简单,所以本节中不会介绍如何使用MapGuide Studio来创建要素源,而是介绍如何以编程的方式创建一个要素源。
最简单的编程式创建要素源的方法是调用MgFeatureService::CreateFeatureSource(…),它的方法签名如下所示,其中参数resource用于指定新建要素源的ID,sourceParams用于指定创建要素源所需的参数。目前,此方法只支持创建SDF类型的要素源,它首先会创建一个SDF文件,然后创建要素模式,最后为此SDF文件创建一个要素源。MapGuide的下一个版本(开源版2.2)即将支持创建SHP和sqlite类型的要素源。
void CreateFeatureSource( MgResourceIdentifier resource, MgFeatureSourceParams sourceParams); |
如下的代码展示了如何创建一个SDF的要素源,在调用方法CreateFeatureSource(…)之前需要创建一个MgCreateSdfParams的对象实例,MgCreateSdfParams继承自MgFeatureSourceParams,指定了新建SDF文件的要素模式、Spatial Context的名称和空间参考系。
$classDef = new MgClassDefinition(); $classDef->SetName("Buffer"); $classDef->SetDescription("Feature class for buffer layer"); $classDef->SetDefaultGeometryPropertyName("GEOM");
$identityProperties = $classDef->GetIdentityProperties(); $properties = $classDef->GetProperties();
$prop = new MgDataPropertyDefinition("KEY"); $prop->SetDataType(MgPropertyType::Int32); $prop->SetAutoGeneration(true); $prop->SetReadOnly(true); $identityProperties->Add($prop); $properties->Add($prop);
$prop = new MgDataPropertyDefinition("NAME"); $prop->SetDataType(MgPropertyType::String); $properties->Add($prop);
$ propGeom = new MgGeometricPropertyDefinition("GEOM"); $propGeom->SetGeometryTypes(MgFeatureGeometricType::Surface); $properties->Add($propGeom);
$schema = new MgFeatureSchema("BufferSchema","Temporary buffer schema"); $schemaClasses = $schema->GetClasses(); $schemaClasses->Add($classDef);
$wkt = "LOCAL_CS[/"Non-Earth (Meter)/",LOCAL_DATUM[/"Local Datum/",0], UNIT[/"Meter/",1],AXIS[/"X/",EAST],AXIS[/"Y/",NORTH]]"; $params = new MgCreateSdfParams("ArbitraryXY",$wkt,$schema); $resource = new MgResourceIdentifier( "Library://Samples/Data/CreateFeatureSourceTest.FeatureSource"); $featureService->CreateFeatureSource($resource,$params); |
如果打算创建其它类型的要素源,或者为已经存在的空间数据创建要素源,那么方法CreateFeatureSource(…)无法实现这些功能,此时我们需要调用资源服务MgResourceService::SetResource()来创建一个要素源。如果是文件类型的要素源,例如SHP、SDF或sqlite,还需要调用MgResourceService::SetResourceData()将文件上传到MapGuide资源库中。
如下的代码展示了如何根据一个已经存在的SDF文件创建要素源。
$resId = new MgResourceIdentifier( "Library://Samples/Data/Sheboygan_Parcels.FeatureSource"); // 设置要素源 $contentSource = new MgByteSource("Sheboygan_Parcels.FeatureSource"); $contentReader = contentSource->GetReader(); $resourceService->SetResource($resId,$contentReader,null);
// 上载要素源数据到资源库 $sdfFileName = "c:/Samples/Sheboygan_Parcels.sdf"; $dataSource = new MgByteSource($sdfFileName); $dataReader = dataSource->GetReader(); $featureService->SetResourceData($resId,"Sheboygan_Parcels.sdf","File",$dataReader); |
上面的代码中使用的要素源定义文件“Sheboygan_Parcels.FeatureSource”的内容如下,在指定FDO连接参数“File”的值时,此要素源定义使用了资源标签%MG_DATA_FILE_PATH%,要素服务在使用此要素源时,会将其替换为SDF文件在MapGuide服务器上实际的存储路径,关于更多资源标签的信息,请参考第六章2.5节资源标签。
<?xml version="1.0" encoding="UTF-8"?> <FeatureSource version="1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance " xsi:noNamespaceSchemaLocation="FeatureSource-1.0.0.xsd"> <Provider>OSGeo.SDF.3.4</Provider> <Parameter> <Name>File</Name> <Value>%MG_DATA_FILE_PATH%Sheboygan_Parcels.sdf</Value> </Parameter> <Parameter> <Name>ReadOnly</Name> <Value>TRUE</Value> </Parameter> </FeatureSource> |