All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class icc.db.DBRequest 

java.lang.Object
   |
   +----icc.net.Request
           |
           +----icc.net.DataRequest
                   |
                   +----icc.db.DBRequest
public class DBRequest
extends DataRequest
The DBRequest class represent a data request for updating or retrieving information from the database.

Variable Index

o anchor
An empty database request to the authentication service.
o AUTHENTICATION
The name of a service that provides for user authentication.
o illegalAccess
An exception to specify that a user's access rights are insufficient.

Constructor Index

o DBRequest(String, int, Class)
o DBRequest(String, Object, Class)

Method Index

o authenticate(String)
Creates a database request for a user to authenticate him/herself.
o authenticate(String, byte[], byte[])
Creates a database request for an agent or mediator to authenticate itself.
o changePassword(String, String)
Creates a data request for a user to change his/her password.
o checkTrust(String)
Creates a data request for a user to check for permanent trust with respect to a mediator's owner.
o raise()
Stores an ill-formed request exception as the request's result.
o raise(Exception)
Stores the specified exception as the request's result.
o removeTrust(String)
Creates a data request for a user to remove permanent trust with respect to a mediator's owner.
o serve(Object)
o setInput(Object, int)
o setTrust(String)
Creates a data request for a user to indicate permanent trust with respect to a mediator's owner.

Variables

o AUTHENTICATION 
 public static final String AUTHENTICATION
The name of a service that provides for user authentication.

o anchor 
 public static final DBRequest anchor
An empty database request to the authentication service.

o illegalAccess 
 public static final Exception illegalAccess
An exception to specify that a user's access rights are insufficient.

Constructors

o DBRequest 
 protected DBRequest(String type,
                     int n,
                     Class output)
o DBRequest 
 protected DBRequest(String type,
                     Object input,
                     Class output)

Methods

o setInput 
 protected void setInput(Object obj,
                         int n)
Overrides:
setInput in class DataRequest
o serve 
 protected void serve(Object output)
Overrides:
serve in class DataRequest
o raise 
 public void raise(Exception e)
Stores the specified exception as the request's result.

Parameters:
e - an exception
Overrides:
raise in class DataRequest
o raise 
 public void raise()
Stores an ill-formed request exception as the request's result.

Overrides:
raise in class DataRequest
o authenticate 
 public static DBRequest authenticate(String pwd)
Creates a database request for a user to authenticate him/herself. This request can only be submitted by the partner self. If successful, an appropriate event is posted.

Parameters:
pwd - the user's password.
Returns:
a database request to authenticate oneself
See Also:
SERVICE, UserEvents
o authenticate 
 public static DBRequest authenticate(String name,
                                      byte message[],
                                      byte signature[])
Creates a database request for an agent or mediator to authenticate itself.

Parameters:
name - registration name
message - the signed message
signature - the message's signature
Returns:
a database request to authenticate by signature
See Also:
SERVICE
o changePassword 
 public DataRequest changePassword(String old,
                                   String pwd)
Creates a data request for a user to change his/her password. This request can only be submitted by the partner self.

Parameters:
old - the user's old password.
pwd - the user's new password.
Returns:
a database request to change one's password
See Also:
SERVICE
o setTrust 
 public DataRequest setTrust(String site)
Creates a data request for a user to indicate permanent trust with respect to a mediator's owner. This request can only be submitted by the partner self.

Parameters:
site - the name of the mediator's owner or site
Returns:
a database request to indicate trust
See Also:
SERVICE
o removeTrust 
 public DataRequest removeTrust(String site)
Creates a data request for a user to remove permanent trust with respect to a mediator's owner. This request can only be submitted by the partner self.

Parameters:
site - the name of the mediator's owner or site
Returns:
a database request to remove trust
See Also:
SERVICE
o checkTrust 
 public DataRequest checkTrust(String site)
Creates a data request for a user to check for permanent trust with respect to a mediator's owner. This request can only be submitted by the partner self.

Parameters:
site - the name of the mediator's owner or site
Returns:
a database request to check trust
See Also:
SERVICE 
All Packages  Class Hierarchy  This Package  Previous  Next  Index

This website has been archived and is no longer maintained.