构造器详细资料

• ImageCacheHelperImpl

  public ImageCacheHelperImpl(java.lang.String outputDir,
                      java.lang.String outputSite)
  

  图片缓存的工具类，用于获取生成临时缓存的文件路径。

  参数:

  outputDir -

  outputSite -

• ImageCacheHelperImpl

  public ImageCacheHelperImpl(java.lang.String outputDir,
                      java.lang.String outputSite,
                      java.lang.String tmpFolder)
  

  图片缓存的工具类，用于获取生成临时缓存的文件路径。

  参数:

  outputDir -

  outputSite -

方法详细资料

• getImageFileName

  public java.lang.String getImageFileName(MapParameter mapParam,
                                  ImageOutputOption outputOption)
  

  根据地图参数和图片输出设置，获取缓存图片的文件名。

  缓存图片的文件名格式为：{centerIndex}_{imageCacheKey}.{postfix}（图片中心点索引_缓存图片关键字.图片文件格式）。 默认的缓存图片为 PNG 格式。

  指定者:

  getImageFileName 在接口中 ImageCacheHelper

  参数:

  mapParam - 地图参数。

  outputOption - 图片输出设置。

  返回:

  缓存图片的文件名。

  另请参阅:

  DefaultUGCCachePolicy#getCenterIndex(MapParameter), DefaultUGCCachePolicy#getImageCacheKey(MapParameter,ImageOutputOption)

• getTempImageFileName

  public java.lang.String getTempImageFileName(MapParameter mapParam,
                                      ImageOutputOption outputOption)
  

  根据地图参数和图片输出设置，获取缓存图片的文件名。

  注意：每次服务重启后该方法获取的图片文件名都会不一栏；若要获取一个永久不变的文件名请使用getCacheKey(MapParameter,ImageOutputOption)

  缓存图片的文件名格式为：{centerIndex}_{imageCacheKey}.{postfix}（图片中心点索引_缓存图片关键字.图片文件格式）。 默认的缓存图片为 PNG 格式。

  指定者:

  getTempImageFileName 在接口中 ImageCacheHelper

  参数:

  mapParam - 地图参数。

  outputOption - 图片输出设置。

  返回:

  缓存图片的文件名。

  另请参阅:

  DefaultUGCCachePolicy#getCenterIndex(MapParameter), DefaultUGCCachePolicy#getImageCacheKey(MapParameter,ImageOutputOption)

• getImageURL

  public java.lang.String getImageURL(MapParameter mapParameter,
                             ImageOutputOption outputOption)
  

  根据地图参数和图片输出设置获取地图缓存图片的完整 URL 地址。

  地图缓存图片的完整 URL 地址格式为： {outputSite}/{cache}/{mapName}_{picWidth}x{picHeight}/{scaleRatio}/{regionInfo}/{centerIndex}_{imageCacheKey}.{postfix}。

  其中：

  1. outputSite 是图片访问地址的根目录，即图片通过 Web 服务器发布之后供客户端能够远程访问的图片 URL 地址的根目录。 默认为："http://localhost:8090/output"。
  2. cache 是使用缓存策略生成地图图片缓存的总目录，默认为“cache”。
  3. mapName 是地图名在整理（去除地图名中的前导空格和尾部空格）之后生成的哈希码。
  4. picWidth 和 picHeight 是缓存图片宽度（16 进制）和高度（16 进制），例如目录名为 **_200×200， 表示缓存的图片大小为 512×512 尺寸大小的图片，单位为像素。
  5. scaleRatio 是比例尺级别，同样比例尺的图片生成在同一个比例尺级别目录下。 当比例尺大于0小于等于1时，该目录名是 {[1/mapScale]}，[]表示取整；当比例尺大于1时，该目录名为 {N+mapScale}。
  6. regionInfo 表示空间区域，空间区域指的是将地图按照网格分块算法将一幅地图分为多个块，每一个分块表示一个空间区域。 空间区域的形式为 X×Y，X 值相同的目录表示是同一列的图片，Y 值相同的目录表示是同一行的图片， X 的值从地图左侧到右侧逐渐增大，Y 的值从下到上逐渐增大。
  7. centerIndex 是缓存图片的中心点索引。
  8. imageCacheKey 是缓存图片关键字。
  9. postfix 是文件的后缀名，表示图片文件格式。

  指定者:

  getImageURL 在接口中 ImageCacheHelper

  参数:

  mapParameter - 地图参数。

  outputOption - 图片输出设置。

  返回:

  地图缓存图片的完整 URL 地址。

• getCacheKey

  public java.lang.String getCacheKey(MapParameter mapParam,
                             ImageOutputOption outputOption)
  

  获取缓存关键字，排除了范围中心点和图片大小等因素。

  服务重启后，该关键字不会变化。

  指定者:

  getCacheKey 在接口中 ImageCacheHelper

  参数:

  mapParam -

  outputOption -

  返回:

• getTempKey

  public java.lang.String getTempKey(MapParameter mapParam,
                            ImageOutputOption outputOption)
  

  获取临时的缓存关键字，排除了范围中心点和图片大小等因素。

  服务重启后，该关键字会变化。

  指定者:

  getTempKey 在接口中 ImageCacheHelper

  参数:

  mapParam -

  outputOption -

  返回:

• pathToUrl

  public java.lang.String pathToUrl(java.lang.String path)
  

  指定者:

  pathToUrl 在接口中 ImageCacheHelper

• clearCache

  public void clearCache(java.lang.String mapName)
  

  删除地图对应的所有缓存图片。

  指定者:

  clearCache 在接口中 ImageCacheHelper

  参数:

  mapName -

• clearCache

  public void clearCache(java.lang.String mapName,
                java.lang.String cachePath)
  

  删除地图对应的所有缓存图片。

  指定者:

  clearCache 在接口中 ImageCacheHelper

  参数:

  mapName - 地图名

  cachePath - 缓存对应的目录