Daemon. A DaemonPermission consists of a
* target name and a list of actions associated with it.
* * In this specification version the only available target name for this * permission is "control", but further releases may add more target * names to fine-tune the access that needs to be granted to the caller. *
** Actions are defined by a string of comma-separated values, as shown in the * table below. The empty string implies no permission at all, while the * special "*" value implies all permissions for the given * name: *
**
| Target"Name | *Action | *Description | *
|---|---|---|
| "control" | *"start" | *
* The permission to call the start() method in an instance
* of a DaemonController interface.
* |
*
| "stop" | *
* The permission to call the stop() method in an instance
* of a DaemonController interface.
* |
* |
| "shutdown" | *
* The permission to call the shutdown() method in an instance
* of a DaemonController interface.
* |
* |
| "reload" | *
* The permission to call the reload() method in an instance
* of a DaemonController interface.
* |
* |
| "*" | ** The special wildcard action implies all above-mentioned action. This is * equal to construct a permission with the "start, stop, shutdown, * reload" list of actions. * | *
DaemonController.start() method.
*/
protected static final String CONTROL_START = "start";
/**
* The action name associated with the permission to call the
* DaemonController.stop() method.
*/
protected static final String CONTROL_STOP = "stop";
/**
* The action name associated with the permission to call the
* DaemonController.shutdown() method.
*/
protected static final String CONTROL_SHUTDOWN = "shutdown";
/**
* The action name associated with the permission to call the
* DaemonController.reload() method.
*/
protected static final String CONTROL_RELOAD = "reload";
/**
* The action mask associated with the permission to call the
* DaemonController.start() method.
*/
protected static final int MASK_CONTROL_START = 0x01;
/**
* The action mask associated with the permission to call the
* DaemonController.stop() method.
*/
protected static final int MASK_CONTROL_STOP = 0x02;
/**
* The action mask associated with the permission to call the
* DaemonController.shutdown() method.
*/
protected static final int MASK_CONTROL_SHUTDOWN = 0x04;
/**
* The action mask associated with the permission to call the
* DaemonController.reload() method.
*/
protected static final int MASK_CONTROL_RELOAD = 0x08;
/**
* The "wildcard" action implying all actions for the given
* target name.
*/
protected static final String WILDCARD = "*";
/* ==================================================================== */
/* Instance variables */
/** The type of this permission object. */
private transient int type = 0;
/** The permission mask associated with this permission object. */
private transient int mask = 0;
/** The String representation of this permission object. */
private transient String desc = null;
/* ==================================================================== */
/* Constructors */
/**
* Create a new DaemonPermission instance with a specified
* permission name.
*
* This constructor will create a new DaemonPermission
* instance that will not grant any permission to the caller.
*
* @param target The target name of this permission.
* @exception IllegalArgumentException If the specified target name is not
* supported.
*/
public DaemonPermission (String target)
throws IllegalArgumentException {
// Setup the target name of this permission object.
super(target);
// Check if the permission target name was specified
if (target==null)
throw new IllegalArgumentException("Null permission name");
// Check if this is a "control" permission and set up accordingly.
if (CONTROL.equalsIgnoreCase(target)) {
type=TYPE_CONTROL;
return;
}
// If we got here, we have an invalid permission name.
throw new IllegalArgumentException("Invalid permission name \""+
target+"\" specified");
}
/**
* Create a new DaemonPermission instance with a specified
* permission name and a specified list of actions.
*
*
* * @param target The target name of this permission. * @param actions The list of actions permitted by this permission. * @exception IllegalArgumentException If the specified target name is not * supported, or the specified list of actions includes an * invalid value. */ public DaemonPermission(String target, String actions) throws IllegalArgumentException { // Setup this instance's target name. this(target); // Create the appropriate mask if this is a control permission. if (this.type==TYPE_CONTROL) { this.mask=this.createControlMask(actions); return; } } /* ==================================================================== */ /* Public methods */ /** * Return the list of actions permitted by this instance of *DaemonPermission in its canonical form.
*
* @return The canonicalized list of actions.
*/
public String getActions() {
if (this.type==TYPE_CONTROL) {
return(this.createControlActions(this.mask));
}
return("");
}
/**
* Return the hash code for this DaemonPermission instance.
*
* @return An hash code value.
*/
public int hashCode() {
this.setupDescription();
return(this.desc.hashCode());
}
/**
* Check if a specified object equals DaemonPermission.
*
* @return true or false wether the specified object equals
* this DaemonPermission instance or not.
*/
public boolean equals(Object object) {
if (object == this) return(true);
if (!(object instanceof DaemonPermission)) return false;
DaemonPermission that = (DaemonPermission)object;
if (this.type!=that.type) return(false);
return(this.mask==that.mask);
}
/**
* Check if this DaemonPermission implies another
* Permission.
*
* @return true or false wether the specified permission
* is implied by this DaemonPermission instance or
* not.
*/
public boolean implies(Permission permission) {
if (permission == this) return(true);
if (!(permission instanceof DaemonPermission)) return false;
DaemonPermission that = (DaemonPermission)permission;
if (this.type!=that.type) return(false);
return((this.mask&that.mask)==that.mask);
}
/**
* Return a String representation of this instance.
*
* @return A String representing this
* DaemonPermission instance.
*/
public String toString() {
this.setupDescription();
return(new String(this.desc));
}
/* ==================================================================== */
/* Private methods */
/** Create a String description for this permission instance. */
private void setupDescription() {
if (this.desc!=null) return;
StringBuffer buf=new StringBuffer();
buf.append(this.getClass().getName());
buf.append('[');
switch (this.type) {
case (TYPE_CONTROL): {
buf.append(CONTROL);
break;
}
default: {
buf.append("UNKNOWN");
break;
}
}
buf.append(':');
buf.append(this.getActions());
buf.append(']');
this.desc=buf.toString();
}
/** Create a permission mask for a given control actions string. */
private int createControlMask(String actions)
throws IllegalArgumentException {
if (actions==null) return(0);
int mask=0;
StringTokenizer tok=new StringTokenizer(actions,",",false);
while (tok.hasMoreTokens()) {
String val=tok.nextToken().trim();
if (WILDCARD.equals(val)) {
return(MASK_CONTROL_START|MASK_CONTROL_STOP|
MASK_CONTROL_SHUTDOWN|MASK_CONTROL_RELOAD);
} else if (CONTROL_START.equalsIgnoreCase(val)) {
mask=mask|MASK_CONTROL_START;
} else if (CONTROL_STOP.equalsIgnoreCase(val)) {
mask=mask|MASK_CONTROL_STOP;
} else if (CONTROL_SHUTDOWN.equalsIgnoreCase(val)) {
mask=mask|MASK_CONTROL_SHUTDOWN;
} else if (CONTROL_RELOAD.equalsIgnoreCase(val)) {
mask=mask|MASK_CONTROL_RELOAD;
} else {
throw new IllegalArgumentException("Invalid action name \""+
val+"\" specified");
}
}
return(mask);
}
/** Create a actions list for a given control permission mask. */
private String createControlActions(int mask) {
StringBuffer buf=new StringBuffer();
boolean sep=false;
if ((mask&MASK_CONTROL_START)==MASK_CONTROL_START) {
sep=true;
buf.append(CONTROL_START);
}
if ((mask&MASK_CONTROL_STOP)==MASK_CONTROL_STOP) {
if (sep) buf.append(",");
else sep=true;
buf.append(CONTROL_STOP);
}
if ((mask&MASK_CONTROL_SHUTDOWN)==MASK_CONTROL_SHUTDOWN) {
if (sep) buf.append(",");
else sep=true;
buf.append(CONTROL_SHUTDOWN);
}
if ((mask&MASK_CONTROL_RELOAD)==MASK_CONTROL_RELOAD) {
if (sep) buf.append(",");
else sep=true;
buf.append(CONTROL_RELOAD);
}
return buf.toString();
}
}