NaviDataManager (JNaviCore SDK Documentation)

java.lang.Object
- com.mapbar.mapdal.NaviDataManager

```
public class NaviDataManager
extends java.lang.Object
```
导航数据管理器类

Notice:

注意：所有的设置或更新操作都需要在主线程中完成

嵌套类概要

嵌套类
限定符和类型	类和说明
`class`	`NaviDataManager.ApplyErrorCode` 数据应用操作错误码
`class`	`NaviDataManager.Event` 导航数据管理器回调事件
`static interface`	`NaviDataManager.Listener` 导航数据管理器监听接口

构造器概要

构造器
构造器和说明

NaviDataManager()

构造器
构造器和说明
`NaviDataManager()`

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`android.graphics.Rect`	`_getBoundingBox(int provinceId, int tableId)`
`int`	`_getProvinceId(java.lang.String dataName)`
`int`	`_getTableId(java.lang.String dataName)`
`int`	`_getVersionLimit()`
`void`	`_setVersionLimit(int limit)`
`boolean`	`applyDataWithMoveFile(NaviDataEntity entity)` 应用数据描述体，应用过程中只是移动文件，用于更新全量数据
`void`	`cleanup()` 模块引擎销毁清理资源
`static java.lang.String`	`convertDatId2DbId(java.lang.String datId)` DAT格式数据Id转换成DB格式数据Id，示例：cn.0beijing.dat->cn.0beijing, cn.0beijing.pvf.free->cn.0beijing
`static java.lang.String[]`	`convertDbId2DatId(java.lang.String dbId)` DB格式数据Id转换成DAT格式数据Id，示例：cn.0beijing->cn.0beijing.dat, cn.0beijing.pvf.free
`void`	`deleteLocalData(NaviDataEntity entity)` 删除指定的本地数据对象信息，删除基础数据，即id为"cn.base"的数据对象时无效
`void`	`deleteLocalDataByIndex(int index)` 删除指定的本地数据
`NaviDataEntity`	`getEntityByDataId(java.lang.String dataId)` 通过数据描述体的Id获取其实例
`NaviDataEntity`	`getEntityByIndex(int index)` 根据数据描述体的索引获取其实例
`int`	`getEntityNumber()` 获取数据描述体的数量。
`static NaviDataManager`	`getInstance()` 获取单例类的实例
`java.lang.String`	`getUrlBase()` 获取基本url地址
`void`	`init()` 模块引擎初始化，必须在使用模块的其他功能之前调用此方法，且不能重复调用，需要和`cleanup()`成对出现
`boolean`	`isInited()` 导航数据管理模块是否已被初始化
`void`	`refreshDataStore()` 刷新数据商店，需要有网络连接，会触发`NaviDataManager.Event.datastoreRefreshCancel`, `NaviDataManager.Event.datastoreRefreshed`或 `NaviDataManager.Event.datastoreRefreshFailed`事件
`void`	`refreshDatastoreFromFile(java.lang.String file)` 刷新数据商店，指定本地数据商店文件，会触发`NaviDataManager.Event.datastoreRefreshCancel`, `NaviDataManager.Event.datastoreRefreshed`或 `NaviDataManager.Event.datastoreRefreshFailed`事件
`void`	`refreshLocalData()` 强制刷新entity。
`void`	`registerListener(NaviDataManager.Listener listener)` 注册监听器
`void`	`setDataFilter(java.lang.String filter)` 过滤dataId，通过get接口只能获取到`NaviDataEntity.dataId`满足过滤条件的 `NaviDataEntity`，默认："*"
`void`	`setPurchasedDataIds(java.lang.String dataIds)` 设置购买数据id，例如"cn.base, cn.cmr\|vip"
`void`	`setUrlBase(java.lang.String url)` 设置基本url地址
`void`	`unregisterListener(NaviDataManager.Listener listener)` 移除监听器

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - NaviDataManager
```
public NaviDataManager()
```
- 方法详细资料
  - getInstance
```
public static NaviDataManager getInstance()
```
    获取单例类的实例
    
    返回:
    
    该单例类NaviDataManager的实例
  - init
```
public void init()
          throws java.lang.Exception
```
    模块引擎初始化，必须在使用模块的其他功能之前调用此方法，且不能重复调用，需要和cleanup()成对出现
    
    抛出:
    
    java.lang.Exception
  - cleanup
```
public void cleanup()
```
    模块引擎销毁清理资源
    
    Notice:
    
    注意：模块销毁过程必须在主线程中调用。
  - isInited
```
public boolean isInited()
```
    导航数据管理模块是否已被初始化
    
    返回:
    
    如果初始化过则返回true,否则返回false
  - registerListener
```
public void registerListener(NaviDataManager.Listener listener)
```
    注册监听器
    
    参数:
    
    listener - 被注册的监听器NaviDataManager.Listener
  - unregisterListener
```
public void unregisterListener(NaviDataManager.Listener listener)
```
    移除监听器
    
    参数:
    
    listener - 需要移除的监听器 NaviDataManager.Listener
  - setUrlBase
```
public void setUrlBase(java.lang.String url)
```
    设置基本url地址
    
    参数:
    
    url - 被设置的url
    
    Notice:
    
    注意：该函数必须在主线程中调用。
  - getUrlBase
```
public java.lang.String getUrlBase()
```
    获取基本url地址
    
    返回:
    
    当前的url地址
  - getEntityNumber
```
public int getEntityNumber()
```
    获取数据描述体的数量。刷新refreshDataStore()或 refreshDatastoreFromFile(String)前，获取到的是已保存在本地的json中的信息
    
    返回:
    
    当前数据描述体的数量，未初始化时返回-1
  - getEntityByIndex
```
public NaviDataEntity getEntityByIndex(int index)
```
    根据数据描述体的索引获取其实例
    
    参数:
    
    index - 带获取数据描述体的索引
    
    返回:
    
    数据描述体NaviDataEntity,若为null则表示该模块未被初始化或该索引不存在对应数据描述体
  - getEntityByDataId
```
public NaviDataEntity getEntityByDataId(java.lang.String dataId)
```
    通过数据描述体的Id获取其实例
    
    参数:
    
    dataId - 数据描述体的Id
    
    返回:
    
    数据描述体NaviDataEntity,若为null则表示该模块未被初始化或该Id不存在对应数据描述体
  - refreshDataStore
```
public void refreshDataStore()
```
    刷新数据商店，需要有网络连接，会触发NaviDataManager.Event.datastoreRefreshCancel, NaviDataManager.Event.datastoreRefreshed或 NaviDataManager.Event.datastoreRefreshFailed事件
    
    Notice:
    
    注意：该函数必须在主线程中调用。
  - refreshDatastoreFromFile
```
public void refreshDatastoreFromFile(java.lang.String file)
```
    刷新数据商店，指定本地数据商店文件，会触发NaviDataManager.Event.datastoreRefreshCancel, NaviDataManager.Event.datastoreRefreshed或 NaviDataManager.Event.datastoreRefreshFailed事件
    
    参数:
    
    file - 数据商店json文件路径
  - applyDataWithMoveFile
```
public boolean applyDataWithMoveFile(NaviDataEntity entity)
```
    应用数据描述体，应用过程中只是移动文件，用于更新全量数据
    
    参数:
    
    entity - 被应用的数据描述体
    
    返回:
    
    应用是否有效
    
    另请参阅:
    
    #applyData(NaviDataEntity)
  - setPurchasedDataIds
```
public void setPurchasedDataIds(java.lang.String dataIds)
```
    设置购买数据id，例如"cn.base, cn.cmr|vip"
    
    参数:
    
    dataIds - 数据描述体的Id
    
    Notice:
    
    注意：该函数必须在主线程中调用。
  - setDataFilter
```
public void setDataFilter(java.lang.String filter)
```
    过滤dataId，通过get接口只能获取到NaviDataEntity.dataId满足过滤条件的 NaviDataEntity，默认："*"
    
    参数:
    
    filter - 过滤器，例如"cn.*, tts.*", "cn.*", "cn.base, tts.dongbeihua"
  - deleteLocalData
```
public void deleteLocalData(NaviDataEntity entity)
```
    删除指定的本地数据对象信息，删除基础数据，即id为"cn.base"的数据对象时无效
    
    参数:
    
    entity - 本地数据对象
  - deleteLocalDataByIndex
```
public void deleteLocalDataByIndex(int index)
```
    删除指定的本地数据
    
    参数:
    
    index - 待删除本地数据的数据描述体
    
    Notice:
    
    注意：该函数必须在主线程中调用。
  - refreshLocalData
```
public void refreshLocalData()
```
    强制刷新entity。适用于直接拷贝数据到数据目录中，刷新过程可能较慢，一般不推荐使用。
    刷新后，需要重新获取 NaviDataEntity
  - convertDbId2DatId
```
public static java.lang.String[] convertDbId2DatId(java.lang.String dbId)
```
    DB格式数据Id转换成DAT格式数据Id，示例：cn.0beijing->cn.0beijing.dat, cn.0beijing.pvf.free
    
    参数:
    
    dbId - db格式的数据id
    
    返回:
    
    dat格式数据id
  - convertDatId2DbId
```
public static java.lang.String convertDatId2DbId(java.lang.String datId)
```
    DAT格式数据Id转换成DB格式数据Id，示例：cn.0beijing.dat->cn.0beijing, cn.0beijing.pvf.free->cn.0beijing
    
    参数:
    
    datId - dat格式的数据id
    
    返回:
    
    db格式数据id
  - _setVersionLimit
```
public void _setVersionLimit(int limit)
```
  - _getVersionLimit
```
public int _getVersionLimit()
```
  - _getProvinceId
```
public int _getProvinceId(java.lang.String dataName)
```
  - _getTableId
```
public int _getTableId(java.lang.String dataName)
```
  - _getBoundingBox
```
public android.graphics.Rect _getBoundingBox(int provinceId,
                                             int tableId)
```

类 NaviDataManager

嵌套类概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

NaviDataManager

方法详细资料

getInstance

init

cleanup

isInited

registerListener

unregisterListener

setUrlBase

getUrlBase

getEntityNumber

getEntityByIndex

getEntityByDataId

refreshDataStore

refreshDatastoreFromFile

applyDataWithMoveFile

setPurchasedDataIds

setDataFilter

deleteLocalData

deleteLocalDataByIndex

refreshLocalData

convertDbId2DatId

convertDatId2DbId

_setVersionLimit

_getVersionLimit

_getProvinceId

_getTableId

_getBoundingBox