mirror of
https://github.com/nextcloud/server.git
synced 2024-08-07 03:07:59 +02:00
85 lines
2.9 KiB
PHP
85 lines
2.9 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
/**
|
|
* SPDX-FileCopyrightText: 2022 Nextcloud GmbH and Nextcloud contributors
|
|
* SPDX-License-Identifier: AGPL-3.0-or-later
|
|
*/
|
|
|
|
|
|
namespace OC\Core\Controller;
|
|
|
|
use InvalidArgumentException;
|
|
use OCP\AppFramework\Http;
|
|
use OCP\AppFramework\Http\Attribute\ApiRoute;
|
|
use OCP\AppFramework\Http\DataResponse;
|
|
use OCP\IL10N;
|
|
use OCP\IRequest;
|
|
use OCP\PreConditionNotMetException;
|
|
use OCP\Translation\CouldNotTranslateException;
|
|
use OCP\Translation\ITranslationManager;
|
|
|
|
class TranslationApiController extends \OCP\AppFramework\OCSController {
|
|
public function __construct(
|
|
string $appName,
|
|
IRequest $request,
|
|
private ITranslationManager $translationManager,
|
|
private IL10N $l10n,
|
|
) {
|
|
parent::__construct($appName, $request);
|
|
}
|
|
|
|
/**
|
|
* @PublicPage
|
|
*
|
|
* Get the list of supported languages
|
|
*
|
|
* @return DataResponse<Http::STATUS_OK, array{languages: array{from: string, fromLabel: string, to: string, toLabel: string}[], languageDetection: bool}, array{}>
|
|
*
|
|
* 200: Supported languages returned
|
|
*/
|
|
#[ApiRoute(verb: 'GET', url: '/languages', root: '/translation')]
|
|
public function languages(): DataResponse {
|
|
return new DataResponse([
|
|
'languages' => array_map(fn ($lang) => $lang->jsonSerialize(), $this->translationManager->getLanguages()),
|
|
'languageDetection' => $this->translationManager->canDetectLanguage(),
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* @PublicPage
|
|
* @UserRateThrottle(limit=25, period=120)
|
|
* @AnonRateThrottle(limit=10, period=120)
|
|
*
|
|
* Translate a text
|
|
*
|
|
* @param string $text Text to be translated
|
|
* @param string|null $fromLanguage Language to translate from
|
|
* @param string $toLanguage Language to translate to
|
|
* @return DataResponse<Http::STATUS_OK, array{text: string, from: ?string}, array{}>|DataResponse<Http::STATUS_BAD_REQUEST|Http::STATUS_PRECONDITION_FAILED|Http::STATUS_INTERNAL_SERVER_ERROR, array{message: string, from?: ?string}, array{}>
|
|
*
|
|
* 200: Translated text returned
|
|
* 400: Language not detected or unable to translate
|
|
* 412: Translating is not possible
|
|
*/
|
|
#[ApiRoute(verb: 'POST', url: '/translate', root: '/translation')]
|
|
public function translate(string $text, ?string $fromLanguage, string $toLanguage): DataResponse {
|
|
try {
|
|
$translation = $this->translationManager->translate($text, $fromLanguage, $toLanguage);
|
|
|
|
return new DataResponse([
|
|
'text' => $translation,
|
|
'from' => $fromLanguage,
|
|
|
|
]);
|
|
} catch (PreConditionNotMetException) {
|
|
return new DataResponse(['message' => $this->l10n->t('No translation provider available')], Http::STATUS_PRECONDITION_FAILED);
|
|
} catch (InvalidArgumentException) {
|
|
return new DataResponse(['message' => $this->l10n->t('Could not detect language')], Http::STATUS_BAD_REQUEST);
|
|
} catch (CouldNotTranslateException $e) {
|
|
return new DataResponse(['message' => $this->l10n->t('Unable to translate'), 'from' => $e->getFrom()], Http::STATUS_BAD_REQUEST);
|
|
}
|
|
}
|
|
}
|