Commits

Anonymous committed ebd1031

Changed page WhatsNewIn21

Comments (0)

Files changed (1)

WhatsNewIn21.wiki

 </div>
 }}}
 
+== Filter changes ==
+
+Since the core was rewritten to use iterators, some of the filter method names are obsolete, and have been replaced. In addition, the filters are no longer divided into separate input and output classes; each core filter is now implemented with a single class per filter.
+
+{{{
+#!html
+<div class="highlighted">
+<a name="filter_methods"></a>
+}}}
+'''Steps to upgrade your site'''
+
+If you have custom filters, you should collapse your classes, and then change the method names (or your code will not be called). In general, you can follow this mapping from old to new names:
+
+||'''Old Name'''||'''New Name'''||
+||setConfig||onStartResource||
+||afterRequestHeader||beforeRequestBody||
+||afterRequestBody||beforeMain||
+||beforeResponse||beforeFinalize||
+||afterResponse||onEndResource||
+||beforeErrorResponse|| no change ||
+||afterErrorResponse|| no change ||
+
+{{{
+#!html
+</div>
+}}}
+
+
 == New way of using static content ==
 
 Static content is now handled by a filter called "staticFilter" that can easily be enabled and configured in your config file. For instance, if you wanted to server /style.css from /home/site/style.css and /static/* from /home/site/static/*, you can use the following configuration:
 #!html
 </div>
 }}}
+
+== New session filter ==
+
+Sessions have been moved into a filter called "sessionFilter". As before, sessions are enabled by setting "session.storageType" to "ram" (or one of the other recognized values).
+
+{{{
+#!html
+<div class="highlighted">
+}}}
+'''Steps to upgrade your site'''
+
+None!
+{{{
+#!html
+</div>
+}}}
+
+
 == Coming soon ==
- * new session implementation, sessions move into a filter called "sessionFilter"
+ * new session implementation
  * new file upload behavior (don't store file in a string)