package org.opentrafficsim.xml.bindings;
   
   import javax.vecmath.Point3d;
   import javax.xml.bind.annotation.adapters.XmlAdapter;
   
   import org.djutils.exceptions.Throw;
   import org.djutils.logger.CategoryLogger;
   import org.opentrafficsim.xml.bindings.types.Point3dList;
   
  /**
   * CoordinateListAdapter converts between the XML String for a list of coordinates and a List of Point3d coordinates. Because
   * the ots-xsd project is not dependent on ots-core, Point3d is chosen instead of OTSPoint3D to store the (x, y, z) information.
   * The marshal function returns 2D-coordinates for points where the z-value is zero. Spaces are not allowed in the textual
   * representation of the list.<br>
   * <br>
   * Copyright (c) 2003-2018 Delft University of Technology, Jaffalaan 5, 2628 BX Delft, the Netherlands. All rights reserved. See
   * for project information <a href="https://www.simulation.tudelft.nl/" target="_blank">www.simulation.tudelft.nl</a>. The
   * source code and binary code of this software is proprietary information of Delft University of Technology.
   * @author <a href="https://www.tudelft.nl/averbraeck" target="_blank">Alexander Verbraeck</a>
   */
  public class CoordinateListAdapter extends XmlAdapter<String, Point3dList>
  {
      /** {@inheritDoc} */
      @Override
      public Point3dList unmarshal(final String field) throws IllegalArgumentException
      {
          try
          {
              Throw.when(!field.startsWith("("), IllegalArgumentException.class, "Coordinate list must start with '(': " + field);
              Throw.when(!field.endsWith(")"), IllegalArgumentException.class, "Coordinate list must end with ')': " + field);
              String clean = field.substring(1, field.length() - 2);
              Point3dListPoint3dList.html#Point3dList">Point3dList coordinates = new Point3dList();
              String[] coordinateFields = clean.split("\\(,\\)");
              for (String coordinateField : coordinateFields)
              {
                  String[] digits = coordinateField.split(",");
                  Throw.when(digits.length < 2, IllegalArgumentException.class,
                          "Coordinate must have at least x and y: " + coordinateField);
                  Throw.when(digits.length > 3, IllegalArgumentException.class,
                          "Coordinate must have at most 3 dimensions: " + coordinateField);
                  double x = Double.parseDouble(digits[0]);
                  double y = Double.parseDouble(digits[1]);
                  double z = digits.length == 2 ? 0.0 : Double.parseDouble(digits[2]);
                  coordinates.add(new Point3d(x, y, z));
              }
              return coordinates;
          }
          catch (Exception exception)
          {
              CategoryLogger.always().error(exception, "Problem parsing coordinate list: '" + field + "'");
              throw new IllegalArgumentException("Error parsing coordinate list: " + field, exception);
          }
      }
  
      /** {@inheritDoc} */
      @Override
      public String marshal(final Point3dList points) throws IllegalArgumentException
      {
          String list = "";
          for (Point3d point : points)
          {
              if (list.length() > 0)
                  list += ",";
              if (point.z == 0.0)
                  list += "(" + point.x + "," + point.y + ")";
              else
                  list += "(" + point.x + "," + point.y + "," + point.z + ")";
          }
          return list;
      }
  
  }