com.oopreserch.mercury.protector
Interface ProtectorFactoryInterface

All Known Implementing Classes:

ProtectorFactory

public interface ProtectorFactoryInterface

extends java.rmi.Remote

Create the new instance of Protector and return it. This class depends on Mercury API.

Author:

Jun Inamori

See Also:

ProtectorInterface, Mercury API Documentation, KeyPairBox

Method Summary

ProtectorInterface	getProtector(java.io.Serializable box) Create the new instance of Protector based on the specified KeyPairBox instance and return it.
ProtectorInterface	getProtector(java.lang.String usr, java.lang.String pss) Create the new instance of Protector based on the default KeyPairBox instance and return it.
ProtectorInterface	getProtector(java.lang.String usr, java.lang.String pss, java.lang.String alias) Create the new instance of Protector based on the default KeyPairBox instance and return it.
void	unbindProtector(java.lang.String usr, java.lang.String pss) Can be invoked only by the administrator.

Method Detail

getProtector

public ProtectorInterface getProtector(java.lang.String usr,
                                       java.lang.String pss)
                                throws java.rmi.RemoteException,
                                       com.oopreserch.util.SimpleException,
                                       com.oopreserch.util.NestedException

Create the new instance of Protector based on the default KeyPairBox instance and return it.

The default KeyPairBox is read from the local file, whose path is specified by the configuration XML file.

Parameters:

usr - The user name for the default KeyPairBox.

pss - The password for the default KeyPairBox.

Returns:

ProtectorInterface

Throws:

java.rmi.RemoteException -

com.oopreserch.util.SimpleException -

com.oopreserch.util.NestedException -

See Also:

ProtectorInterface, KeyPairBox

getProtector

public ProtectorInterface getProtector(java.lang.String usr,
                                       java.lang.String pss,
                                       java.lang.String alias)
                                throws java.rmi.RemoteException,
                                       com.oopreserch.util.SimpleException,
                                       com.oopreserch.util.NestedException

Create the new instance of Protector based on the default KeyPairBox instance and return it. The public keys other than the one specified by the alias are removed.

The default KeyPairBox is read from the local file, whose path is specified by the configuration XML file. Because only the public key with the specified alias is contained in the KeyPairBox instance, the data signed and encrypted by the other private keys fails to be decrypted and verified.

Parameters:

usr - The user name for the default KeyPairBox.

pss - The password for the default KeyPairBox.

alias - The name of the public key used to decrypt and verify. Other public keys are removed from the instance of KeyPairBox, which means the data signed and encrypted by the other private keys fails to be decrypted and verified.

Returns:

ProtectorInterface

Throws:

java.rmi.RemoteException -

com.oopreserch.util.SimpleException -

com.oopreserch.util.NestedException -

See Also:

ProtectorInterface, KeyPairBox

getProtector

public ProtectorInterface getProtector(java.io.Serializable box)
                                throws java.rmi.RemoteException,
                                       com.oopreserch.util.NestedException

Create the new instance of Protector based on the specified KeyPairBox instance and return it.

The KeyPairBox is specified as the argument, whose implementation class is Serializable.

Parameters:

box - The serializable KeyPairBox instance.

Returns:

ProtectorInterface

Throws:

java.rmi.RemoteException -

com.oopreserch.util.NestedException -

See Also:

ProtectorInterface, KeyPairBox

unbindProtector

public void unbindProtector(java.lang.String usr,
                            java.lang.String pss)
                     throws java.rmi.RemoteException,
                            java.lang.Exception

Can be invoked only by the administrator.

This method invokes Context.unbind().

Parameters:

usr - The user name for administrator.

pss - The password for administrator.

Throws:

java.rmi.RemoteException -

java.lang.Exception -