summaryrefslogtreecommitdiffstats
path: root/pki/base/common/src/com/netscape/certsrv/profile/IProfileSubsystem.java
blob: cf54a4ba43ab0ca31b8a7ab190c190f793f16323 (plain)
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
// --- BEGIN COPYRIGHT BLOCK ---
// This program is free software; you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation; version 2 of the License.
//
// This program 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 General Public License for more details.
//
// You should have received a copy of the GNU General Public License along
// with this program; if not, write to the Free Software Foundation, Inc.,
// 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
//
// (C) 2007 Red Hat, Inc.
// All rights reserved.
// --- END COPYRIGHT BLOCK ---
package com.netscape.certsrv.profile;


import java.util.*;
import com.netscape.certsrv.base.*;
import com.netscape.certsrv.request.*;


/**
 * This represents the profile subsystem that manages 
 * a list of profiles.
 *
 * @version $Revision$, $Date$
 */
public interface IProfileSubsystem extends ISubsystem {
    public static final String ID = "profile";

    /**
     * Retrieves a profile by id.
     *
     * @return profile
     * @exception EProfileException failed to retrieve
     */
    public IProfile getProfile(String id)
        throws EProfileException;

    /**
     * Checks if a profile is approved by an agent or not.
     *
     * @param id profile id
     * @return true if profile is approved
     */
    public boolean isProfileEnable(String id);

    /**
     * Retrieves the approver of the given profile.
     *
     * @param id profile id
     * @return user id of the agent who has approved the profile
     */
    public String getProfileEnableBy(String id);

    /**
     * Creates new profile.
     *
     * @param id profile id
     * @param classid implementation id
     * @param className class Name
     * @param configFile configuration file
     * @exception EProfileException failed to create profile
     */
    public IProfile createProfile(String id, String classid, 
        String className, String configFile) 
        throws EProfileException;

    /**
     * Deletes profile.
     *
     * @param id profile id
     * @param configFile configuration file
     * @exception EProfileException failed to delete profile
     */
    public void deleteProfile(String id, String configFile) 
        throws EProfileException;

    /**
     * Creates a new profile configuration file.
     *
     * @param id profile id
     * @param classId implementation id
     * @param configPath location to create the configuration file
     * @exception failed to create profile
     */
    public void createProfileConfig(String id, String classId,
        String configPath) throws EProfileException;

    /**
     * Enables a profile.
     *
     * @param id profile id
     * @param enableBy agent's user id
     * @exception EProfileException failed to enable profile
     */
    public void enableProfile(String id, String enableBy)
        throws EProfileException;

    /**
     * Disables a profile.
     *
     * @param id profile id
     * @exception EProfileException failed to disable
     */
    public void disableProfile(String id)
        throws EProfileException;

    /**
     * Retrieves the id of the implementation of the given profile.
     *
     * @param id profile id
     * @return implementation id managed by the registry
     */
    public String getProfileClassId(String id);

    /**
     * Retrieves a list of profile ids. The return
     * list is of type String.
     *
     * @return a list of profile ids
     */
    public Enumeration getProfileIds();

    /**
     * Checks if owner id should be enforced during profile approval.
     *
     * @return true if approval should be checked
     */
    public boolean checkOwner();

}