Bug 1086733
Summary: | [Doc Change] Changes in PicketLink API between versions 2.1 and 2.5 | ||
---|---|---|---|
Product: | [JBoss] JBoss Enterprise Application Platform 6 | Reporter: | Ondrej Lukas <olukas> |
Component: | Documentation | Assignee: | Scott Mumford <smumford> |
Status: | CLOSED CURRENTRELEASE | QA Contact: | Ondrej Lukas <olukas> |
Severity: | urgent | Docs Contact: | |
Priority: | high | ||
Version: | 6.3.0 | CC: | asaldhan, dosoudil, fbogyai, hmlnarik, jcacek, nziakova, rdickens, rsvoboda, smumford, twells |
Target Milestone: | GA | Keywords: | Documentation, FutureFeature |
Target Release: | EAP 6.3.0 | ||
Hardware: | Unspecified | ||
OS: | Unspecified | ||
Whiteboard: | |||
Fixed In Version: | Doc Type: | Known Issue | |
Doc Text: |
PicketLink 2.5 has brought some API changes from PicketLink 2.1, which was included in previous JBoss EAP 6.x releases.
These changes include several classes being which affects backwards compatibility. PicketLink 2.1 applications will need to be updated with the changes.
The full list of changes is provided at the end of this document.
|
Story Points: | --- |
Clone Of: | Environment: | ||
Last Closed: | 2014-08-06 14:35:03 UTC | Type: | Bug |
Regression: | --- | Mount Type: | --- |
Documentation: | --- | CRM: | |
Verified Versions: | Category: | --- | |
oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
Cloudforms Team: | --- | Target Upstream Version: | |
Embargoed: |
Description
Ondrej Lukas
2014-04-11 11:53:52 UTC
Attention: Anil In this BZ ticket's description, Ondrej notes "_Non-exhaustive_ example of the API changes". Is there an authoritative reference of differences between PL 2.1 and 2.5 which I can include in the EAP 6.3.0 Release Notes? We particularly need to highlight any instances where changes may break compatibility. Russell - Ondrej is correct. We need move a bunch of internal classes around. The list of packages that were moved is correct. You can document the packages moved. They do not affect user applications. I was not sure of the meaning of Anil's feedback in comment 3, so I asked for clarification via IRC: <rdickens> asaldhan: do i understand correctly that the list of modules mentioned by Ondrej is the *complete* list of modules which were moved between PL 2.1 and 2.5? <rdickens> asaldhan: thank you I have changed the release notes flag as Anil Saldhana has confirmed that these API changes will not affect customer applications already using PicketLink 2.5. The changes do affect backwards compatibility. Applications using PL 2.1 API do not even compile with 2.5 and their source (at least the imports, maybe more?) needs to be changed. All of these changes need to be documented as PL API is a part of the EAP public API. Anil, Russell, please provide full list of changes to the Release Notes or note to Rel Notes and full list into more appropriate guide. Russell, please change the RN text accordingly. It must be stated that the changes are _not_ backwards compatible. Topic 35798 has been created to contain the API changes and has been added to the content spec for the 6.3.0 Release Notes. Moving ticket to MODIFIED pending document rebuild. Moving to POST pending rebuild of the Release Notes. Update will be available at the below URL (Info will be in an appendix at the end of the document). https://access.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/6.3.0_Release_Notes/index.html In EAP 6.3 Release Notes section 8. API changes between PicketLink versions 2.1 and 2.5, there is wrong package name in the beggining. Change the first package name from "org.picketlink.identity.federation.core.configliteral>" to "org.picketlink.identity.federation.core.config" Nice catch Filip. Markup goof. I've fixed it now. A new build of the 6.3.0 Release Notes is available for review at: https://documentation-devel.engineering.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/6.3.0_Release_Notes/index.html When verifying bugs, please ensure you're viewing the latest version of the document (6.3.0-14 or later). Build details: https://brewweb.devel.redhat.com/taskinfo?taskID=7700244 Verified in Revision 6.3.0-14 Moving back to assigned as a tracker (so I don't forget to add this content in the final GA build). A new version of the Release Notes is available for review at: https://documentation-devel.engineering.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/6.3.0_Release_Notes/index.html (ensure you're reviewing version 6.3.0-17) Brew task: http://brewweb.devel.redhat.com/brew/taskinfo?taskID=7735113 Verified in Revision 6.3.0-17 |