class LdapResource extends AlpineResource {

    private static final Logger LOGGER = Logger.getLogger(LdapResource.class);

    @GET
    @Path("/groups")
    @Produces(MediaType.APPLICATION_JSON)
    @ApiOperation(
            value = "Returns the DNs of all accessible groups within the directory",
            response = String.class,
            responseContainer = "List",
            responseHeaders = @ResponseHeader(name = TOTAL_COUNT_HEADER, response = Long.class, description = "The total number of ldap groups that match the specified search criteria"),
            notes = """
                    <p>
                      This API performs a pass-through query to the configured LDAP server.
                      Search criteria results are cached using default Alpine CacheManager policy.
                    <p>
                    <p>Requires permission <strong>ACCESS_MANAGEMENT</strong></p>"""
    )
    @ApiResponses(value = {
            @ApiResponse(code = 401, message = "Unauthorized")
    })
    @PermissionRequired(Permissions.Constants.ACCESS_MANAGEMENT)
    public Response retrieveLdapGroups () {<FILL_FUNCTION_BODY>}

    @GET
    @Path("/team/{uuid}")
    @Produces(MediaType.APPLICATION_JSON)
    @ApiOperation(
            value = "Returns the DNs of all groups mapped to the specified team",
            response = String.class,
            responseContainer = "List",
            notes = "<p>Requires permission <strong>ACCESS_MANAGEMENT</strong></p>"
    )
    @ApiResponses(value = {
            @ApiResponse(code = 401, message = "Unauthorized"),
            @ApiResponse(code = 404, message = "The UUID of the team could not be found"),
    })
    @PermissionRequired(Permissions.Constants.ACCESS_MANAGEMENT)
    public Response retrieveLdapGroups (@ApiParam(value = "The UUID of the team to retrieve mappings for", format = "uuid", required = true)
                                        @PathParam("uuid") @ValidUuid String uuid) {
        try (QueryManager qm = new QueryManager()) {
            final Team team = qm.getObjectByUuid(Team.class, uuid);
            if (team != null) {
                final List<MappedLdapGroup> mappings = qm.getMappedLdapGroups(team);
                return Response.ok(mappings).build();
            } else {
                return Response.status(Response.Status.NOT_FOUND).entity("The UUID of the team could not be found.").build();
            }
        }
    }

    @PUT
    @Path("/mapping")
    @Produces(MediaType.APPLICATION_JSON)
    @ApiOperation(
            value = "Adds a mapping",
            response = MappedLdapGroup.class,
            notes = "<p>Requires permission <strong>ACCESS_MANAGEMENT</strong></p>"
    )
    @ApiResponses(value = {
            @ApiResponse(code = 401, message = "Unauthorized"),
            @ApiResponse(code = 404, message = "The UUID of the team could not be found"),
            @ApiResponse(code = 409, message = "A mapping with the same team and dn already exists")
    })
    @PermissionRequired(Permissions.Constants.ACCESS_MANAGEMENT)
    public Response addMapping(MappedLdapGroupRequest request) {
        final Validator validator = super.getValidator();
        failOnValidationError(
                validator.validateProperty(request, "team"),
                validator.validateProperty(request, "dn")
        );
        try (QueryManager qm = new QueryManager()) {
            final Team team = qm.getObjectByUuid(Team.class, request.getTeam());
            if (team != null) {
                if (!qm.isMapped(team, request.getDn())) {
                    final MappedLdapGroup mapping = qm.createMappedLdapGroup(team, request.getDn());
                    return Response.ok(mapping).build();
                } else {
                    return Response.status(Response.Status.CONFLICT).entity("A mapping with the same team and dn already exists.").build();
                }
            } else {
                return Response.status(Response.Status.NOT_FOUND).entity("The UUID of the team could not be found.").build();
            }
        }
    }

    @DELETE
    @Path("/mapping/{uuid}")
    @Produces(MediaType.APPLICATION_JSON)
    @ApiOperation(
            value = "Removes a mapping",
            response = MappedLdapGroup.class,
            notes = "<p>Requires permission <strong>ACCESS_MANAGEMENT</strong></p>"
    )
    @ApiResponses(value = {
            @ApiResponse(code = 401, message = "Unauthorized"),
            @ApiResponse(code = 404, message = "The UUID of the mapping could not be found"),
    })
    @PermissionRequired(Permissions.Constants.ACCESS_MANAGEMENT)
    public Response deleteMapping(
            @ApiParam(value = "The UUID of the mapping to delete", format = "uuid", required = true)
            @PathParam("uuid") @ValidUuid String uuid) {
        try (QueryManager qm = new QueryManager()) {
            final MappedLdapGroup mapping = qm.getObjectByUuid(MappedLdapGroup.class, uuid);
            if (mapping != null) {
                qm.delete(mapping);
                return Response.status(Response.Status.NO_CONTENT).build();
            } else {
                return Response.status(Response.Status.NOT_FOUND).entity("The UUID of the mapping could not be found.").build();
            }
        }
    }
}

        if (!LdapConnectionWrapper.LDAP_CONFIGURED) {
            return Response.ok().build();
        }
        if (getAlpineRequest().getFilter() == null) {
            return Response.status(Response.Status.NO_CONTENT).build();
        }
        List<String> groups = CacheManager.getInstance().get(ArrayList.class, "ldap-group-search:" + getAlpineRequest().getFilter());
        if (groups == null) {
            final LdapConnectionWrapper ldap = new LdapConnectionWrapper();
            DirContext dirContext = null;
            try {
                dirContext = ldap.createDirContext();
                groups = ldap.searchForGroupName(dirContext, getAlpineRequest().getFilter());
                CacheManager.getInstance().put("ldap-group-search:" + getAlpineRequest().getFilter(), groups);
            } catch (SizeLimitExceededException e) {
                LOGGER.warn("The LDAP server did not return results from the specified search criteria as the result list would have exceeded the size limit specified by the LDAP server");
                return Response.status(Response.Status.NO_CONTENT).build();
            } catch (NamingException e) {
                LOGGER.error("An error occurred attempting to retrieve a list of groups from the configured LDAP server", e);
                return Response.status(Response.Status.INTERNAL_SERVER_ERROR).build();
            } finally {
                ldap.closeQuietly(dirContext);
            }
        }
        final List<String> result = groups.stream()
                .skip(getAlpineRequest().getPagination().getOffset())
                .limit(getAlpineRequest().getPagination().getLimit())
                .collect(Collectors.toList());
        return Response.ok(result).header(TOTAL_COUNT_HEADER, groups.size()).build();
    
<no_super_class>