Fixed all JavaDoc warnings in pact-common.

Fixed all JavaDoc warnings in pact-common. 
I focused on fixing the build warnings but also added and updated some JavaDoc on the way.

Adresses issue #330.