
UnboundID LDAP SDK for Java
UnboundID LDAP SDK for Java 是一个快速、强大、用户友好且完全免费开源的Java库,用于与LDAP目录服务器通信。它在性能、易用性和功能方面优于其他基于Java的LDAP API。由 Ping Identity Corporation 开发,并作为Ping Identity客户端和服务器软件的关键组件,持续得到维护和增强。
UnboundID LDAP SDK for Java 可依据 Apache 2.0 许可(一个非常宽松且经OSI批准的开源许可)在开源或专有应用程序中免费使用和再分发。出于历史原因,该软件也适用于 GNU GPLv2 或 LGPLv2.1 许可,或非开源但仍可免费使用的 UnboundID Free Use License。
LDAP SDK 没有任何第三方依赖,只需 Java 8 或更高版本的 Java 运行时环境,因此单个 jar 文件即可为您的 Java 应用程序添加顶级的 LDAP 支持。它还可以与大多数其他基于 JVM 的语言以及 Android 移动平台一起使用。
LDAP SDK 的完整文档在线提供:https://docs.ldap.com/ldap-sdk/docs/index.html。UnboundID LDAP SDK for Java 的 API 文档(即 JavaDoc)位于 https://docs.ldap.com/ldap-sdk/docs/javadoc/index.html。LDAP.com 网站也提供了大量关于 LDAP 和目录服务的有用信息。
UnboundID LDAP SDK for Java 的一些主要优势包括:
全面支持最新规范更新中的 LDAPv3 协议,包括所有操作类型、中间响应消息、增量修改扩展以及绝对真/假过滤器。
内置支持广泛的官方及事实上的标准协议扩展,包括控件、扩展操作和 SASL 机制。LDAP SDK 还包含 API,可用于开发您可能需要但 SDK 未包含的任何自定义协议扩展。
非常方便且用户友好的 API,减少了执行所需操作时所需编写的代码量。
多项安全相关功能,有助于简化安全通信,确保与 LDAP 服务器和数据的所有交互安全可靠,且仅限正确授权的用户访问。
强大且灵活的连接池、负载均衡和故障转移支持,有助于确保即使一个或多个目录服务器不可用,您的应用程序也能正常运行。
简单而强大的持久化框架,允许您像处理 Java 对象一样与 LDAP 条目交互。无需任何更改即可与现有模式及目录数据配合使用,从而保持与其他可能需要访问该数据的应用程序的兼容性。
对多种特殊条目类型的增强支持,包括根 DSE、子模式子条目和变更日志条目。
支持多种相关 API,包括读写 LDIF 条目和变更记录(包括并行编码/解码以获得最佳性能)、Base64 编码/解码以及 ASN.1 BER 编码/解码。还提供用于简化创建支持 LDAP 的命令行工具的 API。
支持简化基于 LDAP 的测试。LDAP SDK 包含一个内存目录服务器,允许您轻松创建一个或多个简单的 LDAPv3 兼容服务器,用于测试框架。还提供一组实用方法,用于对 LDAP 目录服务器中存储的内容进行断言。
LDAP SDK 以单个自包含的 jar 文件形式提供,除 Java SE 8 或更高版本外,无任何依赖。
UnboundID LDAP SDK for Java 的打包版本可从 GitHub 的 https://github.com/pingidentity/ldapsdk/releases 以及 SourceForge 的 https://sourceforge.net/projects/ldap-sdk/files/ 下载。
如果您更倾向于使用 Maven 工具管理库依赖,可以访问 Maven Central Repository 获取 UnboundID LDAP SDK for Java,其 GroupId 为 "com.unboundid",ArtifactId 为 "unboundid-ldapsdk"。
如果您希望从源代码检出并构建 LDAP SDK,可以使用以下 git 命令:
git clone https://github.com/pingidentity/ldapsdk.git
代码检出后,可以在 UNIX 系统上运行 build.sh 脚本,或在 Windows 上运行 build.bat 批处理文件来构建 LDAP SDK。构建完成后,包含打包 LDAP SDK 的 zip 文件位于 build/package 目录中。
如果您在使用 LDAP SDK 时遇到问题,且无法从文档中找到解决方案,可以通过以下方式获取帮助:
对于错误报告和功能请求,请使用 GitHub Issue 追踪器:https://github.com/pingidentity/ldapsdk/issues。
对于问题、反馈及其他讨论,请使用在线讨论论坛:http://sourceforge.net/p/ldap-sdk/discussion/ 或邮件列表:[email protected]。有关该邮件列表的更多信息,包括归档和订阅方式,请参阅 https://sourceforge.net/p/ldap-sdk/mailman/ldap-sdk-discuss/。
如果您希望私下沟通,请发送电子邮件至 [email protected]。
如果您与 Ping Identity 签订了支持合同,您可以像获取其他 Ping Identity 产品支持一样,通过相同方式获得 LDAP SDK 支持。
Ping Identity 不接受第三方代码提交。不过,您可以通过其他方式提供帮助,包括提交错误报告和功能请求。更多信息请参阅 CONTRIBUTING.md 文件。