اسپرنگ بوٽ تي هڪ آرام واري خدمت ۾ PostgreSQL ڊيٽابيس شامل ڪرڻ. حصو 1

مون کي اهو چوڻ سان شروع ڪرڻ ڏيو ته مون ايلينور ڪيري جي آرٽيڪلز جي سيريز مان واقعي لطف اندوز ٿيو جنهن کي ”REST Overview“ سڏيو ويندو آهي. هتي انهن مضمونن جا لنڪ آهن:

• REST جو جائزو. حصو 1: آرام ڇا آهي
• REST جو جائزو. حصو 2: ڪلائنٽ ۽ سرور جي وچ ۾ رابطي
• REST جو جائزو. حصو 3: اسپرنگ بوٽ ۾ آرام واري خدمت ٺاهڻ

عام طور تي، مون آزادي وٺڻ جو فيصلو ڪيو ۽ ان ۾ ٿورو اضافو ڪيو. يعني، ٻڌايو ته ڊيٽابيس ڪيئن ٺاهيو ۽ ان کي هن ايپليڪيشن سان ڳنڍيو. ڪٿي شروع ڪرڻ لاء؟ شايد ڊيٽابيس مان ئي. مون PostgreSQL استعمال ڪرڻ جو فيصلو ڪيو ڇو ته مون ان جو صارف دوست ايڊمن انٽرفيس پسند ڪيو. پهرين، اسان کي ڊائون لوڊ ڪرڻ جي ضرورت آهي PostgreSQL انسٽالر، مثال طور هتان کان: PostgreSQL ڊيٽابيس ڊائون لوڊ آئون مڪمل انسٽاليشن جي عمل کي بيان نه ڪندس، ڇاڪاڻ ته اهو توهان جي او ايس جي لحاظ کان مختلف ٿي سگهي ٿو. بهرحال، مان نوٽ ڪريان ٿو ته پروسيس ۾ توهان کي ڊفالٽ پوسٽ گريس رول (اڪائونٽ) لاءِ ايڊمنسٽريٽر پاسورڊ سان گڏ اچڻو پوندو ۽ ان کي 2 ڀيرا داخل ڪريو. سادگي لاءِ، مون پاسورڊ سيٽ ڪيو 123 . يقينا، حقيقي منصوبن ۾ اهو ضروري آهي ته ڪجهه وڌيڪ پيچيده سان گڏ اچي. اڳيون، انسٽاليشن پروگرام توهان کي بندرگاهن کي چونڊڻ لاء اشارو ڪري ٿو؛ مون ان کي ان جي ڊفالٽ قيمت تي ڇڏي ڏنو. مقامي به ڊفالٽ طور ڇڏي ويو. انسٽال ٿيل، پوءِ ايڊمنسٽريٽر انٽرفيس کوليو pgAdmin . هڪ برائوزر هڪ پاپ اپ ونڊو سان کلي ويندو جتي اسان کي چيو ويندو ته اڳي ٺاهيل پاسورڊ داخل ڪريو. هاڻي اسان کي انٽرفيس جي ٻولي مقرر ڪرڻ جي ضرورت آهي. ائين ڪرڻ لاءِ، ڪلڪ ڪريو ترتيب ڏيو pgAdmin --> Miscellaneous --> User Language , منتخب ڪريو ٻولي --> Save , and reload the browser page . صفحي جي مٿين کاٻي ڪنڊ ۾، سرور تي ڪلڪ ڪريو، " سرور سان ڳنڍيو " ونڊو ظاهر ٿئي ٿو . اسان جو پاسورڊ ٻيهر داخل ڪريو ۽ دٻي کي چيڪ ڪريو پاسورڊ محفوظ ڪريو ته جيئن ان کي هر وقت داخل نه ڪيو وڃي. اسان سڀني ڊيٽابيس لاءِ ايڊمنسٽريٽر جي ڪردار کي استعمال ڪرڻ جاري رکي سگهون ٿا، پر اهو بهتر ٿيندو ته هڪ نئون ڪردار ٺاهيو وڃي، ڇاڪاڻ ته اسان وٽ ڪيترائي ڊيٽابيس ۽ ڪيترائي پروگرام هوندا جيڪي انهن کي استعمال ڪندا آهن. ائين ڪرڻ لاءِ، مٿي کاٻي ڪنڊ ۾، تي ڪلڪ ڪريو PostgreSQL 12 --> RMB on Login/Group Roles --> Create --> Login/Group Role پاپ اپ ونڊو ۾، ” جنرل “ ٽئب تي، داخل ڪريو. ڪردار جو نالو. مون ڪردار جو نالو رکيو . " تعريف " ٽئب تي اسان هڪ نئون پاسورڊ ٺاهيندا آهيون، مون 123 ڇڏي ڏنو ته جيئن مونجهارو نه ٿئي. وڃو " حق " ٽئب ۽ نشان لڳايو سڀني ضروري شيون. مون سڀني شين کي " YES " تي سيٽ ڪيو آهي. " محفوظ ڪريو " تي ڪلڪ ڪريو اسان ڊيٽابيس ٺاهڻ لاء اڳتي وڌو. "Databases" تي ساڄي ڪلڪ ڪريو -> Create -> Database " General " ٽئب تي، ڊيٽابيس جو نالو ٺاھيو. اچو ته، مثال طور، گراهڪ . اسان مالڪ کي روٽ کي تفويض ڪريون ٿا ، جنهن کي اسان اڳئين قدم ۾ ٺاهيو. تي "وصف » چيڪ ڪريو ته اسان وٽ UTF8 انڪوڊنگ سيٽ آهي . " محفوظ ڪريو " تي ڪلڪ ڪريو. اھو اھو آھي، اسان جو ڊيٽابيس ٺاھيو ويو آھي (ھاڻي لاءِ خالي). هن نقطي تي اسان pgAdmin سان ختم ڪري سگهون ٿا، ڇاڪاڻ ته ... اسان پروگرام طور جدول ٺاهينداسين، پر، صرف ان صورت ۾، مان توهان کي ڏيکاريندس ته ٽيبل ڪيئن ٺاهي دستي طور. گراهڪن کي وڌايو --> اسڪيما -> عوامي وڻ . Right-Click Tables --> Create --> Table . هڪ پاپ اپ ونڊو کلي ويندي. " جنرل " ٽئب تي، اسان پنھنجي ٽيبل تي ھڪڙو نالو ڏيون ٿا، مثال طور test_table ، ۽ روٽ کي مالڪ طور تفويض ڪريو . " ڪالمن " ٽئب ڏانھن وڃو، نئون ڪالم ٺاھڻ لاءِ " + " تي ڪلڪ ڪريو. نالو داخل ڪريو " id " ۽ ڊيٽا جو قسم bigserial ، جيڪو جاوا ۾ لانگ قسم جي برابر آهي ، پر خودڪار واڌ سان (جڏهن نئون رڪارڊ شامل ڪيو ويندو، id خودڪار طريقي سان هڪ کان وڌي ويندي). اسان غير NULL کي " ها " طور نشان لڳايو، بنيادي ڪيئي پڻ " ها " آهي. اسان ساڳيءَ طرح ” نالو “، ” اي ميل “ ۽ ” فون “ ڪالم ٺاهيندا آهيون . اسان ڊيٽا جي قسم جو اکر مختلف چونڊيو ٿا ، اهو اسٽرنگ قسم سان ملندو آهي ، پر توهان کي اجازت ڏئي ٿو ته وڌ ۾ وڌ ڊگھائي مقرر ڪريو. اسان مڪمل نالو ڀرڻ لاءِ وڌ ۾ وڌ نالي جي ڊيگهه کي 200 اکرن تائين مقرر ڪيو. هڪ ڪالمن ۾. اسان وڌ ۾ وڌ اي ميل ڊگھائي 254 اکرن تي مقرر ڪيو. ڇو ته اي ميل اهڙي وڌ ۾ وڌ ڊگھائي آهي هتي ڳولهي سگهجي ٿو . هڪ فون نمبر لاء، 20 اکر چونڊيو، اهو ڪافي هجڻ گهرجي. ٽيليفون نمبرن بابت ٿورڙو: ٽيليفون نمبرن بابت پروگرامرز جون غلط فهميون (Habr) اسان سڀني ڪالمن ۾ غير NULL کي ” ها “ طور نشان لڳايو آهي جيڪڏهن اسان چاهيون ٿا ته هي ڊيٽا لازمي هجي. " محفوظ ڪريو " تي ڪلڪ ڪريو. اھو اھو آھي، ٽيبل ٺاھيو ويو آھي. اسان جي ٽيسٽ ٽيبل کي ختم ڪرڻ لاء، ان تي صحيح ڪلڪ ڪريو (وڻ ۾) ۽ " خارج ڪريو "، ڇاڪاڻ ته اسان کي هاڻي ان جي ضرورت ناهي، ڇو ته اسان پنهنجي پروگرام مان ٽيبل ٺاهينداسين. بند ڪريو pgAdmin ۽ وڃو اسان جي پروگرام. اچو ته اسان جي منصوبي سان IDEA کوليو. انٽرفيس جي ساڄي ڪالمن ۾ ڊيٽابيس تي ڪلڪ ڪريو ، اسان جي ڊيٽابيس کي شامل ڪرڻ لاء " + " تي ڪلڪ ڪريو. اڳيون ڊيٽا جو ذريعو --> PostgreSQL . پاپ اپ ونڊو ۾، يوزر فيلڊ ۾ داخل ڪريو روٽ ڪردار جيڪو اسان اڳ ۾ ٺاهيو، ۽ اسان جو پاسورڊ123 پاسورڊ فيلڊ ۾ . ڊيٽابيس جي فيلڊ ۾ اسان اسان جي گراهڪن جي ڊيٽابيس جو نالو لکندا آهيون . اسان بٽڻ کي دٻايو ٽيسٽ ڪنيڪشن ، ۽ جيڪڏهن اسان ان جي هيٺان سائي چيڪ مارڪ ڏسون ٿا، ته پوء هر شي ترتيب ۾ آهي، ۽ اسان بٽڻ کي دٻايو OK . اھو آھي، اسان ڊيٽابيس سان ڳنڍيو آھي، ھاڻي اچو pom.xml فائل ڏانھن وڃو ۽ انحصار شامل ڪريو. ORM ڊيٽابيس سان ڪم ڪرڻ لاءِ :

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>

هڪ REST ڪنٽرولر ٺاهڻ لاء:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-rest</artifactId>
</dependency>

Tomcat سرور لاء:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
</dependency>

PostgreSQL لاءِ:

<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <version>42.2.10</version>
</dependency>

هاڻي ته اسان pom.xml کي ترتيب ڏنو آهي، اچو ته وسيلن جي فولڊر ۾ وڃو ۽ ايپليڪيشن. پراپرٽيز فائل کي هن ريت ڀريو :

spring.datasource.url=jdbc:postgresql://localhost:5432/customers
spring.datasource.username=root
spring.datasource.password=123

spring.datasource.driver-class-name=org.postgresql.Driver
spring.jpa.database=postgresql
spring.jpa.database-platform=org.hibernate.dialect.PostgreSQL10Dialect

ھتي اسان پنھنجي ڊيٽابيس جو URL داخل ڪيو، ان لاءِ لاگ ان ۽ پاسورڊ ڏنو، ڊرائيور کي PostgreSQL لاءِ رجسٽر ڪيو، اشارو ڪيو ته اسان PostgreSQL ڊيٽا جو قسم استعمال ڪنداسين، ۽ ھائبرنيٽ لاءِ ڊيليڪٽ بيان ڪيو. اڳيون، اچو ته ساڳئي وسيلن فولڊر ۾ ڊيٽابيس نالي هڪ نئين ڊاريڪٽري ٺاهي . هن ڊاريڪٽري ۾ اسان 2 فائلون ٺاهينداسين: initDB.sql ۽ populateDB.sql . پھريون جدولن کي ٺاھڻ جو ذميوار ھوندو، ٻيو انھن کي شروعاتي طور ڀرڻ جو ذميوار ھوندو. اچو ته initDB.sql کي کوليون ۽ مٿي تي سائي بار ڏسو جيڪو چوي ٿو SQL dialect ترتيب نه آهي . هن جو مطلب آهي ته اسان پنهنجي پروجيڪٽ لاءِ SQL ٻولي نه چونڊيو آهي (۽ انهن مان ڪيترائي آهن). ساڳئي پٽي جي ساڄي پاسي تي ڪلڪ ڪريو لکت تي dialect تبديل ڪريو… . پاپ اپ ونڊو ۾، ڪلڪ ڪريو Project SQL Dialect , ۽ جيئن ته اسان جو ڊيٽابيس PostgreSQL آهي ، اسان ساڳئي نالي جي ٻولي چونڊون ٿا. OK تي ڪلڪ ڪريو اچو ته اڳتي وڌون اسان جون .sql فائلون ڀرڻ لاءِ . اچو ته پھريون initDB.sql فائل ڀريون :

CREATE TABLE IF NOT EXISTS clients
(
    id    BIGSERIAL PRIMARY KEY ,
    name  VARCHAR(200) NOT NULL ,
    email VARCHAR(254) NOT NULL ,
    phone VARCHAR(20)  NOT NULL
);

جيڪڏهن، فائل ڀرڻ کان پوء، ڪلائنٽ کان سواء ٻيا لفظ اڇا فونٽ ۾ لکيل آهن، پوء متن جي اندر صحيح ڪلڪ ڪريو ۽ تبديل ڪريو Dialect -> PostgreSQL ٻيهر چونڊيو . جيئن توهان شايد اڳ ۾ ئي سمجهي چڪا آهيو، اهو ساڳيو ڊيٽا آهي جيڪو اسان ڀريو هو جڏهن ٽيسٽ ٽيبل دستي طور تي ٺاهيو. هتي اهي SQL ٻولي جي PostgreSQL ٻولي ۾ فارميٽ ٿيل آهن. ھاڻي اچو populateDB.sql فائل ڀريون :

INSERT INTO clients VALUES
(1, 'Vassily Petrov', 'vpetrov@jr.com', '+7 (191) 322-22-33)'),
(2, 'Pjotr Vasechkin', 'pvasechkin@jr.com', '+7 (191) 223-33-22)');

جيڪڏهن توهان جي گراهڪن جي ٽيبل جو نالو ڳاڙهي اکرن ۾ لکيل آهي، پوء اهو ٺيڪ آهي. نقطو اهو آهي ته اسان اڃا تائين هي ٽيبل نه ٺاهيو آهي، ۽ IDEA اڃا تائين ان کي سڃاڻي نه ٿو. ٽيبل ٺاهڻ ۽ آباد ڪرڻ لاءِ، اسان کي واپس وڃڻو پوندو application.properties فائل ۽ اتي ھيٺيون ٽي لائينون شامل ڪريو:

spring.datasource.initialization-mode=ALWAYS
spring.datasource.schema=classpath*:database/initDB.sql
spring.datasource.data=classpath*:database/populateDB.sql

انهن لائينن ۾ اسان چئون ٿا ته اسان ڊيٽابيس کي پروگرام جي شروعات ڪرڻ چاهيون ٿا ۽ ظاهر ڪرڻ چاهيون ٿا ته ڪهڙن فائلن کي استعمال ڪرڻ جي ضرورت آهي. اڳيون، اسان جي ايپليڪيشن جي مکيه طريقي ڏانھن وڃو ۽ ان کي لانچ ڪريو . ان کان پوء، وڃو pgAdmin --> سرورز --> PostgreSQL 12 --> Databases --> Customers --> Schemas --> public , ساڄي ڪلڪ ڪريو " Tables "، " Update ". جيڪڏھن سڀ ڪجھ ٺيڪ ٿي ويو، پوء اسان ڏسون ٿا ڪلائنٽ ٽيبل جيڪو اسان ٺاھيو آھي . ان کان پوء، واپس وڃو application.properties فائل ۽ تبصرو لائن ڪڍيو.

spring.datasource.data=classpath*:database/populateDB.sql

جيئن هيٺ ڏنل:

spring.datasource.url=jdbc:postgresql://localhost:5432/customers
spring.datasource.username=root
spring.datasource.password=123

spring.datasource.driver-class-name=org.postgresql.Driver
spring.jpa.database=postgresql
spring.jpa.database-platform=org.hibernate.dialect.PostgreSQL10Dialect

spring.datasource.initialization-mode=ALWAYS
spring.datasource.schema=classpath*:database/initDB.sql
#spring.datasource.data=classpath*:database/populateDB.sql

جيڪڏهن اسان ائين نه ٿا ڪريون، ته پوءِ ايندڙ ڀيري جڏهن اسان پروگرام هلائينداسين ته اسان کي هيٺ ڏنل نقص ملندو: org.postgresql.util.PSQLException: ERROR: هڪ نقل ڪيل ڪي قدر منفرد رڪاوٽ "clients_pkey" جي ڀڃڪڙي ڪري ٿي . اهو ٿي سگهي ٿو ڇاڪاڻ ته اسان اڳ ۾ ئي فيلڊ ۾ ڀريو آهي id 1 ۽ 2 سان ٽيبل ۾ (جيتوڻيڪ پهرين لانچ دوران). اسان جي ٺاهيل جدول ۾، id فيلڊ جي طور تي بيان ڪيو ويو آهي bigserial ، جيڪو جاوا ۾ لانگ قسم سان ملندو آهي. بهرحال، اسان جي پروگرام ۾ هن فيلڊ جو قسم آهي Integer . مون فيصلو ڪيو ته ڪيئن استعمال ڪجي لانگ (BIGSERIAL) ڇاڪاڻ ته ان ۾ Integer کان وڏي رينج آهي. حقيقت اها آهي ته جدولن ۾، پرائمري ڪي جي طور تي نامزد ٿيل فيلڊ استعمال ڪري سگهجي ٿي نه رڳو صارف جي ids کي ذخيرو ڪرڻ لاء ، پر پڻ مختلف قسم جي ڊيٽا جي انڊيڪس کي ذخيرو ڪرڻ لاء، ۽ اهڙن رڪارڊن جو تعداد وڌ کان وڌ انٽيجر قدر کان وڌي سگھي ٿو. مثال طور، جيڪڏهن اسان جو پروگرام هر سيڪنڊ ۾ ڪجهه ماپون وٺندو آهي ۽ ڊيٽا کي ٽيبل تي لکندو آهي. لانگ ڊيٽا جي قسم کي استعمال ڪرڻ لاءِ اسان جي ڪلاسن کي ٻيهر لکڻ لاءِ، اسان کي ان قسم کي Integer کان Long تائين سڀني طبقن ۽ طريقن ۾ تبديل ڪرڻو پوندو جيڪي id فيلڊ استعمال ڪندا آهن . اسان اهو نه ڪنداسين، ڇاڪاڻ ته پروگرام اصل ۾ ليکڪ طرفان لکيو ويو هو id Integer قسم، جنهن جو مطلب اهو آهي ته اهو ڪجهه سمجهه ۾ اچي ٿو. جاري رکڻ لاءِ، اچو ته هڪ ڀيرو ٻيهر ڪلائنٽ ٽيبل کي هٽائي ڇڏيون جيڪو اسان پنهنجي ڊيٽابيس مان ٺاهيو آهي، پر هاڻي اسان ان کي دستي جي بجاءِ پروگرام طور ڪرڻ جي ڪوشش ڪنداسين. هن کي ڪرڻ لاء، اسان جي ڪوڊ کي initDB.sql فائل ۾ تبصرو ڪريو ۽ هڪ لائن شامل ڪريو:

-- CREATE TABLE IF NOT EXISTS clients
-- (
--     id    BIGSERIAL PRIMARY KEY ,
--     name  VARCHAR(200) NOT NULL ,
--     email VARCHAR(254) NOT NULL ,
--     phone VARCHAR(20)  NOT NULL
-- );
DROP TABLE IF EXISTS clients

اچو ته پروگرام شروع ڪريون، pgAdmin ڏانهن وڃو، " ٽيبلز " تي صحيح ڪلڪ ڪريو (اسان جي ڪسٽمر ڊيٽابيس ۾ ) -> " اپڊيٽ "، ۽ اسان ڏسنداسين ته اسان جي ٽيبل غائب ٿي وئي آهي. NB! هن حڪم کي استعمال ڪرڻ وقت محتاط رهو، ٻي صورت ۾ توهان کي پنهنجي ٽيبل ۾ موجود سموري ڊيٽا کي وڃائڻ جو خطرو آهي! اچو ته initDB.sql فائل ڏانهن واپس وڃو ۽ ان کي هن ريت لکون:

CREATE TABLE IF NOT EXISTS clients
(
    id    SERIAL PRIMARY KEY ,
    name  VARCHAR(200) NOT NULL ,
    email VARCHAR(254) NOT NULL ,
    phone VARCHAR(50)  NOT NULL
);

هتي اسان id قسم کي SERIAL ۾ تبديل ڪيو آهي ، جيڪو Integer قسم سان ملندو آهي جيڪو اسان پنهنجي پروگرام ۾ id فيلڊ لاءِ استعمال ڪري رهيا آهيون . ان کان علاوه، فون جي فيلڊ جي وڌ ۾ وڌ ڊگھائي وڌايو ويو آهي ته جيئن اسان آزاديء سان ان جي لکڻين ۾ اسپيس ۽ خاص اکر (قوس، ڊيش، وغيره) استعمال ڪري سگهون ٿا. فون نمبر ۾ انگن جو وڌ ۾ وڌ تعداد في الحال 18 انگن جو آهي (جيڪڏهن منهنجي ياداشت مون کي صحيح طور تي ڪم ڪري ٿي). پڪ ڪرڻ لاءِ مون سائيز کي 50 اکرن تي مقرر ڪيو. اچو ته وڃو application.properties فائل ۽ ان لائن کي ختم ڪريو:

spring.datasource.data=classpath*:database/populateDB.sql

اچو ته اسان جو پروگرام هلون، pgAdmin ڏانهن وڃو، چيڪ ڪريو ته اسان جي ٽيبل ٺاهي وئي آهي، ۽ هن لائن کي واپس تبصرو ڪيو.

#spring.datasource.data=classpath*:database/populateDB.sql

هي آهي جتي مان شايد آرٽيڪل جو پهريون حصو ختم ڪندس. مون کي اميد آهي ته توهان ان کي پسند ڪيو، تبصرو لکو (جيتوڻيڪ توهان اهو پسند نه ڪيو). ٻئين حصي ۾، اسان پنهنجي ڪلاسن کي ٻيهر لکنداسين ته جيئن اهي حقيقي ڊيٽابيس سان ڪم ڪري سگهن. تسلسل: اسپرنگ بوٽ تي هڪ آرام واري خدمت ۾ PostgreSQL ڊيٽابيس شامل ڪرڻ. حصو 2 UPD منهنجي تصويرن ۽ ٽيڪسٽ فارميٽنگ کي درست ڪرڻ لاءِ منتظمين جي مهرباني!