TipitakaWordParagraphAggregateController.php 1.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445
  1. <?php
  2. namespace App\Http\Controllers\V3;
  3. use App\Http\Controllers\Controller;
  4. use App\Http\Requests\V3\AggregateTipitakaWordParagraphRequest;
  5. use App\Http\Resources\V3\TipitakaWordBookResource;
  6. use App\Services\V3\TipitakaWordParagraphService;
  7. /**
  8. * 按词形检索的出处分布(只读、公开)。
  9. *
  10. * 取代 `GET /v2/search-pali-wbw-books`(`SearchPaliWbwController@book_list`)。
  11. * v2 那份在 dashboard-v4 下线前原样保留,不要改动。
  12. */
  13. class TipitakaWordParagraphAggregateController extends Controller
  14. {
  15. public function __construct(private readonly TipitakaWordParagraphService $paragraphs) {}
  16. /**
  17. * 按书统计命中
  18. *
  19. * 与 `GET /v3/tipitaka-word-paragraphs` 同样的检索条件,按书汇总:每本书命中多少段、多少词次,
  20. * 按段落数降序,不分页。v2 只给词次;同一段里出现多次只算一段,所以两者不相等。
  21. *
  22. * @unauthenticated
  23. *
  24. * @queryParam words string required 词形,逗号分隔,最多 200 个。Example: vitakko,vitakkaṃ
  25. * @queryParam bold string 只看黑体(only)或排除黑体(exclude);不给则不限。Enum: only,exclude
  26. *
  27. * @meta total integer 书的数目
  28. * @meta paragraphs integer 命中段落总数
  29. * @meta occurrences integer 词次总数
  30. */
  31. public function __invoke(AggregateTipitakaWordParagraphRequest $request)
  32. {
  33. $result = $this->paragraphs->books($request->criteria());
  34. return TipitakaWordBookResource::collection($result['items'])->additional(['meta' => [
  35. 'total' => count($result['items']),
  36. 'paragraphs' => $result['paragraphs'],
  37. 'occurrences' => $result['occurrences'],
  38. ]]);
  39. }
  40. }