101 lines
3.6 KiB
YAML
101 lines
3.6 KiB
YAML
uuid:
|
|
- value: 62684ebe-62d0-4999-b4c3-c768e371caac
|
|
langcode:
|
|
- value: en
|
|
type:
|
|
- target_id: daily_email
|
|
target_type: node_type
|
|
target_uuid: 8bde1f2f-eef9-4f2d-ae9c-96921f8193d7
|
|
revision_timestamp:
|
|
- value: '2025-05-11T09:00:44+00:00'
|
|
revision_uid:
|
|
- target_type: user
|
|
target_uuid: b8966985-d4b2-42a7-a319-2e94ccfbb849
|
|
revision_log: { }
|
|
status:
|
|
- value: true
|
|
uid:
|
|
- target_type: user
|
|
target_uuid: b8966985-d4b2-42a7-a319-2e94ccfbb849
|
|
title:
|
|
- value: |
|
|
Data transfer objects and value objects
|
|
created:
|
|
- value: '2023-04-14T00:00:00+00:00'
|
|
changed:
|
|
- value: '2025-05-11T09:00:44+00:00'
|
|
promote:
|
|
- value: false
|
|
sticky:
|
|
- value: false
|
|
default_langcode:
|
|
- value: true
|
|
revision_translation_affected:
|
|
- value: true
|
|
path:
|
|
- alias: /daily/2023/04/14/data-transfer-objects-and-value-objects
|
|
langcode: en
|
|
body:
|
|
- value: |
|
|
<p>In the last few emails, we've seen a data transfer object called <code>AccountDetails</code> that stores the account number and sort code for a bank account.</p>
|
|
|
|
<p>A data transfer object only stores data but we could also use a value object that can do more tasks, like validating the values.</p>
|
|
|
|
<p>For example, we could validate that the account number is the correct length and the sort code is the correct format:</p>
|
|
|
|
<pre><code class="language-php">class AccountDetails {
|
|
|
|
public function __construct(
|
|
public readonly string $accountNumber,
|
|
public readonly string $sortCode,
|
|
) {
|
|
// Validate the account number.
|
|
if (!preg_match('/^\d{8}$/', $accountNumber)) {
|
|
throw new \InvalidArgumentException('Account number must be an 8-digit number');
|
|
}
|
|
|
|
// Validate the sort code.
|
|
if (!preg_match('/^\d{2}-\d{2}-\d{2}$/', $sortCode)) {
|
|
throw new \InvalidArgumentException('Sort code must be in the format 00-00-00');
|
|
}
|
|
}
|
|
|
|
}
|
|
</code></pre>
|
|
|
|
<p>Helper methods can also be added to a value object as long as they don't modify the state of the object, such as getting the raw sort code without the separating dashes or performing further checks on the input values.</p>
|
|
|
|
|
|
format: full_html
|
|
processed: |
|
|
<p>In the last few emails, we've seen a data transfer object called <code>AccountDetails</code> that stores the account number and sort code for a bank account.</p>
|
|
|
|
<p>A data transfer object only stores data but we could also use a value object that can do more tasks, like validating the values.</p>
|
|
|
|
<p>For example, we could validate that the account number is the correct length and the sort code is the correct format:</p>
|
|
|
|
<pre><code class="language-php">class AccountDetails {
|
|
|
|
public function __construct(
|
|
public readonly string $accountNumber,
|
|
public readonly string $sortCode,
|
|
) {
|
|
// Validate the account number.
|
|
if (!preg_match('/^\d{8}$/', $accountNumber)) {
|
|
throw new \InvalidArgumentException('Account number must be an 8-digit number');
|
|
}
|
|
|
|
// Validate the sort code.
|
|
if (!preg_match('/^\d{2}-\d{2}-\d{2}$/', $sortCode)) {
|
|
throw new \InvalidArgumentException('Sort code must be in the format 00-00-00');
|
|
}
|
|
}
|
|
|
|
}
|
|
</code></pre>
|
|
|
|
<p>Helper methods can also be added to a value object as long as they don't modify the state of the object, such as getting the raw sort code without the separating dashes or performing further checks on the input values.</p>
|
|
|
|
|
|
summary: null
|
|
field_daily_email_cta: { }
|