Engine (JxBrowser 7.0 API)

All Superinterfaces:

java.lang.AutoCloseable, Closeable, Observable<EngineEvent>
```
public interface Engine
extends Closeable, Observable<EngineEvent>
```
Provides access to the Chromium engine functionality.
To perform operations with the engine, a license key is required. The license key represents a sting that can be set via the "jxbrowser.license.key" system property or individually for every Engine using the EngineOptions.Builder.licenseKey(String) method. If you set the license key via the system property, then please make sure that you set it before creating an Engine instance.
The Chromium engine is running in a separate native process. Communication between the native and Java process is done through the Inter-Process Communication (IPC) layer that allows transferring data between two processes on a local machine.
The native process allocates memory and system resources that must be released. So, when the engine is no longer needed, it must be closed through the Closeable.close() method to shutdown the native process and free all the allocated memory and system resources. For example:
```
 Engine engine = Engine.newInstance(engineOptions);
 ...
 engine.close();
```
Any attempt to use an already closed engine will lead to the IllegalStateException.
To get notifications that the Engine instance has been closed subscribe to the following event:
```
 engine.on(EngineClosed.class, event -> {
     // The engine has been closed.
 });
 
```
To get notifications that the Engine instance has been unexpectedly crashed use:
```
 engine.on(EngineCrashed.class, event -> {
     // The engine has been unexpectedly crashed.
 });
 
```

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`java.util.List<Browser>`	`browsers()` Returns an immutable list of alive `Browser` instances including child popup browsers for this engine or an empty list if this engine does not have any alive `Browser`.
`CookieStore`	`cookieStore()` Returns the cookie store that allows managing cookies.
`Downloads`	`downloads()` Returns a service that allows managing downloads.
`HttpCache`	`httpCache()` Returns a service for working with HTTP cache.
`MediaDevices`	`mediaDevices()` Returns a service that allows managing media stream devices.
`Network`	`network()` Returns a service that allows working with network.
`Browser`	`newBrowser()` Creates a new `Browser` instance with the initial "about:blank" web page.
`static Engine`	`newInstance(EngineOptions options)` Initializes and runs the Chromium engine with the given `options`.
`EngineOptions`	`options()` Returns the options the current engine was initialized with.
`Permissions`	`permissions()` Returns a service that allows managing permissions.
`Plugins`	`plugins()` Returns a service that allows configuring plugins.
`Proxy`	`proxy()` Returns a service that allows working with proxy.
`SpellChecker`	`spellChecker()` Returns a service that allows working with spell checking functionality.
`ZoomLevels`	`zoomLevels()` Returns a service that allows working with zoom.

Methods inherited from interface com.teamdev.jxbrowser.Closeable
close, isClosed

Methods inherited from interface com.teamdev.jxbrowser.event.Observable
on

- Method Detail
  - newInstance
```
static Engine newInstance(EngineOptions options)
```
    Initializes and runs the Chromium engine with the given options.
    Depending on the hardware performance, the initialization process might take several seconds. So, do not call this method in the application UI thread.
    The method performs the following actions:
    1. Checks the environment and makes sure that it is supported.
    2. Locates the Chromium binaries and extracts them if it is necessary.
    3. Runs the main native process and initializes the Chromium engine.
    4. Setup IPC connection between Java and the main native process.
    Parameters:
    
    options - the engine options
    
    Returns:
    
    a new instance of the Engine
    
    Throws:
    
    EnvironmentException - when the current environment is not supported
    
    UserDataDirectoryAlreadyInUseException - when the given user data directory is already in use.
    
    IpcSetupFailureException - when Inter-Process Communication (IPC) setup has been failed
    
    ChromiumProcessStartupFailureException - when startup of the Chromium process has been failed
    
    NoLicenseException - when no license found.
    
    InvalidLicenseException - when no valid license found.
  - options
```
EngineOptions options()
```
    Returns the options the current engine was initialized with.
  - newBrowser
```
Browser newBrowser()
```
    Creates a new Browser instance with the initial "about:blank" web page.
    
    Returns:
    
    a new instance of the Browser
  - browsers
```
java.util.List<Browser> browsers()
```
    Returns an immutable list of alive Browser instances including child popup browsers for this engine or an empty list if this engine does not have any alive Browser.
    
    Returns:
    
    the list of alive Browser instances for this engine
  - zoomLevels
```
ZoomLevels zoomLevels()
```
    Returns a service that allows working with zoom.
  - proxy
```
Proxy proxy()
```
    Returns a service that allows working with proxy.
  - network
```
Network network()
```
    Returns a service that allows working with network.
  - spellChecker
```
SpellChecker spellChecker()
```
    Returns a service that allows working with spell checking functionality.
  - cookieStore
```
CookieStore cookieStore()
```
    Returns the cookie store that allows managing cookies.
  - httpCache
```
HttpCache httpCache()
```
    Returns a service for working with HTTP cache.
  - mediaDevices
```
MediaDevices mediaDevices()
```
    Returns a service that allows managing media stream devices.
  - plugins
```
Plugins plugins()
```
    Returns a service that allows configuring plugins.
  - downloads
```
Downloads downloads()
```
    Returns a service that allows managing downloads.
  - permissions
```
Permissions permissions()
```
    Returns a service that allows managing permissions.

Interface Engine

Method Summary

Methods inherited from interface com.teamdev.jxbrowser.Closeable

Methods inherited from interface com.teamdev.jxbrowser.event.Observable

Method Detail

newInstance

options

newBrowser

browsers

zoomLevels

proxy

network

spellChecker

cookieStore

httpCache

mediaDevices

plugins

downloads

permissions