Skip to content

Java SDK File Reference

Upload (request, fileRoute, options)

Returns: Map<Object, Object>

Method used to upload file to the specified location on disk.


  • request

    All the HTTP specific information for the HTTP request.

    Type: HttpServletRequest

  • fileRoute

    The server route where the file will be uploaded. This route must be public to be accessed by the editor.

    Type: String

  • options

    This parameter is optional. It can be used to pass custom options for the file upload. All available options are described below. Short example:

    FileOptions options = new FileOptions();
    options.setResize(width, height, keepAspectRatio);

    Type: FileOptions

options parameter:

  • fieldname

    Tag name that points to the file. Use getter/setter to access it.


    Type: String
  • validation

    Specified the allowed file extensions and mimetypes. Use getter/setter to access it.

    options.setValidation(new FileValidation());
    options.setValidation(new FileValidation(new String[] { "txt" }, new String[] { "text/plain" }));
    options.setValidation(new FileValidation(new CustomValidation() {
      public boolean validate(String filePath, String mimeType) {

    Type: FileValidation
    /// Allowed file validation default extensions.
    public static final String[] allowedFileExtsDefault = new String[] { "txt", "pdf", "doc" };
    /// Allowed file validation default mimetypes.
    public static final String[] allowedFileMimeTypesDefault = new String[] { "text/plain", "application/msword", "application/x-pdf", "application/pdf" };


If the upload is completed successfully, the method returns an object with the absolute path to the uploaded file. If an error occurs, the method throws an exception.

Map<Object, Object> responseData;
try {
  responseData = File.upload(request, fileRoute, options);
} catch (Exception e) {
  responseData = new HashMap();
  responseData.put("error", e.toString());
String jsonResponseData = new Gson().toJson(responseData);

Delete (request, filePath)

Method used to delete an file from disk. Throws an exception if an error occurs.


  • request

    All the HTTP specific information for the HTTP request.

    Type: HttpServletRequest

  • filePath

    The server file path.

    Type: String

Do you think we can improve this article? Let us know.