CefApp (CEF3 Java API Docs)

java.lang.Object
- org.cef.handler.CefAppHandlerAdapter
- - org.cef.CefApp

所有已实现的接口:

CefAppHandler
```
public class CefApp
extends CefAppHandlerAdapter
```
Exposes static methods for managing the global CEF context.
(公开用于管理全局CEF上下文的静态方法)

嵌套类概要

嵌套类
限定符和类型	类和说明
`static class`	`CefApp.CefAppState` The CefAppState gives you a hint if the CefApp is already usable or not usable any more. (CefAppState会提供一个CefApp可用或不可用等状况的提示)
`class`	`CefApp.CefVersion`

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`static void`	`addAppHandler(CefAppHandler appHandler)` Assign an AppHandler to CefApp. (给CefApp分配AppHandler，注册CefAppHandler接口的实现)
`boolean`	`clearSchemeHandlerFactories()` Clear all registered scheme handler factories. (清除所有注册的handler方案)
`protected void`	`clientWasDisposed(CefClient client)` This method is called by a CefClient if it was disposed. (如果处理了CefClient，则调用此方法)
`CefClient`	`createClient()` Creates a new client instance and returns it to the caller. (创建一个新的客户端实例并将其返回给调用者)
`void`	`dispose()` To shutdown the system, it's important to call the dispose method. (要关闭系统，调用dispose方法很重要)
`void`	`doMessageLoopWork(long delay_ms)` Perform a single message loop iteration. (执行单个消息循环迭代)
`static CefApp`	`getInstance()` Get an instance of this class. (获取CefApp类的实例)
`static CefApp`	`getInstance(CefSettings settings)`
`static CefApp`	`getInstance(java.lang.String[] args)`
`static CefApp`	`getInstance(java.lang.String[] args, CefSettings settings)`
`static CefApp.CefAppState`	`getState()` Returns the current state of CefApp. (返回CefApp的当前状态)
`CefApp.CefVersion`	`getVersion()`
`protected void`	`handleBeforeTerminate()` This method is invoked by the native code (currently on Mac only) in case of a termination event (e.g. someone pressed CMD+Q). (在终止事件的情况下（例如有人按下CMD + Q），本机代码（目前仅在Mac上）调用此方法)
`boolean`	`registerSchemeHandlerFactory(java.lang.String schemeName, java.lang.String domainName, CefSchemeHandlerFactory factory)` Register a scheme handler factory for the specified \|scheme_name\| and optional \|domain_name\|. (注册一个方案处理工厂，需要设置唯一的 scheme_name 和 domain_name[可选])
`void`	`setSettings(CefSettings settings)`

从类继承的方法 org.cef.handler.CefAppHandlerAdapter
getPrintHandler, onBeforeCommandLineProcessing, onBeforeTerminate, onContextInitialized, onRegisterCustomSchemes, onScheduleMessagePumpWork, stateHasChanged

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - addAppHandler
```
public static void addAppHandler(CefAppHandler appHandler)
                          throws java.lang.IllegalStateException
```
    Assign an AppHandler to CefApp. The AppHandler can be used to evaluate application arguments, to register your own schemes and to hook into the shutdown sequence. See CefAppHandler for more details. This method must be called before CefApp is initialized. CefApp will be initialized automatically if you call createClient() the first time.
    (将AppHandler分配给CefApp。 AppHandler可用于评估应用程序参数，注册您自己的方案以及挂钩关闭序列。有关更多详细信息，请参阅CefAppHandler。必须在初始化CefApp之前调用此方法。如果您是第一次调用createClient（），CefApp将自动初始化。)
    
    参数:
    
    appHandler - An instance of CefAppHandler.
    
    抛出:
    
    java.lang.IllegalStateException - in case of CefApp is already initialized
  - clearSchemeHandlerFactories
```
public boolean clearSchemeHandlerFactories()
```
    Clear all registered scheme handler factories. Returns false on error. This function may be called on any thread in the browser process.
    (清除所有注册的方案处理工厂,错误时返回false,可以在浏览器进程中的任何线程上调用此函数。)
  - clientWasDisposed
```
protected final void clientWasDisposed(CefClient client)
```
    This method is called by a CefClient if it was disposed. This causes CefApp to clean up its list of available client instances. If all clients are disposed, CefApp will be shutdown.
    (如果处理了CefClient，则调用此方法。这会导致CefApp清理其可用客户端实例列表。如果所有客户端都被丢弃，CefApp将被关闭)
    
    参数:
    
    client - the disposed client.
  - createClient
```
public CefClient createClient()
```
    Creates a new client instance and returns it to the caller. One client instance is responsible for one to many browser instances
    (创建一个新的客户端实例并将其返回给调用者。一个客户端实例负责一个到多个浏览器实例)
    
    返回:
    
    a new client instance
  - dispose
```
public final void dispose()
```
    To shutdown the system, it's important to call the dispose method. Calling this method closes all client instances with and all browser instances each client owns. After that the message loop is terminated and CEF is shutdown.
    (要关闭系统，调用dispose方法很重要。调用此方法将关闭所有客户端实例以及每个客户端拥有的所有浏览器实例。之后，消息循环终止，CEF关闭)
  - doMessageLoopWork
```
public final void doMessageLoopWork(long delay_ms)
```
    Perform a single message loop iteration. Used on all platforms except Windows with windowed rendering.
    (执行单个消息循环迭代,在带窗口渲染的Windows以外的所有平台上使用)
  - getInstance
```
public static CefApp getInstance()
                          throws java.lang.UnsatisfiedLinkError
```
    Get an instance of this class.
    (获取CefApp类的实例。)
    
    返回:
    
    an instance of this class
    
    抛出:
    
    java.lang.UnsatisfiedLinkError
  - getInstance
```
public static CefApp getInstance(CefSettings settings)
                          throws java.lang.UnsatisfiedLinkError
```
    抛出:
    
    java.lang.UnsatisfiedLinkError
  - getInstance
```
public static CefApp getInstance(java.lang.String[] args)
                          throws java.lang.UnsatisfiedLinkError
```
    抛出:
    
    java.lang.UnsatisfiedLinkError
  - getInstance
```
public static CefApp getInstance(java.lang.String[] args,
                                 CefSettings settings)
                          throws java.lang.UnsatisfiedLinkError
```
    抛出:
    
    java.lang.UnsatisfiedLinkError
  - getState
```
public static final CefApp.CefAppState getState()
```
    Returns the current state of CefApp.
    
    返回:
    
    current state.
  - getVersion
```
public final CefApp.CefVersion getVersion()
```
  - handleBeforeTerminate
```
protected final void handleBeforeTerminate()
```
    This method is invoked by the native code (currently on Mac only) in case of a termination event (e.g. someone pressed CMD+Q).
  - registerSchemeHandlerFactory
```
public boolean registerSchemeHandlerFactory(java.lang.String schemeName,
                                            java.lang.String domainName,
                                            CefSchemeHandlerFactory factory)
```
    Register a scheme handler factory for the specified |scheme_name| and optional |domain_name|. An empty |domain_name| value for a standard scheme will cause the factory to match all domain names. The |domain_name| value will be ignored for non-standard schemes. If |scheme_name| is a built-in scheme and no handler is returned by |factory| then the built-in scheme handler factory will be called. If |scheme_name| is a custom scheme then also implement the CefApp::OnRegisterCustomSchemes() method in all processes. This function may be called multiple times to change or remove the factory that matches the specified |scheme_name| and optional |domain_name|. Returns false if an error occurs. This function may be called on any thread in the browser process.
    (为指定的| scheme_name |注册方案处理程序工厂和可选| domain_name |。空| domain_name | 标准方案的值将导致工厂匹配所有域名。 | domain_name | 非标准方案将忽略该值。如果| scheme_name | 是一个内置的方案，并且| factory |不返回任何处理程序然后将调用内置的方案处理程序工厂。如果| scheme_name | 是一个自定义方案，然后在所有进程中实现CefApp :: OnRegisterCustomSchemes（）方法。可以多次调用此函数来更改或删除与指定的| scheme_name |匹配的工厂和可选| domain_name |。如果发生错误，则返回false。可以在浏览器进程中的任何线程上调用此函数。)
  - setSettings
```
public final void setSettings(CefSettings settings)
                       throws java.lang.IllegalStateException
```
    抛出:
    
    java.lang.IllegalStateException

类 CefApp

嵌套类概要

方法概要

从类继承的方法 org.cef.handler.CefAppHandlerAdapter

从类继承的方法 java.lang.Object

方法详细资料

addAppHandler

clearSchemeHandlerFactories

clientWasDisposed

createClient

dispose

doMessageLoopWork

getInstance

getInstance

getInstance

getInstance

getState

getVersion

handleBeforeTerminate

registerSchemeHandlerFactory

setSettings