6.4. 弃用了来自数据供应商和模型的方法

在迁移前：访问删除的 API 不会编译

session.userLocalStorage();

迁移后： 当调用者不依赖于旧的存储 API 时访问新的 API

session.users();

在迁移前：访问已删除的 API

session.userLocalStorage();

迁移后：通过 LegacyStoreManagers API 访问新功能

((LegacyDatastoreProvider) session.getProvider(DatastoreProvider.class)).userLocalStorage();

迁移前：因为更改的 API，代码不会编译

realm.getClientStorageProvidersStream()...;

迁移后：将实例转换为旧接口

((LegacyRealmModel) realm).getClientStorageProvidersStream()...;

迁移前：代码实现旧接口

public class MyClass extends RealmModel {
    /* might not compile due to @Override annotations for methods no longer present
       in the interface RealmModel. / / ... */
}

迁移后：代码实现新接口

public class MyClass extends LegacyRealmModel {
    /* ... */
}

在迁移前：代码不会编译[source,java,subs="+ quote"]

session**.userCache()**.evict(realm, user);

迁移后：直接使用 API

UserStorageUitl.userCache(session);

在迁移前：代码使用 cache API[source,java,subs="+ quotes"]

UserCache cache = session.getProvider(UserCache.class);
if (cache != null) cache.evict(realm)();

迁移后：使用无效 API

session.invalidate(InvalidationHandler.ObjectType.REALM, realm.getId());

在迁移前：访问已删除的 API

session.userCredentialManager().createCredential(realm, user, credentialModel)

迁移后：访问新的 API

user.credentialManager().createStoredCredential(credentialModel)

迁移前：因为 UserModel需要的新方法 credentialManager （），代码不会被编译

public class MyUserStorageProvider implements UserLookupProvider, ... {
    /* ... */
    protected UserModel createAdapter(RealmModel realm, String username) {
        return new AbstractUserAdapter(session, realm, model) {
            @Override
            public String getUsername() {
                return username;
            }
        };
    }
}

迁移后：为传统存储实施 API UserModel.credentialManager （）。

public class MyUserStorageProvider implements UserLookupProvider, ... {
    /* ... */
    protected UserModel createAdapter(RealmModel realm, String username) {
        return new AbstractUserAdapter(session, realm, model) {
            @Override
            public String getUsername() {
                return username;
            }

            @Override
            public SubjectCredentialManager credentialManager() {
                return new LegacyUserCredentialManager(session, realm, this);
            }
        };
    }
}