Bermula dengan rak buku.js

mata teras

bookshelf.js adalah perisian pemetaan objek-hubungan (ORM) untuk JavaScript (terutamanya Node.js), yang memudahkan proses berkomunikasi dengan pangkalan data dengan membenarkan pemaju menggunakan objek dalam bahasa pengaturcaraan mereka untuk berinteraksi dengan pangkalan data.
Perpustakaan menyediakan cara yang mudah dan intuitif untuk melaksanakan operasi CRUD (membuat, membaca, mengemas kini, memadam) dan menyokong antara muka berasaskan janji, yang bermaksud bahawa fungsi dipanggil hanya apabila pertanyaan berjaya.
seperti yang ditunjukkan dalam contoh membuat blog JSON API dalam artikel, bookshelf.js boleh digunakan bersempena dengan ekspres.js untuk membina API, dan boleh digunakan untuk merangkum struktur jadual pangkalan data yang mendasari, mendedahkan javascript biasa objek untuk pertanyaan.

Pada tahun -tahun kebelakangan ini, JavaScript telah melonjak popular. Selama bertahun -tahun, orang telah cuba memohon bahasa popular ini ke sisi pelayan berkali -kali. Salah satu percubaan yang paling berjaya ialah Node.js, yang disyorkan kepada masyarakat sebagai cara untuk menulis aplikasi pelayan dengan cepat. Titik jualan nod adalah kelajuan, baik dari segi prestasi dan masa pembangunan. Dengan populariti ini, masyarakat terus berkembang, dan projek itu juga mendapat manfaat daripada lebih banyak penyumbang, menghasilkan modul berkualiti tinggi seperti Express.js.

jadi orang mula membina backend lengkap menggunakan nod. Salah satu perkara yang paling penting yang perlu dilakukan oleh sistem backend ialah berkomunikasi dengan pangkalan data dengan berkesan. Di sinilah perisian pemetaan hubungan objek (ORM) masuk. Sering kali, pemaju perlu mahir dalam bahasa pengaturcaraan dan SQL yang mereka gunakan untuk berkomunikasi dengan pangkalan data. ORM memudahkan proses pembangunan dengan membenarkan pemaju berinteraksi dengan pangkalan data menggunakan objek dalam bahasa pengaturcaraan mereka pilihan. Artikel ini memperkenalkan ORM dan memberi perhatian khusus kepada rak buku.

Apa itu Orm?

Wikipedia mentakrifkan pemetaan hubungan objek sebagai:

Teknik pengaturcaraan untuk menukar data antara sistem jenis yang tidak serasi dalam bahasa pengaturcaraan berorientasikan objek. Ini sebenarnya mewujudkan "pangkalan data objek maya" yang boleh digunakan secara dalaman dalam bahasa pengaturcaraan.

Dalam contoh kami, bahasa pengaturcaraan adalah JavaScript, dan sistem yang tidak serasi adalah sistem pangkalan data relasi, seperti MySQL. Ini bermakna perpustakaan ORM harus membolehkan kita berkomunikasi dengan pangkalan data dengan cara yang sama seperti berinteraksi dengan objek JavaScript konvensional. Terdapat banyak perpustakaan Orm di node.js, dan perpustakaan popular termasuk ketekunan.js, sequelize.js, dan bookshelf.js. Artikel ini akan memperkenalkan Bookshelf.js.

bookshelf.js Contoh

Interaksi pangkalan data biasanya berputar di sekitar empat operasi CRUD -mewujudkan, membaca, mengemas kini, dan memadam. Bookshelf.js menyediakan cara intuitif untuk melaksanakan operasi ini, sebagai contoh, membuat operasi seperti ini:

new Post({name: 'New Article'}).save().then(function(model) {
  // ...
});

Katakan pos adalah model dengan jadual pangkalan data yang sepadan, dan nama adalah harta yang sepadan dengan lajur dalam jadual pangkalan data.

Begitu juga, operasi baca adalah seperti berikut:

new Post({name: 'New Article'}).save().then(function(model) {
  // ...
});

Sila ambil perhatian yang kemudian panggilan dalam kod. Bookshelf.js menyokong antara muka berasaskan janji, di mana ini bermakna fungsi tanpa nama yang diluluskan pada masa itu akan dipanggil hanya apabila pertanyaan berjaya. Model adalah objek JavaScript yang dihasilkan yang boleh anda gunakan untuk mengakses sifat yang berkaitan dengan pengguna. Dalam contoh kami, model.get ('jantina') mengembalikan jantina pengguna.

membina API dengan bookshelf.js dan express.js

Untuk contoh yang lebih lengkap, katakan kami diwakilkan untuk membina blog dengan sumber -sumber berikut JSON API:

// select * from `user` where `email` = 'user@mail.com'
new User({email: 'user@mail.com'})
  .fetch()
  .then(function(model) {
    console.log(model.get('gender'));
  });

dan pelanggan sudah mempunyai jadual berikut:

<code>GET  /api/article
GET  /api/article/:article_id
POST /api/article</code>

Pertama sekali, kita perlu menggunakan Package.json untuk menubuhkan persekitaran Express.js:

create table article (
  id int not null primary key,
  title varchar(100) null,
  body text null,
  author varchar(100) null
);

Kami memerlukan pembina pertanyaan Knex kerana rak buku bergantung padanya, dan kami memerlukan Bluebird untuk mengendalikan janji. Struktur app.js kami adalah seperti berikut:

{
  "name": "article_api",
  "description": "expose articles via JSON",
  "version": "0.0.1",
  "private": true,
  "dependencies": {
    "bluebird": "^2.1.3",
    "body-parser": "^1.3.1",
    "express": "4.4.3",
    "mysql": "*",
    "knex": "*",
    "bookshelf": "*"
  }
}

pangkalan data MySQL kami dipanggil blog. Kita perlu menentukan model artikel dan mengikatnya ke jadual artikel. Kami akan menggantikan // {kod definisi model kami di sini}:

// 当应用程序启动时
var express = require('express');
var app = express();
var bodyParser = require('body-parser');
var Promise = require('bluebird');

var dbConfig = {
  client: 'mysql',
  connection: {
    host: 'localhost',
    user: 'root',
    password: 'your_password',
    database: 'blog',
    charset: 'utf8'
  }
};

var knex = require('knex')(dbConfig);
var bookshelf = require('bookshelf')(knex);

app.set('bookshelf', bookshelf);

var allowCrossDomain = function(req, res, next) {
  res.header('Access-Control-Allow-Origin', '*');
  next();
};

app.use(allowCrossDomain);
// 解析 application/x-www-form-urlencoded
app.use(bodyParser.urlencoded());

// 解析 application/json
app.use(bodyParser.json());

// 解析 application/vnd.api+json 为 json
app.use(bodyParser.json({type: 'application/vnd.api+json'}));

// 在其他地方，使用 bookshelf 客户端：
var bookshelf = app.get('bookshelf');

// {我们的模型定义代码在这里}

app.listen(3000, function() {
  console.log('Express started at port 3000');
});

tidak syak lagi ini adalah semua yang anda perlukan untuk menentukan model dalam bookshelf.js. Kami kini boleh menggunakan model ini untuk menanyakan pangkalan data dalam API kami. Pertama, kaedah GET /API /artikel harus mengembalikan semua artikel dalam pangkalan data:

var Article = bookshelf.Model.extend({
  tableName: 'article'
});

Fetchall dalam bookshelf.js mendapat semua penyertaan dalam jadual pangkalan data dan tangkapan dilakukan hanya jika ralat berlaku (terdapat lebih banyak kaedah model dalam dokumen).

Kesimpulan

node.js telah dibangunkan sebagai teknologi dan boleh digunakan untuk membina aplikasi web dan API melalui modul seperti Express.js. Bookshelf.js membuat interaksi dengan pangkalan data relasi aplikasi Node.js lebih mudah dengan merangkumi struktur jadual pangkalan data asas dan mendedahkan objek JavaScript biasa untuk pertanyaan. Artikel ini menyediakan pengenalan peringkat tinggi. Pelaksanaan penuh projek demo boleh didapati di GitHub. (Pautan github harus ditambah di sini, jika ada)

bookshelf.js memulakan FAQ

Apa itu bookshelf.js dan mengapa saya harus menggunakannya?

bookshelf.js adalah perpustakaan JavaScript yang menyediakan API yang mudah dan elegan untuk berinteraksi dengan pangkalan data SQL. Ia menyokong urus niaga, loading hubungan segera/leher yang mendesak, persatuan polimorfik, dan banyak lagi. Kelebihan utama menggunakan bookshelf.js adalah kesederhanaan dan fleksibiliti. Ia membolehkan anda menulis kurang kod semasa melakukan lebih banyak perkara, menjadikan proses pembangunan anda lebih cepat dan lebih cekap.

bagaimana memasang bookshelf.js?

Untuk memasang bookshelf.js, anda perlu memasang node.js dan npm pada sistem anda. Selepas pemasangan selesai, anda boleh memasang bookshelf.js dengan menjalankan arahan npm install bookshelf knex sqlite3 --save di terminal. Ini akan memasang bookshelf.js serta knex.js (pembina pertanyaan SQL) dan SQLite3 (pangkalan data berasaskan cakera ringan).

Bagaimana untuk menyambungkan bookshelf.js ke pangkalan data saya?

Untuk menyambungkan bookshelf.js ke pangkalan data anda, anda perlu mula -mula memulakan knex.js dengan konfigurasi pangkalan data anda. Anda kemudian lulus contoh Knex yang diasaskan ini ke rak buku. Berikut adalah contoh asas:

new Post({name: 'New Article'}).save().then(function(model) {
  // ...
});

bagaimana untuk menentukan model dalam bookshelf.js?

Di bookshelf.js, model ini ditakrifkan dengan memperluaskan model kelas asas yang disediakan oleh bookshelf.js. Berikut adalah contoh yang mentakrifkan model pengguna:

// select * from `user` where `email` = 'user@mail.com'
new User({email: 'user@mail.com'})
  .fetch()
  .then(function(model) {
    console.log(model.get('gender'));
  });

bagaimana menggunakan bookshelf.js untuk mengekstrak data dari pangkalan data?

Sangat mudah untuk mengekstrak data dari pangkalan data menggunakan bookshelf.js. Anda boleh menggunakan kaedah pengambilan yang disediakan oleh model. Berikut adalah contoh:

<code>GET  /api/article
GET  /api/article/:article_id
POST /api/article</code>

Bagaimana untuk menyimpan data ke pangkalan data menggunakan bookshelf.js?

Ia juga mudah untuk menyimpan data ke pangkalan data menggunakan bookshelf.js. Anda boleh menggunakan kaedah simpan yang disediakan oleh model. Berikut adalah contoh:

create table article (
  id int not null primary key,
  title varchar(100) null,
  body text null,
  author varchar(100) null
);

Bagaimana menggunakan bookshelf.js untuk mengemas kini data dalam pangkalan data?

Data dalam pangkalan data boleh dikemas kini menggunakan kaedah simpan. Anda hanya perlu mengeluarkan model terlebih dahulu dan kemudian hubungi simpan dengan data baru. Berikut adalah contoh:

{
  "name": "article_api",
  "description": "expose articles via JSON",
  "version": "0.0.1",
  "private": true,
  "dependencies": {
    "bluebird": "^2.1.3",
    "body-parser": "^1.3.1",
    "express": "4.4.3",
    "mysql": "*",
    "knex": "*",
    "bookshelf": "*"
  }
}

Bagaimana menggunakan bookshelf.js untuk memadam data dari pangkalan data?

Data boleh dipadam dari pangkalan data menggunakan kaedah memusnahkan yang disediakan oleh model. Berikut adalah contoh:

// 当应用程序启动时
var express = require('express');
var app = express();
var bodyParser = require('body-parser');
var Promise = require('bluebird');

var dbConfig = {
  client: 'mysql',
  connection: {
    host: 'localhost',
    user: 'root',
    password: 'your_password',
    database: 'blog',
    charset: 'utf8'
  }
};

var knex = require('knex')(dbConfig);
var bookshelf = require('bookshelf')(knex);

app.set('bookshelf', bookshelf);

var allowCrossDomain = function(req, res, next) {
  res.header('Access-Control-Allow-Origin', '*');
  next();
};

app.use(allowCrossDomain);
// 解析 application/x-www-form-urlencoded
app.use(bodyParser.urlencoded());

// 解析 application/json
app.use(bodyParser.json());

// 解析 application/vnd.api+json 为 json
app.use(bodyParser.json({type: 'application/vnd.api+json'}));

// 在其他地方，使用 bookshelf 客户端：
var bookshelf = app.get('bookshelf');

// {我们的模型定义代码在这里}

app.listen(3000, function() {
  console.log('Express started at port 3000');
});

bagaimana menangani hubungan di rak buku.js?

bookshelf.js menyediakan beberapa cara untuk menangani hubungan antara model, seperti hasone, hasmany, milik, dan milik. Berikut adalah contoh model pengguna dengan pelbagai model pos:

var Article = bookshelf.Model.extend({
  tableName: 'article'
});

bagaimana menangani transaksi di rak buku.js?

Transaksi dalam bookshelf.js boleh dikendalikan menggunakan kaedah urus niaga yang disediakan oleh knex.js. Berikut adalah contoh:

app.get('/api/article', function(req, res) {
  new Article().fetchAll()
    .then(function(articles) {
      res.send(articles.toJSON());
    }).catch(function(error) {
      console.log(error);
      res.send('An error occured');
    });
});

Sila ambil perhatian bahawa beberapa butiran dalam contoh kod di atas mungkin perlu diselaraskan mengikut pangkalan data dan persekitaran khusus anda. Di samping itu, adalah disyorkan untuk merujuk kepada dokumentasi rasmi Bookshelf.js untuk maklumat terkini dan panduan yang lebih terperinci.

Atas ialah kandungan terperinci Bermula dengan rak buku.js. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!