阅读(4627) (11)

IntelliJ IDEA如何使用库

2017-10-12 10:31:59 更新

IntelliJ IDEA 使用库

库是您使用的已编译代码的集合。例如,一个 Java 库可以包括类文件,存档和带有类文件的目录以及具有 Java 本机库(.dll,.so或.jnilib)的目录。

IntelliJ IDEA 使用库可以选择包括库类的源代码以及相应的 API 文档。包括源文件和文档是可选的。它增加了使用从源代码提取的内联文档的能力(查看| 快速文档(View | Quick Documentation)或 Ctrl+Q),还可以从 IDE 查看 API 文档(查看| 外部文档(View | External Documentation)或 Shift+F1)。

库可以让您重用其他开发的代码,而不是自己实现相应的功能。

库的级别

您可以在全局(IDE),项目和模块级别定义库。库的级别定义了其潜在或实际使用的范围:

  • 全局库可以在任何 IntelliJ IDEA 项目中使用。也就是说,可以将它们添加到任何项目中任何模块的依赖项中。
  • 项目库可用于相应项目中的任何模块。但是,它们在定义它们的项目之外不可用。
  • 模块库仅作为相应模块的依赖关系存在。
请注意,除非添加到模块的依赖关系中,否则全局或项目库实际上是未使用的。

IntelliJ IDEA 允许您将库移动到更高级别(例如:从项目到全局),在较低的级别创建库副本(例如,您可以在项目级别创建全局库的副本)等。

应用程序服务器库

应用程序服务器库可以让您使用相应服务器分发中可用的类。

当您添加应用程序服务器的定义(例如:在 IntelliJ IDEA 中定义应用程序服务器)时,将创建一个关联的应用程序服务器库。

在库级别方面,应用服务器库是全局库。可以将它们添加到任何项目中任何模块的依赖关系中。

排除 IntelliJ IDEA 库项目

您可以将 IntelliJ IDEA 库项目“排除”。当您编写代码时,IntelliJ IDEA 将忽略此类项目。因此,排除包中的类不会出现在代码完成建议列表中,对这些类的引用将在编辑器中显示为未解决的内容等。但是,在编译或运行代码时,库仍将作为一个整体使用,而不管该库中是否存在已排除的项。

您可以排除存档中的文件夹,存档(例如:JAR)和文件夹。

当您的代码仅引用大型库的一小部分时,排除“不必要”的项目可能会大大提高 IDE 性能。

IntelliJ IDEA 如何管理库

IntelliJ IDEA 与使用库相关的大多数任务都在 "项目结构" 对话框中执行(文件| 项目结构(File | Project Structure))。

但是有个例外的情况:应用程序服务器库和 JavaScript 库。这些在 "设置/首选项" 对话框中进行管理:

  • 应用程序服务器库: Ctrl+Alt+S | 构建,执行,部署| 应用服务器(Ctrl+Alt+S | Build, Execution, Deployment | Application Servers)。
  • JavaScript库: Ctrl+Alt+S | 语言与框架| JavaScript | 库(Ctrl+Alt+S | Languages and Frameworks | JavaScript | Libraries)。有关更多信息,请参阅配置 JavaScript 库。

在“项目结构”对话框中,具体取决于库的级别:

  1. 全局(IDE)。要查看全局库,请选择“全局库”。
    IntelliJ IDEA 如何管理全局库
  2. 项目。要查看您的项目库,请选择“库”。

    IntelliJ IDEA 如何管理项目库

  3. 要查看模块的依赖项中包含的库,请选择 "模块",选择感兴趣的模块,然后选择 "依赖关系"。

    IntelliJ IDEA 如何管理库

不是依赖项列表中的 SDK 或模块,而是一个库。

这里的库不一定都是模块库。也可能有全局库和项目库。

如果您想了解库的级别,请选择感兴趣的库并点击 。库级别将反映在将打开的对话框的名称中,例如配置模块库。

IntelliJ IDEA 从 Maven 下载库

当您添加一个库(  | 从 Maven),IntelliJ IDEA 从 Maven 或 Nexus 公共存储库下载一个库。存储库在设置 |生成、执行、部署 |远程 Jar 存储库(Settings | Build, Execution, Deployment | Remote Jar Repositories)页面中完成配置。

IntelliJ IDEA 从 Maven 下载库


您不必使 Maven 插件从 Maven 存储库中下载您的库。此外,您可以从 IntelliJ IDEA 下载库中配置自定义远程存储库。

IntelliJ IDEA 从 Maven 下载库


如果您的公司对需要访问的公司的远程存储库使用某些工件存储库管理器,这可能会有所帮助。您可以为服务和存储库添加 URL 以访问库的授权版本。

在这种情况下,不需要为 VCS 中的所有项目保存库,因为您可以随时访问指定的存储库和存储在该库中的库的版本。

在所有其他情况下,您可以通过指定计算机上已有的文件和文件夹来组合库。

创建 IntelliJ IDEA 库

根据您当前库的级别:

全局库或项目库。在库的列表的上方,单击 并选择库类型(例如:Java)。选择要包含在库中的文件和文件夹。选择要将库添加到其依赖关系的模块。

模块库。在依赖关系列表旁边,单击 。现在,您可以选择以下路由之一,两者都会产生大致相同的结果:

  • JAR 或 目录。在打开的对话框中,选择要包含在库中的文件和文件夹。因此,将创建一个未命名的模块库并将其添加到模块的依赖关系中。
  • 库。 在打开的对话框中,单击"新建库" 并选择库类型(例如:Java)。然后选择要包含在库中的文件和文件夹。在 "配置库" 对话框中,指定库名称和级别。要将新库添加到模块的依赖项,请单击 "添加选定"。

在“项目”工具窗口中创建库

如果要用作库的 .jar 文件位于您的项目内容根目录中,则可以在 "项目" 工具窗口中开始创建库 (查看 |工具窗口 |项目(View | Tool Windows | Project))。

  1. 选择要包含在库中的 .jar 文件或文件,或者包含感兴趣的 .jar 文件的目录。
  2. 从上下文菜单中选择 "添加为库"。
  3. 在打开的对话框中,指定将使用此库的库名称、级别和模块。

将全局或项目库添加​​到模块依赖关系

取决于当前库的级别:

全局库或项目库。右键单击感兴趣的库,然后选择“添加到模块”。选择要将库添加到其依赖关系的模块。

模块库。在依赖关系列表的旁边,单击 并选择库。在打开的对话框中,选择一个或多个库并单击 "添加选定"项。

将库移动到高级别

您可以将模块库移动到项目或全局级别。此外,您可以将项目库移动到全局级别。

  1. 右键单击库并选择然后选择 "移动到项目库" 或 "移动到全局库"。
  2. 在打开的对话框中,指定要移动库内容的地点和位置。

何时将库移到更高的级别?

假设在您想在另一个模块中有一个模块库。在这种情况下,你将:

  1. 将库移动到项目级别。
  2. 将库添加到相应模块的依赖关系中。

IntelliJ IDEA 在较低级别创建库的副本

您可以在项目级别创建一个全局库的副本:右键单击该库并选择 "复制到项目库"。然后,在打开的对话框中,指定是否还需要存储库文件的副本以及应在何处创建该副本。

对于包含在模块的依赖项中的全局或项目库,若要开始在模块级别创建副本,请右键单击相应的库,然后选择 "复制到模块库"。

何时需要较低级别的库的副本?

假设有一个项目库应用于多个模块。而你想要在该库中有更多的类,但只在其中一个模块中。在这种情况下,你将:

  1. 在相应模块的依赖关系中创建库的副本。(这样就创建了一个新的模块库。)
  2. 将类添加到新的模块库中。

查找项目或全局库的使用实例

您可以找到是哪个模块的使用项目库或全局库:右键单击库并选择 "查找实例" (Alt+F7)。

将类,源和文档添加到 IntelliJ IDEA 库

根据当前库的级别:

全局库或项目库。在对话框的右侧部分,显示库的名称和内容,单击  (Alt+Insert),然后选择包含要添加的类、源和文档的文件和文件夹。

模块库。选择感兴趣的库并点击 。在打开的对话框中,单击 (Alt+Insert),然后选择包含要添加的类、源和文档的文件和文件夹。

IntelliJ IDEA 访问在线文档

如果您正在使用的库可以在线文档,则可以在编码时使该文档可访问。为此,您应该指定文档的 URL。(稍后,查看在线文档,使用查看| 外部文档(View | External Documentation)或Shift+F1。)

根据当前库的级别:

全局库或项目库。在对话框的右侧部分,显示库的名称和内容,单击 并指定文档的 URL。

模块库。选择感兴趣的库并点击 。在打开的对话框中,单击 并指定文档的 URL。

取消 IntelliJ IDEA 库的排除状态

若要使 IntelliJ IDEA 库项目不被排除,具体取决于当前库的级别:

全局库或项目库。在对话框的右侧部分,显示库名称和内容,单击 。在打开的对话框中,选择要排除的项目。(您可以排除存档中的文件夹,存档(例如 JAR)和文件夹。)

这样,将显示具有排除状态的项目。它们显示为

模块库。选择感兴趣的库并点击 。在打开的对话框中,单击 ,然后选择要排除的项目。

取消库项目的排除状态:

在 "全局" 或 "项目" 级别上: 选择要取消排除状态的项目( ),然后单击 (Delete)。

在“模块”级别上:选择感兴趣的库并单击 。在打开的对话框中,选择要取消排除状态的项目( ),然后单击 (Delete)。

从依赖关系切换到库配置

要查看包含在模块依赖项中的库的库配置(设置和内容),请右键单击库并选择 Navigate(F4)。