1
|
|
|
<?php |
2
|
|
|
|
3
|
|
|
declare(strict_types=1); |
4
|
|
|
|
5
|
|
|
namespace PHPTdGram\SchemaGenerator; |
6
|
|
|
|
7
|
|
|
use InvalidArgumentException; |
8
|
|
|
use JsonSerializable; |
9
|
|
|
use Nette\PhpGenerator\Literal; |
10
|
|
|
use Nette\PhpGenerator\PhpFile; |
11
|
|
|
use Nette\PhpGenerator\PsrPrinter; |
12
|
|
|
use PHPTdGram\SchemaGenerator\Model\ClassDefinition; |
13
|
|
|
|
14
|
|
|
/** |
15
|
|
|
* @author Aurimas Niekis <[email protected]> |
16
|
|
|
*/ |
17
|
|
|
class CodeGenerator |
18
|
|
|
{ |
19
|
|
|
public const OBJECT_CLASS = 'TdObject'; |
20
|
|
|
public const FUNCTION_CLASS = 'TdFunction'; |
21
|
|
|
public const SCHEMA_REGISTRY_CLASS = 'TdSchemaRegistry'; |
22
|
|
|
public const TYPE_SERIALIZER_INTERFACE = 'TdTypeSerializableInterface'; |
23
|
|
|
|
24
|
|
|
private string $baseNamespace; |
25
|
|
|
private string $baseFolder; |
26
|
|
|
|
27
|
|
|
public function __construct(string $baseNamespace, string $baseFolder) |
28
|
|
|
{ |
29
|
|
|
$this->baseNamespace = $baseNamespace; |
30
|
|
|
$this->baseFolder = $baseFolder; |
31
|
|
|
} |
32
|
|
|
|
33
|
|
|
/** |
34
|
|
|
* @param ClassDefinition[] $classes |
35
|
|
|
*/ |
36
|
|
|
public function generate(array $classes): void |
37
|
|
|
{ |
38
|
|
|
$files = [ |
39
|
|
|
'TdTypeSerializableInterface.php' => $this->generateTypeSerializeInterface(), |
40
|
|
|
'TdObject.php' => $this->generateTdObject(), |
41
|
|
|
'TdFunction.php' => $this->generateTdFunction(), |
42
|
|
|
'TdSchemaRegistry.php' => $this->generateTdSchemaRegistry($classes), |
43
|
|
|
]; |
44
|
|
|
|
45
|
|
|
foreach ($classes as $classDefinition) { |
46
|
|
|
$fileName = $classDefinition->className . '.php'; |
47
|
|
|
|
48
|
|
|
$files[$fileName] = $this->generateClass($classDefinition); |
49
|
|
|
} |
50
|
|
|
|
51
|
|
|
$printer = new PsrPrinter(); |
52
|
|
|
$printer->setTypeResolving(false); |
53
|
|
|
foreach ($files as $fileName => $file) { |
54
|
|
|
$filePath = $this->baseFolder . '/' . $fileName; |
55
|
|
|
|
56
|
|
|
file_put_contents($filePath, $printer->printFile($file)); |
57
|
|
|
} |
58
|
|
|
} |
59
|
|
|
|
60
|
|
|
public function generateTypeSerializeInterface(): PhpFile |
61
|
|
|
{ |
62
|
|
|
$phpFile = new PhpFile(); |
63
|
|
|
$phpFile->addComment('This phpFile is auto-generated.'); |
64
|
|
|
$phpFile->setStrictTypes(); // adds declare(strict_types=1) |
65
|
|
|
|
66
|
|
|
$phpNamespace = $phpFile->addNamespace($this->baseNamespace); |
67
|
|
|
|
68
|
|
|
$typeSerializerInterface = $phpNamespace->addInterface( |
69
|
|
|
static::TYPE_SERIALIZER_INTERFACE |
70
|
|
|
); |
71
|
|
|
|
72
|
|
|
$typeSerializerInterface->addMethod('typeSerialize') |
73
|
|
|
->setPublic() |
74
|
|
|
->setReturnType('array'); |
75
|
|
|
|
76
|
|
|
return $phpFile; |
77
|
|
|
} |
78
|
|
|
|
79
|
|
|
public function generateTdObject(): PhpFile |
80
|
|
|
{ |
81
|
|
|
$phpFile = new PhpFile(); |
82
|
|
|
$phpFile->addComment('This phpFile is auto-generated.'); |
83
|
|
|
$phpFile->setStrictTypes(); // adds declare(strict_types=1) |
84
|
|
|
|
85
|
|
|
$phpNamespace = $phpFile->addNamespace($this->baseNamespace); |
86
|
|
|
$phpNamespace->addUse(JsonSerializable::class); |
87
|
|
|
|
88
|
|
|
$objectClass = $phpNamespace->addClass(static::OBJECT_CLASS); |
89
|
|
|
$objectClass->addImplement(static::TYPE_SERIALIZER_INTERFACE) |
90
|
|
|
->addImplement(JsonSerializable::class) |
91
|
|
|
->setAbstract(); |
92
|
|
|
|
93
|
|
|
$objectClass->addConstant('TYPE_NAME', '_tdObject') |
94
|
|
|
->setPublic(); |
95
|
|
|
|
96
|
|
|
$objectClass->addProperty('tdExtra', new Literal('null')) |
97
|
|
|
->setType('string') |
98
|
|
|
->setNullable(true); |
99
|
|
|
|
100
|
|
|
$extraGetMethod = $objectClass->addMethod('getTdExtra') |
101
|
|
|
->setPublic() |
102
|
|
|
->setReturnType('string') |
103
|
|
|
->setReturnNullable(); |
104
|
|
|
|
105
|
|
|
$objectClass->addMethod('getTdTypeName') |
106
|
|
|
->setPublic() |
107
|
|
|
->setReturnType('string') |
108
|
|
|
->setBody('return static::TYPE_NAME;'); |
109
|
|
|
|
110
|
|
|
$extraGetMethod->addBody('return $this->tdExtra;'); |
111
|
|
|
|
112
|
|
|
$extraSetMethod = $objectClass->addMethod('setTdExtra') |
113
|
|
|
->setPublic() |
114
|
|
|
->setReturnType('self'); |
115
|
|
|
|
116
|
|
|
$extraSetMethod->addParameter('tdExtra') |
117
|
|
|
->setType('string') |
118
|
|
|
->setNullable(); |
119
|
|
|
|
120
|
|
|
$extraSetMethod->addBody('$this->tdExtra = $tdExtra;'); |
121
|
|
|
$extraSetMethod->addBody(''); |
122
|
|
|
$extraSetMethod->addBody('return $this;'); |
123
|
|
|
|
124
|
|
|
$jsonSerializeMethod = $objectClass->addMethod('jsonSerialize') |
125
|
|
|
->setPublic() |
126
|
|
|
->setReturnType('array'); |
127
|
|
|
|
128
|
|
|
$jsonSerializeMethod->addBody('$output = [];'); |
129
|
|
|
$jsonSerializeMethod->addBody('if (null !== $this->tdExtra) {'); |
130
|
|
|
$jsonSerializeMethod->addBody(' $output[\'@extra\'] = $this->tdExtra;'); |
131
|
|
|
$jsonSerializeMethod->addBody('}'); |
132
|
|
|
$jsonSerializeMethod->addBody(''); |
133
|
|
|
$jsonSerializeMethod->addBody('return array_merge($output, $this->typeSerialize());'); |
134
|
|
|
|
135
|
|
|
return $phpFile; |
136
|
|
|
} |
137
|
|
|
|
138
|
|
|
public function generateTdFunction(): PhpFile |
139
|
|
|
{ |
140
|
|
|
$phpFile = new PhpFile(); |
141
|
|
|
$phpFile->addComment('This phpFile is auto-generated.'); |
142
|
|
|
$phpFile->setStrictTypes(); // adds declare(strict_types=1) |
143
|
|
|
|
144
|
|
|
$phpNamespace = $phpFile->addNamespace($this->baseNamespace); |
145
|
|
|
|
146
|
|
|
$functionClass = $phpNamespace->addClass(static::FUNCTION_CLASS); |
147
|
|
|
$functionClass->addExtend(static::OBJECT_CLASS) |
148
|
|
|
->setAbstract(); |
149
|
|
|
|
150
|
|
|
return $phpFile; |
151
|
|
|
} |
152
|
|
|
|
153
|
|
|
/** |
154
|
|
|
* @param ClassDefinition[] $classes |
155
|
|
|
*/ |
156
|
|
|
public function generateTdSchemaRegistry(array $classes): PhpFile |
157
|
|
|
{ |
158
|
|
|
$phpFile = new PhpFile(); |
159
|
|
|
$phpFile->addComment('This phpFile is auto-generated.'); |
160
|
|
|
$phpFile->setStrictTypes(); // adds declare(strict_types=1) |
161
|
|
|
|
162
|
|
|
$phpNamespace = $phpFile->addNamespace($this->baseNamespace); |
163
|
|
|
|
164
|
|
|
$phpNamespace->addUse(InvalidArgumentException::class); |
165
|
|
|
|
166
|
|
|
$class = $phpNamespace->addClass(static::SCHEMA_REGISTRY_CLASS); |
167
|
|
|
|
168
|
|
|
$types = []; |
169
|
|
|
|
170
|
|
|
foreach ($classes as $classDefinition) { |
171
|
|
|
$types[$classDefinition->typeName] = new Literal($classDefinition->className . '::class'); |
172
|
|
|
} |
173
|
|
|
|
174
|
|
|
$class->addConstant('VERSION', '1.6.0') |
175
|
|
|
->setPublic(); |
176
|
|
|
|
177
|
|
|
$class->addConstant('TYPES', $types) |
178
|
|
|
->setPublic(); |
179
|
|
|
|
180
|
|
|
$hasTypeMethod = $class->addMethod('hasType') |
181
|
|
|
->setPublic() |
182
|
|
|
->setStatic() |
183
|
|
|
->setReturnType('bool'); |
184
|
|
|
|
185
|
|
|
$hasTypeMethod->addParameter('type') |
186
|
|
|
->setType('string'); |
187
|
|
|
|
188
|
|
|
$hasTypeMethod->addBody('return isset(static::TYPES[$type]);'); |
189
|
|
|
|
190
|
|
|
$getTypeClassMethod = $class->addMethod('getTypeClass') |
191
|
|
|
->setPublic() |
192
|
|
|
->setStatic() |
193
|
|
|
->setReturnType('string'); |
194
|
|
|
|
195
|
|
|
$getTypeClassMethod->addParameter('type') |
196
|
|
|
->setType('string'); |
197
|
|
|
|
198
|
|
|
$getTypeClassMethod->addBody('if (!static::hasType($type)) {'); |
199
|
|
|
$getTypeClassMethod->addBody(' throw new InvalidArgumentException('); |
200
|
|
|
$getTypeClassMethod->addBody(' sprintf(\'Type "%s" not found in registry\', $type)'); |
201
|
|
|
$getTypeClassMethod->addBody(' );'); |
202
|
|
|
$getTypeClassMethod->addBody('}'); |
203
|
|
|
$getTypeClassMethod->addBody(''); |
204
|
|
|
$getTypeClassMethod->addBody('return static::TYPES[$type];'); |
205
|
|
|
|
206
|
|
|
$fromArrayMethod = $class->addMethod('fromArray') |
207
|
|
|
->setPublic() |
208
|
|
|
->setStatic() |
209
|
|
|
->setReturnType('TdObject'); |
210
|
|
|
|
211
|
|
|
$fromArrayMethod->addParameter('array') |
212
|
|
|
->setType('array'); |
213
|
|
|
|
214
|
|
|
$fromArrayMethod->addBody('if (!isset($array[\'@type\'])) {'); |
215
|
|
|
$fromArrayMethod->addBody(' throw new InvalidArgumentException(\'Can\\\'t find "@type" key in array\');'); |
216
|
|
|
$fromArrayMethod->addBody('}'); |
217
|
|
|
$fromArrayMethod->addBody(''); |
218
|
|
|
$fromArrayMethod->addBody('$type = $array[\'@type\'];'); |
219
|
|
|
$fromArrayMethod->addBody('$extra = $array[\'@extra\'] ?? null;'); |
220
|
|
|
$fromArrayMethod->addBody('$typeClass = static::getTypeClass($type);'); |
221
|
|
|
$fromArrayMethod->addBody(''); |
222
|
|
|
$fromArrayMethod->addBody('$obj = call_user_func($typeClass . \'::fromArray\', $array);'); |
223
|
|
|
$fromArrayMethod->addBody(''); |
224
|
|
|
$fromArrayMethod->addBody('return $obj->setTdExtra($extra);'); |
225
|
|
|
|
226
|
|
|
return $phpFile; |
227
|
|
|
} |
228
|
|
|
|
229
|
|
|
public function generateClass(ClassDefinition $classDef): PhpFile |
230
|
|
|
{ |
231
|
|
|
$phpFile = new PhpFile(); |
232
|
|
|
$phpFile->addComment('This phpFile is auto-generated.'); |
233
|
|
|
$phpFile->setStrictTypes(); // adds declare(strict_types=1) |
234
|
|
|
|
235
|
|
|
$phpNamespace = $phpFile->addNamespace($this->baseNamespace); |
236
|
|
|
|
237
|
|
|
$class = $phpNamespace->addClass($classDef->className); |
238
|
|
|
|
239
|
|
|
$parentClass = $classDef->parentClass; |
240
|
|
|
if ('Object' === $parentClass) { |
241
|
|
|
$parentClass = static::OBJECT_CLASS; |
242
|
|
|
} elseif ('Function' === $parentClass) { |
243
|
|
|
$parentClass = static::FUNCTION_CLASS; |
244
|
|
|
} |
245
|
|
|
|
246
|
|
|
$class->addExtend($parentClass) |
247
|
|
|
->addComment($classDef->classDocs); |
248
|
|
|
|
249
|
|
|
$class->addConstant('TYPE_NAME', $classDef->typeName) |
250
|
|
|
->setPublic(); |
251
|
|
|
|
252
|
|
|
$constructor = $class->addMethod('__construct') |
253
|
|
|
->setPublic(); |
254
|
|
|
|
255
|
|
|
if (!in_array($parentClass, [static::OBJECT_CLASS, static::FUNCTION_CLASS])) { |
256
|
|
|
$constructor->addBody('parent::__construct();') |
257
|
|
|
->addBody(''); |
258
|
|
|
} |
259
|
|
|
|
260
|
|
|
$fromArray = $class->addMethod('fromArray') |
261
|
|
|
->setPublic() |
262
|
|
|
->setStatic() |
263
|
|
|
->setReturnType($classDef->className); |
264
|
|
|
|
265
|
|
|
$serialize = $class->addMethod('typeSerialize') |
266
|
|
|
->setReturnType('array'); |
267
|
|
|
|
268
|
|
|
$fromArray->addParameter('array') |
269
|
|
|
->setType('array'); |
270
|
|
|
|
271
|
|
|
if (count($classDef->fields) > 0) { |
272
|
|
|
$fromArray->addBody('return new static('); |
273
|
|
|
|
274
|
|
|
$serialize->addBody('return ['); |
275
|
|
|
$serialize->addBody(' \'@type\' => static::TYPE_NAME,'); |
276
|
|
|
} else { |
277
|
|
|
$fromArray->addBody('return new static();'); |
278
|
|
|
$serialize->addBody('return [\'@type\' => static::TYPE_NAME];'); |
279
|
|
|
} |
280
|
|
|
|
281
|
|
|
foreach ($classDef->fields as $fieldDef) { |
282
|
|
|
$typeStyle = $fieldDef->type; |
283
|
|
|
$type = $fieldDef->type; |
284
|
|
|
|
285
|
|
|
$arrayNestLevels = substr_count($type, '[]'); |
286
|
|
|
if (1 === $arrayNestLevels) { |
287
|
|
|
$type = 'array'; |
288
|
|
|
$typeStyle = 'array'; |
289
|
|
|
} elseif (2 === $arrayNestLevels) { |
290
|
|
|
$type = 'array'; |
291
|
|
|
$typeStyle = 'array_array'; |
292
|
|
|
} elseif ($arrayNestLevels > 2) { |
293
|
|
|
throw new InvalidArgumentException('Vector of higher than 2 lvl deep'); |
294
|
|
|
} |
295
|
|
|
|
296
|
|
|
$class->addProperty($fieldDef->name) |
297
|
|
|
->setProtected() |
298
|
|
|
->setNullable($fieldDef->mayBeNull) |
299
|
|
|
->setType($type) |
300
|
|
|
->addComment($fieldDef->doc) |
301
|
|
|
->addComment('') |
302
|
|
|
->addComment('@var ' . $fieldDef->type . ($fieldDef->mayBeNull ? '|null' : '')); |
303
|
|
|
|
304
|
|
|
$constructor->addParameter($fieldDef->name) |
305
|
|
|
->setType($type) |
306
|
|
|
->setNullable($fieldDef->mayBeNull); |
307
|
|
|
|
308
|
|
|
$constructor->addBody('$this->' . $fieldDef->name . ' = $' . $fieldDef->name . ';'); |
309
|
|
|
|
310
|
|
|
[$rawType] = explode('[', $fieldDef->type); |
311
|
|
|
|
312
|
|
|
switch ($rawType) { |
313
|
|
|
case 'string': |
314
|
|
|
case 'int': |
315
|
|
|
case 'bool': |
316
|
|
|
case 'float': |
317
|
|
|
$fromArray->addBody(' $array[\'' . $fieldDef->rawName . '\'],'); |
318
|
|
|
$serialize->addBody(' \'' . $fieldDef->rawName . '\' => $this->' . $fieldDef->name . ','); |
319
|
|
|
break; |
320
|
|
|
|
321
|
|
|
default: |
322
|
|
|
if ($fieldDef->mayBeNull) { |
323
|
|
|
if ('array' === $typeStyle) { |
324
|
|
|
$fromArray->addBody( |
325
|
|
|
' (isset($array[\'' . $fieldDef->name . |
326
|
|
|
'\']) ? array_map(fn($x) => ' . 'TdSchemaRegistry::fromArray($x), $array[\'' . |
327
|
|
|
$fieldDef->name . '\']) : null),' |
328
|
|
|
); |
329
|
|
|
|
330
|
|
|
$serialize->addBody( |
331
|
|
|
' (isset($this->' . $fieldDef->name . |
332
|
|
|
') ? array_map(fn($x) => $x->typeSerialize(), $this->' . $fieldDef->name . ') : null),' |
333
|
|
|
); |
334
|
|
|
} elseif ('array_array' === $typeStyle) { |
335
|
|
|
$fromArray->addBody( |
336
|
|
|
' (isset($array[\'' . $fieldDef->name . |
337
|
|
|
'\']) ? array_map(fn($x) => ' . |
338
|
|
|
'array_map(fn($y) => TdSchemaRegistry::fromArray($y), $x), $array[\'' . |
339
|
|
|
$fieldDef->name . '\']) : null),' |
340
|
|
|
); |
341
|
|
|
|
342
|
|
|
$serialize->addBody( |
343
|
|
|
' (isset($this->' . $fieldDef->name . |
344
|
|
|
') ? array_map(fn($x) => array_map(fn($y) => $y->typeSerialize(), $x), $this->' . |
345
|
|
|
$fieldDef->name . ') : null),' |
346
|
|
|
); |
347
|
|
|
} else { |
348
|
|
|
$fromArray->addBody( |
349
|
|
|
' (isset($array[\'' . $fieldDef->rawName . '\']) ? ' . |
350
|
|
|
'TdSchemaRegistry::fromArray($array[\'' . $fieldDef->rawName . '\']) : null),' |
351
|
|
|
); |
352
|
|
|
|
353
|
|
|
$serialize->addBody( |
354
|
|
|
' \'' . $fieldDef->rawName . '\' => (isset($this->' . |
355
|
|
|
$fieldDef->name . ') ? $this->' . $fieldDef->name . ' : null),' |
356
|
|
|
); |
357
|
|
|
} |
358
|
|
|
} else { |
359
|
|
|
if ('array' === $typeStyle) { |
360
|
|
|
$fromArray->addBody( |
361
|
|
|
' array_map(fn($x) => TdSchemaRegistry::fromArray($x), $array[\'' . |
362
|
|
|
$fieldDef->name . '\']),' |
363
|
|
|
); |
364
|
|
|
|
365
|
|
|
$serialize->addBody( |
366
|
|
|
' array_map(fn($x) => $x->typeSerialize(), $this->' . $fieldDef->name . '),' |
367
|
|
|
); |
368
|
|
|
} elseif ('array_array' === $typeStyle) { |
369
|
|
|
$fromArray->addBody( |
370
|
|
|
' array_map(fn($x) => array_map(fn($y) => TdSchemaRegistry::fromArray($y), $x)' . |
371
|
|
|
', $array[\'' . $fieldDef->name . '\']),' |
372
|
|
|
); |
373
|
|
|
|
374
|
|
|
$serialize->addBody( |
375
|
|
|
' array_map(fn($x) => array_map(fn($y) => $y->typeSerialize(), $x), $this->' . |
376
|
|
|
$fieldDef->name . '),' |
377
|
|
|
); |
378
|
|
|
} else { |
379
|
|
|
$fromArray->addBody( |
380
|
|
|
' ' . 'TdSchemaRegistry::fromArray($array[\'' . $fieldDef->rawName . '\']),' |
381
|
|
|
); |
382
|
|
|
|
383
|
|
|
$serialize->addBody( |
384
|
|
|
' \'' . $fieldDef->rawName . '\' => $this->' . $fieldDef->name . '->typeSerialize(),' |
385
|
|
|
); |
386
|
|
|
} |
387
|
|
|
} |
388
|
|
|
} |
389
|
|
|
|
390
|
|
|
$getter = $class->addMethod('get' . ucfirst($fieldDef->name)) |
391
|
|
|
->setPublic() |
392
|
|
|
->setReturnType($type) |
393
|
|
|
->setReturnNullable($fieldDef->mayBeNull); |
394
|
|
|
|
395
|
|
|
$getter->addBody('return $this->' . $fieldDef->name . ';'); |
396
|
|
|
} |
397
|
|
|
|
398
|
|
|
if (count($classDef->fields) > 0) { |
399
|
|
|
$fromArray->addBody(');'); |
400
|
|
|
|
401
|
|
|
$serialize->addBody('];'); |
402
|
|
|
} |
403
|
|
|
|
404
|
|
|
return $phpFile; |
405
|
|
|
} |
406
|
|
|
} |
407
|
|
|
|