配置文件

本指南介绍了如何管理 Chromium 配置文件。

请考虑阅读架构指南,以更好地了解 JxBrowser 架构的设计方式、工作原理以及它提供的主要组件。

概观

配置文件存储用户数据,如导航历史、cookie、缓存、密码等。

Profile 类提供了对信息的访问,如配置文件名称、配置文件存储其数据的目录的绝对路径等,还提供了对配置文件相关服务的访问,例如:

  • ZoomLevels
  • Plugins
  • Proxy
  • Network
  • SpellChecker
  • CookieStore
  • HttpCache
  • HttpAuthCache
  • Downloads
  • Permissions

属于同一 ProfileBrowser 实例共享 cookie、历史记录、缓存和其他数据。 如果您不想在两个 Browser 实例之间共享数据,那么您可以创建多个配置文件并使用属于不同配置文件的 Browser 实例。

要创建和删除配置文件,访问所有已创建的配置文件,包括默认配置文件,请使用 Profiles 服务:

Profiles profiles = engine.profiles(); 
val profiles = engine.profiles()

默认配置文件

创建 Engine 实例时,会自动创建默认配置文件。 您可以使用以下方法访问它:

Profile defaultProfile = profiles.defaultProfile();
val defaultProfile = profiles.defaultProfile()

隐身

要使默认配置文件隐身,请在创建 Engine 实例时使用隐身选项。 此选项仅影响默认配置文件。

创建配置文件

要创建一个新的常规配置文件,请使用 Profiles.newProfile(String) 方法:

Profile profile = profiles.newProfile("MyProfile");
val profile = profiles.newProfile("MyProfile")

配置文件将其数据(例如导航历史记录、代理设置、cookie、拼写检查器配置等)存储在用户数据目录内的单独目录中。

创建隐身配置文件

要创建隐身配置文件,请使用以下方法:

Profile profile = profiles.newIncognitoProfile("MyIncognitoProfile");
val profile = profiles.newIncognitoProfile("MyIncognitoProfile")

获取配置文件

您可以使用 Profiles.list()方法获取所有已创建配置文件的列表,包括默认配置文件。 例如:

List<Profile> profiles = profiles.list();
val profiles = profiles.list()

删除配置文件

要删除现有配置文件,请使用 Profiles.delete(Profile) 方法。 例如:

profiles.delete(profile);
profiles.delete(profile)

当您删除配置文件时,所有与其相关联的浏览器实例都会自动关闭。 尝试使用已删除的 Profile 将导致 IllegalStateException 错误。

默认配置文件无法被删除。 尝试删除默认配置文件会导致 IllegalArgumentException

首选项

每个配置文件都有一组首选项。 您可以使用以下方法访问配置文件的首选项:

ProfilePreferences profilePrefs = profile.preferences();
val profilePrefs = profile.preferences()

配置文件首选项存储在用户数据目录中。 当您创建 Engine 实例时,它们将从目录中恢复。

网页表格自动填写

您可以让 JxBrowser 使用保存的信息自动填写表单,例如用户名和密码。 当用户在新的在线表格中输入用户名和密码时,库可能会询问您是否要保存它。

请在密码中阅读有关如何处理保存密码请求和管理所有已保存密码的更多信息。

要禁用网页表单自动填充,请使用:

profile.preferences().disableAutofill();
profile.preferences().disableAutofill()
Go Top