Agent System POND 1.2 (28.2.2002)

PkgAgentSystem.Classification
Interface AgentClassification

All Known Subinterfaces:
CertificateClassification, RegularCustomerClassification, RevocationCheckCertificateClassification

public interface AgentClassification

Base class for additional classifications. Additional classifications are optional data an agent may provide to receive more or cheaper permissions (but need not). They need not be understood by the agent system and therefore might have no result after presenting them. A classifications has a status, which ranges from "unknown" over "to check" to "accepted" and "rejected".

Version:
1.0, 1.7.2000
Author:
Michael Sonntag
See Also:
ClassificationSet

Field Summary
static int ACCEPTED
          The classification was accepted.
static int CHECK_CURRENTLY_IMPOSSIBLE
          The agent system could not verify the classification, however it seems that this was because of a temporary problem.
static int CHECK_IMPOSSIBLE
          The agent system could not verify the classification.
static int IGNORE
          This classification should be or is ignored
static int REJECTED
          The classification was rejected.
static int REQUEST_CHECK
          The agent requests from the agent system to check this classification.
static int UNKNOWN_CLASSIFICATION
          The agent system does not recognize this classification
 
Method Summary
 int getClassificationStatus()
          Returns the current status of this classification.
 void setClassificationStatus(int newStatus)
          Sets the status of this classification.
 

Field Detail

UNKNOWN_CLASSIFICATION

public static final int UNKNOWN_CLASSIFICATION
The agent system does not recognize this classification

IGNORE

public static final int IGNORE
This classification should be or is ignored

REQUEST_CHECK

public static final int REQUEST_CHECK
The agent requests from the agent system to check this classification. This might be done or not.

CHECK_CURRENTLY_IMPOSSIBLE

public static final int CHECK_CURRENTLY_IMPOSSIBLE
The agent system could not verify the classification, however it seems that this was because of a temporary problem. The agent is encouraged to resubmit at a later time.

CHECK_IMPOSSIBLE

public static final int CHECK_IMPOSSIBLE
The agent system could not verify the classification. This is a permanent problem which is unlikely to change. Resubmission is discouraged.

ACCEPTED

public static final int ACCEPTED
The classification was accepted. This does not guarantee, that the agent profits from it (e. g. if he already possesses the permissions this classification would grant).

REJECTED

public static final int REJECTED
The classification was rejected. The check could be completed but failed. No permissions are granted and some systems even might decrease permissions because of this (e. g. presenting a wrong/revoked certificate).
Method Detail

getClassificationStatus

public int getClassificationStatus()
Returns the current status of this classification. Is one of the constants defined in this interface.
Returns:
the status of the classification

setClassificationStatus

public void setClassificationStatus(int newStatus)
Sets the status of this classification. Must be one of the constants defined in this interface.
Should include the following code before setting the new status:
SecurityManager security=System.getSecurityManager();
if(security!=null)
security.checkPermission(new RuntimePermission("setClassification"));
Parameters:
newStatus - the new status
Throws:
SecurityException - if the caller may not modify the status of the classification

Agent System POND 1.2 (28.2.2002)

Submit a bug

Copyright 2001,2002 Michael Sonntag & Institute for Information Processing and Microprocessor Technology (FIM), Johannes-Kepler-University Linz, Altenbergerstr. 69, A-4040 Linz, Austria.