1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
/*************************************************************************
/* ProtectionDomain.java -- A security domain
/*
/* Copyright (c) 1998 Free Software Foundation, Inc.
/* Written by Aaron M. Renn (arenn@urbanophile.com)
/*
/* This library is free software; you can redistribute it and/or modify
/* it under the terms of the GNU Library General Public License as published
/* by the Free Software Foundation, either version 2 of the License, or
/* (at your option) any later verion.
/*
/* This library is distributed in the hope that it will be useful, but
/* WITHOUT ANY WARRANTY; without even the implied warranty of
/* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
/* GNU Library General Public License for more details.
/*
/* You should have received a copy of the GNU Library General Public License
/* along with this library; if not, write to the Free Software Foundation
/* Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307 USA
/*************************************************************************/
package java.security;
/**
* This class represents a group of classes, along with the permissions
* they are granted. The classes are identified by a <code>CodeSource</code>.
* Thus, any class loaded from the specified <code>CodeSource</code> is
* treated as part of this domain. The set of permissions is represented
* by a <code>PermissionCollection</code>.
* <p>
* Every class in the system will belong to one and only one
* <code>ProtectionDomain</code>.
*
* @version 0.0
*
* @author Aaron M. Renn (arenn@urbanophile.com)
*/
public class ProtectionDomain
{
/*************************************************************************/
/*
* Class Variables
*/
private static final String linesep = System.getProperty("line.separator");
/*************************************************************************/
/*
* Instance Variables
*/
/**
* This is the <code>CodeSource</code> for this protection domain
*/
private CodeSource code_source;
/**
* This is the set of permissions granted to this domain
*/
private PermissionCollection perms;
/*************************************************************************/
/*
* Constructors
*/
/**
* This method initializes a new instance of <code>ProtectionDomain</code>
* representing the specified <code>CodeSource</code> and permission set.
*
* @param code_source The <code>CodeSource</code> for this domain
* @param perms The permission set for this domain
*/
public
ProtectionDomain(CodeSource code_source, PermissionCollection perms)
{
this.code_source = code_source;
this.perms = perms;
}
/*************************************************************************/
/*
* Instance Methods
*/
/**
* This method returns the <code>CodeSource</code> for this domain.
*
* @return This domain's <code>CodeSource</code>.
*/
public final CodeSource
getCodeSource()
{
return(code_source);
}
/*************************************************************************/
/**
* This method returns the set of permissions granted to this domain.
*
* @return The permission set for this domain
*/
public final PermissionCollection
getPermissions()
{
return(perms);
}
/*************************************************************************/
/**
* This method tests whether or not the specified <code>Permission</code> is
* implied by the set of permissions granted to this domain.
*
* @param perm The <code>Permission</code> to test.
*
* @return <code>true</code> if the specified <code>Permission</code> is implied for this domain, <code>false</code> otherwise.
*/
public boolean
implies(Permission perm)
{
PermissionCollection pc = getPermissions();
if (pc == null)
return(false);
return(pc.implies(perm));
}
/*************************************************************************/
/**
* This method returns a <code>String</code> representation of this
* object. It will print the <code>CodeSource</code> and
* permission set associated with this domain.
*
* @return A <code>String</code> representation of this object.
*/
public String
toString()
{
StringBuffer sb = new StringBuffer("");
sb.append(super.toString() + " (" + linesep);
sb.append(code_source.toString());
sb.append(perms.toString());
sb.append(")" + linesep);
return(sb.toString());
}
} // class ProtectionDomain
|
