/*
 * Created on 13-Sep-2005
 *
 * TODO To change the template for this generated file go to
 * Window - Preferences - Java - Code Style - Code Templates
 */
package org.vamsas.client;

/**
 * Defines methods for instantiating Vorba client application agents
 * @author jimp
 *
 * (it's VORBA, not CORBA!)
 */

public interface IClientFactory {

     /**
      * Create a new Vorba Session
      * @param applicationHandle is the application's VAMSAS handle string
      */
     	IClient getIClient(ClientHandle applicationHandle);
     	/**
     	 * returns new Vorba for a given session.
     	 * @param applicationHandle
     	 * @param sessionUrn locates the session that the client should attach to
     	 * @return
     	 */
       IClient getIClient(ClientHandle applicationHandle, String sessionUrn);
       /**
        * returns new vorba for a  given session acting as a particular identity
        * @param applicationHandle
        * @param userId
        * @param sessionUrn
        * @return
        */
       IClient getIClient(ClientHandle applicationHandle, UserHandle userId, String sessionUrn);
       /**
        * New session for application and specific user
        * @param applicationHandle
        * @param userId
        * @return
        */
       IClient getIClient(ClientHandle applicationHandle, UserHandle userId);
       

}