# clarified some serializer code (comment + modifiers)

java/com.sap.sailing.server.gateway.serialization/src/com/sap/sailing/server/gateway/serialization/JsonSerializer.java

@@ -2,7 +2,19 @@ package com.sap.sailing.server.gateway.serialization;
 
 import org.json.simple.JSONObject;
 
+/**
+ * Interface for serializer to Json. 
+ * All implementations must be thread-safe.
+ *
+ * @param <T> Object class to serialize.
+ */
 public interface JsonSerializer<T>
 {
+	/**
+	 * Serializes given object to a Json object.
+	 * 
+	 * @param object to be serialized.
+	 * @return serialized Json object.
+	 */
 	JSONObject serialize(T object);
 }

java/com.sap.sailing.server.gateway.serialization/src/com/sap/sailing/server/gateway/serialization/impl/CourseJsonSerializer.java

@@ -11,7 +11,7 @@ public class CourseJsonSerializer implements JsonSerializer<Course> {
 	public static final String FIELD_NAME = "name";
 	public static final String FIELD_WAYPOINTS = "waypoints";
 	
-	private JsonSerializer<Waypoint> waypointSerializer;
+	private final JsonSerializer<Waypoint> waypointSerializer;
 	
 	public CourseJsonSerializer(JsonSerializer<Waypoint> waypointSerializer) {
 		this.waypointSerializer = waypointSerializer;

java/com.sap.sailing.server.gateway.serialization/src/com/sap/sailing/server/gateway/serialization/impl/EventJsonSerializer.java

@@ -12,7 +12,7 @@ public class EventJsonSerializer implements JsonSerializer<Event> {
 	public static final String FIELD_PUBLICATION_URL = "publicationUrl";
 	public static final String FIELD_VENUE = "venue";
 	
-	private JsonSerializer<Venue> venueSerializer;
+	private final JsonSerializer<Venue> venueSerializer;
 	
 	public EventJsonSerializer(JsonSerializer<Venue> venueSerializer)
 	{

java/com.sap.sailing.server.gateway.serialization/src/com/sap/sailing/server/gateway/serialization/impl/GateJsonSerializer.java

@@ -12,7 +12,7 @@ public class GateJsonSerializer extends BaseControlPointJsonSerializer implement
 	public static final String FIELD_LEFT = "left";
 	public static final String FIELD_RIGHT = "right";
 	
-	private JsonSerializer<ControlPoint> markSerializer;
+	private final JsonSerializer<ControlPoint> markSerializer;
 	
 	public GateJsonSerializer(JsonSerializer<ControlPoint> markSerializer) {
 		this.markSerializer = markSerializer;

java/com.sap.sailing.server.gateway.serialization/src/com/sap/sailing/server/gateway/serialization/impl/RaceCommitteeEventSerializer.java

@@ -9,8 +9,8 @@ import com.sap.sailing.server.gateway.serialization.JsonSerializer;
 
 public class RaceCommitteeEventSerializer implements JsonSerializer<RaceCommitteeEvent> {
 
-	private JsonSerializer<RaceCommitteeEvent> flagEventSerializer;
-	private JsonSerializer<RaceCommitteeEvent> startTimeSerializer;
+	private final JsonSerializer<RaceCommitteeEvent> flagEventSerializer;
+	private final JsonSerializer<RaceCommitteeEvent> startTimeSerializer;
 
 	public RaceCommitteeEventSerializer(
 			JsonSerializer<RaceCommitteeEvent> flagEventSerializer,

java/com.sap.sailing.server.gateway.serialization/src/com/sap/sailing/server/gateway/serialization/impl/RaceDefinitionJsonSerializer.java

@@ -11,7 +11,7 @@ public class RaceDefinitionJsonSerializer implements JsonSerializer<RaceDefiniti
 	public static final String FIELD_NAME = "name";
 	public static final String FIELD_COURSE = "course";
 	
-	private JsonSerializer<Course> courseSerializer;
+	private final JsonSerializer<Course> courseSerializer;
 	
 	public RaceDefinitionJsonSerializer(JsonSerializer<Course> courseSerializer) {
 		this.courseSerializer = courseSerializer;

java/com.sap.sailing.server.gateway.serialization/src/com/sap/sailing/server/gateway/serialization/impl/RegattaJsonSerializer.java

@@ -14,8 +14,8 @@ public class RegattaJsonSerializer implements JsonSerializer<Regatta> {
 	public static final String FIELD_BOAT_CLASS = "boatClass";
 	public static final String FIELD_RACES = "races";
 	
-	private JsonSerializer<BoatClass> boatClassSerializer;
-	private JsonSerializer<RaceDefinition> raceDefinitionSerializer;
+	private final JsonSerializer<BoatClass> boatClassSerializer;
+	private final JsonSerializer<RaceDefinition> raceDefinitionSerializer;
 	
 	public RegattaJsonSerializer(
 			JsonSerializer<BoatClass> boatClassSerializer,

java/com.sap.sailing.server.gateway.serialization/src/com/sap/sailing/server/gateway/serialization/impl/VenueJsonSerializer.java

@@ -12,7 +12,7 @@ public class VenueJsonSerializer implements JsonSerializer<Venue> {
 	public static final String FIELD_NAME = "name";
 	public static final String FIELD_COURSE_AREAS = "courseAreas";
 	
-	private JsonSerializer<CourseArea> areaSerializer;
+	private final JsonSerializer<CourseArea> areaSerializer;
 	
 	public VenueJsonSerializer(JsonSerializer<CourseArea> areaSerializer)
 	{

java/com.sap.sailing.server.gateway.serialization/src/com/sap/sailing/server/gateway/serialization/impl/WaypointJsonSerializer.java

@@ -12,7 +12,7 @@ public class WaypointJsonSerializer implements JsonSerializer<Waypoint> {
 	public static final String FIELD_PASSING_SIDE = "passingSide";
 	public static final String FIELD_CONTROL_POINT = "controlPoint";
 	
-	private JsonSerializer<ControlPoint> controlPointSerializer;
+	private final JsonSerializer<ControlPoint> controlPointSerializer;
 	
 	public WaypointJsonSerializer(JsonSerializer<ControlPoint> controlPointSerializer) {
 		this.controlPointSerializer = controlPointSerializer;