first version sent out to Iain and Pierre
[vamsas.git] / src / org / vamsas / client / IclientFactory.java
1 /*
2  * Created on 13-Sep-2005
3  *
4  * TODO To change the template for this generated file go to
5  * Window - Preferences - Java - Code Style - Code Templates
6  */
7 package org.vamsas.client;
8
9 /**
10  * Defines methods for instantiating Vorba client application agents
11  * @author jimp
12  *
13  * (it's VORBA, not CORBA!)
14  */
15
16    public interface IclientFactory {
17
18      /**
19       * Create a new Vorba Session
20       * @param ApplicationHandle is the application's VAMSAS handle string
21       */
22         Iclient getIclient(ClientHandle ApplicationHandle);
23         /**
24          * returns new Vorba for a given session.
25          * @param ApplicationHandle
26          * @param SessionUrn locates the session that the client should attach to
27          * @return
28          */
29        Iclient getIclient(ClientHandle ApplicationHandle, String SessionUrn);
30        /**
31         * returns new vorba for a  given session acting as a particular identity
32         * @param ApplicationHandle
33         * @param UserId
34         * @param SessionUrn
35         * @return
36         */
37        Iclient getIclient(ClientHandle ApplicationHandle, UserHandle UserId, String SessionUrn);
38        /**
39         * New session for application and specific user
40         * @param ApplicationHandle
41         * @param UserId
42         * @return
43         */
44        Iclient getIclient(ClientHandle ApplicationHandle, UserHandle UserId);
45        
46
47 }