[#384] FIX Control Panel: empty help URL values (#386)

Maxim Thomas

29.01.2024 0cf4a67b0e8eeb8065d5df84238ee690906131eb

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
/*
 * The contents of this file are subject to the terms of the Common Development and
 * Distribution License (the License). You may not use this file except in compliance with the
 * License.
 *
 * You can obtain a copy of the License at legal/CDDLv1.0.txt. See the License for the
 * specific language governing permission and limitations under the License.
 *
 * When distributing Covered Software, include this CDDL Header Notice in each file and include
 * the License file at legal/CDDLv1.0.txt. If applicable, add the following below the CDDL
 * Header, with the fields enclosed by brackets [] replaced by your own identifying
 * information: "Portions Copyright [year] [name of copyright owner]".
 *
 * Copyright 2016 ForgeRock AS.
 */
package org.forgerock.opendj.rest2ldap;
 
import org.forgerock.api.models.ApiDescription;
import org.forgerock.http.ApiProducer;
import org.forgerock.json.resource.ActionRequest;
import org.forgerock.json.resource.ActionResponse;
import org.forgerock.json.resource.CreateRequest;
import org.forgerock.json.resource.DeleteRequest;
import org.forgerock.json.resource.PatchRequest;
import org.forgerock.json.resource.QueryRequest;
import org.forgerock.json.resource.QueryResourceHandler;
import org.forgerock.json.resource.QueryResponse;
import org.forgerock.json.resource.ReadRequest;
import org.forgerock.json.resource.Request;
import org.forgerock.json.resource.RequestHandler;
import org.forgerock.json.resource.ResourceException;
import org.forgerock.json.resource.ResourceResponse;
import org.forgerock.json.resource.UpdateRequest;
import org.forgerock.services.context.Context;
import org.forgerock.services.descriptor.Describable;
import org.forgerock.util.Reject;
import org.forgerock.util.promise.Promise;
 
/** Decorator for a request handler that can return an api descriptor of the underlying handler. */
public class DescribableRequestHandler implements RequestHandler, Describable<ApiDescription, Request> {
    private final RequestHandler delegate;
    private final Describable<ApiDescription, Request> describableDelegate;
    private ApiDescription api;
 
    /**
     * Builds an object decorating the provided handler.
     *
     * @param handler
     *          the handler to decorate.
     */
    @SuppressWarnings("unchecked")
    public DescribableRequestHandler(final RequestHandler handler) {
        this.delegate = Reject.checkNotNull(handler);
        this.describableDelegate = delegate instanceof Describable
            ? (Describable<ApiDescription, Request>) delegate
            : null;
    }
 
    @Override
    public Promise<ActionResponse, ResourceException> handleAction(Context context, ActionRequest request) {
        return delegate.handleAction(wrap(context), request);
    }
 
    @Override
    public Promise<ResourceResponse, ResourceException> handleCreate(Context context, CreateRequest request) {
        return delegate.handleCreate(wrap(context), request);
    }
 
    @Override
    public Promise<ResourceResponse, ResourceException> handleDelete(Context context, DeleteRequest request) {
        return delegate.handleDelete(wrap(context), request);
    }
 
    @Override
    public Promise<ResourceResponse, ResourceException> handlePatch(Context context, PatchRequest request) {
        return delegate.handlePatch(wrap(context), request);
    }
 
    @Override
    public Promise<QueryResponse, ResourceException> handleQuery(
            Context context, QueryRequest request, QueryResourceHandler handler) {
        return delegate.handleQuery(wrap(context), request, handler);
    }
 
    @Override
    public Promise<ResourceResponse, ResourceException> handleRead(Context context, ReadRequest request) {
        return delegate.handleRead(wrap(context), request);
    }
 
    @Override
    public Promise<ResourceResponse, ResourceException> handleUpdate(Context context, UpdateRequest request) {
        return delegate.handleUpdate(wrap(context), request);
    }
 
    /**
     * Allows sub classes to wrap the provided context and return the wrapping context.
     *
     * @param context
     *          the context to wrap
     * @return the wrapping context that should be used
     */
    protected Context wrap(final Context context) {
        return context;
    }
 
    @Override
    public ApiDescription api(ApiProducer<ApiDescription> producer) {
        if (describableDelegate != null) {
            api = describableDelegate.api(producer);
        }
        return api;
    }
 
    @Override
    public ApiDescription handleApiRequest(Context context, Request request) {
        return api;
    }
 
    @Override
    public void addDescriptorListener(Describable.Listener listener) {
        if (describableDelegate != null) {
            describableDelegate.addDescriptorListener(listener);
        }
    }
 
    @Override
    public void removeDescriptorListener(Describable.Listener listener) {
        if (describableDelegate != null) {
            describableDelegate.removeDescriptorListener(listener);
        }
    }
}