Permalink
Browse files

ID#340: added conversion rule documentation.

  • Loading branch information...
Christian Achatz
Christian Achatz committed Dec 2, 2018
1 parent 8eea86c commit 613d8babbe6b7c2ebd3e524a382464218b9b8310
@@ -1689,6 +1689,46 @@ <h4 id="Chapter-10-1-Konzept"><a href="#Chapter-10-1-Konzept">10.1. Konzept</a><
den Wert desjenigen Formular-Feldes zu, dass den selben Namen trägt. Besitzt ein Model die Eigenschaft <em>$street</em>,
so wertet das Formular das korrespondierende Feld <em>street</em> aus um den entsprechenden Wert zu ermitteln.
</p>
<div class="warn">
Um das Mapping von Formular-Feldern zu Model-Eigenschaften zu erleichtern, werden die Namen der Formular-Felder
ausgehend von den Model-Eigenschaften generiert. Die nach LCC-Schreibweise benannten Model-Eigenschaften werden in
durch Bindestrich getrennte Feld-Namen konvertiert. Die folgende Tabelle gibt eine Übersicht über die
Konvertierungs-Regeln:
<table>
<thead>
<tr>
<td>Model-Eigenschaft</td>
<td>(Generierter) Formular-Feld-Name</td>
</tr>
</thead>
<tbody>
<tr>
<td>foo</td>
<td>foo</td>
</tr>
<tr>
<td>Foo</td>
<td>Foo</td>
</tr>
<tr>
<td>fooBar</td>
<td>foo-bar</td>
</tr>
<tr>
<td>fooBarBaz</td>
<td>foo-bar-baz</td>
</tr>
<tr>
<td>foo_bar</td>
<td>foo_bar</td>
</tr>
<tr>
<td>fooBAr</td>
<td>foo-bAr</td>
</tr>
</tbody>
</table>
</div>
<p>
Die Mapping-Implementierung ist dabei nicht auf das Vorhandensein einer öffentlichen Setter-Methode angewiesen,
sondern injiziert die Werte über die <em>Reflection</em>-API von PHP. Ein DTO
@@ -2227,6 +2267,46 @@ <h4 id="Chapter-11-1-Konzept"><a href="#Chapter-11-1-Konzept">11.1. Konzept</a><
des DTOs bzw. Models zu, die den selben Namen tragen. Besitzt ein Model die Eigenschaft <em>$street</em>,
so weist das Formular dem korrespondierenden Feld <em>street</em> den Wert zu.
</p>
<div class="warn">
Um das Mapping von Formular-Feldern zu Model-Eigenschaften zu erleichtern, werden die Namen der Formular-Felder
ausgehend von den Model-Eigenschaften generiert. Die nach LCC-Schreibweise benannten Model-Eigenschaften werden in
durch Bindestrich getrennte Feld-Namen konvertiert. Die folgende Tabelle gibt eine Übersicht über die
Konvertierungs-Regeln:
<table>
<thead>
<tr>
<td>Model-Eigenschaft</td>
<td>(Generierter) Formular-Feld-Name</td>
</tr>
</thead>
<tbody>
<tr>
<td>foo</td>
<td>foo</td>
</tr>
<tr>
<td>Foo</td>
<td>Foo</td>
</tr>
<tr>
<td>fooBar</td>
<td>foo-bar</td>
</tr>
<tr>
<td>fooBarBaz</td>
<td>foo-bar-baz</td>
</tr>
<tr>
<td>foo_bar</td>
<td>foo_bar</td>
</tr>
<tr>
<td>fooBAr</td>
<td>foo-bAr</td>
</tr>
</tbody>
</table>
</div>
<p>
Die Mapping-Implementierung ist dabei nicht auf das Vorhandensein einer öffentlichen Getter-Methode angewiesen,
sondern liest die Werte über die <em>Reflection</em>-API von PHP. Ein DTO
@@ -1636,6 +1636,45 @@ <h4 id="Chapter-10-1-Concept"><a href="#Chapter-10-1-Concept">10.1. Concept</a><
matching the name of the properties. In case a Model defines a property called <em>$street</em> the form evaluates
corresponding field <em>street</em> to fill the Model property.
</p>
<div class="warn">
In order to ease mapping of form field names to model properties, the name of the form fields are generated based on
the model properties. Model properties named according to the LCC notation are converted into form field names
separated by hyphen. The following table provides an overview of the conversion rules applied:
<table>
<thead>
<tr>
<td>Model property</td>
<td>(Generated) Form field name</td>
</tr>
</thead>
<tbody>
<tr>
<td>foo</td>
<td>foo</td>
</tr>
<tr>
<td>Foo</td>
<td>Foo</td>
</tr>
<tr>
<td>fooBar</td>
<td>foo-bar</td>
</tr>
<tr>
<td>fooBarBaz</td>
<td>foo-bar-baz</td>
</tr>
<tr>
<td>foo_bar</td>
<td>foo_bar</td>
</tr>
<tr>
<td>fooBAr</td>
<td>foo-bAr</td>
</tr>
</tbody>
</table>
</div>
<p>
The mapping implementation is not restricted to properties with a public setter method but injects values based on
PHP's <em>Reflection</em> API. Given DTO
@@ -2165,6 +2204,45 @@ <h4 id="Chapter-11-1-Concept"><a href="#Chapter-11-1-Concept">11.1. Concept</a><
name. In case a Model defines a property called <em>$street</em> the form evaluates corresponding field <em>street</em>
be filled with the Model property.
</p>
<div class="warn">
In order to ease mapping of form field names to model properties, the name of the form fields are generated based on
the model properties. Model properties named according to the LCC notation are converted into form field names
separated by hyphen. The following table provides an overview of the conversion rules applied:
<table>
<thead>
<tr>
<td>Model property</td>
<td>(Generated) Form field name</td>
</tr>
</thead>
<tbody>
<tr>
<td>foo</td>
<td>foo</td>
</tr>
<tr>
<td>Foo</td>
<td>Foo</td>
</tr>
<tr>
<td>fooBar</td>
<td>foo-bar</td>
</tr>
<tr>
<td>fooBarBaz</td>
<td>foo-bar-baz</td>
</tr>
<tr>
<td>foo_bar</td>
<td>foo_bar</td>
</tr>
<tr>
<td>fooBAr</td>
<td>foo-bAr</td>
</tr>
</tbody>
</table>
</div>
<p>
The mapping implementation is not restricted to properties with a public setter method but injects values based on
PHP's <em>Reflection</em> API. Given DTO

0 comments on commit 613d8ba

Please sign in to comment.