content: /*
   * Solo - A small and beautiful blogging system written in Java.
   * Copyright (c) 2010-present, b3log.org
   *
   * Solo is licensed under Mulan PSL v2.
   * You can use this software according to the terms and conditions of the Mulan PSL v2.
   * You may obtain a copy of Mulan PSL v2 at:
   *         http://license.coscl.org.cn/MulanPSL2
   * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
   * See the Mulan PSL v2 for more details.
   */
  package org.b3log.solo.repository;
  
  import org.b3log.latke.Keys;
  import org.b3log.latke.repository.*;
  import org.b3log.latke.repository.annotation.Repository;
  import org.b3log.solo.model.Category;
  import org.b3log.solo.model.Tag;
  import org.json.JSONObject;
  
  /**
   * Category-Tag relation repository.
   *
   * @author <a href="http://88250.b3log.org">Liang Ding</a>
   * @version 1.1.0.3, Jan 15, 2019
   * @since 2.0.0
   */
  @Repository
  public class CategoryTagRepository extends AbstractRepository {
  
      /**
       * Public constructor.
       */
      public CategoryTagRepository() {
          super(Category.CATEGORY + "_" + Tag.TAG);
      }
  
      /**
       * Gets category-tag relations by the specified category id.
       *
       * @param categoryId     the specified category id
       * @param currentPageNum the specified current page number, MUST greater then {@code 0}
       * @param pageSize       the specified page size(count of a page contains objects), MUST greater then {@code 0}
       * @return for example      <pre>
       * {
       *     "pagination": {
       *       "paginationPageCount": 88250
       *     },
       *     "rslts": [{
       *         "oId": "",
       *         "category_oId": categoryId,
       *         "tag_oId": ""
       *     }, ....]
       * }
       * </pre>
       * @throws RepositoryException repository exception
       */
      public JSONObject getByCategoryId(final String categoryId, final int currentPageNum, final int pageSize) throws RepositoryException {
          final Query query = new Query().setFilter(new PropertyFilter(Category.CATEGORY + "_" + Keys.OBJECT_ID, FilterOperator.EQUAL, categoryId)).
                  setPage(currentPageNum, pageSize).setPageCount(1);
          return get(query);
      }
  
      /**
       * Gets category-tag relations by the specified tag id.
       *
       * @param tagId          the specified tag id
       * @param currentPageNum the specified current page number, MUST greater then {@code 0}
       * @param pageSize       the specified page size(count of a page contains objects), MUST greater then {@code 0}
       * @return for example      <pre>
       * {
       *     "pagination": {
       *       "paginationPageCount": 88250
       *     },
       *     "rslts": [{
       *         "oId": "",
       *         "category_oId": "",
       *         "tag_oId": tagId
       *     }, ....]
       * }
       * </pre>
       * @throws RepositoryException repository exception
       */
      public JSONObject getByTagId(final String tagId, final int currentPageNum, final int pageSize) throws RepositoryException {
          final Query query = new Query().setFilter(new PropertyFilter(Tag.TAG + "_" + Keys.OBJECT_ID, FilterOperator.EQUAL, tagId)).
                  setPage(currentPageNum, pageSize).setPageCount(1);
  
          return get(query);
      }
  
      /**
       * Removes category-tag relations by the specified category id.
       *
       * @param categoryId the specified category id
       * @throws RepositoryException repository exception
       */
      public void removeByCategoryId(final String categoryId) throws RepositoryException {
          final Query query = new Query().setFilter(new PropertyFilter(Category.CATEGORY + "_" + Keys.OBJECT_ID, FilterOperator.EQUAL, categoryId));
          remove(query);
      }
  
      /**
       * Removes category-tag relations by the specified tag id.
       *
       * @param tagId the specified tag id
       * @throws RepositoryException repository exception
       */
      public void removeByTagId(final String tagId) throws RepositoryException {
          final Query query = new Query().setFilter(new PropertyFilter(Tag.TAG + "_" + Keys.OBJECT_ID, FilterOperator.EQUAL, tagId));
          remove(query);
      }
  }
  