aboutsummaryrefslogtreecommitdiffstats
path: root/lib/public/Migration/Attributes/ColumnMigrationAttribute.php
blob: 30b6fe008e6a32d89fbc1fe73a3df4ecf76d528d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
<?php

declare(strict_types=1);

/**
 * SPDX-FileCopyrightText: 2024 Nextcloud GmbH and Nextcloud contributors
 * SPDX-License-Identifier: AGPL-3.0-or-later
 */
namespace OCP\Migration\Attributes;

use JsonSerializable;

/**
 * generic class related to migration attribute about column changes
 *
 * @since 30.0.0
 */
class ColumnMigrationAttribute extends MigrationAttribute implements JsonSerializable {
	/**
	 * @param string $table name of the database table
	 * @param string $name name of the column
	 * @param ColumnType|null $type type of the column
	 * @param string $description description of the migration
	 * @param array $notes notes about the migration/column
	 * @since 30.0.0
	 */
	public function __construct(
		string $table,
		private string $name = '',
		private ?ColumnType $type = null,
		string $description = '',
		array $notes = [],
	) {
		parent::__construct($table, $description, $notes);
	}

	/**
	 * @param string $name
	 *
	 * @return $this
	 * @since 30.0.0
	 */
	public function setName(string $name): self {
		$this->name = $name;
		return $this;
	}

	/**
	 * @return string
	 * @since 30.0.0
	 */
	public function getName(): string {
		return $this->name;
	}

	/**
	 * @param ColumnType|null $type
	 *
	 * @return $this
	 * @since 30.0.0
	 */
	public function setType(?ColumnType $type): self {
		$this->type = $type;
		return $this;
	}

	/**
	 * @return ColumnType|null
	 * @since 30.0.0
	 */
	public function getType(): ?ColumnType {
		return $this->type;
	}

	/**
	 * @param array $data
	 *
	 * @return $this
	 * @since 30.0.0
	 */
	public function import(array $data): self {
		parent::import($data);
		$this->setName($data['name'] ?? '');
		$this->setType(ColumnType::tryFrom($data['type'] ?? ''));
		return $this;
	}

	/**
	 * @return array
	 * @since 30.0.0
	 */
	public function jsonSerialize(): array {
		return array_merge(
			parent::jsonSerialize(),
			[
				'name' => $this->getName(),
				'type' => $this->getType() ?? '',
			]
		);
	}
}