package org.opentrafficsim.xml.bindings;
   
   import javax.vecmath.Point3d;
   import javax.xml.bind.annotation.adapters.XmlAdapter;
   
   import org.djutils.exceptions.Throw;
   
   /**
    * CoordinateAdapter converts between the XML String for a coordinate and a Point3d. 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 a 2D-coordinate in case the z-value is zero. <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 CoordinateAdapter extends XmlAdapter<String, Point3d>
  {
      /** {@inheritDoc} */
      @Override
      public Point3d unmarshal(final String field) throws IllegalArgumentException
      {
          try
          {
              String clean = field.replaceAll("\\s", "");
              Throw.when(!clean.startsWith("("), IllegalArgumentException.class, "Coordinate must start with '(': " + field);
              Throw.when(!clean.endsWith(")"), IllegalArgumentException.class, "Coordinate must end with ')': " + field);
              clean = clean.substring(1, clean.length() - 2);
              String[] digits = clean.split(",");
              Throw.when(digits.length < 2, IllegalArgumentException.class, "Coordinate must have at least x and y: " + field);
              Throw.when(digits.length > 3, IllegalArgumentException.class,
                      "Coordinate must have at most 3 dimensions: " + field);
  
              double x = Double.parseDouble(digits[0]);
              double y = Double.parseDouble(digits[1]);
              double z = digits.length == 2 ? 0.0 : Double.parseDouble(digits[2]);
              return new Point3d(x, y, z);
          }
          catch (Exception exception)
          {
              throw new IllegalArgumentException("Error parsing coordinate" + field, exception);
          }
      }
  
      /** {@inheritDoc} */
      @Override
      public String marshal(final Point3d point) throws IllegalArgumentException
      {
          if (point.z == 0.0)
              return "(" + point.x + ", " + point.y + ")";
          return "(" + point.x + ", " + point.y + ", " + point.z + ")";
      }
  
  }