Author: apetrelli
Date: Mon Oct 6 03:16:28 2008
New Revision: 702080
URL: http://svn.apache.org/viewvc?rev=702080&view=rev
Log:
TILES-312
Added docs for roles.
Added:
tiles/framework/trunk/src/site/apt/tutorial/advanced/security.apt
Modified:
tiles/framework/trunk/src/site/apt/tutorial/advanced/index.apt
tiles/framework/trunk/src/site/apt/tutorial/index.apt
tiles/framework/trunk/src/site/site.xml
Modified: tiles/framework/trunk/src/site/apt/tutorial/advanced/index.apt
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/src/site/apt/tutorial/advanced/index.apt?rev=702080&r1=702079&r2=702080&view=diff
==============================================================================
--- tiles/framework/trunk/src/site/apt/tutorial/advanced/index.apt (original)
+++ tiles/framework/trunk/src/site/apt/tutorial/advanced/index.apt Mon Oct 6
03:16:28 2008
@@ -50,3 +50,5 @@
[[11]] {{{attribute-rendering.html}Attribute rendering}}
[[12]] {{{multiple-containers.html}Using multiple containers}}
+
+ [[13]] {{{security.html}Security}}
Added: tiles/framework/trunk/src/site/apt/tutorial/advanced/security.apt
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/src/site/apt/tutorial/advanced/security.apt?rev=702080&view=auto
==============================================================================
--- tiles/framework/trunk/src/site/apt/tutorial/advanced/security.apt (added)
+++ tiles/framework/trunk/src/site/apt/tutorial/advanced/security.apt Mon Oct
6 03:16:28 2008
@@ -0,0 +1,91 @@
+~~ $Id: menu.apt 700541 2008-09-30 18:32:01Z apetrelli $
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License. You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied. See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+~~
+ -----------
+ Security
+ -----------
+
+Security
+
+ Tiles allows the visibility of a template, an attribute or a definition only
+ to selected roles.
+
+* Allowing definitions
+
+ A definition can be allowed to be rendered only by selected roles:
+
+ * in XML definition files:
+
+---------------------------------
+<definition name="test.definition"
+ template="/layout/my-template.jsp role="myrole">
+ ...
+</definition>
+---------------------------------
+
+ * in JSP pages, when inserting definitions:
+
+---------------------------------
+<tiles:insertDefinition name="test.definition" role="myrole" />
+---------------------------------
+
+ * in JSP pages, when definining definitions:
+
+---------------------------------
+<tiles:definition name="test.definition"
+ template="/layout/my-template.jsp" "role="myrole">
+ ...
+</tiles:definition>
+---------------------------------
+
+* Allowing attributes
+
+ An attribute can be allowed to be rendered only by selected roles:
+
+ * in XML definition files:
+
+---------------------------------
+<definition name="test.definition"
+ template="/layout/my-template.jsp>
+ <put-attribute name="header" value="/header.jsp" role="myrole" />
+</definition>
+---------------------------------
+
+ * in JSP pages, when inserting attributes:
+
+---------------------------------
+<tiles:insertAttribute name="header" role="myrole" />
+---------------------------------
+
+ * in JSP pages, when putting attributes:รน
+
+---------------------------------
+<tiles:putAttribute name="header" value="/header.jsp" role="myrole" />
+---------------------------------
+
+* Allowing templates
+
+ Templates can be allowed to be rendered only by selected rows in JSP pages:
+
+---------------------------------
+<tiles:insertTemplate name="test.definition"
+ template="/layout/my-template.jsp" "role="myrole">
+ ...
+</tiles:insertTemplate>
+---------------------------------
Modified: tiles/framework/trunk/src/site/apt/tutorial/index.apt
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/src/site/apt/tutorial/index.apt?rev=702080&r1=702079&r2=702080&view=diff
==============================================================================
--- tiles/framework/trunk/src/site/apt/tutorial/index.apt (original)
+++ tiles/framework/trunk/src/site/apt/tutorial/index.apt Mon Oct 6 03:16:28
2008
@@ -65,6 +65,8 @@
[[12]] {{{advanced/multiple-containers.html}Using multiple containers}}
+ [[13]] {{{advanced/security.html}Security}}
+
[[6]] {{{integration/index.html}Integration with other technologies}}
[[1]] {{{integration/frameworks.html}Integration with other
frameworks}}
Modified: tiles/framework/trunk/src/site/site.xml
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/src/site/site.xml?rev=702080&r1=702079&r2=702080&view=diff
==============================================================================
--- tiles/framework/trunk/src/site/site.xml (original)
+++ tiles/framework/trunk/src/site/site.xml Mon Oct 6 03:16:28 2008
@@ -119,6 +119,9 @@
<item
name="Multiple containers"
href="tutorial/advanced/multiple-containers.html"/>
+ <item
+ name="Security"
+ href="tutorial/advanced/security.html"/>
</item>
<item
name="Integrations"
