caprica/SwtBrowserCanvas.java

## SwtBrowserCanvas.java
/*
 * This class is made available under the Apache License, Version 2.0.
 *
 * See http://www.apache.org/licenses/LICENSE-2.0.txt
 *
 * Author: Mark Lee
 *
 * (C)2013 Caprica Software (http://www.capricasoftware.co.uk)
 */

package uk.co.caprica.swt.browser;

import java.awt.BorderLayout;
import java.awt.Canvas;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import java.awt.event.WindowListener;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.atomic.AtomicReference;

import javax.swing.JFrame;
import javax.swing.JPanel;

import org.eclipse.swt.SWT;
import org.eclipse.swt.awt.SWT_AWT;
import org.eclipse.swt.browser.Browser;
import org.eclipse.swt.layout.FillLayout;
import org.eclipse.swt.widgets.Display;
import org.eclipse.swt.widgets.Shell;

/**
 * Implementation of an AWT {@link Canvas} that embeds an SWT {@link Browser} component.
 * <p>
 * With contemporary versions of SWT, the Webkit browser is the default implementation.
 * <p>
 * To embed an SWT component inside of a Swing component there are a number of important
 * considerations (all of which comprise this implementation):
 * <ul>
 *   <li>A background thread must be created to process the SWT event dispatch loop.</li>
 *   <li>The browser component can not be created until after the hosting Swing component (e.g. the
 *       JFrame) has been made visible - usually right after <code>frame.setVisible(true).</code></li>
 *   <li>To cleanly dispose the native browser component, it is necessary to perform that clean
 *       shutdown from inside a {@link WindowListener#windowClosing(WindowEvent)} implementation in
 *       a listener registered on the hosting JFrame.</li>
 *   <li>On Linux, the <code>sun.awt.xembedserver</code> system property must be set.</li>
 * </ul>
 */
public final class SwtBrowserCanvas extends Canvas {

    /**
     * Required for Linux, harmless for other OS.
     * <p>
     * <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=161911">SWT Component Not Displayed Bug</a>
     */
    static {
        System.setProperty("sun.awt.xembedserver", "true");
    }

    /**
     * SWT browser component reference.
     */
    private final AtomicReference<Browser> browserReference = new AtomicReference<>();

    /**
     * SWT event dispatch thread reference.
     */
    private final AtomicReference<SwtThread> swtThreadReference = new AtomicReference<>();

    /**
     * Get the native browser instance.
     *
     * @return browser, may be <code>null</code>
     */
    public Browser getBrowser() {
        return browserReference.get();
    }

    /**
     * Navigate to a URL.
     *
     * @param url URL
     */
    public void setUrl(final String url) {
        // This action must be executed on the SWT thread
        getBrowser().getDisplay().asyncExec(new Runnable() {
            @Override
            public void run() {
                getBrowser().setUrl(url);
            }
        });
    }

    /**
     * Create the browser canvas component.
     * <p>
     * This must be called <strong>after</strong> the parent application Frame is made visible -
     * usually directly after <code>frame.setVisible(true)</code>.
     * <p>
     * This method creates the background thread, which in turn creates the SWT components and
     * handles the SWT event dispatch loop.
     * <p>
     * This method will block (for a very short time) until that thread has successfully created
     * the native browser component (or an error occurs).
     *
     * @return <code>true</code> if the browser component was successfully created; <code>false if it was not</code/
     */
    public boolean initialise() {
        CountDownLatch browserCreatedLatch = new CountDownLatch(1);
        SwtThread swtThread = new SwtThread(browserCreatedLatch);
        swtThreadReference.set(swtThread);
        swtThread.start();
        boolean result;
        try {
            browserCreatedLatch.await();
            result = browserReference.get() != null;
        }
        catch (InterruptedException e) {
            e.printStackTrace();
            result = false;
        }
        return result;
    }

    /**
     * Dispose the browser canvas component.
     * <p>
     * This should be called from a {@link WindowListener#windowClosing(WindowEvent)} implementation.
     */
    public void dispose() {
        browserReference.set(null);
        SwtThread swtThread = swtThreadReference.getAndSet(null);
        if (swtThread != null) {
            swtThread.interrupt();
        }
    }

    /**
     * Implementation of a thread that creates the browser component and then implements an event
     * dispatch loop for SWT.
     */
    private class SwtThread extends Thread {

        /**
         * Initialisation latch.
         */
        private final CountDownLatch browserCreatedLatch;

        /**
         * Create a thread.
         *
         * @param browserCreatedLatch initialisation latch.
         */
        private SwtThread(CountDownLatch browserCreatedLatch) {
            this.browserCreatedLatch = browserCreatedLatch;
        }

        @Override
        public void run() {
            // First prepare the SWT components...
            Display display;
            Shell shell;
            try {
                display = new Display();
                shell = SWT_AWT.new_Shell(display, SwtBrowserCanvas.this);
                shell.setLayout(new FillLayout());
                browserReference.set(new Browser(shell, SWT.NONE));
            }
            catch (Exception e) {
                e.printStackTrace();
                return;
            }
            finally {
                // Guarantee the count-down so as not to block the caller, even in case of error -
                // there is a theoretical (rare) chance of failure to initialise the SWT components
                browserCreatedLatch.countDown();
            }
            // Execute the SWT event dispatch loop...
            try {
                shell.open();
                while (!isInterrupted() && !shell.isDisposed()) {
                    if (!display.readAndDispatch()) {
                        display.sleep();
                    }
                }
                browserReference.set(null);
                shell.dispose();
                display.dispose();
            }
            catch (Exception e) {
                e.printStackTrace();
                interrupt();
            }
        }
    }

    /**
     * Example implementation.
     *
     * @param args command-line arguments (unused)
     */
    public static void main(String[] args) {
        final SwtBrowserCanvas browserCanvas = new SwtBrowserCanvas();

        JPanel contentPane = new JPanel();
        contentPane.setLayout(new BorderLayout());
        contentPane.add(browserCanvas, BorderLayout.CENTER);

        JFrame frame = new JFrame("SWT Browser Embedded in JPanel");
        frame.setBounds(100, 100, 1200, 800);
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setContentPane(contentPane);

        frame.addWindowListener(new WindowAdapter() {

            @Override
            public void windowClosing(WindowEvent e) {
                // Dispose of the native component cleanly
                browserCanvas.dispose();
            }
        });

        frame.setVisible(true);

        // Initialise the native browser component, and if successful...
        if (browserCanvas.initialise()) {
            // ...navigate to the desired URL
            browserCanvas.setUrl("http://www.capricasoftware.co.uk");
        }
        else {
            System.out.println("Failed to initialise browser");
        }
    }
}
	/*
	* This class is made available under the Apache License, Version 2.0.
	*
	* See http://www.apache.org/licenses/LICENSE-2.0.txt
	*
	* Author: Mark Lee
	*
	* (C)2013 Caprica Software (http://www.capricasoftware.co.uk)
	*/

	package uk.co.caprica.swt.browser;

	import java.awt.BorderLayout;
	import java.awt.Canvas;
	import java.awt.event.WindowAdapter;
	import java.awt.event.WindowEvent;
	import java.awt.event.WindowListener;
	import java.util.concurrent.CountDownLatch;
	import java.util.concurrent.atomic.AtomicReference;

	import javax.swing.JFrame;
	import javax.swing.JPanel;

	import org.eclipse.swt.SWT;
	import org.eclipse.swt.awt.SWT_AWT;
	import org.eclipse.swt.browser.Browser;
	import org.eclipse.swt.layout.FillLayout;
	import org.eclipse.swt.widgets.Display;
	import org.eclipse.swt.widgets.Shell;

	/**
	* Implementation of an AWT {@link Canvas} that embeds an SWT {@link Browser} component.
	* <p>
	* With contemporary versions of SWT, the Webkit browser is the default implementation.
	* <p>
	* To embed an SWT component inside of a Swing component there are a number of important
	* considerations (all of which comprise this implementation):
	* <ul>
	* <li>A background thread must be created to process the SWT event dispatch loop.</li>
	* <li>The browser component can not be created until after the hosting Swing component (e.g. the
	* JFrame) has been made visible - usually right after <code>frame.setVisible(true).</code></li>
	* <li>To cleanly dispose the native browser component, it is necessary to perform that clean
	* shutdown from inside a {@link WindowListener#windowClosing(WindowEvent)} implementation in
	* a listener registered on the hosting JFrame.</li>
	* <li>On Linux, the <code>sun.awt.xembedserver</code> system property must be set.</li>
	* </ul>
	*/
	public final class SwtBrowserCanvas extends Canvas {

	/**
	* Required for Linux, harmless for other OS.
	* <p>
	* <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=161911">SWT Component Not Displayed Bug</a>
	*/
	static {
	System.setProperty("sun.awt.xembedserver", "true");
	}

	/**
	* SWT browser component reference.
	*/
	private final AtomicReference<Browser> browserReference = new AtomicReference<>();

	/**
	* SWT event dispatch thread reference.
	*/
	private final AtomicReference<SwtThread> swtThreadReference = new AtomicReference<>();

	/**
	* Get the native browser instance.
	*
	* @return browser, may be <code>null</code>
	*/
	public Browser getBrowser() {
	return browserReference.get();
	}

	/**
	* Navigate to a URL.
	*
	* @param url URL
	*/
	public void setUrl(final String url) {
	// This action must be executed on the SWT thread
	getBrowser().getDisplay().asyncExec(new Runnable() {
	@Override
	public void run() {
	getBrowser().setUrl(url);
	}
	});
	}

	/**
	* Create the browser canvas component.
	* <p>
	* This must be called <strong>after</strong> the parent application Frame is made visible -
	* usually directly after <code>frame.setVisible(true)</code>.
	* <p>
	* This method creates the background thread, which in turn creates the SWT components and
	* handles the SWT event dispatch loop.
	* <p>
	* This method will block (for a very short time) until that thread has successfully created
	* the native browser component (or an error occurs).
	*
	* @return <code>true</code> if the browser component was successfully created; <code>false if it was not</code/
	*/
	public boolean initialise() {
	CountDownLatch browserCreatedLatch = new CountDownLatch(1);
	SwtThread swtThread = new SwtThread(browserCreatedLatch);
	swtThreadReference.set(swtThread);
	swtThread.start();
	boolean result;
	try {
	browserCreatedLatch.await();
	result = browserReference.get() != null;
	}
	catch (InterruptedException e) {
	e.printStackTrace();
	result = false;
	}
	return result;
	}

	/**
	* Dispose the browser canvas component.
	* <p>
	* This should be called from a {@link WindowListener#windowClosing(WindowEvent)} implementation.
	*/
	public void dispose() {
	browserReference.set(null);
	SwtThread swtThread = swtThreadReference.getAndSet(null);
	if (swtThread != null) {
	swtThread.interrupt();
	}
	}

	/**
	* Implementation of a thread that creates the browser component and then implements an event
	* dispatch loop for SWT.
	*/
	private class SwtThread extends Thread {

	/**
	* Initialisation latch.
	*/
	private final CountDownLatch browserCreatedLatch;

	/**
	* Create a thread.
	*
	* @param browserCreatedLatch initialisation latch.
	*/
	private SwtThread(CountDownLatch browserCreatedLatch) {
	this.browserCreatedLatch = browserCreatedLatch;
	}

	@Override
	public void run() {
	// First prepare the SWT components...
	Display display;
	Shell shell;
	try {
	display = new Display();
	shell = SWT_AWT.new_Shell(display, SwtBrowserCanvas.this);
	shell.setLayout(new FillLayout());
	browserReference.set(new Browser(shell, SWT.NONE));
	}
	catch (Exception e) {
	e.printStackTrace();
	return;
	}
	finally {
	// Guarantee the count-down so as not to block the caller, even in case of error -
	// there is a theoretical (rare) chance of failure to initialise the SWT components
	browserCreatedLatch.countDown();
	}
	// Execute the SWT event dispatch loop...
	try {
	shell.open();
	while (!isInterrupted() && !shell.isDisposed()) {
	if (!display.readAndDispatch()) {
	display.sleep();
	}
	}
	browserReference.set(null);
	shell.dispose();
	display.dispose();
	}
	catch (Exception e) {
	e.printStackTrace();
	interrupt();
	}
	}
	}

	/**
	* Example implementation.
	*
	* @param args command-line arguments (unused)
	*/
	public static void main(String[] args) {
	final SwtBrowserCanvas browserCanvas = new SwtBrowserCanvas();

	JPanel contentPane = new JPanel();
	contentPane.setLayout(new BorderLayout());
	contentPane.add(browserCanvas, BorderLayout.CENTER);

	JFrame frame = new JFrame("SWT Browser Embedded in JPanel");
	frame.setBounds(100, 100, 1200, 800);
	frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
	frame.setContentPane(contentPane);

	frame.addWindowListener(new WindowAdapter() {

	@Override
	public void windowClosing(WindowEvent e) {
	// Dispose of the native component cleanly
	browserCanvas.dispose();
	}
	});

	frame.setVisible(true);

	// Initialise the native browser component, and if successful...
	if (browserCanvas.initialise()) {
	// ...navigate to the desired URL
	browserCanvas.setUrl("http://www.capricasoftware.co.uk");
	}
	else {
	System.out.println("Failed to initialise browser");
	}
	}
	}