| Summary: | ALLOW_CLASSPATH_DEP product preference should be deprecated | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Product: | [WebTools] WTP Java EE Tools | Reporter: | Aidyl Kareh <amkareh> | ||||||||
| Component: | jst.j2ee | Assignee: | Aidyl Kareh <amkareh> | ||||||||
| Status: | RESOLVED FIXED | QA Contact: | Chuck Bridgham <cbridgha> | ||||||||
| Severity: | normal | ||||||||||
| Priority: | P3 | CC: | amkareh, ccc, david_williams, jsholl | ||||||||
| Version: | unspecified | Flags: | cbridgha:
review+
jsholl: review? (ccc) |
||||||||
| Target Milestone: | 3.2.3 | ||||||||||
| Hardware: | PC | ||||||||||
| OS: | Windows Vista | ||||||||||
| Whiteboard: | |||||||||||
| Bug Depends on: | |||||||||||
| Bug Blocks: | 332684 | ||||||||||
| Attachments: |
|
||||||||||
|
Description
Aidyl Kareh
Created attachment 184838 [details]
Proposed Patch
I approve of this change - and it will be added to PMC for approval. It needs to be stressed that the original adopter of this code (IBM) no longer has a use, and recommend removing this option for simplicity. Created attachment 184887 [details]
Proposed Patch - Updated
Updated @deprecated comments.
* Explain why you believe this is a stop-ship defect. Or, if it is a "hotbug" (requested by an adopter) please document it as such.
The adopter that introduced the ALLOW_CLASSPATH_DEP product preference no longer needs to disable dynamic manifest updates at runtime and export and is recommending that the preference and related classes be deprecated and the calls to the preference removed for code clarity. We want to be able to ensure that all users will have consistent behavior regardless whether they are using existing workspaces or new ones or what the value of this preference might be. All existing functionality in WTP will remain unchanged by this patch since this preference was used to disable WTP functionality.
* Is there a work-around? If so, why do you believe the work-around is insufficient?
No.
* How has the fix been tested? Is there a test case attached to the bugzilla record? Has a JUnit Test been added?
Tested through UI.
* Give a brief technical overview. Who has reviewed this fix?
The attached patch updates the code to deprecate the "allowClasspathDep" preference and the related classes/methods used for get/set purposes. This patch also removes the calls to check this preference's value. A new product preference, "validateDupClasspathCompURI", was also introduced by this patch to allow adopters to disable the validator which checks for duplicate classpath and component URIs. This patch has been reviewed by Chuck and Jason.
* What is the risk associated with this fix?
Low since all WTP functionality will remain unchanged.
Can you net this out for me? Its not obvious why you are asking for PMC approval ... is it that the UI is changing? Or, simply since sort of a change to API, marking it deprecated? Since we are deprecating and removing the use of the preference, other adopters that might have used this preference expecting that it disabled the 'dynamic manifest updates' functionality will now see a change in behavior. There is no change in UI, WTP functionality will remain unchanged, and adopters code will not break by these changes. (In reply to comment #6) > Since we are deprecating and removing the use of the preference, other adopters > that might have used this preference expecting that it disabled the 'dynamic > manifest updates' functionality will now see a change in behavior. There is no > change in UI, WTP functionality will remain unchanged, and adopters code will > not break by these changes. I am not sure why to remove it in maintenance stream, if there is any chance it would break someone. I could see how you might want to mark it deprecated, and document it to be removed in 3.3 stream ... but, just wondering. I'd guess there's little chance of anyone else using it? But ... why take a chance, especially in maintenance? Your statements above seems a little contradictory ... staring by saying there might be a change in behavior if adopters used it ... but then saying adopters code would not be broken? (Sorry if I'm being dense ... maybe it'd be obvious if I loaded up the code, applied the patch, etc, ... but, since you asked for PMC review ... you are going to get it :) Retracting PMC approval; we are taking a route which will not risk regression in 32M for 3.2.3. The plan is still to remove this code in HEAD for 3.3. Created attachment 185261 [details]
patch v3
Updated patch deprecates but does not change any behavior. Also introduces a new product constant to control whether the EAR Validator attempts to load classpath references.
created bug 332684 to delete this preference from HEAD Code checked into both 32M and HEAD for WTP 3.2.3 and 3.3 approved |