GEAS::ConnectionFactory
=======================

General Notes:
--------------
    None


Parents:
--------
    None


Methods:
--------

Name:
    guestLogin

Synopsis:
    Connection guestLogin( )

Description:
    This method logs into the database, using the username and password
'guest'. If it succeeds, it returns a valid GEAS::Connection object.

Arguments:
    None

Result:
    A valid connection object.

Exceptions:
    AuthenticationError : The login attempt was rejected
    ServerError         : The server encountered a problem while logging in


Name:
    unsecureLogin
Synopsis:
    unsecureLogin( in string username , in string password )

Description:
    This function checks that the username and password match an entry in
the set of all geas::user business objects. If a match is found, an
appropriate Connection object is returned, otherwise an exception is raised.

    The lack of any encryption or realistic method of preventing forged
object requests means that no real security is implied by this feature.

Arguments:
    username : The user ID of the user logging in
    password : The associated password

Result:
   A valid Connection instance, associated with the username given as input.

Exceptions:
    AuthenticationError : The login attempt was rejected
    ServerError         : The server encountered a problem while logging in

