- /*
- * @(#)MBeanTrustPermission.java 1.15 03/12/19
- *
- * Copyright 2004 Sun Microsystems, Inc. All rights reserved.
- * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
- */
-
- package javax.management;
-
- import java.security.BasicPermission;
-
- /**
- * This permission represents "trust" in a signer or codebase.
- * <p>
- * MBeanTrustPermission contains a target name but no actions list.
- * A single target name, "register", is defined for this permission.
- * The target "*" is also allowed, permitting "register" and any future
- * targets that may be defined.
- * Only the null value or the empty string are allowed for the action
- * to allow the policy object to create the permissions specified in
- * the policy file.
- * <p>
- * If a signer, or codesource is granted this permission, then it is
- * considered a trusted source for MBeans. Only MBeans from trusted
- * sources may be registered in the MBeanServer.
- *
- * @since 1.5
- * @since.unbundled JMX 1.2
- */
- public class MBeanTrustPermission extends BasicPermission {
-
- private static final long serialVersionUID = -2952178077029018140L;
-
- /** <p>Create a new MBeanTrustPermission with the given name.</p>
- <p>This constructor is equivalent to
- <code>MBeanTrustPermission(name,null)</code>.</p>
- @param name the name of the permission. It must be
- "register" or "*" for this permission.
- @exception NullPointerException if the name is null.
- @exception IllegalArgumentException if the name is neither
- "register" nor "*".
- */
- public MBeanTrustPermission(String name) {
- this(name, null);
- }
-
- /** <p>Create a new MBeanTrustPermission with the given name.</p>
- @param name the name of the permission. It must be
- "register" or "*" for this permission.
- @param actions the actions for the permission. It must be
- null or <code>""</code>.
- @exception NullPointerException if the name is null.
- @exception IllegalArgumentException if the name is neither
- "register" nor "*"; or if <code>actions</code> is a non-null
- non-empty string.
- */
- public MBeanTrustPermission(String name, String actions) {
- super(name, actions);
- /* Check that actions is a null empty string */
- if (actions != null && actions.length() > 0)
- throw new IllegalArgumentException("MBeanTrustPermission " +
- "actions must be null: " +
- actions);
-
- if (!name.equals("register") && !name.equals("*"))
- throw new IllegalArgumentException("MBeanTrustPermission: " +
- "Unknown target name " +
- "[" + name + "]");
- }
- }