# CommunityWebManager.java

    /*
     * Copyright (C) 2000 - 2026 Silverpeas
     *
     * This program is free software: you can redistribute it and/or modify
     * it under the terms of the GNU Affero General Public License as
     * published by the Free Software Foundation, either version 3 of the
     * License, or (at your option) any later version.
     *
     * As a special exception to the terms and conditions of version 3.0 of
     * the GPL, you may redistribute this Program in connection with Free/Libre
     * Open Source Software ("FLOSS") applications as described in Silverpeas's
     * FLOSS exception. You should have received a copy of the text describing
     * the FLOSS exception, and it is also available here:
     * "http://www.silverpeas.org/docs/core/legal/floss_exception.html"
     *
     * 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 Affero General Public License for more details.
     *
     * You should have received a copy of the GNU Affero General Public License
     * along with this program.  If not, see <http://www.gnu.org/licenses/>.
     */

    package org.silverpeas.components.community;

    import org.silverpeas.components.community.model.CommunityMembership;
    import org.silverpeas.components.community.model.CommunityOfUsers;
    import org.silverpeas.components.community.model.MembershipStatus;
    import org.silverpeas.components.community.notification.user.MembershipLeaveUserNotificationBuilder;
    import org.silverpeas.components.community.notification.user.MembershipRequestUserNotificationBuilder;
    import org.silverpeas.components.community.notification.user.MembershipRequestValidationUserNotificationBuilder;
    import org.silverpeas.core.admin.PaginationPage;
    import org.silverpeas.core.admin.component.model.ComponentInst;
    import org.silverpeas.core.admin.service.AdminException;
    import org.silverpeas.core.admin.service.Administration;
    import org.silverpeas.core.admin.service.OrganizationController;
    import org.silverpeas.core.admin.user.model.SilverpeasRole;
    import org.silverpeas.core.admin.user.model.User;
    import org.silverpeas.core.annotation.Service;
    import org.silverpeas.core.cache.service.CacheAccessorProvider;
    import org.silverpeas.core.util.ServiceProvider;
    import org.silverpeas.core.util.SilverpeasList;
    import org.silverpeas.core.web.mvc.webcomponent.WebMessager;

    import jakarta.annotation.Nonnull;
    import jakarta.annotation.Nullable;
    import jakarta.ws.rs.WebApplicationException;
    import java.util.Objects;
    import java.util.Set;
    import java.util.function.Supplier;

    import static org.silverpeas.components.community.CommunityComponentSettings.getMessagesIn;
    import static org.silverpeas.core.admin.user.model.SilverpeasRole.fromString;
    import static org.silverpeas.kernel.util.StringUtil.getBooleanValue;

    /**
     * WEB manager which allows to centralize code to be used by REST Web Services and Web Component
     * Controller.
     *
     * @author silveryocha
     */
    @Service
    public class CommunityWebManager {

      private static final String CACHE_KEY_PREFIX = CommunityWebManager.class.getSimpleName() + ":";
      public static final PaginationPage NO_PAGINATION = new PaginationPage(1, Integer.MAX_VALUE);

      protected CommunityWebManager() {
      }

      /**
       * Gets the singleton instance of the provider.
       */
      public static CommunityWebManager get() {
        return ServiceProvider.getService(CommunityWebManager.class);
      }

      /**
       * Makes the current user joining the given community.
       *
       * @param community {@link CommunityOfUsers} instance representing the community.
       */
      public void join(final CommunityOfUsers community) {
        final SilverpeasRole defaultRole = getDefaultMemberRoleOf(community);
        final String spaceName = getSpaceName(community);
        final User currentRequester = User.getCurrentRequester();
        if (adminMustValidateNewMemberOf(community)) {
          community.addAsAPendingMember(currentRequester);
          MembershipRequestUserNotificationBuilder
              .about(community)
              .newRequestFrom(currentRequester)
              .build()
              .send();
          successMessage("community.join.pendingValidation.success", spaceName);
        } else {
          community.addAsMember(currentRequester, defaultRole);
          successMessage("community.join.success", spaceName);
        }
      }

      /**
       * Validates the membership request of user given in parameters on specified community.
       *
       * @param requester the user behind the request to join the community.
       * @param community the community the user accesses.
       * @param accept true to accept the request, false to refuse.
       * @param message message linked to the acceptation or refuse.
       */
      public void validateRequestOf(final User requester, final CommunityOfUsers community,
          final boolean accept, final String message) {
        if (accept) {
          final SilverpeasRole defaultRole = getDefaultMemberRoleOf(community);
          community.addAsMember(requester, defaultRole);
        } else {
          community.refuseMembership(requester);
        }
        MembershipRequestValidationUserNotificationBuilder
            .about(community)
            .validating(requester, accept)
            .withMessage(message)
            .build()
            .send();
      }

      /**
       * Makes the given user leaving the given community.
       *
       * @param community {@link CommunityOfUsers} instance representing the community.
       * @param member the member to manage.
       */
      public void endMembershipOf(final CommunityOfUsers community, final User member) {
        community.removeMembership(member);
        successMessage("community.endMembership.success", member.getDisplayedName(),
            getSpaceName(community));
      }

      /**
       * Makes the current user leaving the given community.
       *
       * @param community {@link CommunityOfUsers} instance representing the community.
       * @param reason the index of the reason of the leaving.
       * @param message a message to explain more precisely the member leaving.
       * @param contactInFuture boolean, true to indicate that the member accepts to be contacted in the
       * future about its leaving.
       */
      public void leave(final CommunityOfUsers community, final int reason, final String message,
          final boolean contactInFuture) {
        final User leavingMember = User.getCurrentRequester();
        community.removeMembership(leavingMember);
        MembershipLeaveUserNotificationBuilder
            .about(community)
            .memberLeavingIs(leavingMember)
            .withReason(reason)
            .andMessage(message)
            .andContactInFuture(contactInFuture)
            .build()
            .send();
        successMessage("community.leave.success", getSpaceName(community));
      }

      /**
       * Saves into instance parameter of the given community the value of parameter
       * 'displayCharterOnSpaceHomepage'.
       *
       * @param community {@link CommunityOfUsers} instance representing the community.
       * @param value true to display the charter, false otherwise.
       */
      public void setDisplayCharterOnSpaceHomepage(final CommunityOfUsers community,
          final boolean value) {
        final ComponentInst componentInst = OrganizationController.get()
            .getComponentInst(community.getComponentInstanceId());
        componentInst.getParameter("displayCharterOnSpaceHomepage").setValue(value ? "yes" : "no");
        try {
          Administration.get().updateComponentInst(componentInst);
        } catch (AdminException e) {
          throw new WebApplicationException(e);
        }
      }

      /**
       * Gets members pending validation of the given community.
       *
       * @param community {@link CommunityOfUsers} instance representing the community.
       * @param page the pending members to get are paginated. Indicates the page to return. If null,
       * all the pending members are got.
       * @return list of {@link CommunityMembership} instance, representing each one a pending member.
       */
      @SuppressWarnings("unchecked")
      public SilverpeasList<CommunityMembership> getMembersToValidate(
          @Nonnull final CommunityOfUsers community, @Nullable final PaginationPage page) {
        PaginationPage paginationPage = page == null ? NO_PAGINATION : page;
        return requestCache("membersToValidate", community.getId(), SilverpeasList.class,
            () -> community.getMembershipsProvider().getPending(paginationPage));
      }

      /**
       * Gets members of the given community.
       *
       * @param community {@link CommunityOfUsers} instance representing the community.
       * @param page the members to get are paginated. Indicates the page to return. If null, all the
       * members are got.
       * @return list of {@link CommunityMembership} instance, representing each one a committed member.
       */
      @SuppressWarnings("unchecked")
      public SilverpeasList<CommunityMembership> getMembers(@Nonnull final CommunityOfUsers community,
          @Nullable final PaginationPage page) {
        PaginationPage paginationPage = page == null ? NO_PAGINATION : page;
        return requestCache("members", community.getId(), SilverpeasList.class,
            () -> community.getMembershipsProvider().getInRange(paginationPage));
      }

      /**
       * Gets history of the given community.
       *
       * @param community {@link CommunityOfUsers} instance representing the community.
       * @param page the members to get are paginated. Indicates the page to return. If null, all the
       * members are got.
       * @return list of {@link CommunityMembership} instance, representing each one a membership
       * whatever its status.
       */
      @SuppressWarnings("unchecked")
      public SilverpeasList<CommunityMembership> getHistory(@Nonnull final CommunityOfUsers community,
          @Nullable final PaginationPage page) {
        PaginationPage paginationPage = page == null ? NO_PAGINATION : page;
        return requestCache("history", community.getId(), SilverpeasList.class,
            () -> community.getMembershipsProvider().getHistory(paginationPage));
      }

      /**
       * Indicates if the current requester is a member.
       * <p>
       * A member MUST be directly specified into ADMIN, PUBLISHER, WRITER or READER role of direct
       * parent space.
       * </p>
       *
       * @param community {@link CommunityOfUsers} instance.
       * @return true if member, false otherwise.
       */
      public boolean isMemberOf(final CommunityOfUsers community) {
        return Objects.requireNonNull(requestCache("isMemberOf", community.getId(), Boolean.class,
            () -> community.isMember(User.getCurrentRequester())));
      }

      /**
       * Indicates if the current requester has membership pending validation.
       * <p>
       * A member MUST be directly specified into ADMIN, PUBLISHER, WRITER or READER role of direct
       * parent space.
       * </p>
       *
       * @param community {@link CommunityOfUsers} instance.
       * @return true if member, false otherwise.
       */
      public boolean isMembershipPendingFor(final CommunityOfUsers community) {
        return Objects.requireNonNull(requestCache("isMembershipPending",
            community.getId(),
            Boolean.class,
            () -> community.getMembershipsProvider()
                .get(User.getCurrentRequester())
                .map(CommunityMembership::getStatus)
                .map(MembershipStatus::isPending)
                .orElse(false)));
      }

      /**
       * Gets the roles the current requester has on the given community.
       *
       * @param community {@link CommunityOfUsers} instance.
       * @return a set of {@link SilverpeasRole}.
       */
      @SuppressWarnings("unchecked")
      public Set<SilverpeasRole> getUserRoleOn(final CommunityOfUsers community) {
        return requestCache("userRoleOf", community.getId(), Set.class,
            () -> community.getUserRoles(User.getCurrentRequester()));
      }

      private boolean adminMustValidateNewMemberOf(final CommunityOfUsers community) {
        return getBooleanValue(getCommunityInstanceParameter(community, "validateNewMember"));
      }

      private SilverpeasRole getDefaultMemberRoleOf(final CommunityOfUsers community) {
        return fromString(getCommunityInstanceParameter(community, "defaultMemberRole"));
      }

      private <T> T requestCache(final String type, final String id, Class<T> classType,
          Supplier<T> supplier) {
        return CacheAccessorProvider.getThreadCacheAccessor()
            .getCache()
            .computeIfAbsent(CACHE_KEY_PREFIX + type + ":" + id, classType, supplier);
      }

      private String getCommunityInstanceParameter(final CommunityOfUsers community,
          final String parameterName) {
        return OrganizationController.get()
            .getComponentParameterValue(community.getComponentInstanceId(), parameterName);
      }

      private String getSpaceName(final CommunityOfUsers community) {
        final String userLanguage = getUserLanguage();
        return OrganizationController.get()
            .getSpaceInstById(community.getSpaceId())
            .getName(userLanguage);
      }

      /**
       * Push a success message to the current user.
       *
       * @param messageKey the key of the message.
       * @param params the message parameters.
       */
      private void successMessage(String messageKey, Object... params) {
        final String userLanguage = getUserLanguage();
        getMessager().addSuccess(getMessagesIn(userLanguage).getString(messageKey), params);
      }

      private String getUserLanguage() {
        return requestCache("language", "user", String.class,
            () -> User.getCurrentRequester().getUserPreferences().getLanguage());
      }

      private WebMessager getMessager() {
        return WebMessager.getInstance();
      }
    }