ArcGIS for Android离线数据编辑实现原理

来自：http://blog.csdn.net/arcgis_mobile/article/details/7565877

ArcGIS for Android中现已经提供了离线缓存图片的加载功能，极大的提高了我们访问地图的效率，对于离线的数据编辑暂时还不支持，而现在对于离线数据编辑操作的需求越来越多，那我们如何才能实现离线数据编辑功能呢？下面我们介绍一下，通过sqlite来实现离线数据编辑的解决方案。

    一、离线数据编辑解决方案

离线编辑无非就是将所需的数据下载到我们的手持端进行存储，当无法连接网络时，数据的读取、显示、编辑、保存都是通过本地数据库完成的；而后，当可以连接网络时,再将编辑的数据从手持端的数据库中提取出来进行在线数据提交。

    二、离线数据编辑实现步骤

根据上面的流程图我们来分析一下，实现离线数据编辑的步骤：

1、 通过ArcGIS Server来发布一个FeatureService服务用于数据下载或上传;

2、 手持端编写通过服务请求业务数据的代码；

在手持端编写下载数据的代码，通过FeatureService服务进行数据的下载，代码如下：

Query query = new Query();

query.setOutFields(new String[] {"*" });                 query.setInSpatialReference(featureLayer.getSpatialReference());

query.setWhere("objectid in ("+where+")");

flayer.selectFeatures(query, ArcGISFeatureLayer.SELECTION_METHOD.NEW,new CallbackListener<FeatureSet>() {

publicvoid onError(Throwable e) {

}

publicvoid onCallback(FeatureSet queryResults) {

}

});

3、 在手持端创建数据库和业务数据表；

在手持端中，我们需要数据库来存储业务数据，因此我们需要创建Sqlite数据库和相应的业务表。

在创建数据库时，我们可以通过扩展Android的帮助类SQLiteOpenHelper来维护和操作数据库和表，创建的表要与我们下载的业务数据的表结构一致。

public class DatabaseHelper extends SQLiteOpenHelper {

public static final String SYSTEM_TABLE = "sqlite_master";

private static final int VERSION=1;

public static final String TABLEORFIELDS =  "tableOrfields";

public static final String TABLENAME = "Environment";

public DatabaseHelper(Context context, String name, CursorFactory factory,

int version) {

super(context, name, factory, version);

// TODO Auto-generated constructor stub

}

public DatabaseHelper(Context context, String name){

this( context,  name,VERSION);

}

public DatabaseHelper(Context context, String name,int version){

this(context,name,null,version);

}

@Override

public void onCreate(SQLiteDatabase db) {

//创建的表结构

String sql = "CREATE TABLE IF NOT EXISTS  "+TABLENAME+"(OBJECTID INTEGER,CODE INTEGER,省名 TEXT,县区名 TEXT,土地覆盖 TEXT, SHAPE TEXT, MARK INT) ";

db.execSQL(sql);

}

@Override

public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {

// TODO Auto-generated method stub

}

}

4、 将下载的数据存储到创建的数据库中；

将第2步下载的要素数据，储存到事先创建好的数据库中，要素的属性我们可以直接存储到我们创建的表中，由于sqlite数据库不支持空间数据类型，因此对于要素的空间几何的存储成为要点，对此，我们可以将空间几何解析拼凑成定制的字符串进行存储，我们可以按照WKT格式拼字符串，如，点：point ( 10.05 10.28 )，线：linestring ((10.0510.28 , 20.95 20.89 ))，面：polygon ((10 10, 10 20, 20 20, 20 15, 10 10))。

将空间几何对象转成WKT的核心代码如下：

/**

* 将几何对象生成wkt字符串

*/

public static String GeometryToWKT(Geometry geometry){

if(geometry ==null){

return null;

}

String geoStr = "";

Geometry.Type type = geometry.getType();

if("Point".equals(type.name())){

Point pt = (Point)geometry;

geoStr = type.name()+"("+pt.getX() +" "+pt.getY()+")";

}else if("Polygon".equals(type.name()) ||"Polyline".equals(type.name())){

MultiPath pg = (MultiPath)geometry;

geoStr = type.name()+"("+"";

int pathSize = pg.getPathCount();

for(int j=0;j<pathSize;j++){

String temp = "(";

int size = pg.getPathSize(j);

for(int i=0;i<size;i++){

Point pt = pg.getPoint(i);

temp +=pt.getX() +" "+pt.getY()+",";

}

temp = temp.substring(0, temp.length()-1)+")";

geoStr +=temp+",";

}

geoStr = geoStr.substring(0, geoStr.length()-1)+")";

}else if("Envelope".equals(type.name())){

Envelope env = (Envelope)geometry;

geoStr = type.name()+"("+ env.getXMin() +","+env.getYMin()+","+env.getXMax()+","+env.getYMax()+")";

}else if("MultiPoint".equals(type.name())){

}else{

geoStr = null;

}

return geoStr;

}

将查询的数据插入到sqlite的核心代码：

//数据批量插入

private void insertGraphics(Graphic[] gps){

//开启事务，使用事务为了提高数据操作的效率

db.beginTransaction();

for(Graphic gp : gps){

ContentValues values = new ContentValues();

String[] attributs = gp.getAttributeNames();

for(String att : attributs){

Object attStr = gp.getAttributeValue(att);

String temp = "";

if(attStr ==null){

}else{

temp = gp.getAttributeValue(att).toString();

}

values.put(att,temp );

}

Geometry gt = gp.getGeometry();

String wktStr = GeometryToWKT(gt);

values.put("shape",wktStr);                                                       values.put("mark", 0);

db.insert(DatabaseHelper.TABLENAME,null, values);

}

db.setTransactionSuccessful();//设置事务成功

db.endTransaction();//结束事务

插入数据时启用Sqlite的事务机制，可以提高批量插入数据的速度。

5、 离线状态时，查询手持端数据库中的数据在设备上展示；

当我们要显示数据时，可以将数据库的数据查询出来，将查询的每条记录生成空间要素对象属性，将我们上面拼凑的字符串反解析生成空间要素对象，也就是将WKT数据格式解析成为一个空间要素对象。

将WKT数据字符串解析成空间几何对象的核心代码：

/**

* 将wkt字符串拼成几何对象

*/

public static Geometry WKTToGeometry(String wkt){

Geometry geo = null;

if(wkt ==null || wkt ==""){

return null;

}

String headStr = wkt.substring(0, wkt.indexOf("("));

String temp = wkt.substring(wkt.indexOf("(")+1, wkt.lastIndexOf(")"));

if(headStr.equals("Point")){

String[] values = temp.split(" ");

geo = new Point(Double.valueOf(values[0]),Double.valueOf(values[1]));

}else if(headStr.equals("Polyline") || headStr.equals("Polygon")){

geo = parseWKT(temp,headStr);

}else if(headStr.equals("Envelope")){

String[] extents = temp.split(",");

geo = new Envelope(Double.valueOf(extents[0]),Double.valueOf(extents[1]),Double.valueOf(extents[2]),Double.valueOf(extents[3]));

}else if(headStr.equals("MultiPoint")){

}else{

return null;

}

return geo;

}

private static Geometry parseWKT(String multipath,String type){

String subMultipath = multipath.substring(1, multipath.length()-1);

String[] paths;

if(subMultipath.indexOf("),(") >=0 ){

paths = subMultipath.split("),(");//多个几何对象的字符串

}else{

paths = new String[]{subMultipath};

}

Point startPoint = null;

MultiPath path = null ;

if(type.equals("Polyline")){

path = new Polyline();

}else{

path = new Polygon();

}

for(int i=0;i<paths.length;i++){

String[] points = paths[i].split(",");

startPoint = null;

for(int j=0;j<points.length;j++){

String[] pointStr = points[j].split(" ");

if(startPoint ==null){

startPoint = new Point(Double.valueOf(pointStr[0]),Double.valueOf(pointStr[1]));

path.startPath(startPoint);

}else{

path.lineTo(new Point(Double.valueOf(pointStr[0]),Double.valueOf(pointStr[1])));

}

}

}

return path;

}

6、 在设备上编辑要素数据；

对于要素的编辑可以分为两方面，一方面是属性的编辑，另一方面是空间编辑，对于这两方面的操作，官方提供的例子中提供了类似的功能（AttributeEditor和GeometryEditor两个例子）。

1)属性编辑

对于属性修改无非就是对Graphic对象的中的属性进行修改， Graphic不能添加事件监听，所以不能像按钮一样，添加一个点击事件弹出该要素的相关信息，我们可以通过GraphicsLayer的getGraphicIDs(float x, float y,int tolerance)方法来获取要素及其要素的相关属性，可悲是Graphic中没提供修改属性的接口，只能新建一个Graphic对象并在他的构造方法中来添加更新后的属性或者是通过GraphicsLayer的updateGraphic(int id,Map<String,Object> attributes)的方法来更新Graphic的属性，并且将修改的要素属性更新到本地sqlite数据库中及其修改表中mark字段的状态。

2)空间编辑

对于Graphic对象我们不仅可以改变他的属性还可以修改它的空间位置信息，对于点、线、面的修改略有不同。

点修改时，直接更新Graphic的Geometry即可，不过Graphic没有提供修改Geometry的接口，我们只能通过GraphicsLayer的updateGraphic(int id,Geometry geometry)方法来实现更新它的空间位置。

线和面的空间位置改变主要指的是线或面的节点的位置修改，我们可以点击线或面上的一个节点进行拖动用GeometryEngine.getNearestVertex()可以得到我们点击的点，距离几何体的哪个节点最近，并返回一个Proximity2DResult对象，通过这个对象我们可以得到这个节点Index位置，再通过线或面对象的setPoint(int index,Point point)方法更新节点，这时我们的图形就可以改变了，将更新后的Graphic的空间对象重新解析成定义的格式入库及其修改表中mark字段的状态。

7、 将编辑后的数据更新到设备数据库中；

将编辑后的数据通过第4步的方式更新到本地数据库中,更新数据的代码如下：

SQLiteDatabase db = this.getWritableDatabase();

db.beginTransaction();

db.update(table, values, whereClause, whereArgs);

db.setTransactionSuccessful();

db.endTransaction();

如果要多次更新时，可以使用sqlite数据库的事务机制，来提高执行效率。

8、 在线时通过ArcGIS Server的服务提交业务数据；

通过sqlite查询，将本地数据库中的数据查询出来，并将数据拼成空间要素对象，再通过FeatureService服务将数据更新到图层上。

更新数据代码如下：

Graphic[] gps = new Graphic[list.size()];

gps = list.toArray(gps);

featureLayerupdate.applyEdits(null, null, gps, null)

List为Graphic对象的列表，上面的操作是更新操作，如果需要添加或删除只需将Graphic数组放到不同的参数位置上即可。

到此，离线数据编辑操作基本完成，待日后spatialite空间数据库日渐完善后，离线编辑将变的更加简单，期待中。