Deprecated API

Contents

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

Deprecated Interfaces

Interface and Description
org.eclipse.rap.rwt.service.IApplicationStore Use ApplicationContext instead.
org.eclipse.rap.rwt.theme.IControlThemeAdapter Use ControlThemeAdapter instead.
org.eclipse.rap.rwt.application.IEntryPoint use EntryPoint instead
org.eclipse.rap.rwt.application.IEntryPointFactory Use EntryPointFactory instead
org.eclipse.rap.rwt.lifecycle.ILifeCycle As of 2.0, PhaseListeners should only be registered in an ApplicationConfiguration. For new applications and custom widgets, consider the (still internal) RemoteObject API which is going to replace PhaseListener.
org.eclipse.rap.rwt.service.IResourceManager Use ResourceManager instead
org.eclipse.rap.rwt.service.IServiceHandler Use ServiceHandler instead.
org.eclipse.rap.rwt.service.IServiceManager Use ServiceManager instead
org.eclipse.rap.rwt.service.IServiceStore This interface will be removed in a future release without a replacement. If you need to store data in the scope of a request, consider to use the request object (e.g. HttpServletRequest#setAttribute(String, Object)).
org.eclipse.rap.rwt.service.ISessionStore Use UISession instead
org.eclipse.rap.rwt.service.ISettingStore Use SettingStore instead.
org.eclipse.rap.rwt.service.ISettingStoreFactory Use SettingStoreFactory instead.
org.eclipse.rap.rwt.lifecycle.IWidgetAdapter Use WidgetAdapter instead.
org.eclipse.rap.rwt.lifecycle.PhaseListener Support for PhaseListeners is going to be removed in the future.
org.eclipse.rap.rwt.lifecycle.WidgetAdapter This adapter interface was provided to facilitate the implementation of LCAs. New custom widgets should use the RemoteObject API instead of LCAs.
org.eclipse.rap.rwt.lifecycle.WidgetLifeCycleAdapter New custom widgets should use the RemoteObject API instead of LCAs.

Deprecated Classes

Class and Description
org.eclipse.rap.rwt.lifecycle.AbstractWidgetLCA New custom widgets should use the RemoteObject API instead of LCAs.
org.eclipse.rap.rwt.lifecycle.ControlLCAUtil New custom widgets should use the RemoteObject API instead of LCAs.
org.eclipse.rap.rwt.widgets.ExternalBrowser Use UrlLauncher instead
org.eclipse.rap.rwt.graphics.Graphics This class will be removed in future versions. For replacements, see the documentation of the single methods.
org.eclipse.rap.rwt.lifecycle.PhaseEvent Support for PhaseListeners is going to be removed in the future.
org.eclipse.rap.rwt.lifecycle.PhaseId Support for PhaseListeners is going to be removed in the future.
org.eclipse.rap.rwt.lifecycle.ProcessActionRunner New applications and custom widgets should not rely on lifecycle phases anymore, as this concept is going to be replaced. Use the RemoteObject API instead.
org.eclipse.rap.rwt.SessionSingletonBase use SingletonUtil instead
org.eclipse.rap.rwt.lifecycle.UICallBack This class will be removed in a future release. Use ServerPushSession instead to enable/disable server push.
org.eclipse.rap.rwt.lifecycle.WidgetLCAUtil New custom widgets should use the RemoteObject API instead of LCAs.
org.eclipse.rap.rwt.lifecycle.WidgetUtil Most of the helper methods in this class will not be supported in the next release. For the remaining methods, use org.eclipse.rap.rwt.widgets.WidgetUtil instead.

Deprecated Fields

Field and Description
org.eclipse.rap.rwt.lifecycle.WidgetUtil.CUSTOM_VARIANT Use RWT.CUSTOM_VARIANT instead
org.eclipse.rap.rwt.lifecycle.WidgetUtil.CUSTOM_WIDGET_ID For UI tests, use the web client JavaScript API to set HTML attributes that can be used to identify widgets. Details can be found in the Developers Guide Chapter "Scripting", section "Widget HTML".
org.eclipse.rap.rwt.lifecycle.WidgetUtil.ENABLE_UI_TESTS The system property has been moved to the internal class RWTProperties. Please look up the name in the documentation of WidgetUtil.CUSTOM_WIDGET_ID.

Deprecated Methods

Method and Description
org.eclipse.rap.rwt.lifecycle.UICallBack.activate(String) Use ServerPushSession.start() instead.
org.eclipse.rap.rwt.application.Application.addPhaseListener(PhaseListener) Support for PhaseListeners is going to be removed in the future.
org.eclipse.rap.rwt.service.ISessionStore.addSessionStoreListener(UISessionListener)
org.eclipse.rap.rwt.service.UISession.addSessionStoreListener(UISessionListener) Use addUISessionListener instead
org.eclipse.rap.rwt.service.ISettingStore.addSettingStoreListener(SettingStoreListener) Use SettingStore instead of ISettingStore.
org.eclipse.rap.rwt.lifecycle.AbstractWidgetLCA.adjustCoordinates(Widget, Rectangle) Adjustment of the widget bounds is now handled on the client.
org.eclipse.rap.rwt.widgets.ExternalBrowser.close(String)
org.eclipse.rap.rwt.lifecycle.UICallBack.deactivate(String) Use ServerPushSession.stop() instead.
org.eclipse.rap.rwt.lifecycle.WidgetUtil.find(Composite, String) Custom widgets that use RemoteObject should not require this method.
org.eclipse.rap.rwt.lifecycle.WidgetUtil.getAdapter(Widget) The WidgetAdapter interface was provided to facilitate the implementation of LCAs. New custom widgets should use the RemoteObject API instead of LCAs.
org.eclipse.rap.rwt.RWT.getApplicationStore() Use RWT.getApplicationContext() instead.
org.eclipse.rap.rwt.service.IApplicationStore.getAttribute(String) Use ApplicationContext instead of IApplicationStore.
org.eclipse.rap.rwt.service.ISessionStore.getAttribute(String)
org.eclipse.rap.rwt.service.ISettingStore.getAttribute(String) Use SettingStore instead of ISettingStore.
org.eclipse.rap.rwt.service.ISessionStore.getAttributeNames()
org.eclipse.rap.rwt.service.ISettingStore.getAttributeNames() Use SettingStore instead of ISettingStore.
org.eclipse.rap.rwt.graphics.Graphics.getAvgCharWidth(Font) Application code should not need to use this method. If you need an average character width, you can use GC.stringExtent(String) with a string of your choice and calculate the average width.
org.eclipse.rap.rwt.RWT.getBrowserHistory() use BrowserNavigation client service instead, see Client.getService(Class)
org.eclipse.rap.rwt.graphics.Graphics.getCharHeight(Font) Application code should not need to use this method. If you need this information, you can use GC.stringExtent(String) with a string of your choice and get the height of the result.
org.eclipse.rap.rwt.graphics.Graphics.getColor(int, int, int) Factory created resources are obsolete and will be removed in a future release. Use the constructor Color(Device, int, int, int) instead.
org.eclipse.rap.rwt.graphics.Graphics.getColor(RGB) Factory created resources are obsolete and will be removed in a future release. Use the constructor Color(Device, RGB) instead.
org.eclipse.rap.rwt.graphics.Graphics.getFont(FontData) Factory created resources are obsolete and will be removed in a future release. Use the constructor Font(Device, FontData) instead.
org.eclipse.rap.rwt.graphics.Graphics.getFont(String, int, int) Factory created resources are obsolete and will be removed in a future release. Use the constructor Font(Device, String, int, int) instead.
org.eclipse.rap.rwt.service.ISessionStore.getHttpSession()
org.eclipse.rap.rwt.lifecycle.IWidgetAdapter.getId() Use WidgetAdapter instead of IWidgetAdapter.
org.eclipse.rap.rwt.service.ISessionStore.getId()
org.eclipse.rap.rwt.service.ISettingStore.getId() Use SettingStore instead of ISettingStore.
org.eclipse.rap.rwt.lifecycle.WidgetUtil.getId(Widget) Use org.eclipse.rap.rwt.widgets.WidgetUtil#getId(Widget) instead.
org.eclipse.rap.rwt.graphics.Graphics.getImage(String) Factory created resources are obsolete and will be removed in a future release. Use the constructor Image(Device, InputStream)} instead.
org.eclipse.rap.rwt.graphics.Graphics.getImage(String, ClassLoader) Factory created resources are obsolete and will be removed in a future release. Use the constructor Image(Device, InputStream)} instead.
org.eclipse.rap.rwt.graphics.Graphics.getImage(String, InputStream) Factory created resources are obsolete and will be removed in a future release. Use the constructor Image(Device, InputStream)} instead.
org.eclipse.rap.rwt.lifecycle.WidgetUtil.getLCA(Widget) New custom widgets should use the RemoteObject API instead of LCAs.
org.eclipse.rap.rwt.RWT.getLifeCycle() As of 2.0, PhaseListeners should only be registered in an ApplicationConfiguration. For new applications and custom widgets, consider the RemoteObject API which is going to replace PhaseListener.
org.eclipse.rap.rwt.service.IResourceManager.getLocation(String) Use ResourceManager instead of IResourceManager
org.eclipse.rap.rwt.lifecycle.IWidgetAdapter.getParent() Use WidgetAdapter instead of IWidgetAdapter.
org.eclipse.rap.rwt.lifecycle.IWidgetAdapter.getPreserved(String) Use WidgetAdapter instead of IWidgetAdapter.
org.eclipse.rap.rwt.service.IResourceManager.getRegisteredContent(String) Use ResourceManager instead of IResourceManager
org.eclipse.rap.rwt.service.IServiceManager.getServiceHandlerUrl(String) Use ServiceManager instead of IServiceManager
org.eclipse.rap.rwt.RWT.getServiceStore() The interface IServiceStore is deprecated and will be removed in a future release without a replacement. If you need to store data in the scope of a request, consider to use the request object (e.g. HttpServletRequest#setAttribute(String, Object)).
org.eclipse.rap.rwt.application.ApplicationRunner.getServletPaths() This method is not part of the RAP API. It will be removed in future versions.
org.eclipse.rap.rwt.RWT.getSessionStore() Use RWT.getUISession() instead
org.eclipse.rap.rwt.lifecycle.WidgetUtil.getVariant(Widget) Application code should obtain the variant using Widget.getData(RWT.CUSTOM_VARIANT).
org.eclipse.rap.rwt.service.ISessionStore.isBound()
org.eclipse.rap.rwt.lifecycle.IWidgetAdapter.isInitialized() Use WidgetAdapter instead of IWidgetAdapter.
org.eclipse.rap.rwt.service.IResourceManager.isRegistered(String) Use ResourceManager instead of IResourceManager
org.eclipse.rap.rwt.service.ISettingStore.loadById(String) Use SettingStore instead of ISettingStore.
org.eclipse.rap.rwt.lifecycle.IWidgetAdapter.markDisposed(Widget) Use WidgetAdapter instead of IWidgetAdapter.
org.eclipse.rap.rwt.widgets.ExternalBrowser.open(String, String, int) Use UrlLauncher.openURL(String) instead
org.eclipse.rap.rwt.lifecycle.IWidgetAdapter.preserve(String, Object) Use WidgetAdapter instead of IWidgetAdapter.
org.eclipse.rap.rwt.service.IResourceManager.register(String, InputStream) Use ResourceManager instead of IResourceManager
org.eclipse.rap.rwt.lifecycle.WidgetUtil.registerDataKeys(String...) Use org.eclipse.rap.rwt.widgets.WidgetUtil#registerDataKeys(String...) instead.
org.eclipse.rap.rwt.service.IServiceManager.registerServiceHandler(String, ServiceHandler) Use ServiceManager instead of IServiceManager
org.eclipse.rap.rwt.service.IApplicationStore.removeAttribute(String) Use ApplicationContext instead of IApplicationStore.
org.eclipse.rap.rwt.service.ISessionStore.removeAttribute(String)
org.eclipse.rap.rwt.service.ISettingStore.removeAttribute(String) Use SettingStore instead of ISettingStore.
org.eclipse.rap.rwt.service.ISessionStore.removeSessionStoreListener(UISessionListener)
org.eclipse.rap.rwt.service.UISession.removeSessionStoreListener(UISessionListener) Use removeUISessionListener instead
org.eclipse.rap.rwt.service.ISettingStore.removeSettingStoreListener(SettingStoreListener) Use SettingStore instead of ISettingStore.
org.eclipse.rap.rwt.lifecycle.UICallBack.runNonUIThreadWithFakeContext(Display, Runnable) Use UISession.exec(Runnable) instead. You can obtain a reference to the UI session for a display by RWT.getUISession(Display). Example: RWT.getUISession( display ).exec( runnable ).
org.eclipse.rap.rwt.service.IApplicationStore.setAttribute(String, Object) Use ApplicationContext instead of IApplicationStore.
org.eclipse.rap.rwt.service.ISessionStore.setAttribute(String, Object)
org.eclipse.rap.rwt.service.ISettingStore.setAttribute(String, String) Use SettingStore instead of ISettingStore.
org.eclipse.rap.rwt.graphics.Graphics.stringExtent(Font, String) You can use SWT API to measure a string. Create a GC, set the font, and measure the string using GC.stringExtent(String). Don't forget to dispose the GC afterwards.
org.eclipse.rap.rwt.graphics.Graphics.textExtent(Font, String, int) In most cases, you can use SWT API to measure texts. Create a GC, set the font, and measure the text using GC.textExtent(String). Don't forget to dispose the GC afterwards.
org.eclipse.rap.rwt.service.IResourceManager.unregister(String) Use ResourceManager instead of IResourceManager
org.eclipse.rap.rwt.service.IServiceManager.unregisterServiceHandler(String) Use ServiceManager instead of IServiceManager