Author: gk
Date: Thu Jan 18 08:26:57 2018
New Revision: 1821460
URL: http://svn.apache.org/viewvc?rev=1821460&view=rev
Log:
- reflect changes in documentation
Modified:
turbine/fulcrum/trunk/security/src/changes/changes.xml
turbine/fulcrum/trunk/security/xdocs/index.xml
Modified: turbine/fulcrum/trunk/security/src/changes/changes.xml
URL:
http://svn.apache.org/viewvc/turbine/fulcrum/trunk/security/src/changes/changes.xml?rev=1821460&r1=1821459&r2=1821460&view=diff
==============================================================================
--- turbine/fulcrum/trunk/security/src/changes/changes.xml (original)
+++ turbine/fulcrum/trunk/security/src/changes/changes.xml Thu Jan 18 08:26:57
2018
@@ -22,9 +22,19 @@
<title>Changes</title>
<author email="[email protected]">Eric Pugh</author>
</properties>
-
<body>
- <release version="1.1.1" date="in Subversion">
+ <release version="1.1.2" date="in Subversion">
+ <action type="update" dev="gk">
+ Torque Turbine Relationships in ACL (Access Control List, which is
immutable) with custom relationships: If not using the provided OM classes two
approaches exist to get proper ACL user/role/groups. Either overriding or by
configuration: Overriding the method retrieveAttachedObjects is done in custom
User OM class or use xml configuration and proper schema interface settings
(Torque OM), cft. test example.
+ Added lazy loading flag if retrieving attachedObjects, i.e. related
user role or user group associations are loaded only if requested. If, where
and how lazy loading occurs depends on the the manager classes. Currently only
group and role manager use it. Configurable with attribute lazy per manager. As
a consequence some more methods may now throw DataBackendException.
+ Added revokeAll(Group) method in model manager.
+ Add interfaces for OM mapping.
+ </action>
+ <action type="update" dev="gk">
+ Torque Fulcrum and Default schema, support for Peer interface, global
group name configurable in model manager
+ </action>
+ </release>
+ <release version="1.1.1" date="2017-05-12">
<action type="update" dev="gk">
Updated to JUnit 4
Configurable global group in Turbine and dynamic model
Modified: turbine/fulcrum/trunk/security/xdocs/index.xml
URL:
http://svn.apache.org/viewvc/turbine/fulcrum/trunk/security/xdocs/index.xml?rev=1821460&r1=1821459&r2=1821460&view=diff
==============================================================================
--- turbine/fulcrum/trunk/security/xdocs/index.xml (original)
+++ turbine/fulcrum/trunk/security/xdocs/index.xml Thu Jan 18 08:26:57 2018
@@ -124,7 +124,7 @@
</subsection>
<subsection name="Configuration">
<p>
- This uses the integrated role and component config XML. Check the
/src/test directory for the most uptodate
+ This uses the integrated role and component config XML. Check the
/src/test directory for the most up-to-date
examples of the configuration files used in unit testing!
</p>
<p>
@@ -217,6 +217,7 @@
<a
href="http://db.apache.org/torque/torque-4.0/documentation/modules/maven-plugin/index.html";>Torque
4.x Maven Plugin Documentation</a> for reference) and use Maven to
generate the Torque-OM-classes and to re-built the JAR.
</p>
+ <subsection name="Torque Dynamic Model">
<p>
The component configuration must refer to the correct Torque-OM-classes as
in the following example for the Dynamic model:
<source>
@@ -236,6 +237,7 @@
]]>
</source>
</p>
+ </subsection>
<p>
As a default, the Torque Security Service uses <code>fulcrum</code> as the
name of the connection pool for the tables used. This should be considered
in the Torque configuration when the service is deployed.
@@ -245,16 +247,50 @@
Until then class annotation has to be done manually, check examples in <a
href="http://svn.apache.org/repos/asf/turbine/fulcrum/trunk/security/torque/src/test/";>Fulcrum
Security Torque</a>!
and for background cft. <a
href="https://issues.apache.org/jira/browse/TORQUE-309";>Torque-309</a>.
</p>
- <p>Check out the Turbine Web App from the maven archetype catalog to test
a web app with example code. Find the archetype with <source>
- // filter archeype catalog by groupid:artefactid =
org.apache.turbine:turbine-webapp-4.0
- mvn archetype:generate
- </source> or checkout and build turbine-webapp-4.0 based on Turbine 4
trunk:
- <source>
- svn co
https://svn.apache.org/repos/asf/turbine/maven/archetypes/trunk/turbine-webapp-4.0
- mvn clean install
- </source>
- If you check out the trunk, you may have to build other sources as well
(any dependeny resource with a SNAPSHOT version).
- </p>
+
+ <subsection name="Torque Turbine Model">
+ <p>
+ The Turbine model may be as simple as the Dynamic Model, but this is the
most expanded configuration:
+ <source>
+ <![CDATA[
+ <userManager>
+
<className>org.apache.fulcrum.security.torque.om.TurbineUser</className>
+
<peerClassName>org.apache.fulcrum.security.torque.om.TurbineUserPeerImpl</peerClassName>
+ <!-- required for acl custom mapping -->
+ <userGroupRoleManager>
+
<peerClassName>org.apache.fulcrum.security.torque.om.TurbineUserGroupRolePeerImpl</peerClassName>
+ </userGroupRoleManager>
+ </userManager>
+ <groupManager lazy="true">
+
<className>org.apache.fulcrum.security.torque.om.TurbineGroup</className>
+
<peerClassName>org.apache.fulcrum.security.torque.om.TurbineGroupPeerImpl</peerClassName>
+ </groupManager>
+ <roleManager lazy="true">
+
<className>org.apache.fulcrum.security.torque.om.TurbineRole</className>
+
<peerClassName>org.apache.fulcrum.security.torque.om.TurbineRolePeerImpl</peerClassName>
+ </roleManager>
+ <permissionManager>
+
<className>org.apache.fulcrum.security.torque.om.TurbinePermission</className>
+
<peerClassName>org.apache.fulcrum.security.torque.om.TurbinePermissionPeerImpl</peerClassName>
+ </permissionManager>
+ ]]>
+ </source>
+ All managers now show custom peer classes and the
<code>userManager</code> has sub-element <code>userGroupRoleManager</code> to
get the ACM (Access Control List) with correct (custom) relationships.
Additionally the attribute <code>lazy</code> may be set for
<code>groupManager</code> and <code>roleManager</code>, which indicates
retrieval of dependent relationships occurs only if explicitely requested.
+ </p>
+ </subsection>
+ <subsection name="Torque Turbine Model Web App">
+ <p>Check out the Turbine Web App from the maven archetype catalog to
test a web app with example code. Find the archetype with
+ <source>
+ // filter archeype catalog by groupid:artefactid =
org.apache.turbine:turbine-webapp-4.0
+ mvn archetype:generate
+ </source> or checkout and build turbine-webapp-4.0 based on Turbine
4 trunk:
+ <source>
+ svn co
https://svn.apache.org/repos/asf/turbine/maven/archetypes/trunk/turbine-webapp-4.0
+ mvn clean install
+ </source>
+ If you check out from the trunk, you may have to build other sources
as well (any dependeny resource with a SNAPSHOT version).
+ </p>
+ </subsection>
</subsection>
<subsection name="NT">
<p>
