You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@river.apache.org by pe...@apache.org on 2013/11/17 09:38:50 UTC

svn commit: r1542661 [3/3] - in /river/jtsk/skunk/qa_refactor/trunk: ./ qa/src/com/sun/jini/test/impl/fiddler/joinadmin/ qa/src/com/sun/jini/test/share/ qa/src/com/sun/jini/test/spec/lookupservice/test_set00/ qa/src/com/sun/jini/test/spec/lookupservice...

Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/RemotePolicyProvider.java
URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/RemotePolicyProvider.java?rev=1542661&r1=1542660&r2=1542661&view=diff
==============================================================================
--- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/RemotePolicyProvider.java (original)
+++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/RemotePolicyProvider.java Sun Nov 17 08:38:47 2013
@@ -47,6 +47,7 @@ import org.apache.river.api.common.Beta;
 
 /**
  * @author Peter Firmstone
+ * @since 3.0.0
  */
 @Beta
 public class RemotePolicyProvider extends AbstractPolicy implements RemotePolicy,

Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/RevocablePolicy.java
URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/RevocablePolicy.java?rev=1542661&r1=1542660&r2=1542661&view=diff
==============================================================================
--- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/RevocablePolicy.java (original)
+++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/RevocablePolicy.java Sun Nov 17 08:38:47 2013
@@ -71,6 +71,7 @@ import net.jini.security.policy.DynamicP
  * @see PermissionGrant
  * @see DelegatePermission
  * @see DelegateSecurityManager
+ * @since 3.0.0
  */
 public interface RevocablePolicy extends DynamicPolicy {
     
@@ -84,11 +85,13 @@ public interface RevocablePolicy extends
      * 
      * @param p
      * @return true if successful 
+     * @since 3.0.0
      */
     public boolean grant(PermissionGrant p);
     /**
-     * 
+     * Checks if policy supports revocation.
      * @return true - If Revoke supported by underlying policy.
+     * @since 3.0.0
      */
     public boolean revokeSupported();
 }

Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/ScalableNestedPolicy.java
URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/ScalableNestedPolicy.java?rev=1542661&r1=1542660&r2=1542661&view=diff
==============================================================================
--- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/ScalableNestedPolicy.java (original)
+++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/ScalableNestedPolicy.java Sun Nov 17 08:38:47 2013
@@ -29,6 +29,7 @@ import java.util.List;
  * an order that avoids unnecessary reverse DNS calls for example.
  * 
  * @author Peter Firmstone
+ * @since 3.0.0
  */
 public interface ScalableNestedPolicy {
     

Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/Segment.java
URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/Segment.java?rev=1542661&r1=1542660&r2=1542661&view=diff
==============================================================================
--- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/Segment.java (original)
+++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/Segment.java Sun Nov 17 08:38:47 2013
@@ -19,10 +19,6 @@
 package org.apache.river.api.security;
 
 import org.apache.river.impl.Messages;
-import java.util.ArrayList;
-import java.util.Collection;
-import java.util.Collections;
-import java.util.List;
 import java.util.Properties;
 import org.apache.river.api.security.PolicyUtils.ExpansionFailedException;
 
@@ -45,6 +41,7 @@ import org.apache.river.api.security.Pol
  * is completed, so initially should be stored in an unsorted Collection.
  * 
  * @author Peter Firmstone.
+ * @since 3.0.0
  */
 class Segment implements Comparable {
     private Segment previous;
@@ -143,11 +140,10 @@ class Segment implements Comparable {
      * Segments the current String by find Properties between the START_MARK and
      * END_MARK and replacing them with their values, splitting them into separate
      * Strings (that remain encapsulated in the Segment) if regex is non null.
-     * @param START_MART
+     * @param START_MARK
      * @param END_MARK
-     * @param splitter
+     * @param regex
      * @param p
-     * @return 
      */
     public void divideAndReplace(String START_MARK, String END_MARK,
             String regex, Properties p) throws ExpansionFailedException{

Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/SubjectDomain.java
URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/SubjectDomain.java?rev=1542661&r1=1542660&r2=1542661&view=diff
==============================================================================
--- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/SubjectDomain.java (original)
+++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/SubjectDomain.java Sun Nov 17 08:38:47 2013
@@ -67,6 +67,7 @@ import javax.security.auth.Subject;
  * @see org.apache.river.api.security.ConcurrentPolicyFile
  * 
  * @author Peter Firmstone
+ * @since 3.0.0
  */
 public interface SubjectDomain {
     

Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/URIGrant.java
URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/URIGrant.java?rev=1542661&r1=1542660&r2=1542661&view=diff
==============================================================================
--- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/URIGrant.java (original)
+++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/URIGrant.java Sun Nov 17 08:38:47 2013
@@ -36,8 +36,9 @@ import java.util.logging.Logger;
 import org.apache.river.api.net.Uri;
 
 /**
- *
+ * RFC3986 URI PermissionGrant
  * @author Peter Firmstone
+ * @since 3.0.0
  */
 class URIGrant extends CertificateGrant {
     private static final long serialVersionUID = 1L;

Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/UnresolvedPrincipal.java
URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/UnresolvedPrincipal.java?rev=1542661&r1=1542660&r2=1542661&view=diff
==============================================================================
--- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/UnresolvedPrincipal.java (original)
+++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/UnresolvedPrincipal.java Sun Nov 17 08:38:47 2013
@@ -17,7 +17,7 @@
 
 /**
 * @author Alexey V. Varlamov
-* @version $Revision$
+* @since 3.0.0
 */
 
 package org.apache.river.api.security;
@@ -37,7 +37,7 @@ import java.security.Principal;
  * acceptable principal and compares it with the actual principal. 
  * 
  * @see PermissionGrant
- * @see org.apache.river.imp.security.policy.se.ConcurrentPolicyFile
+ * @see org.apache.river.api.security.ConcurrentPolicyFile
  */
 final class UnresolvedPrincipal implements Principal {
 

Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/Util.java
URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/Util.java?rev=1542661&r1=1542660&r2=1542661&view=diff
==============================================================================
--- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/Util.java (original)
+++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/Util.java Sun Nov 17 08:38:47 2013
@@ -17,6 +17,11 @@
 
 package org.apache.river.api.security;
 
+/**
+ * 
+ * @author peter
+ * @since 3.0.0
+ */
 class Util {
 
     static String toUpperCase(String s) {

Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/package.html
URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/package.html?rev=1542661&r1=1542660&r2=1542661&view=diff
==============================================================================
--- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/package.html (original)
+++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/package.html Sun Nov 17 08:38:47 2013
@@ -33,5 +33,8 @@ further disk access and minimises networ
     </p><p>
 Disk access of policy files is performed serially.
 </p>
+
+@since 3.3.0
+
 </body>
 </html>

Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/Commission.java
URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/Commission.java?rev=1542661&r1=1542660&r2=1542661&view=diff
==============================================================================
--- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/Commission.java (original)
+++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/Commission.java Sun Nov 17 08:38:47 2013
@@ -23,9 +23,9 @@ package org.apache.river.api.util;
  * export or any other activity after construction is complete, required to put
  * the object into an operational state.
  * 
- * @see ServiceDescriptor
- * @see Exporter
- * 
+ * @see com.sun.jini.start.ServiceDescriptor
+ * @see net.jini.export.Exporter
+ * @since 3.0.0
  */
 public interface Commission {
     /**

Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/Facade.java
URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/Facade.java?rev=1542661&r1=1542660&r2=1542661&view=diff
==============================================================================
--- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/Facade.java (original)
+++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/Facade.java Sun Nov 17 08:38:47 2013
@@ -21,7 +21,7 @@ package org.apache.river.api.util;
 /**
  * Interface definition of the facade pattern.
  * @author Peter Firmstone.
- * @since 2.3.0
+ * @since 3.0.0
  */
 public interface Facade<T> {
     /**
@@ -42,7 +42,7 @@ public interface Facade<T> {
      * an IllegalArgumentException.
      * 
      * @param o
-     * @return
+     * @return true if equal
      */
     @Override
     public boolean equals(Object o);

Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/ResultStream.java
URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/ResultStream.java?rev=1542661&r1=1542660&r2=1542661&view=diff
==============================================================================
--- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/ResultStream.java (original)
+++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/ResultStream.java Sun Nov 17 08:38:47 2013
@@ -28,6 +28,7 @@ import java.io.IOException;
  * by returning a null value.
  * 
  * @author Peter Firmstone
+ * @since 3.0.0
  */
 public interface ResultStream<T> {
     /**

Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/impl/Messages.java
URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/impl/Messages.java?rev=1542661&r1=1542660&r2=1542661&view=diff
==============================================================================
--- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/impl/Messages.java (original)
+++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/impl/Messages.java Sun Nov 17 08:38:47 2013
@@ -19,6 +19,7 @@
  * THE FILE HAS BEEN AUTOGENERATED BY MSGTOOL TOOL.
  * All changes made to this file manually will be overwritten 
  * if this tool runs again. Better make changes in the template file.
+ * - Shamelessly taken from Apache Harmony.
  */
 
 package org.apache.river.impl;
@@ -44,7 +45,7 @@ import java.util.ResourceBundle;
  * is looked up, or resource bundle support is not available, the key itself
  * will be returned as the associated message. This means that the <em>KEY</em>
  * should a reasonable human-readable (english) string.
- * 
+ * @since 3.0.0
  */
 public class Messages {
 

Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/impl/net/UriString.java
URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/impl/net/UriString.java?rev=1542661&r1=1542660&r2=1542661&view=diff
==============================================================================
--- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/impl/net/UriString.java (original)
+++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/impl/net/UriString.java Sun Nov 17 08:38:47 2013
@@ -32,6 +32,7 @@ import java.util.logging.Logger;
  * 
  * @author Peter Firmstone.
  */
+@Deprecated
 public class UriString {
     
     private static Logger logger = Logger.getLogger("org.apache.river.impl.net");
@@ -131,7 +132,7 @@ public class UriString {
      * 
      * @param array
      * @param character
-     * @return 
+     * @return index
      */
     public static int index(char [] array, char character){
         int l = array.length;
@@ -150,7 +151,7 @@ public class UriString {
      * No normalisation or platform specific changes are performed.
      * 
      * @param str
-     * @return
+     * @return encoded String.
      * @throws URISyntaxException  
      */
     public static String escapeIllegalCharacters(String str) throws URISyntaxException {
@@ -268,7 +269,7 @@ public class UriString {
      * @param path -
      *            file path.
      * @return - the resulting URI.
-     * @throw URISyntaxException
+     * @throws URISyntaxException
      */
     private static URI filePathToURI(String path) throws URISyntaxException {
         if (File.separatorChar == '\\') {