/* * Copyright (c) 2000, Oracle and/or its affiliates. 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. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle 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 Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ package com.sun.rmi.rmid; import java.security.*; import java.io.*; import java.util.*; /** * The ExecPermission class represents permission for rmid to execute * a specific command to launch an activation group. An ExecPermission * consists of a pathname of a command to launch an activation group. *
* Pathname is the pathname of the file or directory to grant rmid
* execute permission. A pathname that ends in "/*" (where "/" is
* the file separator character, File.separatorChar
) indicates
* all the files and directories contained in that directory. A pathname
* that ends with "/-" indicates (recursively) all files
* and subdirectories contained in that directory. A pathname consisting of
* the special token "<<ALL FILES>>" matches
* Note: A pathname consisting of a single "*" indicates all the files * in the current directory, while a pathname consisting of a single "-" * indicates all the files in the current directory and * (recursively) all files and subdirectories contained in the current * directory. *
* * * @author Ann Wollrath * * @serial exclude */ public final class ExecPermission extends Permission { /** * UID for serialization */ private static final long serialVersionUID = -6208470287358147919L; private transient FilePermission fp; /** * Creates a new ExecPermission object with the specified path. * path is the pathname of a file or directory. * *
A pathname that ends in "/*" (where "/" is
* the file separator character, File.separatorChar
) indicates
* a directory and all the files contained in that directory. A pathname
* that ends with "/-" indicates a directory and (recursively) all files
* and subdirectories contained in that directory. The special pathname
* "<<ALL FILES>>" matches all files.
*
*
A pathname consisting of a single "*" indicates all the files * in the current directory, while a pathname consisting of a single "-" * indicates all the files in the current directory and * (recursively) all files and subdirectories contained in the current * directory. * * @param path the pathname of the file/directory. */ public ExecPermission(String path) { super(path); init(path); } /** * Creates a new ExecPermission object with the specified path. * path is the pathname of a file or directory. * *
A pathname that ends in "/*" (where "/" is
* the file separator character, File.separatorChar
) indicates
* a directory and all the files contained in that directory. A pathname
* that ends with "/-" indicates a directory and (recursively) all files
* and subdirectories contained in that directory. The special pathname
* "<<ALL FILES>>" matches all files.
*
*
A pathname consisting of a single "*" indicates all the files * in the current directory, while a pathname consisting of a single "-" * indicates all the files in the current directory and * (recursively) all files and subdirectories contained in the current * directory. * * @param path the pathname of the file/directory. * @param actions the action string (unused) */ public ExecPermission(String path, String actions) { this(path); } /** * Checks if this ExecPermission object "implies" the specified permission. *
* More specifically, this method returns true if:
*
and *
* @param obj the object we are testing for equality with this object. * @return true if obj is an ExecPermission, and has the same * pathname as this ExecPermission object, false otherwise. */ public boolean equals(Object obj) { if (obj == this) return true; if (! (obj instanceof ExecPermission)) return false; ExecPermission that = (ExecPermission) obj; return fp.equals(that.fp); } /** * Returns the hash code value for this object. * * @return a hash code value for this object. */ public int hashCode() { return this.fp.hashCode(); } /** * Returns the canonical string representation of the actions. * * @return the canonical string representation of the actions. */ public String getActions() { return ""; } /** * Returns a new PermissionCollection object for storing * ExecPermission objects. *
* A ExecPermissionCollection stores a collection of * ExecPermission permissions. * *
ExecPermission objects must be stored in a manner that allows
* them to be inserted in any order, but that also enables the
* PermissionCollection implies
method
* to be implemented in an efficient (and consistent) manner.
*
* @return a new PermissionCollection object suitable for
* storing ExecPermissions.
*/
public PermissionCollection newPermissionCollection() {
return new ExecPermissionCollection();
}
/**
* readObject is called to restore the state of the ExecPermission
* from a stream.
*/
private synchronized void readObject(java.io.ObjectInputStream s)
throws IOException, ClassNotFoundException
{
s.defaultReadObject();
// init is called to initialize the rest of the values.
init(getName());
}
/**
* Initialize a ExecPermission object. Common to all constructors.
* Also called during de-serialization.
*/
private void init(String path) {
this.fp = new FilePermission(path, "execute");
}
/**
* A ExecPermissionCollection stores a collection
* of ExecPermission permissions. ExecPermission objects
* must be stored in a manner that allows them to be inserted in any
* order, but enable the implies function to evaluate the implies
* method in an efficient (and consistent) manner.
*
* @serial include
*/
private static class ExecPermissionCollection
extends PermissionCollection
implements java.io.Serializable
{
private Vector