org.zanata.rest.service

Interface FileResource

All Known Subinterfaces:

IFileResource

public interface FileResource

Interface for file upload and download REST methods.

Field Summary

Fields

Modifier and Type	Field and Description
static String	ACCEPTED_TYPES_RESOURCE
static String	DOWNLOAD_TEMPLATE
static String	FILE_DOWNLOAD_TEMPLATE
static String	FILE_RESOURCE Deprecated.
static String	FILETYPE_RAW_SOURCE_DOCUMENT Specifies to download the original source file that was uploaded, byte-for-byte.
static String	FILETYPE_TRANSLATED_APPROVED Specifies to download a completed version of a translated document in the original source format, showing only approved translations.
static String	FILETYPE_TRANSLATED_APPROVED_AND_FUZZY Specifies to download a preview of the translated document in the original source format, showing all non-empty translations (even if not approved).
static String	SERVICE_PATH
static String	SOURCE_DOWNLOAD_TEMPLATE
static String	SOURCE_UPLOAD_TEMPLATE
static String	TRANSLATION_UPLOAD_TEMPLATE

Method Summary

Methods

Modifier and Type	Method and Description
javax.ws.rs.core.Response	acceptedFileTypes()
javax.ws.rs.core.Response	download(String downloadId) Downloads a previously generated file.
javax.ws.rs.core.Response	downloadSourceFile(String projectSlug, String iterationSlug, String fileType, String docId) Downloads a single source file.
javax.ws.rs.core.Response	downloadTranslationFile(String projectSlug, String iterationSlug, String locale, String fileExtension, String docId) Downloads a single translation file.
javax.ws.rs.core.Response	uploadSourceFile(String projectSlug, String iterationSlug, String docId, DocumentFileUploadForm uploadForm)
javax.ws.rs.core.Response	uploadTranslationFile(String projectSlug, String iterationSlug, String localeId, String docId, String merge, DocumentFileUploadForm uploadForm)

Field Detail

SERVICE_PATH

static final String SERVICE_PATH

See Also:

Constant Field Values

FILE_RESOURCE

@Deprecated
static final String FILE_RESOURCE

Deprecated.

See Also:

Constant Field Values

ACCEPTED_TYPES_RESOURCE

static final String ACCEPTED_TYPES_RESOURCE

See Also:

Constant Field Values

DOWNLOAD_TEMPLATE

static final String DOWNLOAD_TEMPLATE

See Also:

Constant Field Values

FILE_DOWNLOAD_TEMPLATE

static final String FILE_DOWNLOAD_TEMPLATE

See Also:

Constant Field Values

TRANSLATION_UPLOAD_TEMPLATE

static final String TRANSLATION_UPLOAD_TEMPLATE

See Also:

Constant Field Values

SOURCE_UPLOAD_TEMPLATE

static final String SOURCE_UPLOAD_TEMPLATE

See Also:

Constant Field Values

SOURCE_DOWNLOAD_TEMPLATE

static final String SOURCE_DOWNLOAD_TEMPLATE

See Also:

Constant Field Values

FILETYPE_RAW_SOURCE_DOCUMENT

static final String FILETYPE_RAW_SOURCE_DOCUMENT

Specifies to download the original source file that was uploaded, byte-for-byte.

See Also:

Constant Field Values

FILETYPE_TRANSLATED_APPROVED_AND_FUZZY

static final String FILETYPE_TRANSLATED_APPROVED_AND_FUZZY

Specifies to download a preview of the translated document in the original source format, showing all non-empty translations (even if not approved). Where translations are empty, source strings are used.

See Also:

Constant Field Values

FILETYPE_TRANSLATED_APPROVED

static final String FILETYPE_TRANSLATED_APPROVED

Specifies to download a completed version of a translated document in the original source format, showing only approved translations. Where no approved translation is available, source strings are used.

See Also:

Constant Field Values

Method Detail

acceptedFileTypes

javax.ws.rs.core.Response acceptedFileTypes()

uploadSourceFile

javax.ws.rs.core.Response uploadSourceFile(String projectSlug,
                                         String iterationSlug,
                                         String docId,
                                         DocumentFileUploadForm uploadForm)

uploadTranslationFile

javax.ws.rs.core.Response uploadTranslationFile(String projectSlug,
                                              String iterationSlug,
                                              String localeId,
                                              String docId,
                                              String merge,
                                              DocumentFileUploadForm uploadForm)

downloadSourceFile

javax.ws.rs.core.Response downloadSourceFile(String projectSlug,
                                           String iterationSlug,
                                           String fileType,
                                           String docId)

Downloads a single source file.

Parameters:

projectSlug -

iterationSlug -

fileType - use 'raw' for original source if available, or 'pot' to generate pot from source strings

docId -

Returns:

response with status code 404 if the document is not found, 415 if fileType is not valid for the document, otherwise 200 with attached document.

downloadTranslationFile

javax.ws.rs.core.Response downloadTranslationFile(String projectSlug,
                                                String iterationSlug,
                                                String locale,
                                                String fileExtension,
                                                String docId)

Downloads a single translation file. To download a preview-document or translated document where a raw source document is available, use fileType 'half_baked' and 'baked' respectively.

Parameters:

projectSlug - Project identifier.

iterationSlug - Project iteration identifier.

locale - Translations for this locale will be contained in the downloaded document.

fileType - File type to be downloaded. (Options: 'po', 'half_baked', 'baked')

docId - Document identifier to fetch translations for.

Returns:

The following response status codes will be returned from this operation:
OK(200) - A translation file in the requested format with translations for the requested document in a project, iteration and locale.
NOT FOUND(404) - If a document is not found with the given parameters.
INTERNAL SERVER ERROR(500) - If there is an unexpected error in the server while performing this operation.

download

javax.ws.rs.core.Response download(String downloadId)

Downloads a previously generated file.

Parameters:

downloadId - The Zanata generated download id.

Returns:

The following response status codes will be returned from this operation:
OK(200) - A translation file in the requested format with translations for the requested document in a project, iteration and locale.
NOT FOUND(404) - If a downloadable file is not found for the given id, or is not yet ready for download (i.e. the system is still preparing it).
INTERNAL SERVER ERROR(500) - If there is an unexpected error in the server while performing this operation.