ReferenceApiController.php 2.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091
  1. <?php
  2. declare(strict_types=1);
  3. /**
  4. * @copyright Copyright (c) 2022 Julius Härtl <jus@bitgrid.net>
  5. *
  6. * @author Julius Härtl <jus@bitgrid.net>
  7. *
  8. * @license GNU AGPL version 3 or any later version
  9. *
  10. * This program is free software: you can redistribute it and/or modify
  11. * it under the terms of the GNU Affero General Public License as
  12. * published by the Free Software Foundation, either version 3 of the
  13. * License, or (at your option) any later version.
  14. *
  15. * This program is distributed in the hope that it will be useful,
  16. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  18. * GNU Affero General Public License for more details.
  19. *
  20. * You should have received a copy of the GNU Affero General Public License
  21. * along with this program. If not, see <http://www.gnu.org/licenses/>.
  22. */
  23. namespace OC\Core\Controller;
  24. use OCP\AppFramework\Http\DataResponse;
  25. use OCP\Collaboration\Reference\IReferenceManager;
  26. use OCP\IRequest;
  27. class ReferenceApiController extends \OCP\AppFramework\OCSController {
  28. private IReferenceManager $referenceManager;
  29. public function __construct(string $appName, IRequest $request, IReferenceManager $referenceManager) {
  30. parent::__construct($appName, $request);
  31. $this->referenceManager = $referenceManager;
  32. }
  33. /**
  34. * @NoAdminRequired
  35. */
  36. public function extract(string $text, bool $resolve = false, int $limit = 1): DataResponse {
  37. $references = $this->referenceManager->extractReferences($text);
  38. $result = [];
  39. $index = 0;
  40. foreach ($references as $reference) {
  41. if ($index++ >= $limit) {
  42. break;
  43. }
  44. $result[$reference] = $resolve ? $this->referenceManager->resolveReference($reference) : null;
  45. }
  46. return new DataResponse([
  47. 'references' => $result
  48. ]);
  49. }
  50. /**
  51. * @NoAdminRequired
  52. */
  53. public function resolveOne(string $reference): DataResponse {
  54. $resolvedReference = $this->referenceManager->resolveReference(trim($reference));
  55. $response = new DataResponse(['references' => [ $reference => $resolvedReference ]]);
  56. $response->cacheFor(3600, false, true);
  57. return $response;
  58. }
  59. /**
  60. * @NoAdminRequired
  61. *
  62. * @param string[] $references
  63. */
  64. public function resolve(array $references, int $limit = 1): DataResponse {
  65. $result = [];
  66. $index = 0;
  67. foreach ($references as $reference) {
  68. if ($index++ >= $limit) {
  69. break;
  70. }
  71. $result[$reference] = $this->referenceManager->resolveReference($reference);
  72. }
  73. return new DataResponse([
  74. 'references' => array_filter($result)
  75. ]);
  76. }
  77. }