harmony-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From le...@apache.org
Subject svn commit: r548253 - in /harmony/enhanced/classlib/branches/java6/modules/security/src/main/java/common/java/security: Policy.java PolicySpi.java
Date Mon, 18 Jun 2007 08:00:18 GMT
Author: leoli
Date: Mon Jun 18 01:00:17 2007
New Revision: 548253

URL: http://svn.apache.org/viewvc?view=rev&rev=548253
Log:
Add Java6 API class PolicySpi.

Added:
    harmony/enhanced/classlib/branches/java6/modules/security/src/main/java/common/java/security/PolicySpi.java
Modified:
    harmony/enhanced/classlib/branches/java6/modules/security/src/main/java/common/java/security/Policy.java

Modified: harmony/enhanced/classlib/branches/java6/modules/security/src/main/java/common/java/security/Policy.java
URL: http://svn.apache.org/viewvc/harmony/enhanced/classlib/branches/java6/modules/security/src/main/java/common/java/security/Policy.java?view=diff&rev=548253&r1=548252&r2=548253
==============================================================================
--- harmony/enhanced/classlib/branches/java6/modules/security/src/main/java/common/java/security/Policy.java
(original)
+++ harmony/enhanced/classlib/branches/java6/modules/security/src/main/java/common/java/security/Policy.java
Mon Jun 18 01:00:17 2007
@@ -26,6 +26,7 @@
 
 import org.apache.harmony.security.fortress.DefaultPolicy;
 import org.apache.harmony.security.fortress.PolicyUtils;
+import org.apache.harmony.security.internal.nls.Messages;
 
 
 /**
@@ -212,4 +213,39 @@
             activePolicy = policy;
         }
     }
+    
+    /**
+     * A read-only empty PermissionCollection instance.
+     * 
+     * @since 1.6
+     */
+    public static final PermissionCollection UNSUPPORTED_EMPTY_COLLECTION = new PermissionCollection()
{
+
+        private static final long serialVersionUID = 1L;
+
+        @Override
+        public void add(Permission permission) {
+            throw new SecurityException(Messages.getString("security.1A5")); //$NON-NLS-1$
+        }
+
+        @Override
+        public Enumeration<Permission> elements() {
+            return new Permissions().elements();
+        }
+
+        @Override
+        public boolean implies(Permission permission) {
+            if (permission == null) {
+                throw new NullPointerException();
+            }
+            return false;
+        }
+
+        @Override
+        public boolean isReadOnly() {
+            // always returns true since it is a read-only instance.
+            // RI does not override this method.
+            return true;
+        }
+    };
 }

Added: harmony/enhanced/classlib/branches/java6/modules/security/src/main/java/common/java/security/PolicySpi.java
URL: http://svn.apache.org/viewvc/harmony/enhanced/classlib/branches/java6/modules/security/src/main/java/common/java/security/PolicySpi.java?view=auto&rev=548253
==============================================================================
--- harmony/enhanced/classlib/branches/java6/modules/security/src/main/java/common/java/security/PolicySpi.java
(added)
+++ harmony/enhanced/classlib/branches/java6/modules/security/src/main/java/common/java/security/PolicySpi.java
Mon Jun 18 01:00:17 2007
@@ -0,0 +1,112 @@
+/*
+ *  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.
+ */
+
+package java.security;
+
+/**
+ * Represents the Service Provider Interface (SPI) for java.security.Policy
+ * class.
+ * 
+ * If there is any class that wants to provide a Policy implementation, all
+ * abstract methods in this SPI should be implemented.
+ * 
+ * The detailed implementations should offer a public constructor, in which a
+ * Policy.Paramters implementation acts as an input parameter.If the
+ * Policy.Paramters input cannot by understood by the constructor, an
+ * IllegalArgumentException will be thrown.
+ * 
+ * @since 1.6
+ */
+public abstract class PolicySpi {
+
+	public PolicySpi() {
+		// default constructor
+	}
+
+	/**
+	 * Answers if the policy has granted a Permission to a
+	 * ProtectionDomain.
+	 * 
+	 * @param domain -
+	 *            the domain to check.
+	 * @param permission -
+	 *            check whether this permission is granted to the specified
+	 *            domain.
+	 * @return - true if the permission is granted to the domain.
+	 * 
+	 */
+	protected abstract boolean engineImplies(ProtectionDomain domain,
+			Permission permission);
+
+	/**
+	 * Refreshes/reloads the policy configuration. The behavior of this method
+	 * depends on the implementation. For example, calling refresh on a
+	 * file-based policy will cause the file to be re-read.
+	 * 
+	 * The default implementation of this method does nothing. This method
+	 * should be overridden if a refresh operation is supported by the policy
+	 * implementation.
+	 * 
+	 */
+	protected void engineRefresh() {
+		// do nothing in default implementation
+	}
+
+	/**
+	 * Answers a PermissionCollection object containing the set of permissions
+	 * granted to the specified CodeSource.
+	 * 
+	 * The default implementation of this method returns
+	 * Policy.UNSUPPORTED_EMPTY_COLLECTION object. This method can be overridden
+	 * if the policy implementation can return a set of permissions granted to a
+	 * CodeSource.
+	 * 
+	 * @param codesource -
+	 *            the CodeSource to which the returned PermissionCollection has
+	 *            been granted.
+	 * @return a set of permissions granted to the specified CodeSource. If this
+	 *         operation is supported, the returned set of permissions must be a
+	 *         new mutable instance and it must support heterogeneous Permission
+	 *         types. If this operation is not supported,
+	 *         Policy.UNSUPPORTED_EMPTY_COLLECTION is returned.
+	 */
+	protected PermissionCollection engineGetPermissions(CodeSource codesource) {
+		return Policy.UNSUPPORTED_EMPTY_COLLECTION;
+	}
+
+	/**
+	 * Answers a PermissionCollection object containing the set of permissions
+	 * granted to the specified ProtectionDomain.
+	 * 
+	 * The default implementation of this method returns
+	 * Policy.UNSUPPORTED_EMPTY_COLLECTION object. This method can be overridden
+	 * if the policy implementation can return a set of permissions granted to a
+	 * ProtectionDomain.
+	 * 
+	 * @param domain -
+	 *            the ProtectionDomain to which the returned
+	 *            PermissionCollection has been granted.
+	 * @return a set of permissions granted to the specified ProtectionDomain.
+	 *         If this operation is supported, the returned set of permissions
+	 *         must be a new mutable instance and it must support heterogeneous
+	 *         Permission types. If this operation is not supported,
+	 *         Policy.UNSUPPORTED_EMPTY_COLLECTION is returned.
+	 */
+	protected PermissionCollection engineGetPermissions(ProtectionDomain domain) {
+		return Policy.UNSUPPORTED_EMPTY_COLLECTION;
+	}
+}



Mime
View raw message