public interface MemoryLeaks
Canvas (including subclasses) that you're done using should be
destroy()d to avoid memory leaks. Since destroy() is recursive, you only need to call destroy() on the topmost component in any
hierarchy of widgets you don't need. This includes DynamicForm automatically destroying FormItems and DrawPane automatically destroying DrawItems. ValuesManagers that you are done using should be destroy()d
to avoid memory leaks, and will never be automatically destroyed as a consequence of destroying
any related Canvas. ResultSet and ResultTree instances that you manually create need to
be destroy()d to avoid leaks. ResultSet and ResultTree instances automatically created by
ListGrids and TreeGrids (see ListGrid.fetchData()) do not need to be
destroy()d as they are automatically destroyed with the creating ListGrid or TreeGrid.
RecordLists must be destroy()d as they are registered with the IDManager. ID need to be
destroy()d to avoid leaks. Most applications do not need to worry about this, as they create a
fixed set of DataSources, and DataSource.get()
will never cause a leak.
Seeing the browser's memory use rise dramatically after a given operation does not demonstrate a memory leak. It's normal for browser memory usage to fluctuate wildly, because the browser will generally not reclaim resources immediately, and in some cases will not reclaim resources until memory is nearly exhausted. Some browsers will also build up pools of resources for later re-use.
The only way to demonstrate a real memory leak is to demonstrate memory exhaustion: showing that the browser memory usage rises until all memory is exhausted and errors begin to occur. No other pattern of increasing memory usage - no matter how large - is considered evidence of a leak, because the browser may suddenly reclaim very large amounts of memory after memory usage rises to a certain trigger point. Memory exhaustion is the only way to demonstrate a real memory leak.
Note that all debugging tools must be closed in order to demonstrate memory exhaustion because debugging tools may themselves consume large amounts of memory:
To
demonstrate memory exhaustion, you generally need to take whatever operation you suspect of
leaking memory and cause it to be repeated thousands or hundreds of thousands of times -
generally, by performing the same operation multiple times in a loop, or, for asynchronous
operations like DataSource saves, performing the operation
again each time you receive notification of completion (via callbacks).
In Windows, you can speed up the process of demonstrating memory exhaustion by disabling paging of memory to disk, which causes Windows to use the physical memory of the system (RAM) only. To disable paging, go to Advanced System Settings, and in the "Virtual Memory" section of the "Performance" settings, uncheck the "Automatically manage paging file size for all drives" checkbox and select "No paging file" (this process may differ slightly on different versions of Windows). The system will need to be rebooted for these new settings to take effect.
Once paging is disabled, verify that you can still open the browser and load the application you intend to test. There needs to be ample physical memory available for the application to use. A rule of thumb is to have enough available memory for the browser's memory footprint to at least quadruple in size or at least 500 MB, which ever is greater. If the system does not have enough physical memory, one option is to re-enable paging, but limit the maximum size of the page file to 500 MB. Then begin the process of repeating the operation being tested for a memory leak.
If Windows shows a warning about low system memory, you have demonstrated memory exhaustion and therefore a memory leak. If you are working with a minimal, ready-to-run test case, you may have found a framework bug or a browser bug that Smart GWT can work around. You should post your minimal test case to the Smart GWT forums for analysis by Isomorphic Support.
If you do not have a minimal test case and have simply shown that your application is leaking memory, consider the possible coding errors that could cause memory leaks (explained above), and work toward creating a minimal test case if you suspect a framework or browser bug is the underlying cause.