You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@wicket.apache.org by ad...@apache.org on 2021/04/30 20:37:16 UTC

[wicket] branch wicket-9.x updated: WICKET-6883 updated chapter 8 to reflect page storing changes

This is an automated email from the ASF dual-hosted git repository.

adelbene pushed a commit to branch wicket-9.x
in repository https://gitbox.apache.org/repos/asf/wicket.git


The following commit(s) were added to refs/heads/wicket-9.x by this push:
     new e3024d6  WICKET-6883 updated chapter 8 to reflect page storing changes
e3024d6 is described below

commit e3024d682ec3148dafd5e7aaeca7a3fde9f609f4
Author: Andrea Del Bene <an...@host.it>
AuthorDate: Fri Apr 30 22:35:01 2021 +0200

    WICKET-6883 updated chapter 8 to reflect page storing changes
---
 .../src/main/asciidoc/img/wicket-cache.png         | Bin 38486 -> 16844 bytes
 .../versioningCaching/versioningCaching_2.adoc     |  21 +++++++--------------
 2 files changed, 7 insertions(+), 14 deletions(-)

diff --git a/wicket-user-guide/src/main/asciidoc/img/wicket-cache.png b/wicket-user-guide/src/main/asciidoc/img/wicket-cache.png
index 0a96e12..e7adbf8 100644
Binary files a/wicket-user-guide/src/main/asciidoc/img/wicket-cache.png and b/wicket-user-guide/src/main/asciidoc/img/wicket-cache.png differ
diff --git a/wicket-user-guide/src/main/asciidoc/versioningCaching/versioningCaching_2.adoc b/wicket-user-guide/src/main/asciidoc/versioningCaching/versioningCaching_2.adoc
index 16d5fd1..67d35d1 100644
--- a/wicket-user-guide/src/main/asciidoc/versioningCaching/versioningCaching_2.adoc
+++ b/wicket-user-guide/src/main/asciidoc/versioningCaching/versioningCaching_2.adoc
@@ -89,15 +89,17 @@ A serializer based on Kryo library and another one based on Fast are provided by
 
 === Page caching
 
-By default Wicket persists versions of pages into a session-relative file on disk, but it uses a two-level cache to speed up this process. The first level of the cache uses a http session attribute called “wicket:persistentPageManagerData-<APPLICATION_NAME>” to store pages. The second level cache stores pages into application-scoped variables which are identified by a session id and a page id.
+By default Wicket persists versions of pages into a session-relative file on disk, but it uses a two-level cache to speed up the access. The first level of the cache contains all the pages involved in the current requests as we may visit more than one page during a single request, for example if we have been redirected with _setResponsePage_.
+The second level cache stores the last rendered page into a session-scoped variables.
+
+NOTE: Scoped variables will be introduced in <<requestProcessing.adoc#_storing_arbitrary_objects_with_metadata,chapter 9.4.6>> which is about Wicket metadata.
 
 The following picture is an overview of these two caching levels:
 
 image::../img/wicket-cache.png[]
 
-The session-scoped cache is faster then the other memory levels but it contains only the pages used to serve the last request. Wicket allows us to set the maximum amount of memory allowed for the application-scoped cache and for the page store file. Both parameters can be configured via setting class _org.apache.wicket.settings.StoreSettings_.
-
-This interface provides the _setMaxSizePerSession(Bytes bytes)_ method to set the size for page store file. The Bytes parameter is the maximum size allowed for this file:
+Wicket allows us to set the maximum size of the file used to store pages with setting class _org.apache.wicket.settings.StoreSettings_.
+This class provides the _setMaxSizePerSession(Bytes bytes)_ method to set the size of the file. The Bytes parameter is the maximum size allowed for this file:
 
 [source,java]
 ----
@@ -110,17 +112,8 @@ public void init()
 ----
 
 Class _org.apache.wicket.util.lang.Bytes_ is an utility class provided by Wicket to express size in bytes (for further details refer to the JavaDoc).
-For the second level cache we can use the _setInmemoryCacheSize(int inmemoryCacheSize)_ method. The integer parameter is the maximum number of page instances that will be saved into application-scoped cache:
 
-[source,java]
-----
-@Override
-public void init()
-{
-	super.init();
-	getStoreSettings().setInmemoryCacheSize(50);
-}
-----
+NOTE: more insights on internal page handling will be covered in <<internals.adoc,chapter 26>> 
 
 === Page expiration