Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
play.cache.CacheApi Deprecated as of 2.6.0. Use SyncCacheApi or AsyncCacheApi.

Deprecated Classes

Class and Description
play.libs.Classpath Deprecated as of 2.6.0
play.Configuration Use Config instead.
play.Play Please use dependency injection. Deprecated since 2.5.0.
play.libs.ws.WS as of 2.6, this class is deprecated in favor of an injected WSClient.

Deprecated Fields

Field and Description
play.routing.Router.Tags.ROUTE_ACTION_METHOD Use Router.Attrs.HandlerDef instead.
play.routing.Router.Tags.ROUTE_COMMENTS Use Router.Attrs.HandlerDef instead.
play.routing.Router.Tags.ROUTE_CONTROLLER Use Router.Attrs.HandlerDef instead.
play.routing.Router.Tags.ROUTE_PATTERN Use Router.Attrs.HandlerDef instead.
play.routing.Router.Tags.ROUTE_VERB Use Router.Attrs.HandlerDef instead.

Deprecated Methods

Method and Description
play.mvc.Http.RequestHeader._underlyingHeader() As of release 2.6.0. Use Http.RequestHeader.asScala()
play.mvc.Http.Request._underlyingRequest() As of release 2.6.0. Use Http.Request.asScala()
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(JsonNode, String) As of 2.6.0, use badRequest(JsonNode, JsonEncoding)
play.Application.configuration()
play.inject.guice.GuiceBuilder.configure(Configuration)
play.libs.crypto.CSRFTokenSigner.constantTimeEquals(String, String) since 2.6.0. Use java.security.MessageDigest.isEqual over this method.
play.libs.crypto.DefaultCSRFTokenSigner.constantTimeEquals(String, String)
play.ApplicationLoader.Context.create(Environment) as of 2.6.0. Use ApplicationLoader.create(Environment).
play.ApplicationLoader.Context.create(Environment, Map<String, Object>) as of 2.6.0. Use ApplicationLoader.create(Environment, Map).
play.http.HttpRequestHandler.createAction(Http.Request, Method) Use ActionCreator instead.
play.mvc.Results.created(JsonNode, String) As of 2.6.0, use created(JsonNode, JsonEncoding)
play.data.DynamicForm.data()
play.data.Form.data() Deprecated as of 2.6.0. Use Form.rawData() instead which returns an unmodifiable map.
play.libs.concurrent.HttpExecution.defaultContext() Since 2.6.0, use HttpExecutionContext.current() from an action, or use HttpExecution.fromThread(ExecutionContext) with a dependency injected ExecutionContext or ActorSystem directly.
play.data.Form.discardErrors() Deprecated as of 2.6.0. Use Form.discardingErrors() instead.
play.data.DynamicForm.error(String) Deprecated as of 2.6.0. Use DynamicForm.getError(String) instead.
play.data.Form.error(String) Deprecated as of 2.6.0. Use Form.getError(String) instead.
play.data.Form.errors() Deprecated as of 2.6.0. Use Form.allErrors() instead.
play.libs.Files.TemporaryFile.file() Use path() over file().
play.mvc.Results.forbidden(JsonNode, String) As of 2.6.0, use forbidden(JsonNode, JsonEncoding)
play.server.Server.forRouter(Router) As of 2.6.0. Use Server.forRouter(Function)
play.server.Server.forRouter(Router, int) As of 2.6.0. Use Server.forRouter(int, Function)
play.server.Server.forRouter(Router, Mode) As of 2.6.0. Use Server.forRouter(Mode, Function)
play.server.Server.forRouter(Router, Mode, int) As of 2.6.0. Use Server.forRouter(Mode, int, Function)
play.Application.getFile(String) Deprecated as in 2.6.0. Use Environment.getFile(java.lang.String) instead.
play.cache.DefaultSyncCacheApi.getOrElse(String, Callable<T>) Use getOrElseUpdate instead (2.6.0)
play.cache.DefaultSyncCacheApi.getOrElse(String, Callable<T>, int) Use getOrElseUpdate instead (2.6.0)
play.libs.Classpath.getReflectionsConfiguration(String, ClassLoader) Deprecated as of 2.6.0
play.http.HandlerForRequest.getRequest() As of release 2.6.0. Use HandlerForRequest.getRequestHeader()
play.libs.Classpath.getTypes(Application, String) Deprecated as of 2.6.0
play.libs.Classpath.getTypes(Environment, String) Deprecated as of 2.6.0
play.libs.Classpath.getTypesAnnotatedWith(Application, String, Class<? extends Annotation>) Deprecated as of 2.6.0
play.libs.Classpath.getTypesAnnotatedWith(Environment, String, Class<? extends Annotation>) Deprecated as of 2.6.0
play.data.Form.globalError() Deprecated as of 2.6.0. Use Form.getGlobalError() instead.
play.mvc.Result.header() Deprecated as in 2.6.0. Use Result.getHeader()
play.ApplicationLoader.Context.initialConfiguration()
play.mvc.Results.internalServerError(JsonNode, String) As of 2.6.0, use internalServerError(JsonNode, JsonEncoding)
play.inject.guice.GuiceApplicationBuilder.load(BiFunction<Environment, Configuration, List<GuiceableModule>>) Use withModuleLoader instead
play.inject.guice.GuiceApplicationBuilder.loadConfig(Configuration) Use loadConfig(Config
play.inject.guice.GuiceApplicationBuilder.loadConfig(Function<Environment, Configuration>) Use withConfigLoader
play.data.Form.Field.name() Deprecated as of 2.6.0. Use Form.Field.getName() instead.
play.libs.ws.WS.newClient(int) as of 2.6, not to be used. This method is not appropriate outside of testing context, because it makes many assumptions about the url, starts up a new client and actorsystem on every call, and hardcodes the config to something other than the app config.
play.mvc.Results.notFound(JsonNode, String) As of 2.6.0, use notFound(JsonNode, JsonEncoding
play.mvc.Results.ok(JsonNode, String) As of 2.6.0, use ok(JsonNode, JsonEncoding)
play.data.format.Formatters.parse(Field, String, Class<T>) As of 2.6.0, use Formatters.parse(Field, String) instead
play.db.ebean.EbeanParsedConfig.parseFromConfig(Configuration) Configuration was deprecated in Play 2.6 in favor of Config. Use EbeanParsedConfig.parseFromConfig(Config)
play.mvc.Results.paymentRequired(JsonNode, JsonEncoding) As of 2.6.0, use paymentRequired(JsonNode, JsonEncoding)
play.i18n.Lang.preferred(List<Lang>) Please use preferred(app, langs). Deprecated since 2.5.0.
play.data.Form.reject(String) Deprecated as of 2.6.0. Use Form.withGlobalError(String) instead.
play.data.Form.reject(String, List<Object>) Deprecated as of 2.6.0. Use Form.withGlobalError(String, List) instead.
play.data.DynamicForm.reject(String, String) Deprecated as of 2.6.0. Use DynamicForm.withError(String, String) instead.
play.data.Form.reject(String, String) Deprecated as of 2.6.0. Use Form.withError(String, String) instead.
play.data.DynamicForm.reject(String, String, List<Object>) Deprecated as of 2.6.0. Use DynamicForm.withError(String, String, List) instead.
play.data.Form.reject(String, String, List<Object>) Deprecated as of 2.6.0. Use Form.withError(String, String, List) instead.
play.data.Form.reject(ValidationError) Deprecated as of 2.6.0. Use Form.withError(ValidationError) instead.
play.Application.resource(String) Deprecated as in 2.6.0. Use Environment.resource(String) instead.
play.Application.resourceAsStream(String) Deprecated as in 2.6.0. UseEnvironment.resourceAsStream(String) instead.
play.test.Helpers.route(Call) as of 2.6.0. Use Helpers.route(Application, Call).
play.test.Helpers.route(Call, long) as of 2.6.0. Use Helpers.route(Application, Call, long).
play.test.Helpers.route(Http.RequestBuilder) as of 2.6.0. Use Helpers#route(Application, RequestBuilder).
play.test.Helpers.route(Http.RequestBuilder, long) as of 2.6.0. Use Helpers#route(Application, RequestBuilder, long).
play.test.Helpers.routeAndCall(Class<? extends Router>, Http.RequestBuilder, long) as of 2.6.0. Use Helpers#routeAndCall(Application, Class, RequestBuilder, long).
play.test.Helpers.routeAndCall(Http.RequestBuilder, long) as of 2.6.0. Use Helpers#routeAndCall(Application, RequestBuilder, long).
play.test.Helpers.routeAndCall(Router, Http.RequestBuilder) as of 2.6.0. Use Helpers#routeAndCall(Application, Router, RequestBuilder).
play.test.Helpers.routeAndCall(Router, Http.RequestBuilder, long) as of 2.6.0. Use Helpers#routeAndCall(Application, RequestBuilder, long).
play.i18n.MessagesApi.scalaApi() As of release 2.6.0. Use MessagesApi.asScala()
play.mvc.StatusHeader.sendJson(JsonNode, String) As of 2.6.0, use sendJson(JsonNode, JsonEncoding)
play.libs.ws.ahc.StandaloneAhcWSRequest.setBody(InputStream) use StandaloneAhcWSRequest.setBody(Source) instead.
play.libs.ws.ahc.AhcWSRequest.setBody(InputStream)
play.libs.ws.StandaloneWSRequest.setBody(InputStream) use StandaloneWSRequest.setBody(Source) instead.
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, Integer, String, String, boolean, boolean, Http.Cookie.SameSite) Use Http.Response.setCookie(Http.Cookie) instead.
play.mvc.Results.status(int, JsonNode, String) As of 2.6.0, use status(int, JsonNode, JsonEncoding)
play.mvc.Http.RequestBuilder.tag(String, String) Use attr(key, value) instead.
play.mvc.Http.RequestHeader.tags() Use attr, withAttr, etc.
play.mvc.Http.RequestBuilder.tags() Use typed attributes, i.e. attrs(), instead.
play.mvc.Http.RequestBuilder.tags(Map<String, String>) Use attrs(...) instead.
play.db.Database.toScala() As of release 2.6.0. Use Database.asScala()
play.ApplicationLoader.Context.underlying() As of release 2.6.0. Use ApplicationLoader.Context.asScala()
play.Environment.underlying() As of release 2.6.0. Use Environment.asScala()
play.mvc.Http.Request.username() As of release 2.6, use attrs.get(Security.USERNAME) or attrs.getOptional(Security.USERNAME).
play.mvc.Http.RequestBuilder.username() Use attrs().get(Security.USERNAME) or attrs().getOptional(Security.USERNAME) instead.
play.mvc.Http.RequestBuilder.username(String) Use attr(Security.USERNAME, username) instead.
play.data.Form.Field.value() Deprecated as of 2.6.0. Use Form.Field.getValue() instead.
play.data.Form.Field.valueOr(String) Deprecated as of 2.6.0. Use Form.Field.getValue() instead.
play.ApplicationLoader.Context.withConfiguration(Configuration)
play.mvc.Http.CookieBuilder.withMaxAge(Integer) As of 2.6.0, use withMaxAge(Duration) instead.
play.mvc.Http.Request.withUsername(String) As of release 2.6, use req.withAttrs(req.attrs().put(Security.USERNAME, username)).
play.http.ActionCreator.wrapAction(Action) Use createAction and set play.http.actionComposition.executeActionCreatorActionFirst = true
play.http.HttpRequestHandler.wrapAction(Action) Use ActionCreator instead.

Deprecated Constructors

Constructor and Description
play.mvc.Http.Cookie(String, String, Integer, String, String, boolean, boolean) as of 2.6.0. Use Http.Cookie.builder(java.lang.String, java.lang.String).
play.DefaultApplication(Application, Configuration, Injector) Use the constructor that accepts Config
play.http.DefaultHttpErrorHandler(Configuration, Environment, OptionalSourceMapper, Provider<Router>)
play.data.DynamicForm(Map<String, String>, Map<String, List<ValidationError>>, Optional<DynamicForm.Dynamic>, MessagesApi, Formatters, Validator) Deprecated as of 2.6.0. Replace the parameter Map<String,List<ValidationError>> with a simple List<ValidationError>.
play.data.Form(String, Class<T>, Map<String, String>, Map<String, List<ValidationError>>, Optional<T>, Class<?>[], MessagesApi, Formatters, Validator) Deprecated as of 2.6.0. Replace the parameter Map<String,List<ValidationError>> with a simple List<ValidationError>.
play.data.Form(String, Class<T>, Map<String, String>, Map<String, List<ValidationError>>, Optional<T>, Class<?>, MessagesApi, Formatters, Validator) Deprecated as of 2.6.0. Replace the parameter Map<String,List<ValidationError>> with a simple List<ValidationError>.
play.data.Form(String, Class<T>, Map<String, String>, Map<String, List<ValidationError>>, Optional<T>, MessagesApi, Formatters, Validator) Deprecated as of 2.6.0. Replace the parameter Map<String,List<ValidationError>> with a simple List<ValidationError>.
play.mvc.Result(int, Optional<String>, Map<String, String>, HttpEntity) Deprecated as of 2.6.0. Use Result.Result(int, String, Map, HttpEntity).
play.routing.RoutingDsl() Deprecated as of 2.6.0. Use an injected version instead.