TypeORM entity ক্লাস পেস্ট করুন এবং সেই entity API থেকে ফেরত দিলে যে JSON আকৃতি তৈরি হয় তা placeholder ভ্যালু দিয়ে পূরণ করা অবস্থায় পান। এটি সেইসব NestJS বা Express প্রজেক্টের জন্য, যেগুলো response-এ সরাসরি entity ফেরত পাঠায় এবং Swagger উদাহরণ বা ফ্রন্টএন্ডের সাথে একমত হওয়ার মতো request/response নমুনা দরকার।
ভ্যালু আসে @Column অপশন থেকে নয়, প্রতিটি প্রপার্টির TypeScript type থেকে। তাই price: number-সহ @Column({ type: "decimal" }) হিসেবে ডিক্লেয়ার করা কলাম সংখ্যা 0 হিসেবে আসে।
TypeORM বক্সে entity ফাইলটি পেস্ট করুন। সম্পর্কিত entity আর enum-ও দিন, যাতে nested অবজেক্ট পূরণ করা যায়।ফলাফল বক্স আপডেট হয়। অন্য কোনো entity reference করে না এমন entity top-level JSON অবজেক্ট হয়; কয়েকটি সম্পর্কহীন entity থাকলে প্রত্যেকটি তার ক্লাসের নামের অধীনে দেখায়।enum Genre { Novel = "novel", Essay = "essay" }
@Entity()
export class Author {
@PrimaryGeneratedColumn()
id: number;
@Column()
name: string;
}
@Entity()
export class Book {
@PrimaryGeneratedColumn("uuid")
id: string;
@Column({ type: "enum", enum: Genre })
genre: Genre;
@Column({ type: "decimal", nullable: true })
price: number | null;
@ManyToOne(() => Author)
author: Author;
@Exclude()
@Column()
internalCode: string;
}{
"id": "",
"genre": "novel",
"price": 0,
"author": {
"id": 0,
"name": ""
}
}Book Author-কে reference করে, তাই Book রুট আর author তার ভেতরে nested। @Exclude()-এর কারণে internalCode বাদ পড়ে, আর number | null type-এর price প্রথম non-null type অনুসরণ করে 0 হয়। uuid primary key-এর type string, তাই এটি একটি ফাঁকা স্ট্রিং।
@ManyToOne আর @OneToOne relation nested অবজেক্ট হয়; @OneToMany বা @ManyToMany-এর Post[] এক element-এর array হয়।Promise<Post[]>) আর ESM-এর Relation<User> wrapper খুলে ভেতরের type নেওয়া হয়।@Exclude() দেওয়া ফিল্ড, static ফিল্ড, মেথড আর getter বাদ যায়।Date প্রপার্টি (@CreateDateColumn ইত্যাদি থেকে) 1970-01-01T00:00:00.000Z-এর মতো ISO স্ট্রিং হয়।Record<string, number>, {"key": 0} হিসেবে দেখানো হয়।null বা ফাঁকা array দিয়ে কেটে দেওয়া হয়, ফলে nesting সীমিত থাকে।সরাসরি entity ফেরত দেওয়া controller-এরও @ApiResponse-এর জন্য উদাহরণ payload দরকার। Entity ফাইল পেস্ট করে ফলাফলের placeholder ভ্যালুগুলো বাস্তবসম্মত ভ্যালু দিয়ে বদলান।
relations: ["author"] দিয়ে কোয়েরি করলে ফ্রন্টএন্ড জানতে চায় response কত গভীরে nested। আউটপুট স্পষ্ট করে দেয় কোন relation ফিল্ড অবজেক্ট আর কোনগুলো array।
supertest-এর POST কলের request body-র কাঠামো হিসেবে আউটপুট ব্যবহার করুন। id আর timestamp-এর মতো জেনারেট হওয়া ফিল্ড মুছে বাকিগুলো পূরণ করুন।
nullable, default বা length-এর মতো @Column অপশন পড়া হয় না; ভ্যালু আসে প্রপার্টির type বা literal initializer (status = "draft") থেকে। কোনো কলাম null হতে পারলে সেই ভ্যালু নিজে null-এ বদলান।@Entity ক্লাস সবই কনভার্ট হয়, ক্লাসের নাম অনুযায়ী key করে ({ "Book": {...}, "Author": {...} })। একে অপরকে reference করা entity তবুও একটি nested রুটই তৈরি করে।null হিসেবে দেখায়।ClassSerializerInterceptor-এর সাথে ব্যবহৃত @Expose, serialization group আর @Transform প্রয়োগ হয় না।@PrimaryGeneratedColumn("uuid") কেন ফাঁকা স্ট্রিং?শুধু প্রপার্টির type-ই ভ্যালু নির্ধারণ করে। id: string দেয় ""; decorator-এর "uuid" আর্গুমেন্ট পড়া হয় না। ডকুমেন্টেশনের জন্য পরে UUID আকৃতির একটি ভ্যালু বসিয়ে দিন।
এটি পুরোপুরি লোড করা entity-র JSON.stringify-এর সাথে মেলে। relations দিয়ে লোড না করা relation আসল response-এ থাকেই না, তাই আউটপুটের relation ফিল্ডগুলোকে লোড করা অবস্থা হিসেবে ধরুন।
Precision হারানো এড়াতে PostgreSQL আর MySQL driver decimal ভ্যালু স্ট্রিং হিসেবে ফেরত দেয়। Entity-তে প্রপার্টিটি price: string হিসেবে ডিক্লেয়ার করুন, তাহলে আপনার আসল ডেটার মতো আউটপুটও স্ট্রিং হবে।