讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

Seko
Seko

AI短剧一键生成成片

剧云
剧云

中文短剧剧本制作平台

Laper
Laper

剧本策划到成片协作

使用 Java 模块系统(JPMS)实现库的内部类封装

胖明大大_8569

胖明大大_8569

发布时间:2025-07-10 18:52:27

|

1077人浏览过

|

来源于php中文网

原创

使用 java 模块系统(jpms)实现库的内部类封装

本文介绍了如何使用 Java 模块系统(JPMS)来封装库的内部类,防止库的使用者直接访问和实例化这些内部类。文章阐述了 JPMS 的强封装特性,以及如何在模块定义中明确指定需要暴露的包。同时,讨论了向后兼容性问题,以及在不强制用户使用模块的情况下,如何通过约定和注解来引导用户正确使用库的 API。

Java 模块系统(JPMS)提供了一种强大的机制来控制代码的可见性,允许开发者将库的内部实现细节隐藏起来,只暴露公共 API。这有助于提高代码的可维护性、可演进性和安全性。

利用模块系统进行封装

JPMS 的核心思想是模块化,每个模块声明其依赖关系以及对外暴露的包。通过这种方式,可以实现强封装,防止外部模块访问内部包。

以下是一个示例,展示如何使用模块系统来封装一个库的内部类:

立即学习“Java免费学习笔记(深入)”;

  1. 组织代码结构: 将公共 API 类放在 *.api 包中,内部类放在 *.internal 包中。

  2. 创建模块描述文件 module-info.java: 在库的根目录下创建 module-info.java 文件,并声明模块的名称和导出的包。

module some.library {
    exports some.library.api;
    requires etc1; // 如果你的库依赖其他模块
}

在上面的示例中,exports some.library.api; 声明了 some.library.api 包中的所有公共类对其他模块可见。而 some.library.internal 包则没有被导出,因此对其他模块是不可见的。

模块路径与类路径

需要注意的是,JPMS 为了向后兼容,引入了模块路径(module path)和类路径(class path)的概念。模块路径强制执行模块间的封装规则,而类路径则允许访问所有类,包括内部类。

如果库的使用者没有使用模块系统,而是将库放在类路径上,那么他们仍然可以访问库的内部类。这是因为类路径上的类被视为“未命名模块”的一部分,可以访问所有其他类。

解决方案:约定与注解

即使不能完全阻止用户访问内部类,仍然可以通过一些约定和注解来引导用户正确使用库的 API。

  • 包命名约定: 使用明确的包命名约定,如 *.internal,来表明这些包包含内部实现细节,不应该被直接使用。
  • 注解: 使用注解(如 @InternalApi)来标记内部类,明确告知用户这些类是内部使用的,可能会在未来的版本中发生变化。
package some.library.internal;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Retention(RetentionPolicy.SOURCE)
@Target(ElementType.TYPE)
public @interface InternalApi {
}

@InternalApi
public class InternalClass {
    // ...
}
  • 语义化版本控制: 遵循语义化版本控制(Semantic Versioning),对公共 API 的更改使用主版本号的更新,而对内部类的更改则不需要。这有助于用户区分公共 API 和内部实现细节,并减少对内部类的依赖。

总结

虽然 JPMS 提供了一种强大的机制来封装库的内部类,但由于向后兼容性的考虑,不能完全阻止用户访问内部类。然而,通过合理的代码组织、包命名约定、注解和语义化版本控制,可以有效地引导用户正确使用库的 API,并提高代码的可维护性和可演进性。最终的目标是让用户明确了解哪些类是公共 API,哪些是内部实现细节,并鼓励他们只依赖公共 API。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

相关专题

更多
class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

4676

2024.01.03

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

326

2025.12.06

class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

4676

2024.01.03

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

326

2025.12.06

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

100

2026.11.12

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

60

2026.11.12

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

60

2026.11.12

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

160

2026.11.06

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

120

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn