How it works

1. You specify the image load options when the javascript editor is initialized on client side.
2. When the Image Manger modal is displayed, the javascript editor makes a request to the server to load the images.
3. Once the request hits the server, it returns the list with the images to display in the rich text editor.
4. The javascript editor processes the response of the server and renders the images in its interface.

Jump to Complete Example

Initialize the javascript editor

To get started, the javascript editor needs to have the imageManagerLoadURL and imageManagerDeleteURL options so that it can interact with your server to load or delete the images listed inside the Image Manager tool. Additionally, you can set other options related to the interaction between your server and the rich text editor: imageManagerLoadMethod, imageManagerLoadParams, imageManagerPreloader, imageManagerDeleteParams.

<script>
  new FroalaEditor('.selector', {
    // Set the image upload URL.
    imageManagerLoadURL: '/load_images',

    // Set the image delete URL.
    imageManagerDeleteURL: '/delete_image'
  })
</script>

Receive the load request

The server implementation is responsible for receiving the request and handling it appropriately. The WYSIWYG editor's Java SDK comes with the possibility to load all the images inside a specified folder using the com.froala.editor.Image.list method.

Note: The path of the folder from where the images are being loaded is relative to the root of the project.

String fileRoute = "/public/";
ArrayList<Object> responseData = Image.list(request, fileRoute);

Receive the delete request

Your server should listen for any delete request and process it accordingly. Using the code from the Editor Initialization step, makes the image path available in the javax.servlet.http.HttpServletRequest parameter. The com.froala.editor.Image.delete method from the Java SDK is expecting the path of the image to remove from disk.

String src = request.getParameter("src");
Image.Delete(request, src);

Complete Example

<script>
  new FroalaEditor('.selector', {
    // Set the image upload URL.
    imageManagerLoadURL: '/load_images',

    // Set the image delete URL.
    imageManagerDeleteURL: '/delete_image'
  })
</script>

package com.froala.examples.servlets;

import java.io.IOException;
import java.util.ArrayList;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import com.froala.editor.Image;
import com.google.gson.Gson;

/**
 * Servlet implementation class LoadImage
 */
@WebServlet("/load_images")
public class LoadImage extends HttpServlet {
    private static final long serialVersionUID = 1L;

    /**
     * @see HttpServlet#HttpServlet()
     */
    public LoadImage() {
        super();

    }

    /**
     * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse
     *      response)
     */
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        String fileRoute = "/public/";
        ArrayList<Object> responseData;
        try {
            responseData = Image.list(request, fileRoute);
        } catch (Exception e) {
            e.printStackTrace();
            response.sendError(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
            return;
        }

        String jsonResponseData = new Gson().toJson(responseData);
        response.setContentType("application/json");
        response.setCharacterEncoding("UTF-8");
        response.getWriter().write(jsonResponseData);
    }

}

package com.froala.examples.servlets;

import java.io.IOException;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import com.froala.editor.Image;
import com.google.gson.Gson;

/**
 * Servlet implementation class DeleteImage
 */
@WebServlet("/delete_image")
public class DeleteImage extends HttpServlet {
    private static final long serialVersionUID = 1L;

    /**
     * @see HttpServlet#HttpServlet()
     */
    public DeleteImage() {
        super();
    }

    /**
     * @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse
     *      response)
     */
    @Override
    protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        String src = request.getParameter("src");

        try {
            Image.delete(request, src);
        } catch (Exception e) {
            e.printStackTrace();
            response.sendError(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
            return;
        }
        String jsonResponseData = new Gson().toJson("Success");
        response.setContentType("application/json");
        response.setCharacterEncoding("UTF-8");
        response.getWriter().write(jsonResponseData);
    }

}