Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Enums
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors
• Deprecated Enum Constants

Deprecated Interfaces

Interface and Description
org.forgerock.util.time.TimeService

Deprecated Classes

Class and Description
org.forgerock.json.jose.jwe.handlers.encryption.AbstractEncryptionHandler Use ContentEncryptionHandler instead.
org.forgerock.json.resource.AbstractRequestHandler RequestHandler now has default methods which implement the not-supported behavior. This class is here for transition from pre-JDK8 impelementations.
org.forgerock.util.time.ClockTimeService
org.forgerock.openig.openam.DeprecatedUserProfileFilter Since 6.5. Prefer to use the UserProfileFilter that does not require a SSO Token.
org.forgerock.json.jose.jwe.handlers.encryption.RSA15AES128CBCHS256EncryptionHandler Use RSAEncryptionHandler and AESCBCHMACSHA2ContentEncryptionHandler instead.
org.forgerock.json.jose.jwe.handlers.encryption.RSA15AES256CBCHS512EncryptionHandler Use RSAEncryptionHandler and AESCBCHMACSHA2ContentEncryptionHandler instead.
org.forgerock.json.resource.http.SecurityContextFactory This class will be removed once CAF has been migrated fully to CHF, at which point components should create SecurityContexts directly rather than via request attributes.
org.forgerock.json.jose.builders.SignedEncryptedJwsHeaderBuilder Use EncryptedThenSignedJwtHeaderBuilder instead.
org.forgerock.json.jose.jws.SignedEncryptedJwt Use EncryptedThenSignedJwt instead.
org.forgerock.json.jose.builders.SignedEncryptedJwtBuilder Use EncryptedThenSignedJwtBuilder instead.
org.forgerock.util.Utils Use Strings, Closeables, Objects or Threads instead.

Deprecated Enums

Enum and Description
org.forgerock.security.keystore.KeyStoreType Specify the keystore type string directly in preference to this enum, as it is extensible at runtime

Deprecated Fields

Field and Description
org.forgerock.json.schema.validator.Constants.DISALLOW removed in JSON schema draft 04
org.forgerock.json.schema.validator.Constants.DIVISIBLEBY renamed to multipleOf in JSON schema draft 04
org.forgerock.json.schema.validator.Constants.EXTENDS removed in JSON schema draft 04
org.forgerock.json.schema.validator.Constants.TYPE_ANY removed in JSON schema draft 04

Deprecated Methods

Method and Description
org.forgerock.util.Utils.asEnum(String, Class<T>) Use Strings.asEnum(String, Class)
org.forgerock.json.schema.validator.FailFastErrorHandler.assembleException()
org.forgerock.json.schema.validator.ErrorHandler.assembleException()
org.forgerock.json.schema.validator.CollectErrorsHandler.assembleException()
org.forgerock.json.jose.utils.Utils.base64urlDecode(String) Use Utils.decodeJwtComponent(String).
org.forgerock.json.jose.utils.Utils.base64urlEncode(String) Use Utils.encodeJwtComponent(String).
org.forgerock.util.Utils.closeSilently(Closeable...) Use Closeables.closeSilently(Closeable...)
org.forgerock.util.Utils.closeSilently(Iterable<? extends Closeable>) Use Closeables.closeSilently(Iterable)
org.forgerock.util.Utils.compareValues(Object, Object) Use Objects.compareValues(Object, Object)
org.forgerock.json.jose.jwk.store.JwksStoreService.configureJwksStore(String, Duration, Duration, URL) Use JwksStoreService.configureJwksStore(String, Duration, Duration, URL, Clock) with an explicit clock.
org.forgerock.util.thread.ExecutorServiceFactory.createCachedThreadPool() ExecutorServiceFactory.createCachedThreadPool(String) or ExecutorServiceFactory.createCachedThreadPool(ThreadFactory) should be used so that threads have meaningful names.
org.forgerock.util.thread.ExecutorServiceFactory.createFixedThreadPool(int) ExecutorServiceFactory.createFixedThreadPool(int, String) should be used so that threads have meaningful names.
org.forgerock.util.thread.ExecutorServiceFactory.createScheduledService(int) ExecutorServiceFactory.createScheduledService(int, String) should be used so that threads have meaningful names.
org.forgerock.util.thread.ExecutorServiceFactory.createThreadPool(int, int, long, TimeUnit, BlockingQueue<Runnable>) ExecutorServiceFactory.createThreadPool(int, int, long, TimeUnit, BlockingQueue, String) should be used so that threads have meaningful names.
org.forgerock.json.jose.jwe.handlers.encryption.EncryptionHandler.decryptContentEncryptionKey(Key, byte[]) Use EncryptionHandler.decryptContentEncryptionKey(Key, byte[], JweHeader) instead.
org.forgerock.json.jose.builders.JweHeaderBuilder.epk(String) Use JweHeaderBuilder.epk(JWK) instead.
org.forgerock.http.protocol.Form.fromString(String) use Form.fromFormString(String) instead.
org.forgerock.json.jose.jwe.handlers.encryption.EncryptionHandler.generateJWEEncryptedKey(Key, Key) Use EncryptionHandler.generateJWEEncryptedKey(Key, Key, JweHeader) instead.
org.forgerock.http.header.ContentTypeHeader.getAdditionalParameters() Replaced by ContentTypeHeader.getDirectives()
org.forgerock.json.jose.jwk.JWK.getAlgorithm() replaced by JWK.getJwaAlgorithm()
org.forgerock.openig.heap.Heap.getAll(Class<T>) marked in 6.5 with no functional equivalent
org.forgerock.json.jose.jwk.EcJWK.getCurve() replaced by EcJWK.getEllipticCurve().
org.forgerock.json.resource.ResourceException.getException(int) in favor of ResourceException.newResourceException(int)
org.forgerock.json.resource.ResourceException.getException(int, String) in favor of ResourceException.newResourceException(int, String)
org.forgerock.json.resource.ResourceException.getException(int, String, Throwable) in favor of ResourceException.newResourceException(int, String, Throwable)
org.forgerock.json.jose.jws.JwsAlgorithm.getJwsAlgorithm(String) Replaced by JwsAlgorithm.parseCryptographicAlgorithm(String)
org.forgerock.util.Utils.isBlank(CharSequence) Use Strings.isBlank(CharSequence)
org.forgerock.util.Utils.isCompatible(Object, Object) Use Objects.isCompatible(Object, Object)
org.forgerock.util.Utils.isNullOrEmpty(String) Use Strings.isNullOrEmpty(String)
org.forgerock.opendj.ldap.Dn.isRootDn() use Dn.isEmpty() instead
org.forgerock.util.Utils.joinAsString(StringBuilder, String, Iterable<?>) Use Strings.joinAsString(StringBuilder, String, Iterable)
org.forgerock.util.Utils.joinAsString(StringBuilder, String, Object...) Use Strings.joinAsString(StringBuilder, String, Object...)
org.forgerock.util.Utils.joinAsString(String, Iterable<?>) Use Strings.joinAsString(String, Iterable)
org.forgerock.util.Utils.joinAsString(String, Object...) Use Strings.joinAsString(String, Object...)
org.forgerock.json.resource.Resources.newAnnotatedRequestHandler(Object) Use Resources.newHandler(Object) instead.
org.forgerock.json.resource.Resources.newCollection(Object) Use Resources.newHandler(Object) instead.
org.forgerock.json.resource.http.CrestHttp.newHttpHandler(ConnectionFactory) Use CrestHttp.newHttpHandler(CrestApplication) instead.
org.forgerock.json.resource.http.CrestHttp.newHttpHandler(ConnectionFactory, Context) Use CrestHttp.newHttpHandler(CrestApplication) instead.
org.forgerock.json.resource.http.CrestHttp.newHttpHandler(ConnectionFactory, HttpContextFactory) Use CrestHttp.newHttpHandler(CrestApplication) instead.
org.forgerock.json.resource.http.CrestHttp.newHttpHandler(RequestHandler) Use CrestHttp.newHttpHandler(CrestApplication) instead.
org.forgerock.json.resource.Responses.newRemainingResultsResponse(String, int) Use Responses.newQueryResponse(String, CountPolicy, int) instead.
org.forgerock.json.resource.Resources.newSingleton(Object) Use Resources.newHandler(Object) instead.
org.forgerock.util.Utils.newThreadFactory(ThreadGroup, String, boolean) Use Threads.newThreadFactory(ThreadGroup, String, boolean)
org.forgerock.opendj.ldap.Dn.rootDn() use Dn.emptyDn() instead
org.forgerock.json.jose.builders.EncryptedJwtBuilder.sign(SigningHandler, JwsAlgorithm) Use EncryptedJwtBuilder.signedWith(SigningHandler, JwsAlgorithm) instead.
org.forgerock.http.protocol.Form.toString() use Form.toFormString() instead.
org.forgerock.http.oauth2.OAuth2Error.toWWWAuthenticateHeader() Use OAuth2Error.asWwwAuthenticateHeader() instead.
org.forgerock.security.keystore.KeyStoreBuilder.withKeyStoreType(KeyStoreType) Use withKeyStoreType(String) instead. Use of the KeyStoreType enum is deprecated as it restricts the keystore type to those specified in the enum. Library consumers may want to specify the keystore type at runtime.

Deprecated Constructors

Constructor and Description
org.forgerock.http.header.ContentTypeHeader(String, String, String) Replaced by ContentTypeHeader.ContentTypeHeader(String, Map)
org.forgerock.http.header.ContentTypeHeader(String, String, String, Map<String, String>) Replaced by ContentTypeHeader.ContentTypeHeader(String, Map)
org.forgerock.util.time.Duration(Long, TimeUnit) Prefer the use of Duration.duration(long, TimeUnit).
org.forgerock.json.jose.jwk.EcJWK(ECPublicKey, ECPrivateKey, KeyUse, String) Use the builder instead.
org.forgerock.json.jose.jwk.EcJWK(ECPublicKey, KeyUse, String) Use the builder instead.
org.forgerock.json.jose.jwk.EcJWK(KeyUse, String, String, String, String, String, String, String, List<String>) Use the builder instead.
org.forgerock.json.jose.jwk.EcJWK(KeyUse, String, String, String, String, String, String, String, String, List<String>) Use the builder instead.
org.forgerock.http.servlet.HttpFrameworkServlet(HttpApplication) Replaced by HttpFrameworkServlet.HttpFrameworkServlet(HttpApplication, boolean), which explicitly sets the trustTransactionIdHeader field
org.forgerock.json.jose.jwk.JWK(KeyType, KeyUse, String, String) Use the builder instead.
org.forgerock.json.jose.jwk.JWK(KeyType, KeyUse, String, String, String, String, List<String>) Use the builder instead.
org.forgerock.json.jose.jwk.OctJWK(KeyUse, String, String, String, String, String, List<String>) Use the builder instead.
org.forgerock.json.jose.jwk.RsaJWK(KeyUse, String, String, String, String, String, String, List<String>) Use the builder instead.
org.forgerock.json.jose.jwk.RsaJWK(KeyUse, String, String, String, String, String, String, String, List<String>) Use the builder instead.
org.forgerock.json.jose.jwk.RsaJWK(KeyUse, String, String, String, String, String, String, String, String, String, String, List<RsaJWK.PrimesInfo>, String, String, List<String>) Use the builder instead.
org.forgerock.json.jose.jwk.RsaJWK(KeyUse, String, String, String, String, String, String, String, String, String, String, String, List<String>) Use the builder instead.
org.forgerock.json.jose.jwk.RsaJWK(RSAPublicKey, KeyUse, String, String, String, String, List<String>) Use the builder instead.
org.forgerock.json.jose.jwk.RsaJWK(RSAPublicKey, RSAPrivateCrtKey, KeyUse, String, String, String, String, List<String>) Use the builder instead.
org.forgerock.json.jose.jwk.RsaJWK(RSAPublicKey, RSAPrivateKey, KeyUse, String, String, String, String, List<String>) Use the builder instead.
org.forgerock.json.jose.jws.handlers.RSASigningHandler(Key, SignatureUtil) Please use RSASigningHandler.RSASigningHandler(Key).
org.forgerock.http.filter.TransactionIdInboundFilter() Replaced by TransactionIdInboundFilter.TransactionIdInboundFilter(boolean)

Deprecated Enum Constants

Enum Constant and Description
org.forgerock.http.handler.HttpClientHandler.HostnameVerifier.ALLOW_ALL this should never be used as it is a security risk.