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空间数据库日渐完善后，离线编辑将变的更加简单，期待中。