OkHttp学习 - POM 文件

前言

前段时间在项目中使用到了 OkHttp 这个 HTTP 开源库，感觉使用十分方便，而且也很高效。OkHttp 作为一款为 Android 量身打造的 HTTP 客户端，支持 SPDY/HTTP 2 协议，通过阅读它的源码确实可以学到不少知识。本文通过对根目录的 POM 文件进行解析，从而对项目有个整理上的了解。

Maven 是一款优秀的跨平台的项目管理工具，主要用于 Java 平台的项目构建、依赖管理和项目信息管理。无论是小型的开源项目，还是大型的企业级应用，使用 Maven 都可以提高生产力。OkHttp 作为一个优秀和成熟的开源库，选择 Maven 来完成编译、单元测试、生成文档、打包、项目管理等工作算是明智之举。

为什么需要 Maven

首先Maven 是跨平台的，这意味着无论是在 Windows 平台，还是在 Linux 或者 Mac 平台，都可以使用同样的命令。

开发项目时，除了编写源代码，还有相当一部分时间花在了编译、运行单元测试、生成文档、打包和部署等烦琐且不起眼的构建工作上。如果现在还手工来完成构建工作，那成本是相当高的。Maven 使得软件的构建可以像自动流水线一样，只需要一条简单的命令，所有烦琐的步骤都能够自动完成。此外，Maven 能帮助我们标准化构建过程。在使用 Maven 之前，十个项目可能有十种不同的构建方式，而 Maven 使得所有项目的构建命令都是简单一致的，这极大地避免了不必要的学习成本，而且有利于促进项目团队的标准化。

任何 Java 应用几乎都会引用一些第三方的开源类库，这些类库都可通过依赖的方式引入到项目中来。随着依赖的增多，版本不一致、版本冲突、依赖臃肿等问题都会接踵而来。手工解决这些问题是十分枯燥的，Maven 提供了一个优秀的依赖管理解决方案，它通过一个坐标系统准确地定位每一个构件（artifact），也就是通过一组坐标找到任何一个 Java 类库（如 jar 文件）。Maven 给这个类库世界引入了经纬，让它们变得有秩序，于是我们可以借助它来有序地管理依赖，轻松地解决那些繁杂的依赖问题。

Maven 还能帮助我们管理原本分散在项目中各个角落的项目信息，包括项目描述、开发者列表、版本控制系统地址、许可证、缺陷管理系统地址等。Maven 还为全世界的 Java 开发者提供了一个免费的中央仓库，在其中可以找到几乎任何的流行开源类库。通过一些 Maven 的衍生工具（如 Nexus），还能对其进行快速地搜索。当然，Android Studio 的 Gradle 天然支持通过 Maven 坐标系统下载开源类库。

本节内容参考自《Maven实战》第一章。

OkHttp 的 POM 文件

POM（Project Object Model，项目对象模型）定义了项目的基本信息，用于描述项目如何构建，声明项目依赖等，这些基本信息保存在文件 pom.xml 中。从 GitHub 中将 OkHttp 仓库克隆下来，在项目根目录中就可以看到 pom.xml 文件。通过解析 pom.xml 文件，我们可以对 OkHttp 项目整体上有个基本了解。pom.xml 文件内容比较丰富，包含了以下几部分，首先是项目基本信息：

  ......

  <parent>                                                                                                            [1]
    <groupId>org.sonatype.oss</groupId>
    <artifactId>oss-parent</artifactId>
    <version>7</version>
  </parent>

  <groupId>com.squareup.okhttp3</groupId>                                                                             [2]
  <artifactId>parent</artifactId>                                                                                     [3]
  <version>3.0.0</version>                                                                                            [4]
  <packaging>pom</packaging>                                                                                          [5]

  <name>OkHttp (Parent)</name>
  <description>