You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@turbine.apache.org by gk...@apache.org on 2018/01/18 08:26:57 UTC
svn commit: r1821460 - in /turbine/fulcrum/trunk/security:
src/changes/changes.xml xdocs/index.xml
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="epugh@upstate.com">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>