ServiceFaq.java

/*
 * Copyright (C) 2000 - 2025 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:
 * "https://www.silverpeas.org/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.mobile.server.services;

import jakarta.servlet.http.HttpServletRequest;
import jakarta.ws.rs.*;
import jakarta.ws.rs.core.Context;
import jakarta.ws.rs.core.MediaType;
import org.silverpeas.components.questionreply.model.Category;
import org.silverpeas.components.questionreply.model.Question;
import org.silverpeas.components.questionreply.model.Reply;
import org.silverpeas.components.questionreply.service.QuestionManagerProvider;
import org.silverpeas.core.admin.service.OrganizationController;
import org.silverpeas.core.annotation.WebService;
import org.silverpeas.core.node.model.NodeDetail;
import org.silverpeas.core.node.model.NodePK;
import org.silverpeas.core.node.service.NodeService;
import org.silverpeas.core.web.rs.annotation.Authorized;
import org.silverpeas.kernel.logging.SilverLogger;
import org.silverpeas.mobile.shared.dto.faq.CategoryDTO;
import org.silverpeas.mobile.shared.dto.faq.QuestionDTO;
import org.silverpeas.mobile.shared.dto.faq.QuestionDetailDTO;
import org.silverpeas.mobile.shared.dto.faq.ReplyDTO;

import java.util.ArrayList;
import java.util.Collection;
import java.util.List;

@WebService
@Authorized
@Path(ServiceFaq.PATH + "/{appId}")
public class ServiceFaq extends AbstractRestWebService {

  @Context
  HttpServletRequest request;

  static final String PATH = "mobile/faq";

  @PathParam("appId")
  private String componentId;

  @POST
  @Path("question")
  @Consumes(MediaType.APPLICATION_JSON)
  @Produces(MediaType.APPLICATION_JSON)
  public QuestionDetailDTO createQuestion(final QuestionDetailDTO question) {
    Question q = new Question();
    q.setTitle(question.getQuestion());
    q.setContent(question.getDescription());
    q.setCreatorId(getUser().getId());
    q.setCreationDate();
    q.setInstanceId(componentId);
    if (!question.getCategoryId().isEmpty()) q.setCategoryId(question.getCategoryId());

    try {
      long id = QuestionManagerProvider.getQuestionManager().createQuestion(q);
      question.setId(id);
    } catch (Exception e) {
      SilverLogger.getLogger(this).error(e);
      throw new WebApplicationException(e);
    }
    return question;
  }

  @GET
  @Path("question/all")
  @Consumes(MediaType.APPLICATION_JSON)
  @Produces(MediaType.APPLICATION_JSON)
  public List<QuestionDTO> getAllQuestions() {
    List<QuestionDTO> dtos = new ArrayList<>();
    try {
      List<Question> questions = QuestionManagerProvider.getQuestionManager().getAllQuestions(getComponentId());
      for (Question q : questions) {
        List<ReplyDTO> dtoReplies = new ArrayList<>();
        QuestionDTO dto = new QuestionDTO();
        dto.setTitle(q.getTitle());
        dto.setCategory(getCategory(q.getCategoryId()));
        dto.setDescription(q.getContent());
        for (Reply r : q.readReplies()) {
          ReplyDTO dt = new ReplyDTO();
          dt.setId(r.getPK().getId());
          dt.setTitle(r.getTitle());
          dt.setContent(r.loadWysiwygContent());
          dtoReplies.add(dt);
        }
        dto.setReplies(dtoReplies);
        dtos.add(dto);
      }
    } catch(Exception e) {
      SilverLogger.getLogger(this).error(e);
    }

    return dtos;
  }

  private CategoryDTO getCategory(String categoryId) throws Exception {
    if (categoryId == null || categoryId.isEmpty()) return null;
    NodePK nodePK = new NodePK(categoryId, getComponentId());
    Category c = new Category(NodeService.get().getDetail(nodePK));
    CategoryDTO dto = new CategoryDTO();
    dto.setId(c.getId());
    dto.setTitle(c.getName(getUser().getUserPreferences().getLanguage()));
    dto.setDescription(c.getDescription(getUser().getUserPreferences().getLanguage()));
    return dto;
  }

  @GET
  @Path("category/all")
  @Consumes(MediaType.APPLICATION_JSON)
  @Produces(MediaType.APPLICATION_JSON)
  public List<CategoryDTO> getAllCategories() {
    List<CategoryDTO> dtos = new ArrayList<>();
    try {
      NodePK nodePK = new NodePK(NodePK.ROOT_NODE_ID, getComponentId());
      Collection<NodeDetail> cats = NodeService.get().getChildrenDetails(nodePK);
      for (NodeDetail cat : cats) {
        CategoryDTO dto = new CategoryDTO();
        dto.setId(cat.getId());
        dto.setTitle(cat.getName(getUser().getUserPreferences().getLanguage()));
        dto.setDescription(cat.getDescription(getUser().getUserPreferences().getLanguage()));
        dtos.add(dto);
      }
    } catch (Exception e) {
      SilverLogger.getLogger(this).error(e);
    }

    return dtos;
  }

  @Override
  protected String getResourceBasePath() {
    return PATH;
  }

  @Override
  public String getComponentId() {
    return this.componentId;
  }

  public String getComponentParameterValue(String parameterName) {
    return OrganizationController.get().getComponentParameterValue(getComponentId(), parameterName);
  }
}