forked from apache/directory-fortress-core
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathapi-changes.txt
85 lines (60 loc) · 3.72 KB
/
api-changes.txt
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
Apache Directory Fortress API Change Notice
Date: June 8, 2015
This document was created to provide instructions about the latest Fortress Core api changes.
The changes were made to the source during a recent improvement effort and required the movement of packages.
*******************************************************************************
SECTION A. Only perform this section if running embedded fortress core apis inside your client programs.
*******************************************************************************
1. Change the package name used for the current fortress entity classes.
- search and replace the imports:
import org.apache.directory.fortress.core.rbac;
- with:
import org.apache.directory.fortress.core.model;
2. If using the fortress notNull utility for Strings, change to use Apache Commons StringUtils instead:
- replace the imports:
import org.apache.directory.fortress.core.util.attr.VUtil;
- with:
import org.apache.commons.collections.CollectionUtils;
- replace the statements:
VUtil.isNotNullOrEmpty
- with:
StringUtils.isNotNull
3. If using the fortress notNull utility for Collections, use the Apache Commons CollectionUtils instead.
- replace:
import org.apache.directory.fortress.core.util.attr.VUtil;
- with:
import org.apache.commons.collections.CollectionUtils;
- search and replace:
VUtil.isNotNullOrEmpty
- with:
CollectionUtils.isNotEmpty
(note: 2 & 3 above only apply if using the ‘VUtil.isNotNullOrEmpty' apis inside your code)
4. Use the factories for Manager construction.
- Don’t do this:
AdminMgr adminMgr = new org.apache.directory.fortress.core.impl.AdminMgrImpl();
- Do this instead:
AdminMgr adminMgr = AdminMgrFactory.createInstance();
*******************************************************************************
SECTION B. Only perform this section if needing to preserve an existing fortress DIT to use the latest apis:
*******************************************************************************
5. if storing fortress properties under the ou=Config node, you may need to change one of the ‘ftProps’ attribute:
e.g. cn=DEFAULT, ou=Config, dc=example,dc=com:
- Do not use this:
temporal.validator.dsd:org.apache.directory.fortress.core.rbac.DSDChecker
- Do use this instead:
temporal.validator.dsd:org.apache.directory.fortress.core.impl.DSDChecker
6. If storing (and using) the fortress arbac permissions under the ou=AdminPerms node, you may need to change:
- Do not use these attribute values:
ftObjNm=org.apache.directory.fortress.core.rbac.AdminMgrImpl, ou=AdminPerms, ou=ARBAC, dc=example,dc=com
ftObjNm=org.apache.directory.fortress.core.rbac.AuditMgrImpl, ou=AdminPerms, ou=ARBAC, dc=example,dc=com
ftObjNm=org.apache.directory.fortress.core.rbac.DelAdminMgrImpl, ou=AdminPerms, ou=ARBAC, dc=example,dc=com
ftObjNm=org.apache.directory.fortress.core.rbac.DelReviewMgrImpl, ou=AdminPerms, ou=ARBAC, dc=example,dc=com
ftObjNm=org.apache.directory.fortress.core.rbac.PwPolicyMgrImpl, ou=AdminPerms, ou=ARBAC, dc=example,dc=com
ftObjNm=org.apache.directory.fortress.core.rbac.ReviewMgrImpl, ou=AdminPerms, ou=ARBAC, dc=example,dc=com
- Do use these values:
ftObjNm=org.apache.directory.fortress.core.impl.AdminMgrImpl, ou=AdminPerms, ou=ARBAC, dc=example,dc=com
ftObjNm=org.apache.directory.fortress.core.impl.AuditMgrImpl, ou=AdminPerms, ou=ARBAC, dc=example,dc=com
ftObjNm=org.apache.directory.fortress.core.impl.DelAdminMgrImpl, ou=AdminPerms, ou=ARBAC, dc=example,dc=com
ftObjNm=org.apache.directory.fortress.core.impl.DelReviewMgrImpl, ou=AdminPerms, ou=ARBAC, dc=example,dc=com
ftObjNm=org.apache.directory.fortress.core.impl.PwPolicyMgrImpl, ou=AdminPerms, ou=ARBAC, dc=example,dc=com
ftObjNm=org.apache.directory.fortress.core.impl.ReviewMgrImpl, ou=AdminPerms, ou=ARBAC, dc=example,dc=com