Capital of the Catalan region of Spain, Barcelona has a style and verve that has made it one of the Mediterranean’s most sought-after destinations, discovers Kenny Coyle