ArcSDE C API

摘要：本文以一个C/C++实例分步讲述了利用ArcSDE C API向空间数据库中添加实体图形的方法。

利用ArcSDE8.1 C API向空间数据库中添加实体图形大致可分为六步。步骤如下：

第一步：与空间数据库建立连接。

SE_CONNECTION handle; //空间数据库连接对象

SE_ERROR Connect_error; //错误状态

LONG rc; //执行结果状态

CHAR server[30] = "LCR"; //空间数据库服务器名

CHAR instance[30] = "esri_sde"; //空间数据库实例名

CHAR database[30] = ""; //数据库名

CHAR user[30] = "sa"; //用户名

CHAR passwd[30] = "sapassword"; //密码



/* 创建连接 */

rc = SE_connection_create(

server, instance, database, user, passwd, &Connect_error, &handle);

/*错误检查 */

check_error (handle, NULL, rc, "SE_connection_create");



第二步：建立用户定义属性表。

LONG num_cols; //列数

SE_SHAPE shape; //形

SE_ENVELOPE rect; //矩形范围

LONG part_offsets[2], int_val;

CHAR **attrs; //属性列

CHAR column[32], table[32]; //列与表

SE_COORDREF coordref; //坐标系引用

SE_POINT pt[10]; //坐标点

SE_LAYERINFO layer; //层信息

SE_COLUMN_DEF *column_defs; //列定义对象

SE_STREAM stream; //数据流



/* 创建数据流连接 */

SE_stream_create (handle, &stream);

check_error (handle, NULL, rc, "SE_stream_create");



/* 创建用户表 */

strcpy(table, "MYTABLE");

num_cols = 1;

column_defs = (SE_COLUMN_DEF *) calloc (num_cols, sizeof(SE_COLUMN_DEF));

strcpy (column_defs[0].column_name, "ATTR_COL");

column_defs[0].sde_type = SE_INTEGER_TYPE; //为整形列

column_defs[0].nulls_allowed = TRUE; //允许为空

rc = SE_table_create(handle, table, num_cols, column_defs,"DEFAULTS");

check_error (handle, NULL, rc, "SE_table_create");

第三步：创建并设置图层信息。

/* 创建层的坐标系参考 */

rc = SE_coordref_create (&coordref);

check_error (handle, NULL, rc, "SE_coordref_create");

//设置假定坐标源点与比例尺

rc = SE_coordref_set_xy (coordref,0,0,10000);

check_error (handle, NULL, rc, "SE_coordref_set_xy");

//分配并初始化层信息结构layer

rc = SE_layerinfo_create (coordref, &layer);

check_error (handle, NULL, rc, "SE_layerinfo_create");



//设置层的格网尺寸、允许的形类型、创建关键字和空间列

rc = SE_layerinfo_set_grid_sizes (layer,1000,0,0);

check_error (handle, NULL, rc, "SE_layerinfo_set_grid_sizes");

rc = SE_layerinfo_set_shape_types(layer, SE_NIL_TYPE_MASK |

SE_POINT_TYPE_MASK |

SE_LINE_TYPE_MASK |

SE_SIMPLE_LINE_TYPE_MASK |

SE_AREA_TYPE_MASK |

SE_MULTIPART_TYPE_MASK );

check_error(handle, NULL, rc, "SE_layerinfo_set_shape_types");

rc = SE_layerinfo_set_creation_keyword (layer, "DEFAULTS");

check_error (handle, NULL, rc, "SE_layerinfo_set_creation_keyword");

strcpy(column, "SPATIAL_COL");

rc = SE_layerinfo_set_spatial_column (layer, table, column);

check_error (handle, NULL, rc, "SE_layerinfo_set_spatial_column");



/* 创建层 */

rc = SE_layer_create (handle, layer, 0,0);

check_error (handle, NULL, rc, "SE_layer_create");



第四步：创建图形实体对象，并设置属性与空间列。

/* 创建形 */

rc = SE_shape_create (coordref, &shape);

check_error (handle, NULL, rc, "SE_shape_create");



/* 将表插入数据流 */

attrs = (CHAR **) malloc (sizeof(CHAR *) * 2);

attrs[0] = "ATTR_COL";

attrs[1] = column;

rc = SE_stream_insert_table (stream, table, 2, (const CHAR**) attrs);

check_error (handle, NULL, rc, "SE_stream_insert_table");



free (attrs);





/* 设置矩形的最值并产生矩形*/

rect.minx = 5000.0;

rect.miny = 1000.0;

rect.maxx = 8000.0;

rect.maxy = 4000.0;



//生成矩形

rc = SE_shape_generate_rectangle (&rect, shape);

check_error (handle, NULL, rc, "SE_shape_generate_rectangle");



/* 设定形和属性列 */

int_val = 2;

rc = SE_stream_set_integer (stream, 1, &int_val);

check_error (NULL, stream, rc, "SE_stream_set_integer");

rc = SE_stream_set_shape (stream, 2, shape);

check_error (NULL, stream, rc, "SE_stream_set_shape");

/*插入行 */

rc = SE_stream_execute (stream);

check_error (NULL, stream, rc, "SE_stream_execute");



/* 对面域设定坐标数组 – 一个中间有洞的矩形，并生成多边形 */

part_offsets[0] = 0;

pt[0].x = 1000.; pt[0].y = 1000.;

pt[1].x = 4000.; pt[1].y = 1000.;

pt[2].x = 4000.; pt[2].y = 4000.;

pt[3].x = 1000.; pt[3].y = 4000.;

pt[4].x = 1000.; pt[4].y = 1000.;

pt[5].x = 2000.; pt[5].y = 2000.;

pt[6].x = 2000.; pt[6].y = 3000.;

pt[7].x = 3000.; pt[7].y = 3000.;

pt[8].x = 3000.; pt[8].y = 2000.;

pt[9].x = 2000.; pt[9].y = 2000.;



//生成多边形

rc = SE_shape_generate_polygon (10,1,part_offsets,pt,NULL,NULL,shape);

check_error (handle, NULL, rc, "SE_shape_generate_polygon");



/* 设定形及属性列 */

int_val = 3;

rc=SE_stream_set_integer (stream, 1, &int_val);

check_error (NULL, stream, rc, "SE_stream_set_integer");

rc = SE_stream_set_shape (stream, 2, shape);

check_error (NULL, stream, rc, "SE_stream_set_shape");



/* 插入行 */

rc = SE_stream_execute (stream);

check_error (NULL, stream, rc, "SE_stream_execute");



第五步：释放资源，例如，形对象、坐标参考对象、数据流对象等。

SE_shape_free (shape);

SE_coordref_free (coordref);

SE_stream_free (stream);



第六步：关闭与空间数据库的连接。

SE_connection_free (handle);

第二篇

SE_CONNECTION Connection;

SE_STREAM Stream;

SE_SQL_CONSTRUCT *sqlc

SE_ERROR Connect_error;

LONG rc, population;

SHORT num_cols;

LFLOAT area;

CHAR *server, *instance, *database, *user, *passwd;

CHAR **attrs, *name;

 

/* Connect to ArcSDE */

rc = SE_connection_create

(server, instance, database, user, passwd, &Connect_error, &Connection);

/* See Error handling section for check_error function code. */

check_error(Connection, NULL, rc, "SE_connection_create");

 

/* Create a stream for the query */

rc = SE_stream_create (Connection, &Stream);

check_error(Connection, NULL, rc, "SE_stream_create");

 

/* Allocate an SE_SQL_CONSTRUCT */

rc = SE_sql_construct_alloc (1, &sqlc);

check_error(Connection, NULL, rc, "SE_sql_construct_alloc");

 

/* Fill in the details of the SQL query */

sqlc->where = malloc(20);

sqlc->num_tables = 1;

strcpy (sqlc->tables[0], "cities");

strcpy (sqlc->where, "population < 10000");

 

/* Define the number and names of the table columns to be returned */

num_cols = 3;

attrs = (CHAR **) malloc (num_cols * sizeof(CHAR *));

attrs[0] = "city_name";

attrs[1] = "area";

attrs[2] = "population";

 

/* Define the stream query */

rc = SE_stream_query (Stream, num_cols, attrs, sqlc);

check_error(NULL, Stream, rc, "SE_stream_query");

 

rc = SE_stream_execute (Stream);

/* Iterate over the results */

while (rc == SE_SUCCESS)

{

rc = SE_stream_fetch (Stream);

if (rc == SE_SUCCESS)

{

rc = SE_stream_get_string (Stream,1,name);

check_error(NULL, Stream, rc, "SE_stream_get_string");

 

rc = SE_stream_get_double (Stream,2,&area);

check_error(NULL, Stream, rc, "SE_stream_get_double");

 

rc = SE_stream_get_integer (Stream,3,&population);

check_error(NULL, Stream, rc, "SE_stream_get_integer");

 

/* Now do something with the name, area and population */

}

}

 

/* Release the stream when it is no longer needed */

rc = SE_stream_free (Stream);

free (attrs);

free (sqlc->where);

undefined undefined undefined undefinedSE_sql_construct_free (sqlc);

 

/* Disconnect from ArcSDE */

undefined undefined undefined undefinedSE_connection_free (Connection);