feature #20273 [Serializer] Deprecate AdvancedNameConverterInterface (mdoutreluingne)

OskarStark · OskarStark · commit a30a66998ea4 · 2024-10-07T17:11:38.000+02:00
This PR was squashed before being merged into the 7.2 branch. Discussion ---------- [Serializer] Deprecate ``AdvancedNameConverterInterface`` Fix #20266 Here, I don't know if I should modify or delete the `.. note::` block, what do you think? Commits ------- 2c93089 [Serializer] Deprecate ``AdvancedNameConverterInterface``
diff --git a/components/serializer.rst b/components/serializer.rst
@@ -549,12 +549,12 @@ A custom name converter can handle such cases::
 
     class OrgPrefixNameConverter implements NameConverterInterface
     {
-        public function normalize(string $propertyName): string
+        public function normalize(string $propertyName, ?string $class = null, ?string $format = null, array $context = []): string
         {
             return 'org_'.$propertyName;
         }
 
-        public function denormalize(string $propertyName): string
+        public function denormalize(string $propertyName, ?string $class = null, ?string $format = null, array $context = []): string
         {
             // removes 'org_' prefix
             return str_starts_with($propertyName, 'org_') ? substr($propertyName, 4) : $propertyName;
@@ -584,12 +584,6 @@ and :class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer`::
     $companyCopy = $serializer->deserialize($json, Company::class, 'json');
     // Same data as $company
 
-.. note::
-
-    You can also implement
-    :class:`Symfony\\Component\\Serializer\\NameConverter\\AdvancedNameConverterInterface`
-    to access the current class name, format and context.
-
 .. _using-camelized-method-names-for-underscored-attributes:
 
 CamelCase to snake_case

Original file line number	Diff line number	Diff line change
`@@ -549,12 +549,12 @@ A custom name converter can handle such cases::`
`549`	`549`
`550`	`550`	`class OrgPrefixNameConverter implements NameConverterInterface`
`551`	`551`	`{`
`552`		`- public function normalize(string $propertyName): string`
	`552`	`+ public function normalize(string $propertyName, ?string $class = null, ?string $format = null, array $context = []): string`
`553`	`553`	`{`
`554`	`554`	`return 'org_'.$propertyName;`
`555`	`555`	`}`
`556`	`556`
`557`		`- public function denormalize(string $propertyName): string`
	`557`	`+ public function denormalize(string $propertyName, ?string $class = null, ?string $format = null, array $context = []): string`
`558`	`558`	`{`
`559`	`559`	`// removes 'org_' prefix`
`560`	`560`	`return str_starts_with($propertyName, 'org_') ? substr($propertyName, 4) : $propertyName;`
@@ -584,12 +584,6 @@ and :class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer`::
`584`	`584`	`$companyCopy = $serializer->deserialize($json, Company::class, 'json');`
`585`	`585`	`// Same data as $company`
`586`	`586`
`587`		`-.. note::`
`588`		`-`
`589`		`- You can also implement`
`590`		- :class:`Symfony\\Component\\Serializer\\NameConverter\\AdvancedNameConverterInterface`
`591`		`- to access the current class name, format and context.`
`592`		`-`
`593`	`587`	`.. _using-camelized-method-names-for-underscored-attributes:`
`594`	`588`
`595`	`589`	`CamelCase to snake_case`