adding a Java EE sample, fixing #11477

adding location to the source

adding partial review comments from #12110

adding syncer macros and fixing links