Clover Coverage Report
Coverage timestamp: Sun Mar 23 2008 08:24:39 GMT
0   80   1   -
0   8   -   0
0     -  
1    
 
 
  Subject       Line # 46 0 1 - -1.0
 
No Tests
 
1    /*
2    * Copyright (c) 2000-2005, University of Salford
3    * All rights reserved.
4    *
5    * Redistribution and use in source and binary forms, with or without
6    * modification, are permitted provided that the following conditions are met:
7    *
8    * Redistributions of source code must retain the above copyright notice, this
9    * list of conditions and the following disclaimer.
10    *
11    * Redistributions in binary form must reproduce the above copyright notice,
12    * this list of conditions and the following disclaimer in the documentation
13    * and/or other materials provided with the distribution.
14    *
15    * Neither the name of the University of Salford nor the names of its
16    * contributors may be used to endorse or promote products derived from this
17    * software without specific prior written permission.
18    *
19    * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
20    * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21    * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22    * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
23    * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24    * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25    * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26    * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27    * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28    * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29    * POSSIBILITY OF SUCH DAMAGE.
30    */
31   
32    package issrg.pba;
33   
34    import java.util.Vector;
35    /**
36    * This is an interface defining basic operations on a Subject. A Subject
37    * object can tell the name of the holder, the set of credentials and contains
38    * a CredentialService object, which provides additional service on the set of
39    * credentials for the AEF (Access decision Enforcement Function, as per
40    * ISO 10181-3 access control framework).
41    *
42    * @author A Otenko
43    * @version 0.2
44    */
45   
 
46    public interface Subject {
47    /**
48    * This method returns the holder of the set of the credentials.
49    *
50    * @return the holders principal object
51    */
52    public java.security.Principal getHolder();
53   
54    /**
55    * This method returns the set of credentials owned by the holder.
56    * In fact, this is the Initiator's ADI (see ISO 10181-3).
57    *
58    * @return the credentials for the subject
59    */
60    public Credentials exportCreds();
61   
62    /**
63    * This method returns the service object. Such objects provide
64    * additional help for the AEF by checking the Session Time, for
65    * example. There can be no service set for a Subject, in which case
66    * <code>null</code> should be returned.
67    *
68    * @return The Credentials service contained by the subject
69    */
70    public CredentialsService getService();
71   
72    /**
73    * This method returns the owner of the Subject object, so the owner
74    * can ensure it uses its own Subjects (and not forged by someone else,
75    * or for expired policy).
76    *
77    * @return the parent PBAAPI
78    */
79    public PBAAPI getOwner();
80    }