Déclare les links comme des IRIs.

src/Bridge/Symfony/Serializer/ObjectMetadataNormalizer.php

@@ -22,6 +22,7 @@ namespace Irstea\ApiMetadata\Bridge\Symfony\Serializer;
 
 use Assert\Assertion;
 use Irstea\ApiMetadata\Model\ObjectMetadata;
+use Irstea\ApiMetadata\Model\PropertyMetadata;
 use Irstea\ApiMetadata\Model\ResourceMetadata;
 use Irstea\ApiMetadata\URI\URIGeneratorInterface;
 use Irstea\ApiMetadata\URI\Util;
@@ -192,6 +193,21 @@ class ObjectMetadataNormalizer implements NormalizerAwareInterface, NormalizerIn
         $normalizedAttrs = $this->normalizer->normalize($attrs, $format, $context);
         Assertion::isArray($normalizedAttrs);
 
-        return ['type' => $object->getBaseType()] + $normalizedAttrs;
+        $required = [];
+        $properties = [];
+
+        /** @var PropertyMetadata $property */
+        foreach ($object->getProperties() as $property) {
+            $properties[$property->getName()] = $this->normalizer->normalize($property->getType(), $format, $context);
+            if ($property->isRequired()) {
+                $required[] = $property->getName();
+            }
+        }
+
+        return [
+                'type'       => $object->getBaseType(),
+                'required'   => $required,
+                'properties' => $properties ?: (object) [],
+            ] + $normalizedAttrs;
     }
 }

src/Bridge/Symfony/Serializer/UnionTypeNormalizer.php

@@ -56,5 +56,4 @@ class UnionTypeNormalizer implements NormalizerAwareInterface, NormalizerInterfa
 
         return ['oneOf' => $alternatives];
     }
-
 }

src/Factory/Property/ResourcePropertyFactory.php

@@ -26,7 +26,10 @@ use ApiPlatform\Core\Metadata\Property\Factory\PropertyMetadataFactoryInterface;
 use ApiPlatform\Core\Metadata\Property\Factory\PropertyNameCollectionFactoryInterface;
 use Irstea\ApiMetadata\Factory\ContextInterface;
 use Irstea\ApiMetadata\Helper\PropertyInfoType;
+use Irstea\ApiMetadata\Model\FormattedStringMetadata;
 use Irstea\ApiMetadata\Model\PropertyMetadata;
+use Irstea\ApiMetadata\Model\ResourceMetadata;
+use Irstea\ApiMetadata\Model\TypeMetadata;
 
 /**
  * Class ResourcePropertyFactory.
@@ -73,6 +76,16 @@ class ResourcePropertyFactory implements PropertyFactoryInterface
         $type = PropertyInfoType::notNull($property->getType());
         $typeMeta = $context->createType($type, $context);
 
+        if (!$property->isReadableLink() && !$property->isWritableLink()) {
+            $typeMeta = $typeMeta->fmap(function (TypeMetadata $t) {
+                if ($t instanceof ResourceMetadata) {
+                    return FormattedStringMetadata::create('iri-reference');
+                }
+
+                return $t;
+            });
+        }
+
         return new PropertyMetadata(
             $name,
             $typeMeta,

src/Factory/Type/NullableTypeFactory.php

 <?php declare(strict_types=1);
-/**
+/*
+ * This file is part of "irstea/api-metadata".
+ *
  * Copyright (C) 2019 IRSTEA
- * All rights reserved.
  *
- * @copyright 2019 IRSTEA
- * @author guillaume.perreal
+ * This program is free software: you can redistribute it and/or modify it under
+ * the terms of the GNU Lesser General Public License as published by the Free
+ * Software Foundation, either version 3 of the License, or (at your option) any
+ * later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT ANY
+ * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+ * PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License and the GNU
+ * Lesser General Public License along with this program. If not, see
+ * <https://www.gnu.org/licenses/>.
  */
 
-
 namespace Irstea\ApiMetadata\Factory\Type;
 
-
 use Irstea\ApiMetadata\Factory\ContextInterface;
 use Irstea\ApiMetadata\Model\BaseTypeMetadata;
 use Irstea\ApiMetadata\Model\TypeMetadata;
@@ -18,12 +27,12 @@ use Irstea\ApiMetadata\Model\UnionTypeMetadata;
 use Symfony\Component\PropertyInfo\Type;
 
 /**
- * Class NullableTypeFactory
+ * Class NullableTypeFactory.
  */
 class NullableTypeFactory extends TypeFactoryDecorator
 {
     /**
-     * @inheritDoc
+     * {@inheritdoc}
      */
     public function createType(Type $type, ContextInterface $context): TypeMetadata
     {

src/Helper/TypeFunctorHelper.php

+<?php declare(strict_types=1);
+/*
+ * This file is part of "irstea/api-metadata".
+ *
+ * Copyright (C) 2019 IRSTEA
+ *
+ * This program is free software: you can redistribute it and/or modify it under
+ * the terms of the GNU Lesser General Public License as published by the Free
+ * Software Foundation, either version 3 of the License, or (at your option) any
+ * later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT ANY
+ * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+ * PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License and the GNU
+ * Lesser General Public License along with this program. If not, see
+ * <https://www.gnu.org/licenses/>.
+ */
+
+namespace Irstea\ApiMetadata\Helper;
+
+use Irstea\ApiMetadata\Model\TypeFunctor;
+
+/**
+ * Class TypeFunctorHelper.
+ */
+class TypeFunctorHelper
+{
+    /**
+     * @param TypeFunctor[] $items
+     * @param callable      $f
+     *
+     * @return TypeFunctor[]
+     */
+    public static function map(array $items, callable $f): array
+    {
+        return array_map(
+            function (TypeFunctor $item) use ($f) {
+                return self::null($item, $f);
+            },
+            $items
+        );
+    }
+
+    /**
+     * @param TypeFunctor|null $item
+     * @param callable         $f
+     *
+     * @return TypeFunctor|null
+     */
+    public static function null(?TypeFunctor $item, callable $f): ?TypeFunctor
+    {
+        return $item ? $item->fmap($f) : null;
+    }
+}

src/Model/ArrayMetadata.php

@@ -63,4 +63,12 @@ final class ArrayMetadata implements SimpleTypeInterface
     {
         return ['items' => $this->item];
     }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function fmap(callable $f)
+    {
+        return $f(new self($this->item->fmap($f)));
+    }
 }

src/Model/BaseTypeMetadata.php

@@ -52,4 +52,12 @@ final class BaseTypeMetadata implements SimpleTypeInterface
     {
         return [];
     }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function fmap(callable $f)
+    {
+        return $f($this);
+    }
 }

src/Model/FormattedStringMetadata.php

@@ -50,4 +50,12 @@ class FormattedStringMetadata implements SimpleTypeInterface
     {
         return ['format' => $this->name];
     }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function fmap(callable $f)
+    {
+        return $f($this);
+    }
 }

src/Model/MapMetadata.php

@@ -63,4 +63,12 @@ final class MapMetadata implements SimpleTypeInterface
     {
         return ['additionalProperties' => $this->value];
     }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function fmap(callable $f)
+    {
+        return $f(new self($this->value->fmap($f)));
+    }
 }

src/Model/ObjectMetadata.php

@@ -21,6 +21,7 @@
 namespace Irstea\ApiMetadata\Model;
 
 use Assert\Assertion;
+use Irstea\ApiMetadata\Helper\TypeFunctorHelper;
 
 /**
  * Class ObjectMetadata.
@@ -76,7 +77,7 @@ class ObjectMetadata implements SimpleTypeInterface
     /**
      * Get properties.
      *
-     * @return array
+     * @return array<string, PropertyMetadata>
      */
     public function getProperties(): array
     {
@@ -96,20 +97,18 @@ class ObjectMetadata implements SimpleTypeInterface
      */
     public function getTypeAttributes(): array
     {
-        $required = [];
-        $properties = [];
-
-        foreach ($this->properties as $property) {
-            $properties[$property->getName()] = $property->getType();
-            if (!$property->isNullable()) {
-                $required[] = $property->getName();
-            }
-        }
+        return ['additionalProperties' => false];
+    }
 
-        return [
-            'properties'           => $properties ?: (object) [],
-            'required'             => $required,
-            'additionalProperties' => false,
-        ];
+    /**
+     * {@inheritdoc}
+     */
+    public function fmap(callable $f)
+    {
+        return $f(new self(
+            $this->class,
+            TypeFunctorHelper::null($this->parent, $f),
+            TypeFunctorHelper::map($this->properties, $f)
+        ));
     }
 }

src/Model/OperationMetadata.php

@@ -20,12 +20,13 @@
 
 namespace Irstea\ApiMetadata\Model;
 
+use Irstea\ApiMetadata\Helper\TypeFunctorHelper;
 use Irstea\ApiMetadata\Model\Identity\OperationIdentityInterface;
 
 /**
  * Class OperationMetadata.
  */
-final class OperationMetadata implements OperationIdentityInterface
+final class OperationMetadata implements OperationIdentityInterface, TypeFunctor
 {
     /** @var OperationIdentityInterface */
     private $id;
@@ -130,4 +131,18 @@ final class OperationMetadata implements OperationIdentityInterface
     {
         return $this->output;
     }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function fmap(callable $f)
+    {
+        return new self(
+            $this->id,
+            $this->path,
+            $this->method,
+            TypeFunctorHelper::null($this->input),
+            TypeFunctorHelper::null($this->output)
+        );
+    }
 }

src/Model/PropertyMetadata.php

@@ -23,7 +23,7 @@ namespace Irstea\ApiMetadata\Model;
 /**
  * Class PropertyMetadata.
  */
-final class PropertyMetadata
+final class PropertyMetadata implements TypeFunctor
 {
     /** @var string */
     private $name;
@@ -98,6 +98,14 @@ final class PropertyMetadata
         return $this->nullable;
     }
 
+    /**
+     * @return bool
+     */
+    public function isRequired(): bool
+    {
+        return !$this->nullable;
+    }
+
     /**
      * Get readable.
      *
@@ -137,4 +145,20 @@ final class PropertyMetadata
     {
         return $this->identifier;
     }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function fmap(callable $f)
+    {
+        return new self(
+            $this->name,
+            $this->type->fmap($f),
+            $this->nullable,
+            $this->readable,
+            $this->writable,
+            $this->initialisable,
+            $this->identifier
+        );
+    }
 }

src/Model/Reference.php

@@ -21,6 +21,7 @@
 namespace Irstea\ApiMetadata\Model;
 
 use Assert\Assertion;
+use Irstea\ApiMetadata\Helper\TypeFunctorHelper;
 
 /**
  * Class Reference.
@@ -83,4 +84,12 @@ class Reference implements SimpleTypeInterface
 
         return $this->target->getTypeAttributes();
     }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function fmap(callable $f)
+    {
+        return $f(new self(TypeFunctorHelper::null($this->target, $f)));
+    }
 }

src/Model/ResourceMetadata.php

@@ -21,6 +21,7 @@
 namespace Irstea\ApiMetadata\Model;
 
 use Assert\Assertion;
+use Irstea\ApiMetadata\Helper\TypeFunctorHelper;
 use Irstea\ApiMetadata\Model\Identity\OperationIdentityInterface;
 use Irstea\ApiMetadata\Model\Identity\ResourceIdentityInterface;
 
@@ -78,4 +79,17 @@ final class ResourceMetadata extends ObjectMetadata implements ResourceIdentityI
     {
         return ['shortName' => $this->getShortName()] + parent::getTypeAttributes();
     }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function fmap(callable $f)
+    {
+        return $f(new self(
+            $this->id,
+            TypeFunctorHelper::null($this->getParent(), $f),
+            TypeFunctorHelper::map($this->getProperties(), $f),
+            $this->operations
+        ));
+    }
 }

src/Model/TypeFunctor.php

+<?php declare(strict_types=1);
+/*
+ * This file is part of "irstea/api-metadata".
+ *
+ * Copyright (C) 2019 IRSTEA
+ *
+ * This program is free software: you can redistribute it and/or modify it under
+ * the terms of the GNU Lesser General Public License as published by the Free
+ * Software Foundation, either version 3 of the License, or (at your option) any
+ * later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT ANY
+ * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+ * PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License and the GNU
+ * Lesser General Public License along with this program. If not, see
+ * <https://www.gnu.org/licenses/>.
+ */
+
+namespace Irstea\ApiMetadata\Model;
+
+/**
+ * Class TypeFunctor.
+ */
+interface TypeFunctor
+{
+    /**
+     * @param callable $f
+     *
+     * @return $this
+     */
+    public function fmap(callable $f);
+}

src/Model/TypeMetadata.php

@@ -23,6 +23,6 @@ namespace Irstea\ApiMetadata\Model;
 /**
  * Interface TypeMetadata.
  */
-interface TypeMetadata
+interface TypeMetadata extends TypeFunctor
 {
 }

src/Model/UnionTypeMetadata.php

@@ -21,6 +21,7 @@
 namespace Irstea\ApiMetadata\Model;
 
 use Assert\Assertion;
+use Irstea\ApiMetadata\Helper\TypeFunctorHelper;
 
 /**
  * Class UnionTypeMetadata.
@@ -53,4 +54,12 @@ class UnionTypeMetadata implements TypeMetadata
     {
         return $this->alternatives;
     }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function fmap(callable $f)
+    {
+        return $f(new self(TypeFunctorHelper::map($this->alternatives, $f)));
+    }
 }