Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Jandex extended path

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#8,451 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
74/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Ít trao đổi
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu với các chủ đề tham chiếu hiện có về applicationManager và cấu hình ứng dụng được liên kết trong issue. Thêm vào cả hai chủ đề thuộc tính readWebInfJandex, giá trị mặc định của thuộc tính, các giá trị được hỗ trợ, mối quan hệ với useJandex, thứ tự ưu tiên và các ví dụ được cung cấp. Hoàn tất khi cả hai trang tham chiếu đã render đều mô tả chính xác hành vi opt-in và vị trí WEB-INF/classes/META-INF/jandex.idx.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Feature epic details
Operating systems

Does the documentation apply to all operating systems?

  • Yes
  • No; specify operating systems: ______
Summary

Provide a concise summary of your feature. What is the update, why does it matter, and to whom? What do 80% of target users need to know to be most easily productive using your runtime update?

Configuration:

Elements: applicationManager, application
Attribute: readWebInfJandex
Description: When performing class scans, when "useJandex" is true, also look for a jandex index under "/WEB-INF/classes/META-INF/jandex.idx".
Possible values: true | false
Default value: false

Examples

 <applicationManager useJandex="true" readWebInfJandex="true"/>
 <application location="TestServlet40.ear" useJandex="true" readWebInfJandex="true"/>

Discussion

Initial Liberty support for jandex looks for jandex indices at "/META-INF/jandex.idx" relative to module roots. That is correct for EJB modules, but is incorrect for web modules. The industry standard location for jandex indices within web modules is relative to the web module class path root: "/WEB-INF/classes/META-INF/jandex.idx".

The new attribute readWebInfJandex enables support for the industry standard location, "/WEB-INF/classes/META-INF/jandex.idx". When the new attribute is enabled, when processing web modules, Liberty looks for jandex indices in both the original location relative to the module root, and at the industry standard location relative to the web module class path root. (If indices are present at both locations, the "/META-INF/jandex.idx" location has precedence.)

The new attribute may be used in the applicationManager element and in the application element. When used in the applicationManager element, the attribute value applies to all applications. When used in an application element, the attribute value applies to that one application. (A value supplied in the application element overrides a value supplied in the applicationManager element, for that one application.)

To reduce migration risks, the new attribute is an opt-in attribute. The default value is false. A true value must be explicitly set to enable support for the new location.

Support for jandex is not enabled by default. The useJandex option must be explicitly set to true to enable jandex support. The new readWebInfJandex option is meaningful only when useJandex is true.

Updates to existing topics

The attribute is being added to two existing configuration elements, application and applicationManager.

https://openliberty.io/docs/latest/reference/config/applicationManager.html
https://openliberty.io/docs/latest/reference/config/application.html

Create a new topic

N/A

Ngôn ngữ chính
Không có dữ liệu ngôn ngữ
Star
14
Fork
58
Merge trung bình
1 giờ 8 phút
Pull request đã merge (30 ngày)
20

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của OpenLiberty/docs

Tất cả issue của OpenLiberty/docs

Issue tương tự

Thêm issue về Documentation

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.