jdk/src/share/classes/javax/management/remote/SubjectDelegationPermission.java
changeset 2 90ce3da70b43
child 5506 202f599c92aa
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/jdk/src/share/classes/javax/management/remote/SubjectDelegationPermission.java	Sat Dec 01 00:00:00 2007 +0000
@@ -0,0 +1,96 @@
+/*
+ * Copyright 2003-2007 Sun Microsystems, Inc.  All Rights Reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.  Sun designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Sun in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
+ * CA 95054 USA or visit www.sun.com if you need additional information or
+ * have any questions.
+ */
+
+package javax.management.remote;
+
+import java.security.BasicPermission;
+
+/**
+ * <p>Permission required by an authentication identity to perform
+ * operations on behalf of an authorization identity.</p>
+ *
+ * <p>A SubjectDelegationPermission contains a name (also referred
+ * to as a "target name") but no actions list; you either have the
+ * named permission or you don't.</p>
+ *
+ * <p>The target name is the name of the authorization principal
+ * classname followed by a period and the authorization principal
+ * name, that is
+ * <code>"<em>PrincipalClassName</em>.<em>PrincipalName</em>"</code>.</p>
+ *
+ * <p>An asterisk may appear by itself, or if immediately preceded
+ * by a "." may appear at the end of the target name, to signify a
+ * wildcard match.</p>
+ *
+ * <p>For example, "*", "javax.management.remote.JMXPrincipal.*" and
+ * "javax.management.remote.JMXPrincipal.delegate" are valid target
+ * names. The first one denotes any principal name from any principal
+ * class, the second one denotes any principal name of the concrete
+ * principal class <code>javax.management.remote.JMXPrincipal</code>
+ * and the third one denotes a concrete principal name
+ * <code>delegate</code> of the concrete principal class
+ * <code>javax.management.remote.JMXPrincipal</code>.</p>
+ *
+ * @since 1.5
+ */
+public final class SubjectDelegationPermission extends BasicPermission {
+
+    private static final long serialVersionUID = 1481618113008682343L;
+
+    /**
+     * Creates a new SubjectDelegationPermission with the specified name.
+     * The name is the symbolic name of the SubjectDelegationPermission.
+     *
+     * @param name the name of the SubjectDelegationPermission
+     *
+     * @throws NullPointerException if <code>name</code> is
+     * <code>null</code>.
+     * @throws IllegalArgumentException if <code>name</code> is empty.
+     */
+    public SubjectDelegationPermission(String name) {
+        super(name);
+    }
+
+    /**
+     * Creates a new SubjectDelegationPermission object with the
+     * specified name.  The name is the symbolic name of the
+     * SubjectDelegationPermission, and the actions String is
+     * currently unused and must be null.
+     *
+     * @param name the name of the SubjectDelegationPermission
+     * @param actions must be null.
+     *
+     * @throws NullPointerException if <code>name</code> is
+     * <code>null</code>.
+     * @throws IllegalArgumentException if <code>name</code> is empty
+     * or <code>actions</code> is not null.
+     */
+    public SubjectDelegationPermission(String name, String actions) {
+        super(name, actions);
+
+        if (actions != null)
+            throw new IllegalArgumentException("Non-null actions");
+    }
+}