以下 WebSphere 工作区 API 和 SPI 在 Liberty 上不可用：

• com.ibm.websphere.workarea
• com.ibm.wsspi.workarea

该规则会在每个 Java 类中标记这些软件包的任何实例。 您必须修改应用程序，以使其可在 Liberty 上运行。

虽然没有完全相同的替代方案，但可以参考以下迁移建议。

评估使用情况

注意代码中使用了工作区 API 和 SPI 的哪些功能，并考虑需要哪些功能。 请参阅 com.ibm.websphere.workarea Javadoc。

较难迁移的功能包括

• 嵌套工作区
• 单向工作区
• 数据具有线程作用域
• 工作区配置了非默认的 PropertyModeType
• read_only
• fixed_normal
• fixed_readonly

潜在替代品

com.ibm.websphere.appserver.api.DistributedMap

• DistributedMap 访问 WebSphere 本地缓存以存储键、值 Object 成对
• 在 JNDI 在 services/cache/distributedmap
• 缓存可通过添加网络缓存提供程序（如 WebSphere eXtreme Scale

java.lang.ThreadLocal

• 可用于存储通用 Object 在线程范围内
• 每个访问 ThreadLocal （使用其 get 或 set 方法）有自己的、独立初始化的变量副本
• ThreadLocal 实例通常 private static 类中与线程状态相关联的字段（例如，用户 ID 或事务 ID）
• Java 8 Javadoc
• Java 21 实例

java.lang.InheritableThreadLocal

• 该类扩展了 ThreadLocal 以提供从父线程到子线程的值继承
• 创建子线程时，子线程会接收父线程有值的所有可继承线程本地变量的初始值
• Java 8 Javadoc

Database

• 如果您的数据需要持久保存或需要外部访问，将其存储在数据库中可能会比较合适
• 您可以配置数据源和 JDBC 驱动程序，这样在 Open Liberty 服务器上运行的应用程序就可以连接关系数据库，如 IBM Db2, PostgreSQL, Microsoft SQL Server 或 MySQL。 了解更多信息
• 您可以创建一个 CDI 生产者提供对 NoSQL 数据库的访问，如 MongoDB 或 CouchDB。 了解更多信息

DistributedMap 示例

本例说明了如何迁移到 DistributedMap 如果您的应用程序不需要任何难以迁移的功能（这些功能已在 " 评估使用情况 "部分列出）。

默认的 WebSphere 动态高速缓存实例是在管理控制台启用高速缓存时创建的，并绑定到全局 JNDI 名称的命名空间 services/cache/distributedmap.使用属性文件可以创建更多缓存实例 cacheinstances.properties 或通过定义一个 resource-ref 模块部署描述符中的缓存。

在 Open Liberty 文档中阅读更多内容并查看示例代码 DistributedMap:

• Enabling DistributedMap
• DistributedMap 文档
• DistributedMap 配置选项

UserWorkArea	DistributedMap
begin(java.lang.String name)	InitialContext ic = new InitialContext(); DistributedMap distributedMap = (DistributedMap)ic.lookup("services/cache/customObjCache");
complete()	大部分情况下不适用，但如果不再需要，可考虑在 DistributedMap 中使密钥失效 distributedMap.addChangeListener(...) distributedMap.invalidate(key)
get(java.lang.String key)	distributedMap.get(Object key) // returns Object
getMode(java.lang.String key)	不适用
getName()	不适用
remove(java.lang.String key)	distributedMap.addChangeListener(InvalidationListener listener) distributedMap.invalidate(Object key) 或者，您也可以设置 timeToLive 或 inactivityTime 设置或更新 Object 在 DistributedMap. distributedMap.put(Object key, Object value, int priority, int timeToLive, int inactivityTime, int sharingPolicy, Object[] dependencyIds)
retrieveAllKeys()	Set dmSet = distributedMap.keySet(boolean includeDiskCache); // returns Set String[] keys = dmSet.toArray(new String[0]);
set(java.lang.String key, java.io.Serializable value)	distributedMap.put(Object key, Object value) distributedMap.put(Object key, Object value, int priority, int timeToLive, int inactivityTime, int sharingPolicy, Object[] dependencyIds) distributedMap.put(Object key, Object value, int priority, int timeToLive, int sharingPolicy, Object[] dependencyIds)
set(java.lang.String key, java.io.Serializable value, PropertyModeType mode)	不适用

有关在 Liberty 上不受支持的其他 API 和 SPI 的信息，请参阅某些 API 和 SPI 在 Liberty 上不可用。