com.supermap.services.util.cache

类 ImageCacheHelperImpl

java.lang.Object

com.supermap.services.util.cache.ImageCacheHelperImpl

所有已实现的接口:

ImageCacheHelper

public final class ImageCacheHelperImpl
extends java.lang.Object
implements ImageCacheHelper

缓存图片工具类，用于提供图片缓存目录计算方式。

构造器概要

构造器

构造器和说明
ImageCacheHelperImpl(java.lang.String outputDir, java.lang.String outputSite) 图片缓存的工具类，用于获取生成临时缓存的文件路径。
ImageCacheHelperImpl(java.lang.String outputDir, java.lang.String outputSite, java.lang.String tmpFolder) 图片缓存的工具类，用于获取生成临时缓存的文件路径。

方法概要

方法

限定符和类型	方法和说明
void	clearCache(java.lang.String mapName) 删除地图对应的所有缓存图片。
void	clearCache(java.lang.String mapName, java.lang.String cachePath) 删除地图对应的所有缓存图片。
java.lang.String	getCacheKey(MapParameter mapParam, ImageOutputOption outputOption) 获取缓存关键字，排除了范围中心点和图片大小等因素。
java.lang.String	getImageFileName(MapParameter mapParam, ImageOutputOption outputOption) 根据地图参数和图片输出设置，获取缓存图片的文件名。
java.lang.String	getImageURL(MapParameter mapParameter, ImageOutputOption outputOption) 根据地图参数和图片输出设置获取地图缓存图片的完整 URL 地址。
java.lang.String	getTempImageFileName(MapParameter mapParam, ImageOutputOption outputOption) 根据地图参数和图片输出设置，获取缓存图片的文件名。
java.lang.String	getTempKey(MapParameter mapParam, ImageOutputOption outputOption) 获取临时的缓存关键字，排除了范围中心点和图片大小等因素。
java.lang.String	pathToUrl(java.lang.String path)

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

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 - 缓存对应的目录