src.com.ibm.as400.access.UserPermission Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jt400 Show documentation
Show all versions of jt400 Show documentation
The Open Source version of the IBM Toolbox for Java
///////////////////////////////////////////////////////////////////////////////
//
// JTOpen (IBM Toolbox for Java - OSS version)
//
// Filename: UserPermission.java
//
// The source code contained herein is licensed under the IBM Public License
// Version 1.0, which has been approved by the Open Source Initiative.
// Copyright (C) 1997-2001 International Business Machines Corporation and
// others. All rights reserved.
//
///////////////////////////////////////////////////////////////////////////////
package com.ibm.as400.access;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
import java.io.Serializable;
/**
* Represents the authority of a specific user.
* Instances of UserPermission are returned by {@link Permission#getUserPermission(String) Permission.getUserPermission()}
**/
public class UserPermission
implements Cloneable,
Serializable
{
static final long serialVersionUID = 4L;
/**
* Constant indicating that no operation has been done.
**/
final static int COMMIT_NONE = -1;
/**
* Constant indicating that this user has just been added.
**/
final static int COMMIT_ADD = 0;
/**
* Constant indicating that this item has been changed for the object.
**/
final static int COMMIT_REMOVE = 1;
/**
* Constant indicating that this user has just been removed.
**/
final static int COMMIT_CHANGE = 2;
/**
* Constant indicating that this user permission has just been set from authorization list.
**/
final static int COMMIT_FROM_AUTL = 3;
/**
* Constant indicating that this user is neither a user nor a group.
* It may be a *PUBLIC, *NTWIRF, or *NTWEFF.
**/
public final static int GROUPINDICATOR_SPECIALVALUE = 0;
/**
* Constant indicating that this user profile is a user.
**/
public final static int GROUPINDICATOR_USER = 1;
/**
* Constant indicating that this user profile is a group.
**/
public final static int GROUPINDICATOR_GROUP = 2;
// Basic authorities mapping to detailed authorities.
final static boolean[][] basicAutMapping = {
{true, true, true, true, true,
true, true, true, true, true },
{false,false,false,false,false,
false,false,false,false,false },
{true, false,false,false,false,
true, false,false,false,true },
{true, false,false,false,false,
true, true, true, true, true }
};
//Constant indicating basic authority type.
final static int BASIC_USER_DEF = -1;
final static int BASIC_ALL = 0;
final static int BASIC_EXCLUDE = 1;
final static int BASIC_USE = 2;
final static int BASIC_CHANGE = 3;
//Constant indicating data authority type.
final static int DATA_READ = 5;
final static int DATA_ADD = 6;
final static int DATA_UPDATE = 7;
final static int DATA_DELETE = 8;
final static int DATA_EXECUTE = 9;
//Constant indicating object authority type.
final static int OBJECT_OPERATION = 0;
final static int OBJECT_MANAGEMENT = 1;
final static int OBJECT_EXIST = 2;
final static int OBJECT_ALTER = 3;
final static int OBJECT_REFERENCE = 4;
//Authorities information.
boolean[] authorities_;
//Data authority information.
String dataAuthority_;
//Object authority informatin.
int objectAuthority_;
// Authorization list management flag.
private boolean autListMgt_;
// Commit flag
private int committed_;
// The value indicating whether this user profile is a user
// profile or a group profile.
private int groupIndicator_;
// User profile name.
private String userName_;
// Indicates whether the user is from authorization list.
private boolean fromAuthorizationList_;
/**
* Constructs a UserPermission object.
* @param userProfileName The name of the user profile.
*
**/
UserPermission(String userProfileName)
{
authorities_ = new boolean[10];
for(int i=0;i
* -1 COMMIT_NONE means no change and any operation to the object.
* 0 COMMIT_ADD means this user permission which was added
* to the object has not been committed.
* 1 COMMIT_REMOVE means this user permission which was
* removed from the object has not been committed.
* 2 COMMIT_CHANGE means the changes of the content have
* not committed.
*
* @see #setCommitted
**/
int getCommitted()
{
return committed_;
}
/**
* Returns the value indicating if the user profile is a group profile.
* @return The value indicating if the user profile is a group profile.
*
**/
public int getGroupIndicator()
{
return groupIndicator_;
}
/**
* Returns the user profile name for this permission.
* @return The user profile name for this permission.
*
**/
public String getUserID()
{
return userName_;
}
/**
* Indicates whether the user permission is from authorization list.
* @return true if the user is from authorization list;
* false otherwise.
**/
public boolean isFromAuthorizationList()
{
return fromAuthorizationList_;
}
/**
* Indicates whether the user has the authority of authorization list management.
* It is valid only for the object which is an authorization list.
* @return true if the user has the authority of authorization list
* management; false otherwise.
*
**/
public boolean isAuthorizationListManagement()
{
return autListMgt_;
}
/**
* Serialization support.
**/
private void readObject(ObjectInputStream s)
throws ClassNotFoundException, IOException
{
s.defaultReadObject();
s.readObject();
}
/**
* Sets the authority of authorization list management.
* It is valid only for the object which is an authorizaiton list.
* @param autListMgt true if the user has the authority
* of authorization list management; false otherwise.
*
**/
public synchronized void setAuthorizationListManagement(boolean autListMgt )
{
autListMgt_ = autListMgt;
if (getCommitted() == COMMIT_NONE)
{
setCommitted(COMMIT_CHANGE);
}
return;
}
/**
* Sets the committed signal.
* @param commit The committed signal.
* @see #getCommitted()
**/
void setCommitted(int commit)
{
committed_ = commit;
return;
}
/**
* Sets the permission of user as coming from an authorization list.
* This is valid only if the user is *PUBLIC and the authorization list
* exists. If set to true, all of the other authorities will be set to false.
* If any of the other authorities are set to true,
* this value is automatically set to false.
* @param fromAutList true if the user is from the authorization list;
* false otherwise.
*
**/
public synchronized void setFromAuthorizationList(boolean fromAutList)
{
if (fromAuthorizationList_ == fromAutList)
return;
if (fromAutList == true)
{
fromAuthorizationList_ = fromAutList;
for(int i=0;i