oracle.ifs.fdk.impl

Class RemoteLoginManagerImpl

java.lang.Object

oracle.ifs.fdk.impl.RemoteLoginManagerImpl

All Implemented Interfaces:

Remote, RemoteLoginManager

public class RemoteLoginManagerImpl
extends Object
implements RemoteLoginManager

Web service login manager implementation.

Constructor Summary

Constructors

Constructor and Description
RemoteLoginManagerImpl()

Method Summary

Modifier and Type	Method and Description
protected FdkSessionImpl	getConnectedSession() Return the web service session.
NamedValue[]	interopTest(long[] longarray, String[] strings, NamedValue[] nv)
protected boolean	isWebServiceCall() Returns true if the current call was made from a web services client.
protected NamedValue[]	login(FdkCredential c, NamedValue[] options, AttributeRequest[] userAttributes) Internal login method used by web services login managers.
NamedValue[]	login(String username, String password, NamedValue[] options, AttributeRequest[] userAttributes) Start a session authenticated as the given user.
void	logout() Disconnects the current session, if any.
void	referenceTypes(TypeReference ref) Dummy web service method to create a reference to data types used in the web services to insure that they are defined in the WSDL.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RemoteLoginManagerImpl

public RemoteLoginManagerImpl()

Method Detail

login

public NamedValue[] login(String username,
                          String password,
                          NamedValue[] options,
                          AttributeRequest[] userAttributes)
                   throws FdkException

Start a session authenticated as the given user. The current session tracking mechanism is via HTTP session cookies. The client MUST pass back ALL cookies received from the server after this call otherwise the session may be lost.

Specified by:

login in interface RemoteLoginManager

Parameters:

username - The username.

password - The password.

options - Options that should be set on the session. NOTE: Currently no options are supported, this argument is ignored and null can be safely passed.

userAttributes - Optional attributes on the user item that should be returned. Can be null.

Returns:

A NamedValue[] set of properties that contains the following keys (listed below as defined constants and literal strings):
WebServicesConstants.LOGIN_USER ("LOGIN_USER") - The user item, which includes the requested attributes.
WebServicesConstants.SESSION_TIMEOUT ("SESSION_TIMEOUT") - The session inactivity timeout, in seconds.
WebServicesConstants.TRANSACTION_TIMEOUT ("TRANSACTION_TIMEOUT") - The transaction inactivity timeout, in seconds.

Throws:

FdkException

logout

public void logout()
            throws FdkException

Disconnects the current session, if any.

Specified by:

logout in interface RemoteLoginManager

Throws:

FdkException

interopTest

public NamedValue[] interopTest(long[] longarray,
                                String[] strings,
                                NamedValue[] nv)
                         throws FdkException

Throws:

FdkException

isWebServiceCall

protected final boolean isWebServiceCall()

Returns true if the current call was made from a web services client. This check can be made by any subclasses in order to determine functionality and restrictions based on the originating call. This feature should be used lightly and only where really necessary as this is not an idea way of implementing business logic.

referenceTypes

public void referenceTypes(TypeReference ref)

Dummy web service method to create a reference to data types used in the web services to insure that they are defined in the WSDL.

login

protected final NamedValue[] login(FdkCredential c,
                                   NamedValue[] options,
                                   AttributeRequest[] userAttributes)
                            throws FdkException

Internal login method used by web services login managers.

Throws:

FdkException

getConnectedSession

protected final FdkSessionImpl getConnectedSession()
                                            throws FdkException

Return the web service session. The return value is guaranteed to be non-null and to represent a connected session. If the client is not authenticated an FdkException is thrown.

Throws:

FdkException