Deprecated List (Play 2.5.18)

Deprecated Interfaces
Interface and Description

play.test.FakeRequest
construct a Request using play.mvc.Http.RequestBuilder

play.mvc.WebSocket.Out
Use Akka Streams instead.

Deprecated Interfaces
Interface and Description
play.test.FakeRequest construct a Request using play.mvc.Http.RequestBuilder
play.mvc.WebSocket.Out Use Akka Streams instead.

Deprecated Classes
Class and Description
play.cache.Cache Please use an dependency injected instance of CacheApi.
play.libs.Crypto This class is deprecated and will be removed in future versions.
play.db.DB Use play.api.Database
play.libs.F.Promise Use the JDK8 `CompletionStage` instead. When migrating to CompletionStage, Promise implements CompletionStage, so it may be easier to first migrate all the existing method calls on the promise, such as map/flatMap, which are also deprecated but include migration instructions in the deprecation message.
play.libs.F.RedeemablePromise Use `CompletableFuture` instead.
play.test.FakeApplication as of 2.5.0. Use GuiceApplicationBuilder to build your application instance.
play.GlobalSettings This class is deprecated in 2.5.0. Please use dependency injection in preference to GlobalSettings.
play.http.GlobalSettingsHttpRequestHandler GlobalSettings is deprecated. Extend DefaultHttpRequestHandler instead.
play.libs.LegacyEventSource
play.mvc.LegacyWebSocket Use play.mvc.WebSocket instead.
play.libs.ws.ning.NingWSClient Use AhcWSClient instead
play.Play Please use dependency injection. Deprecated since 2.5.0.
play.mvc.Results.ByteChunks use `Source` instead.
play.mvc.Results.Chunks use `Source` instead.
play.mvc.Results.StringChunks use `Source` instead.
play.Routes as of 2.5. This class will be removed in future versions of Play.
play.mvc.WebSocket.In Use Akka Streams instead.

Deprecated Fields
Field and Description
play.Routes.ROUTE_ACTION_METHOD Use play.routing.Router.Tags.ROUTE_ACTION_METHOD
play.Routes.ROUTE_CONTROLLER Use play.routing.Router.Tags.ROUTE_CONTROLLER
play.Routes.ROUTE_PATTERN Use play.routing.Router.Tags.ROUTE_PATTERN
play.Routes.ROUTE_VERB Use play.routing.Router.Tags.ROUTE_VERB
play.i18n.Lang.underlyingLang All instances of play.i18n.Lang can be used as a play.api.i18n.Lang (2.5.1)

Deprecated Methods
Method and Description
play.Play.application() inject the `Application` instead. Deprecated since 2.5.0.
play.i18n.Lang.availables() Please use Lang.availables(app), since 2.5.0
play.mvc.Results.badRequest(Results.Chunks<?>) Use `Results.badRequest()` with `StatusHeader.chunked(akka.stream.javadsl.Source)` instead.
play.db.jpa.JPA.bindForAsync(EntityManager) Use JPAEntityManagerContext.push or JPAEntityManagerContext.pop
play.mvc.StatusHeader.chunked(Results.Chunks<T>) Use `StatusHeader.chunked(Source)` instead.
play.libs.ws.WS.client() Please use a WSClient instance using DI (since 2.5)
play.libs.Comet.close()
play.http.HttpRequestHandler.createAction(Http.Request, Method) Use ActionCreator instead.
play.mvc.Results.created(Results.Chunks<?>) Use `Results.created()` with `StatusHeader.chunked(akka.stream.javadsl.Source)` instead.
play.libs.Crypto.decryptAES(String) This method is deprecated and will be removed in future versions.
play.libs.Crypto.decryptAES(String, String) This method is deprecated and will be removed in future versions.
play.libs.F.Promise.delayed(Supplier<A>, long, TimeUnit) Use `Futures.delayed(Supplier, long, TimeUnit, Executor)` with `HttpExecution.defaultContext()` instead.
play.libs.F.Promise.delayed(Supplier<A>, long, TimeUnit, ExecutionContext) Use `Futures.delayed(Supplier, long, TimeUnit, Executor)` instead.
play.db.jpa.JPA.em(String)
play.libs.Crypto.encryptAES(String) This method is deprecated and will be removed in future versions.
play.libs.Crypto.encryptAES(String, String) This method is deprecated and will be removed in future versions.
play.test.Helpers.fakeApplication(GlobalSettings) Use dependency injection (since 2.5.0)
play.test.Helpers.fakeApplication(Map<String, ? extends Object>, GlobalSettings) Use the version without GlobalSettings (since 2.5.0)
play.test.Helpers.fakeGlobal() Use dependency injection (since 2.5.0)
play.libs.F.Promise.fallbackTo(F.Promise<A>) Use `F.Promise.handleAsync(BiFunction)` followed by `F.Promise.thenCompose(Function)` with the identity function.
play.libs.F.Promise.filter(Predicate<? super A>) Use `F.Promise.thenApplyAsync(Function, Executor)` to implement the filter manually.
play.libs.F.Promise.filter(Predicate<? super A>, ExecutionContext) Use `F.Promise.thenApplyAsync(Function, Executor)` to implement the filter manually.
play.libs.F.Promise.flatMap(Function<? super A, ? extends CompletionStage<B>>) Use `F.Promise.thenComposeAsync(Function, Executor)` with `HttpExecution.defaultContext()` if you want to capture the current context.
play.libs.F.Promise.flatMap(Function<? super A, ? extends CompletionStage<B>>, ExecutionContext) Use `F.Promise.thenComposeAsync(Function, Executor)`.
play.mvc.Results.forbidden(Results.Chunks<?>) Use `Results.forbidden()` with `StatusHeader.chunked(akka.stream.javadsl.Source)` instead.
play.data.Form.form() inject a `FormFactory` instead, since 2.5.0
play.data.Form.form(Class<T>) inject a `FormFactory` instead, since 2.5.0
play.data.Form.form(Class<T>, Class<?>...)
play.data.Form.form(Class<T>, Class<?>) inject a `FormFactory` instead, since 2.5.0
play.data.Form.form(String, Class<T>) inject a `FormFactory` instead, since 2.5.0
play.data.Form.form(String, Class<T>, Class<?>...)
play.data.Form.form(String, Class<T>, Class<?>) inject a `FormFactory` instead, since 2.5.0
play.i18n.Messages.get(Lang, List<String>, Object...) Please use messages.at(keys, args)
play.i18n.Messages.get(Lang, String, Object...) Please use messages.at(key, args). since 2.5.0
play.i18n.Messages.get(List<String>, Object...) use messages.at(keys, args). Deprecated since 2.5.0
play.libs.F.Promise.get(long) Calling get on a promise is a blocking operation and so introduces the risk of deadlocks and has serious performance implications.
play.libs.F.Promise.get(long, TimeUnit) Calling get on a promise is a blocking operation and so introduces the risk of deadlocks and has serious performance implications.
play.cache.Cache.get(String) Please use non-static cacheApi.get(key), deprecated since 2.5.0
play.i18n.Messages.get(String, Object...) use messages.at(key, args). Deprecated since 2.5.0
play.cache.Cache.getOrElse(String, Callable<T>, int) Please use non-static cacheApi.getOrElse, deprecated since 2.5.0
play.inject.guice.GuiceApplicationBuilder.global(GlobalSettings) use dependency injection, since 2.5.0
play.libs.Comet.initialBuffer()
play.mvc.Results.internalServerError(Results.Chunks<?>) Use `Results.internalServerError()` with `StatusHeader.chunked(akka.stream.javadsl.Source)` instead.
play.i18n.Messages.isDefined(Lang, String) Use messages.isDefinedAt(key). Deprecated since 2.5.0
play.i18n.Messages.isDefined(String) Use messages.isDefinedAt(key). Deprecated since 2.5.0
play.Play.isDev() inject the `Environment` instead. Deprecated since 2.5.0.
play.Play.isProd() inject the `Environment` instead. Deprecated since 2.5.0.
play.Play.isTest() inject the `Environment` instead. Deprecated since 2.5.0.
play.Routes.javascriptRouter(String, JavaScriptReverseRoute...) Use play.routing.JavaScriptReverseRouter.create
play.Routes.javascriptRouter(String, String, JavaScriptReverseRoute...) Use play.routing.JavaScriptReverseRouter.create
play.db.jpa.JPA.jpaApi() as of 2.5.0. Inject a JPAApi instead.
play.Play.langCookieHttpOnly() Deprecated since 2.5.0.
play.Play.langCookieName() Deprecated since 2.5.0.
play.Play.langCookieSecure() Deprecated since 2.5.0.
play.libs.F.Promise.map(Function<? super A, ? extends B>) Use `F.Promise.thenApplyAsync(Function, Executor)` with `HttpExecution.defaultContext()` if you want to capture the current context.
play.libs.F.Promise.map(Function<? super A, ? extends B>, ExecutionContext) Use `F.Promise.thenApplyAsync(Function, Executor)`
play.Play.mode() inject the `Environment` instead. Deprecated since 2.5.0.
play.mvc.Results.notFound(Results.Chunks<?>) Use `Results.notFound()` with `StatusHeader.chunked(akka.stream.javadsl.Source)` instead.
play.mvc.Results.ok(Results.Chunks<?>) Use `Results.ok()` with `StatusHeader.chunked(akka.stream.javadsl.Source)` instead.
play.libs.Comet.onConnected()
play.libs.Comet.onDisconnected(Runnable)
play.libs.F.Promise.onFailure(Consumer<Throwable>) Use `F.Promise.whenCompleteAsync(BiConsumer, Executor)` with `HttpExecution.defaultContext()` if you want to capture the current context.
play.libs.F.Promise.onFailure(Consumer<Throwable>, ExecutionContext) Use `F.Promise.whenCompleteAsync(BiConsumer, Executor)`.
play.libs.Comet.onReady(Results.Chunks.Out<String>)
play.libs.F.Promise.onRedeem(Consumer<? super A>) Use `F.Promise.thenAcceptAsync(Consumer, Executor)` with `HttpExecution.defaultContext()` instead.
play.libs.F.Promise.onRedeem(Consumer<? super A>, ExecutionContext) Use `F.Promise.thenAcceptAsync(Consumer, Executor)` instead.
play.libs.F.Promise.or(F.Promise<B>) Use `F.Promise.applyToEither(CompletionStage, Function)` instead.
play.mvc.Results.paymentRequired(Results.Chunks<?>) Use `Results.paymentRequired()` with `StatusHeader.chunked(akka.stream.javadsl.Source)` instead.
play.i18n.Lang.preferred(List<Lang>) Please use preferred(app, langs). Deprecated since 2.5.0.
play.libs.F.Promise.promise(Supplier<A>) Use `CompletableFuture.supplyAsync(Supplier, Executor)` instead.
play.libs.F.Promise.promise(Supplier<A>, ExecutionContext) Use `CompletableFuture.supplyAsync(Supplier, Executor)` instead.
play.test.WithApplication.provideFakeApplication() use the new `provideApplication` method instead.
play.test.WithServer.provideFakeApplication() use the new `provideApplication` method instead.
play.libs.F.Promise.pure(A) Use `CompletableFuture.completedFuture(Object)` instead.
play.db.jpa.JPAEntityManagerContext.pushOrPopEm(EntityManager, boolean) use push or pop methods
play.libs.F.Promise.recover(Function<Throwable, ? extends A>) Use `F.Promise.exceptionally(Function)` if you don't need the current context captured, or `F.Promise.handleAsync(BiFunction, Executor)` with `HttpExecution.defaultContext()` if you do.
play.libs.F.Promise.recover(Function<Throwable, ? extends A>, ExecutionContext) Use `F.Promise.handleAsync(BiFunction, Executor)` instead.
play.libs.F.Promise.recoverWith(Function<Throwable, ? extends CompletionStage<A>>) Use `F.Promise.exceptionally(Function)` if you don't need the current context captured, or `F.Promise.handleAsync(BiFunction, Executor)` with `HttpExecution.defaultContext()` if you do, then use `F.Promise.thenCompose(Function)` with the identity function to flatten the result.
play.libs.F.Promise.recoverWith(Function<Throwable, F.Promise<A>>, ExecutionContext) Use `F.Promise.handleAsync(BiFunction, Executor)` instead, followed by `F.Promise.thenCompose(Function)` with the identity function.
play.libs.openid.OpenID.redirectURL(String, String) Inject an OpenIdClient into your component.
play.libs.openid.OpenID.redirectURL(String, String, Map<String, String>) Inject an OpenIdClient into your component.
play.libs.openid.OpenID.redirectURL(String, String, Map<String, String>, Map<String, String>) Inject an OpenIdClient into your component.
play.libs.openid.OpenID.redirectURL(String, String, Map<String, String>, Map<String, String>, String) Inject an OpenIdClient into your component.
play.mvc.WebSocket.reject(Result) Use the WebSocket.accept*OrResult methods instead.
play.cache.Cache.remove(String) Please use non-static cacheApi.set(key,value,expiration), deprecated since 2.5.0
play.libs.Comet.sendMessage(JsonNode)
play.libs.Comet.sendMessage(String)
play.libs.F.Promise.sequence(ExecutionContext, F.Promise<A>...) Use `Futures.sequence(CompletionStage[])` instead.
play.libs.F.Promise.sequence(F.Promise<A>...) Use `Futures.sequence(CompletionStage[])` instead.
play.libs.F.Promise.sequence(Iterable<F.Promise<A>>) Use `Futures.sequence(Iterable)` instead.
play.libs.F.Promise.sequence(Iterable<F.Promise<A>>, ExecutionContext) Use `Futures.sequence(Iterable)` instead.
play.cache.Cache.set(String, Object)
play.cache.Cache.set(String, Object, int) Please use non-static cacheApi.set(key,value,expiration), deprecated since 2.5.0
play.libs.ws.WSRequest.setBody(InputStream) use `WSRequest.setBody(Source)` instead.
play.mvc.Http.Response.setContentType(String) noop. Use `Result.as(String)` instead.
play.mvc.Http.Response.setCookie(String, String) Use `Http.Response.setCookie(Http.Cookie)` instead.
play.mvc.Http.Response.setCookie(String, String, Integer) Use `Http.Response.setCookie(Http.Cookie)` instead.
play.mvc.Http.Response.setCookie(String, String, Integer, String) Use `Http.Response.setCookie(Http.Cookie)` instead.
play.mvc.Http.Response.setCookie(String, String, Integer, String, String) Use `Http.Response.setCookie(Http.Cookie)` instead.
play.mvc.Http.Response.setCookie(String, String, Integer, String, String, boolean, boolean) Use `Http.Response.setCookie(Http.Cookie)` instead.
play.mvc.Http.Request.setUsername(String) As of release 2.4, use `Http.Request.withUsername(java.lang.String)`
play.libs.Akka.system() Please use "@Inject ActorSystem actorSystem", since 2.5.0
play.libs.F.Promise.throwing(Throwable) Construct a new `CompletableFuture` and use `CompletableFuture.completeExceptionally(Throwable)` instead.
play.libs.F.Promise.timeout(A, long) Use `Futures.timeout(Object, long, TimeUnit)` instead.
play.libs.F.Promise.timeout(A, long, TimeUnit) Use `Futures.timeout(Object, long, TimeUnit)` instead.
play.libs.F.Promise.timeout(long) Use `Futures.timeout(long, TimeUnit)` instead.
play.libs.F.Promise.timeout(long, TimeUnit) Use `Futures.timeout(long, TimeUnit)` instead.
play.libs.F.Promise.transform(Function<? super A, ? extends B>, Function<Throwable, Throwable>) Use `F.Promise.handleAsync(BiFunction, Executor)` instead.
play.libs.F.Promise.transform(Function<? super A, ? extends B>, Function<Throwable, Throwable>, ExecutionContext) Use `F.Promise.handleAsync(BiFunction, Executor)` instead.
play.mvc.Results.unauthorized(Results.Chunks<?>) Use `Results.unauthorized()` with `StatusHeader.chunked(akka.stream.javadsl.Source)` instead.
play.libs.ws.WS.url(String) Please use a WSClient instance using DI (since 2.5)
play.libs.openid.OpenID.verifiedId() Inject an OpenIdClient into your component.
play.libs.Comet.whenConnected(String, Consumer<Comet>)
play.mvc.WebSocket.whenReady(BiConsumer<WebSocket.In<A>, WebSocket.Out<A>>) Use the WebSocket.accept* methods instead.
play.mvc.WebSocket.withActor(Function<ActorRef, Props>) Use the WebSocket.accept* methods instead, with a flow created by wrapping a Sink.actorRef and Source.actorRef.
play.db.jpa.JPA.withTransaction(Runnable) as of 2.5.0. Inject a JPAApi instead.
play.db.jpa.JPA.withTransaction(String, boolean, Supplier<T>) as of 2.5.0. Inject a JPAApi instead.
play.db.jpa.JPA.withTransaction(Supplier<T>) as of 2.5.0. Inject a JPAApi instead.
play.libs.F.Promise.wrap(Future<A>) Use `FutureConverters.toJava(Future)` instead.
play.http.ActionCreator.wrapAction(Action) Use createAction and set play.http.actionComposition.executeActionCreatorActionFirst = true
play.http.HttpRequestHandler.wrapAction(Action) Use ActionCreator instead.
play.libs.F.Promise.wrapped() Promise no longer wraps a Scala Future, use asScala instead.
play.libs.F.Promise.zip(CompletionStage<B>) Use `F.Promise.thenCombine(CompletionStage, BiFunction)` instead.

Deprecated Constructors
Constructor and Description
play.libs.Comet(String) Please use `Comet.string` or `Comet.json`, since 2.5.x
play.test.FakeApplication(File, ClassLoader, Map<String, ? extends Object>, GlobalSettings) Use the version without GlobalSettings, since 2.5.0
play.data.validation.ValidatorProvider(ConstraintValidatorFactory) as of 2.5.11. Use ValidatorProvider(ConstraintValidatorFactory, ApplicationLifecycle)

Deprecated API

Contents