svn commit: r897359 - /tapestry/tapestry5/trunk/src/site/apt/cookbook/lib.apt

[hl...@apache.org]

Author: hlship
Date: Sat Jan  9 00:56:25 2010
New Revision: 897359

URL: http://svn.apache.org/viewvc?rev=897359&view=rev
Log:
Add a note about asset security to the component library cookbook page

Modified:
    tapestry/tapestry5/trunk/src/site/apt/cookbook/lib.apt

Modified: tapestry/tapestry5/trunk/src/site/apt/cookbook/lib.apt
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/src/site/apt/cookbook/lib.apt?rev=897359&r1=897358&r2=897359&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/src/site/apt/cookbook/lib.apt (original)
+++ tapestry/tapestry5/trunk/src/site/apt/cookbook/lib.apt Sat Jan  9 00:56:25 2010
@@ -213,7 +213,24 @@
 
 ----
 
-Step 6: Versioning Assets
+Step 6: Extending Client Access
+
+  As of Tapestry 5.2, a new step is needed: {{{../guide/assets.html}extending access for the assets}}.
+  
+  This is accomplished in your library's module class, HappyModule:
+  
+----
+  public static void contributeRegexAuthorizer(Configuration<String> configuration)
+  {
+    configuration.add("^org/example/happylib/.*\\.jpg$");
+  }  
+----
+
+  This contribution uses a regular expression to identify that any resource on the classpath under the
+  org/example/happylib folder with a <<<jpg>>> extension is allowed.  If you had a mix of different
+  image types, you could replace <<<jpg>>> with <<<(jpg|gif|png)>>>.
+
+Step 7: Versioning Assets
 
   Classpath assets, those packaged in JAR files (such as the happy.jpg asset) are retrieved by the client web browser
   using a URL that reflects the package name.                  Tapestry users a special virtual folder, <<</assets>>>, under