Author: gk
Date: Thu May 11 13:13:03 2017
New Revision: 1794835

URL: http://svn.apache.org/viewvc?rev=1794835&view=rev
Log:
- doc changes, fix warning 

Modified:
    
turbine/fulcrum/trunk/security/api/src/test/org/apache/fulcrum/security/model/turbine/test/AbstractTurbineModelManagerTest.java
    turbine/fulcrum/trunk/security/pom.xml
    turbine/fulcrum/trunk/security/xdocs/index.xml

Modified: 
turbine/fulcrum/trunk/security/api/src/test/org/apache/fulcrum/security/model/turbine/test/AbstractTurbineModelManagerTest.java
URL: 
http://svn.apache.org/viewvc/turbine/fulcrum/trunk/security/api/src/test/org/apache/fulcrum/security/model/turbine/test/AbstractTurbineModelManagerTest.java?rev=1794835&r1=1794834&r2=1794835&view=diff
==============================================================================
--- 
turbine/fulcrum/trunk/security/api/src/test/org/apache/fulcrum/security/model/turbine/test/AbstractTurbineModelManagerTest.java
 (original)
+++ 
turbine/fulcrum/trunk/security/api/src/test/org/apache/fulcrum/security/model/turbine/test/AbstractTurbineModelManagerTest.java
 Thu May 11 13:13:03 2017
@@ -46,6 +46,7 @@ import org.junit.Before;
 import org.junit.Test;
 
 /**
+ * Initialization of services in implementing tests
  * @author Eric Pugh
  * 
  */

Modified: turbine/fulcrum/trunk/security/pom.xml
URL: 
http://svn.apache.org/viewvc/turbine/fulcrum/trunk/security/pom.xml?rev=1794835&r1=1794834&r2=1794835&view=diff
==============================================================================
--- turbine/fulcrum/trunk/security/pom.xml (original)
+++ turbine/fulcrum/trunk/security/pom.xml Thu May 11 13:13:03 2017
@@ -22,6 +22,7 @@
        <artifactId>turbine-parent</artifactId>
        <groupId>org.apache.turbine</groupId>
        <version>4</version>
+       <relativePath></relativePath>
    </parent>
     <modelVersion>4.0.0</modelVersion>
     <groupId>org.apache.fulcrum</groupId>

Modified: turbine/fulcrum/trunk/security/xdocs/index.xml
URL: 
http://svn.apache.org/viewvc/turbine/fulcrum/trunk/security/xdocs/index.xml?rev=1794835&r1=1794834&r2=1794835&view=diff
==============================================================================
--- turbine/fulcrum/trunk/security/xdocs/index.xml (original)
+++ turbine/fulcrum/trunk/security/xdocs/index.xml Thu May 11 13:13:03 2017
@@ -77,10 +77,10 @@
     <subsection name="Turbine">
       <p>
       This model is based on what the Turbine application server uses, and 
leverages the Dynamic model.  It merely adds
-      the concept of a "global group" which is a toplevel group to the Dynamic 
model.
+      the concept of a "global group" which is a toplevel group to the Dynamic 
model (which allows user - role assignments with or without a group).
       However, what makes this different is that instead of roles
       being related just to groups, there instead is a many to many 
relationship between users and
-      groups and roles.  So you pick a user, pick their role, and their group, 
and that is their permissions.
+      groups and roles.  So you pick a user, pick their role, and their group, 
and that is their permissions.  </p> <p>Put it in another way, a simple example 
would be that a user has just a (global) role assigned (global group) and only 
optionally is assigned to a group. This allows to have flexible groups 
assignments and even cascaded security controls: check user's (global) role 
(this is the default)  - no group assignment required; check group 
assignment(s); check role assignment of each (non global) group. Permissions 
are handled like in dynamic model and are as non global group role assignments 
optional.
       </p>
       <p>
       The <code>memory</code>, <code>hibernate</code> and <code>torque</code> 
packages currently implement this security model.
@@ -170,7 +170,8 @@
 <section name="Adapters">
   <subsection name="Turbine">
     <p>
-    In <code>org.apache.fulcrum.security.adapter.turbine</code> is an 
implementation of the Turbine Security Service.
+    For Turbine 4.x or above use the common Security Turbine. 
+    </p><p>In <code>org.apache.fulcrum.security.adapter.turbine</code> is an 
implementation of the Turbine Security Service.
     This is designed to allow you to run the Fulcrum Security Service, but 
have Turbine 2.3's be able to query, through
     the adapter the Fulcrum Security service.
     </p>
@@ -211,9 +212,9 @@
   </subsection>
   <subsection name="Torque">
     <p>
-    The Torque SPI provides three different schema mappings for the different 
security models (in the schema directory). You can easily adjust these to your
+    The Torque SPI provides four different (basic, dynamic type and two 
turbine schemata) schema mappings for the different security models (in the 
schema directory). You can easily adjust these to your
     needs. If adjustments are needed, set up the 
<code>project.properties</code> file according to your database environment 
(see the
-    <a 
href="http://db.apache.org/torque/releases/torque-3.3/maven-plugin/index.html";>Torque
 Maven Plugin Documentation</a> for reference) and use Maven to
+    <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>
     <p>
@@ -237,8 +238,23 @@
     </p>
     <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.
-    </p>
+    in the Torque configuration when the service is deployed. 
+    Another mapping <code>default</code> is provided for the Turbine models. 
+    Additionally Torque-OM peer classes could be made configurable by using a 
<a 
href="http://turbine.apache.org/fulcrum/fulcrum-security/apidocs/org/apache/fulcrum/security/torque/peer/TorqueTurbinePeer.html";>(marker)
 interface</a>. 
+    This will be supported out of the box in schema configuration in <a 
href="http://db.apache.org/torque";>Torque 4.1</a> release. 
+    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>
   <subsection name="NT">
     <p>


Reply via email to