Deprecated API

Contents

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

Deprecated Interfaces

org.apache.wicket.IComponentBorder
please use IBehavior instead

org.apache.wicket.util.io.IObjectStreamFactory
replaced by ISerializer. In Wicket 1.5 the (de)serializator is a pluggable piece,and can be coded regardless of the java.io API.

org.apache.wicket.markup.html.form.persistence.IValuePersister
remove in 1.5

org.apache.wicket.util.tester.TestPanelSource

Deprecated Classes

org.apache.wicket.ajax.markup.html.form.AjaxSubmitButton
Use AjaxButton instead.

org.apache.wicket.spring.injection.annot.AnnotSpringWebApplication
instead in application.init() do addComponentInstantiationListener(new SpringComponentInjector(this)); TODO remove post 1.3

org.apache.wicket.model.BoundCompoundPropertyModel
See CompoundPropertyModel.bind(String)

org.apache.wicket.markup.html.resources.CompressedPackageResourceReference
Will be renamed to CompressedResourceReference in Wicket 2.0

org.apache.wicket.markup.repeater.data.DefaultDataProvider
not very useful

org.apache.wicket.resource.DynamicByteArrayResource
use DynamicWebResource now

org.apache.wicket.validation.validator.EmailAddressPatternValidator
Use EmailAddressValidator instead. Don't forget to update your resource keys!

org.apache.wicket.markup.html.link.ImageMap
Use ClientSideImageMap

org.apache.wicket.extensions.ajax.markup.html.IndicatingAjaxSubmitButton
Use IndicatingAjaxButton instead.

org.apache.wicket.markup.html.link.InternalFrame
will be replaced by InlineFrame in Wicket 2.0 as that's a better name for it.

org.apache.wicket.validation.validator.NumberValidator
RangeValidator, MaximumValidator, MinimumValidator

org.apache.wicket.validation.validator.NumberValidator.DoubleMaximumValidator
see MaximumValidator

org.apache.wicket.validation.validator.NumberValidator.DoubleMinimumValidator
see MinimumValidator

org.apache.wicket.validation.validator.NumberValidator.DoubleRangeValidator
see RangeValidator

org.apache.wicket.validation.validator.NumberValidator.MaximumValidator
see MaximumValidator

org.apache.wicket.validation.validator.NumberValidator.MinimumValidator
see MinimumValidator

org.apache.wicket.validation.validator.NumberValidator.RangeValidator
see RangeValidator

org.apache.wicket.markup.html.PackageResourceReference
Use ResourceReference instead. This class will be removed in Wicket 2.0

org.apache.wicket.PageId
will be removed

org.apache.wicket.request.target.component.PageIdRequestTarget
will be removed before 1.5

org.apache.wicket.markup.html.link.PageLink
use BookmarkablePageLink or Link instead

org.apache.wicket.spring.SpringWebApplication
when using java5 it is preferrable to use SpringBean annotations for injection rather then this spring-specific application subclass with its helpers. To setup SpringBean add the following line to your WebApplication subclass init method addComponentInstantiationListener(new SpringComponentInjector(this));

org.apache.wicket.extensions.ajax.markup.html.WicketAjaxIndicatorAppender
Use AjaxIndicatorAppender instead.

org.apache.wicket.util.io.WicketObjectInputStream
in Wicket 1.5 the (de)serializator is a pluggable piece, if some customization is needed see the new framework settings

org.apache.wicket.util.io.WicketObjectOutputStream
in Wicket 1.5 the (de)serializator is a pluggable piece, if some customization is needed see the new framework settings

Deprecated Exceptions

org.apache.wicket.util.upload.FileUploadBase.UnknownSizeException
As of commons-fileupload 1.2, the presence of a content-length header is no longer required.

Deprecated Fields

org.apache.wicket.markup.html.PackageResource.EXTENSION_CSS
Will be removed in 2.0; contribute resources one by one instead

org.apache.wicket.markup.html.PackageResource.EXTENSION_JS
Will be removed in 2.0; contribute resources one by one instead

org.apache.wicket.util.upload.FileUploadBase.MAX_HEADER_SIZE
This constant is no longer used. As of commons-fileupload 1.2, the only applicable limit is the total size of a parts headers, MultipartStream#HEADER_PART_SIZE_MAX.

org.apache.wicket.validation.validator.NumberValidator.NEGATIVE
see MaximumValidator

org.apache.wicket.validation.validator.NumberValidator.POSITIVE
see MinimumValidator

org.apache.wicket.extensions.ajax.markup.html.autocomplete.AbstractAutoCompleteBehavior.preselect

Deprecated Methods

org.apache.wicket.ajax.AjaxRequestTarget.addJavascript(String)
use appendJavascript(String javascript) instead

org.apache.wicket.Session.attach()
will not be available in 1.5+

org.apache.wicket.MarkupContainer.autoAdd(Component)
since 1.3 Please use MarkupContainer.autoAdd(Component, MarkupStream) instead

org.apache.wicket.markup.html.PackageResource.bind(Application, Class, Pattern)
Since Wicket 1.2.1 this method is effectively a no-op. package resources are automatically tried and bound as shared resources so that they don't have to be pre-registered anymore. Will be removed in 2.0

org.apache.wicket.markup.html.PackageResource.bind(Application, Class, Pattern, boolean)
Since Wicket 1.2.1 this method is effectively a no-op. package resources are automatically tried and bound as shared resources so that they don't have to be pre-registered anymore. Will be removed in 2.0

org.apache.wicket.Component.callOnBeforeRenderIfNotVisible()
this was only useful for controlling visibility from inside Component.onBeforeRender(), with the addition of Component.onConfigure() this is now obsolete.

org.apache.wicket.util.tester.BaseWicketTester.callOnBeginRequest(RequestCycle)

org.apache.wicket.protocol.https.HttpsRequestCycleProcessor.checkSecure(IRequestTarget)
use checkSecureIncoming

org.apache.wicket.extensions.yui.calendar.DatePicker.configureWidgetProperties(Map)
Please use DatePicker.configure(Map) instead.

org.apache.wicket.util.upload.FileUploadBase.createItem(Map, boolean)
This method is no longer used in favour of internally created instances of FileItem.

org.apache.wicket.protocol.http.AbstractHttpSessionStore.createPageMap(String, Session)
remove after deprecation release

org.apache.wicket.protocol.http.RequestUtils.decode(String)
Use WicketURLDecoder instead.

org.apache.wicket.Application.destroy()
use Application.onDestroy() instead

org.apache.wicket.behavior.AbstractBehavior.detachModel(Component)
replaced by AbstractBehavior.detach(Component)

org.apache.wicket.protocol.http.RequestUtils.encode(String)
Use WicketURLEncoder instead.

org.apache.wicket.behavior.HeaderContributor.forCss(Class, String)
please use CSSPackageResource.getHeaderContribution() instead

org.apache.wicket.behavior.HeaderContributor.forCss(Class, String, String)
please use CSSPackageResource.getHeaderContribution() instead

org.apache.wicket.behavior.HeaderContributor.forCss(ResourceReference)
please use CSSPackageResource.getHeaderContribution() instead

org.apache.wicket.behavior.HeaderContributor.forCss(ResourceReference, String)
please use CSSPackageResource.getHeaderContribution() instead

org.apache.wicket.behavior.HeaderContributor.forCss(String)
please use CSSPackageResource.getHeaderContribution() instead

org.apache.wicket.behavior.HeaderContributor.forCss(String, String)
please use CSSPackageResource.getHeaderContribution() instead

org.apache.wicket.behavior.HeaderContributor.forJavaScript(Class, String)
please use JavascriptPackageResource.getHeaderContribution() instead

org.apache.wicket.behavior.HeaderContributor.forJavaScript(ResourceReference)
please use JavascriptPackageResource.getHeaderContribution() instead

org.apache.wicket.behavior.HeaderContributor.forJavaScript(String)
please use JavascriptPackageResource.getHeaderContribution() instead

org.apache.wicket.markup.html.PackageResource.get(Class, Pattern)
Will be removed in 2.0; contribute resources one by one instead

org.apache.wicket.markup.html.PackageResource.get(Class, Pattern, boolean)
Will be removed in 2.0; contribute resources one by one instead

org.apache.wicket.Component.getComponentBorder()

org.apache.wicket.Component.getConverter()
To be removed. Please use/ override Component.getConverter(Class) instead.

org.apache.wicket.protocol.http.WebApplication.getDefaultRequestCycleFactory()
Replaced by WebApplication.newRequestCycle(Request, Response)

org.apache.wicket.markup.html.panel.FeedbackPanel.getEscapeMessages()
use Component.getEscapeModelStrings() instead

org.apache.wicket.util.upload.FileUploadBase.getFieldName(Map)
Use FileUploadBase.getFieldName(FileItemHeaders).

org.apache.wicket.util.upload.FileUploadBase.getFileName(Map)
Use FileUploadBase.getFileName(FileItemHeaders).

org.apache.wicket.util.upload.FileUploadBase.getHeader(Map, String)
Use FileItemHeaders.getHeader(String).

org.apache.wicket.validation.validator.EmailAddressPatternValidator.getInstance()
Use EmailAddressValidator instead. Don't forget to update your resource keys!

org.apache.wicket.markup.html.form.Form.getJavascriptId()
use Component.getMarkupId()

org.apache.wicket.Application.getMarkupCache()
please use IMarkupSettings.getMarkupCache() instead

org.apache.wicket.model.Model.getObject(Component)
replace by IModel.getObject().

org.apache.wicket.model.CompoundPropertyModel.getObject(Component)
replace by IModel.getObject().

org.apache.wicket.model.AbstractReadOnlyModel.getObject(Component)
replace by IModel.getObject().

org.apache.wicket.extensions.model.AbstractCheckBoxModel.getObject(Component)
replaced by AbstractCheckBoxModel.getObject()

org.apache.wicket.markup.html.link.Link.getOnClickScript(String)
this method will be removed by Link.getOnClickScript(CharSequence) shortly. Please override that method instead.

org.apache.wicket.Page.getPageId()
This method will be removed before the final of 1.4

org.apache.wicket.markup.html.link.PopupSettings.getPageMap()
will be removed in Wicket 2.0; use PopupSettings.getPageMap(Component) instead

org.apache.wicket.markup.html.link.PopupSettings.getPageMap(Component)
Use getPageMapName instead. There is no need to eager create the pagemap object to create URLs. The pagemap will be created during the request cycle when user click on the link for this popup.

org.apache.wicket.protocol.http.MockHttpServletRequest.getRealPath(String)
Use ServletContext.getRealPath(String) instead.

org.apache.wicket.RequestCycle.getRedirect()
Use RequestCycle.isRedirect() instead

org.apache.wicket.Request.getRelativeURL()
Use Request.getURL() instead.

org.apache.wicket.Application.getRequestCycleFactory()
replaced by Application.newRequestCycle(Request, Response)

org.apache.wicket.protocol.http.WebApplication.getSessionAttributePrefix(WebRequest)
since 1.4RC3 please use WebApplication.getSessionAttributePrefix(WebRequest, String) instead

org.apache.wicket.protocol.http.MockHttpSession.getSessionContext()

org.apache.wicket.Application.getSessionFactory()
replaced by Application.newSession(Request, Response)

org.apache.wicket.Localizer.getString(String, Component, IModel, Locale, String, String)
please use Localizer.getString(String, Component, IModel, String)

org.apache.wicket.settings.Settings.getStripJavascriptCommentsAndWhitespace()
please us Settings.setJavascriptCompressor(IJavascriptCompressor) instead. Will be removed in 1.5

org.apache.wicket.settings.IResourceSettings.getStripJavascriptCommentsAndWhitespace()
please use IResourceSettings.getJavascriptCompressor() instead. Will be removed in 1.5

org.apache.wicket.settings.IExceptionSettings.getThrowExceptionOnMissingResource()
use IResourceSettings.getThrowExceptionOnMissingResource() instead

org.apache.wicket.protocol.http.MockHttpSession.getValue(String)
use getAttribute(String) instead

org.apache.wicket.protocol.http.MockHttpSession.getValueNames()
use getAttributeNames() instead

org.apache.wicket.markup.MarkupParser.initFilterChain()
since 1.3

org.apache.wicket.Component.internalAttach()

org.apache.wicket.Component.internalDetach()

org.apache.wicket.Component.isAncestorOf(Component)
use getParent().contains(component, false)

org.apache.wicket.AttributeModifier.isEnabled()

org.apache.wicket.behavior.SimpleAttributeModifier.isEnabled()
use isEnabled(Component) now.

org.apache.wicket.markup.html.form.CheckBoxMultipleChoice.isEscapeLabelMarkup()
use Component.setEscapeModelStrings(boolean)

org.apache.wicket.util.upload.FileUploadBase.isMultipartContent(HttpServletRequest)
Use the method on ServletFileUpload instead.

org.apache.wicket.extensions.model.AbstractCheckBoxModel.isSelected(Component)
replaced by AbstractCheckBoxModel.isSelected()

org.apache.wicket.validation.validator.NumberValidator.maximum(double)
see MaximumValidator

org.apache.wicket.validation.validator.NumberValidator.maximum(long)
see MaximumValidator

org.apache.wicket.markup.html.form.validation.AbstractFormValidator.messageModel()
use AbstractFormValidator.variablesMap() instead

org.apache.wicket.validation.validator.AbstractValidator.messageModel(FormComponent)
use AbstractValidator.variablesMap(IValidatable) instead

org.apache.wicket.validation.validator.NumberValidator.minimum(double)
see MinimumValidator

org.apache.wicket.validation.validator.NumberValidator.minimum(long)
see MinimumValidator

org.apache.wicket.extensions.yui.calendar.DateTimeField.newDateTextField(PropertyModel)
replaced by DateTimeField.newDateTextField(String, PropertyModel)

org.apache.wicket.extensions.yui.calendar.DateField.newDateTextField(PropertyModel)
replaced by DateField.newDateTextField(String, PropertyModel)

org.apache.wicket.Application.newRequestCycle(Application, Request, Response)
Applications wishing to provide custom request cycles should override method Application.newRequestCycle(Request, Response)

org.apache.wicket.protocol.http.WebApplication.newSession()
see WebApplication.newSession(Request, Response).

org.apache.wicket.protocol.http.WebApplication.newSession(Request)
WebApplication.newSession(Request, Response).

org.apache.wicket.Page.newVersionManager()
TODO Remove in 1.4

org.apache.wicket.model.Model.of(List)
see Model.ofList(List)

org.apache.wicket.model.Model.of(Map)
use Model.ofMap(Map)

org.apache.wicket.model.Model.of(Set)
replace by Model.ofSet(java.util.Set).

org.apache.wicket.Component.onAttach()

org.apache.wicket.Component.onBeginRequest()
use Component.onConfigure() or Component.onBeforeRender() instead

org.apache.wicket.Component.onEndRequest()
use onDetach() instead

org.apache.wicket.protocol.http.request.CryptedUrlWebRequestCodingStrategy.onError(Exception)
Use CryptedUrlWebRequestCodingStrategy.onError(Exception, String)

org.apache.wicket.model.AbstractPropertyModel.onGetObject(Component)
use AbstractPropertyModel.getObject() instead

org.apache.wicket.model.AbstractPropertyModel.onSetObject(Component, Object)
use AbstractPropertyModel.setObject(Object) instead

org.apache.wicket.util.upload.FileUploadBase.parseHeaders(String)
Use FileUploadBase.getParsedHeaders(String)

org.apache.wicket.util.upload.FileUploadBase.parseRequest(HttpServletRequest)
Use the method in ServletFileUpload instead.

org.apache.wicket.markup.html.form.Form.process()
use Form.process(IFormSubmittingComponent)

org.apache.wicket.markup.MarkupCache.putIntoCache(String, Markup)
see MarkupCache.putIntoCache(String, MarkupContainer, Markup)

org.apache.wicket.protocol.http.MockHttpSession.putValue(String, Object)
Use setAttribute(String, Object) instead

org.apache.wicket.validation.validator.NumberValidator.range(double, double)
see RangeValidator

org.apache.wicket.validation.validator.NumberValidator.range(long, long)
see RangeValidator

org.apache.wicket.protocol.http.MockHttpSession.removeValue(String)
Use removeAttribute(String) instead

org.apache.wicket.behavior.AbstractBehavior.rendered(Component)
replaced by AbstractBehavior.afterRender(Component)

org.apache.wicket.AttributeModifier.replaceAttibuteValue(Component, ComponentTag)
see AttributeModifier.replaceAttributeValue(Component, ComponentTag)

org.apache.wicket.validation.validator.AbstractValidator.resourceKey(FormComponent)
use AbstractValidator.resourceKey() instead

org.apache.wicket.markup.html.border.Border.setBorderBodyVisible(boolean)
1.3 please use #getBodyContainer().setVisible(false) instead

org.apache.wicket.Component.setComponentBorder(IComponentBorder)

org.apache.wicket.markup.html.panel.FeedbackPanel.setEscapeMessages(boolean)
use Component.setEscapeModelStrings(boolean)

org.apache.wicket.markup.html.form.FormComponent.setModelValue(String)
call or override setModelValue(String[])

org.apache.wicket.model.Model.setObject(Component, Object)
replace by IModel.setObject(Object).

org.apache.wicket.model.CompoundPropertyModel.setObject(Component, Object)
replace by IModel.setObject(Object).

org.apache.wicket.extensions.model.AbstractCheckBoxModel.setObject(Component, Object)
replaced by IModel.setObject(Object)

org.apache.wicket.extensions.model.AbstractCheckBoxModel.setSelected(Component, boolean)
replaced by AbstractCheckBoxModel.select()

org.apache.wicket.extensions.markup.html.repeater.data.sort.ISortStateLocator.setSortState(ISortState)
use ISortStateLocator.getSortState().setPropertySortOrder(...) instead

org.apache.wicket.protocol.http.MockHttpServletResponse.setStatus(int, String)

org.apache.wicket.settings.Settings.setStripJavascriptCommentsAndWhitespace(boolean)
please us Settings.setJavascriptCompressor(IJavascriptCompressor) instead. Will be removed in 1.5

org.apache.wicket.settings.IResourceSettings.setStripJavascriptCommentsAndWhitespace(boolean)
please us IResourceSettings.setJavascriptCompressor(IJavascriptCompressor) instead. Will be removed in 1.5

org.apache.wicket.settings.IExceptionSettings.setThrowExceptionOnMissingResource(boolean)
use IResourceSettings.setThrowExceptionOnMissingResource(boolean) instead

org.apache.wicket.feedback.FeedbackMessages.trimToSize()
because FeedbackMessages.messages is actually CopyOnWriteArrayList and cannot be trimmed. Will be removed in Wicket 1.5

org.apache.wicket.Session.update()
obsolete method (was meant for internal book keeping really). Clients should override Session.detach() instead.

org.apache.wicket.request.target.coding.AbstractRequestTargetUrlCodingStrategy.urlDecode(String)
Use urlEncodePathComponent or urlEncodeQueryComponent instead

org.apache.wicket.request.target.coding.AbstractRequestTargetUrlCodingStrategy.urlEncode(String)
Use urlEncodePathComponent or urlEncodeQueryComponent instead

org.apache.wicket.validation.validator.AbstractValidator.validate(FormComponent)
use AbstractValidator.variablesMap(IValidatable) instead

org.apache.wicket.model.Model.valueOf(List)
see Model.of(List)

org.apache.wicket.model.Model.valueOf(Map)
see Model.of(Map)

Deprecated Constructors

org.apache.wicket.ajax.markup.html.form.AjaxSubmitButton(String)
Use AjaxButton instead.

org.apache.wicket.ajax.markup.html.form.AjaxSubmitButton(String, Form)
Use AjaxButton instead.

org.apache.wicket.authentication.AuthenticatedWebSession(AuthenticatedWebApplication, Request)
Use AuthenticatedWebSession.AuthenticatedWebSession(Request)

org.apache.wicket.extensions.ajax.markup.html.autocomplete.AutoCompleteTextField(String, boolean)
use the constructor AutoCompleteTextField AutoCompleteTextField.AutoCompleteTextField(String, AutoCompleteSettings)

org.apache.wicket.extensions.ajax.markup.html.autocomplete.AutoCompleteTextField(String, IModel, boolean)
use the constructor AutoCompleteTextField AutoCompleteTextField.AutoCompleteTextField(String, IModel, AutoCompleteSettings)

org.apache.wicket.extensions.ajax.markup.html.autocomplete.AutoCompleteTextField(String, IModel, Class, boolean)
use the constructor AutoCompleteTextField AutoCompleteTextField.AutoCompleteTextField(String, IModel, Class, AutoCompleteSettings)

org.apache.wicket.extensions.ajax.markup.html.autocomplete.AutoCompleteTextField(String, IModel, Class, IAutoCompleteRenderer, boolean)
use the constructor AutoCompleteTextField AutoCompleteTextField.AutoCompleteTextField(String, IModel, Class, IAutoCompleteRenderer, AutoCompleteSettings)

org.apache.wicket.util.upload.FileUploadBase.SizeLimitExceededException()
Replaced by #SizeLimitExceededException(String, long, long)

org.apache.wicket.util.upload.FileUploadBase.SizeLimitExceededException(String)
Replaced by #SizeLimitExceededException(String, long, long)

org.apache.wicket.markup.html.form.validation.FormComponentFeedbackIndicator(String, IModel)
no need for a model in this component

org.apache.wicket.markup.html.panel.Fragment(String, String)
use Fragment.Fragment(String, String, MarkupContainer)

org.apache.wicket.markup.html.panel.Fragment(String, String, IModel)
use Fragment.Fragment(String, String, MarkupContainer, IModel)

org.apache.wicket.util.upload.MultipartFormInputStream()
Use #MultipartStream(InputStream, byte[], org.apache.wicket.util.uploadMultipartStream.ProgressNotifier) , or #MultipartStream(InputStream, byte[], int, org.apache.wicket.util.uploadMultipartStream.ProgressNotifier)

org.apache.wicket.util.upload.MultipartFormInputStream(InputStream, byte[])
Use MultipartFormInputStream.MultipartFormInputStream(InputStream, byte[], MultipartFormInputStream.ProgressNotifier) .

org.apache.wicket.util.upload.MultipartFormInputStream(InputStream, byte[], int)
Use #MultipartStream(InputStream, byte[], int, org.apache.wicket.util.uploadMultipartStream.ProgressNotifier) .

org.apache.wicket.request.target.component.PageIdRequestTarget(Page)

org.apache.wicket.request.target.component.PageIdRequestTarget(PageReference)

org.apache.wicket.markup.html.link.PageLink(String, Page)
rather than using this class/ constructor, use normal links and call setResponsePage in their onClick methods.

org.apache.wicket.PageParameters(String, String)
Please use RequestUtils.decodeParameters(String, ValueMap) to decode a request URL, or ValueMap.ValueMap(String, String) for other usecases.

org.apache.wicket.markup.html.link.PopupSettings(IPageMap)
Use the PopupSettings.PopupSettings(String)

org.apache.wicket.markup.html.link.PopupSettings(IPageMap, int)
Use the PopupSettings.PopupSettings(String, int)

org.apache.wicket.Session(Application, Request)
Use #Session(Request)

org.apache.wicket.request.target.basic.StringRequestTarget(String, Charset, String)
use StringRequestTarget.StringRequestTarget(String, String, String) instead

org.apache.wicket.protocol.http.WebSession(Application, Request)
Use #WebSession(Request) instead

org.apache.wicket.protocol.http.WebSession(WebApplication, Request)
Use #WebSession(Request)