JERSEY-224 && JERSEY-222 part II: (findbugs & javadocs issues)

Change-Id: Ic0d111e179d9b546c076eb24050ed854a8aef41e
Merge "JERSEY-224 && JERSEY-222 part II: (findbugs & javadocs issues)"