Tujuan utama proyek Spring Data adalah untuk mempermudah pembuatan aplikasi bertenaga Spring yang menggunakan teknologi akses data baru seperti database non-relasional, kerangka kerja pengurangan peta, dan layanan data berbasis cloud.
Proyek Spring Data MongoDB bertujuan untuk menyediakan model pemrograman berbasis Spring yang familier dan konsisten untuk penyimpanan data baru sambil tetap mempertahankan fitur dan kemampuan khusus toko. Proyek Spring Data MongoDB menyediakan integrasi dengan database dokumen MongoDB. Area fungsional utama Spring Data MongoDB adalah model sentris POJO untuk berinteraksi dengan Document
MongoDB dan dengan mudah menulis lapisan akses data gaya repositori.
Proyek ini diatur oleh Kode Etik Musim Semi. Dengan berpartisipasi, Anda diharapkan menjunjung tinggi kode etik ini. Silakan laporkan perilaku yang tidak dapat diterima ke [email protected].
Berikut ini teaser singkat aplikasi yang menggunakan Spring Data Repositories di Java:
public interface PersonRepository extends CrudRepository < Person , Long > {
List < Person > findByLastname ( String lastname );
List < Person > findByFirstnameLike ( String firstname );
}
@ Service
public class MyService {
private final PersonRepository repository ;
public MyService ( PersonRepository repository ) {
this . repository = repository ;
}
public void doWork () {
repository . deleteAll ();
Person person = new Person ();
person . setFirstname ( "Oliver" );
person . setLastname ( "Gierke" );
repository . save ( person );
List < Person > lastNameResults = repository . findByLastname ( "Gierke" );
List < Person > firstNameResults = repository . findByFirstnameLike ( "Oli*" );
}
}
@ Configuration
@ EnableMongoRepositories
class ApplicationConfig extends AbstractMongoClientConfiguration {
@ Override
protected String getDatabaseName () {
return "springdata" ;
}
}
Tambahkan ketergantungan Maven:
< dependency >
< groupId >org.springframework.data</ groupId >
< artifactId >spring-data-mongodb</ artifactId >
< version >${version}</ version >
</ dependency >
Jika Anda lebih menyukai snapshot terbaru dari versi utama yang akan datang, gunakan repositori snapshot Maven kami dan nyatakan versi ketergantungan yang sesuai.
< dependency >
< groupId >org.springframework.data</ groupId >
< artifactId >spring-data-mongodb</ artifactId >
< version >${version}-SNAPSHOT</ version >
</ dependency >
< repository >
< id >spring-snapshot</ id >
< name >Spring Snapshot Repository</ name >
< url >https://repo.spring.io/snapshot</ url >
</ repository >
Petunjuk tentang cara meningkatkan versi Spring Data dari versi sebelumnya disediakan di wiki proyek. Ikuti tautan di bagian catatan rilis untuk menemukan versi yang ingin Anda tingkatkan.
Mengalami masalah dengan Spring Data? Kami ingin membantu!
Periksa dokumentasi referensi, dan Javadocs
Pelajari dasar-dasar Spring – Spring Data dibangun di atas Spring Framework, periksa situs web spring.io untuk mendapatkan banyak dokumentasi referensi. Jika Anda baru memulai Spring, cobalah salah satu panduan ini.
Jika Anda melakukan peningkatan, periksa log perubahan untuk fitur “baru dan penting”.
Ajukan pertanyaan - kami memantau stackoverflow.com untuk pertanyaan yang diberi tag spring-data-mongodb
. Anda juga dapat mengobrol dengan komunitas di Gitter.
Laporkan bug dengan Spring Data MongoDB di github.com/spring-projects/spring-data-mongodb/issues.
Spring Data menggunakan Github sebagai sistem pelacakan masalah untuk mencatat bug dan permintaan fitur. Jika Anda ingin mengangkat suatu masalah, silakan ikuti rekomendasi di bawah ini:
Sebelum Anda mencatat bug, harap telusuri pelacak masalah untuk melihat apakah seseorang telah melaporkan masalah tersebut.
Jika masalah belum ada, buatlah masalah baru.
Harap berikan informasi sebanyak mungkin terkait laporan masalah, kami ingin mengetahui versi Spring Data yang Anda gunakan, versi JVM, Stacktrace, dll.
Jika Anda perlu menempelkan kode, atau menyertakan pelacakan tumpukan, gunakan pagar kode penurunan harga ```.
Situs spring.io berisi beberapa panduan yang menunjukkan cara menggunakan Spring Data langkah demi langkah:
Mengakses Data dengan MongoDB adalah panduan dasar yang menunjukkan cara membuat aplikasi sederhana dan cara mengakses data menggunakan repositori.
Mengakses Data MongoDB dengan REST adalah panduan untuk membuat layanan web REST yang mengekspos data yang disimpan di MongoDB melalui repositori.
Contoh Data Musim Semi berisi contoh proyek yang menjelaskan fitur spesifik secara lebih detail.
Anda tidak perlu membangun dari sumber untuk menggunakan Spring Data. Biner tersedia di repo.spring.io dan dapat diakses dari Maven menggunakan konfigurasi Maven yang disebutkan di atas.
Catatan | Konfigurasi Gradle mirip dengan Maven. |
Cara terbaik untuk memulai adalah dengan membuat proyek Spring Boot menggunakan MongoDB di start.spring.io. Ikuti tautan ini untuk membangun aplikasi penting dan tautan ini untuk membangun aplikasi reaktif.
Namun, jika Anda ingin mencoba yang terbaru dan terhebat, Spring Data MongoDB dapat dengan mudah dibuat dengan wrapper Maven dan minimal, JDK 17 (unduhan JDK).
Untuk membangun Spring Data MongoDB, Anda perlu mengunduh dan menginstal distribusi MongoDB.
Setelah Anda menginstal MongoDB, Anda perlu memulai server MongoDB. Lebih mudah untuk mengatur variabel lingkungan ke direktori instalasi MongoDB Anda (misalnya MONGODB_HOME
).
Untuk menjalankan rangkaian pengujian lengkap, diperlukan Kumpulan Replika MongoDB.
Untuk menjalankan server MongoDB masukkan perintah berikut dari baris perintah:
$ $MONGODB_HOME /bin/mongod --dbpath $MONGODB_HOME /runtime/data --ipv6 --port 27017 --replSet rs0
...
" msg " : " Successfully connected to host "
Setelah server MongoDB dijalankan, Anda akan melihat pesan ( msg
), " Berhasil terhubung ke host ".
Perhatikan opsi --dbpath
pada perintah mongod
. Anda dapat mengaturnya sesuai keinginan Anda, tetapi dalam kasus ini, kami menetapkan jalur absolut ke subdirektori ( runtime/data/
) di bawah direktori instalasi MongoDB (dalam $MONGODB_HOME
).
Anda perlu menginisialisasi kumpulan replika MongoDB hanya sekali saat pertama kali server MongoDB dimulai. Untuk menginisialisasi kumpulan replika, mulai klien mongo:
$ $MONGODB_HOME /bin/mongo
MongoDB server version: 6.0.0
...
Kemudian masukkan perintah berikut:
mongo > rs.initiate({ _id: ' rs0 ' , members: [ { _id: 0, host: ' 127.0.0.1:27017 ' } ] })
Terakhir, pada sistem berbasis UNIX (misalnya, Linux atau Mac OS X) Anda mungkin perlu menyesuaikan ulimit
. Jika perlu, Anda dapat menyesuaikan ulimit
dengan perintah berikut (32768 hanyalah rekomendasi):
$ ulimit -n 32768
Anda dapat menggunakan ulimit -a
lagi untuk memverifikasi ulimit
untuk " open files " telah disetel dengan tepat.
Sekarang Anda siap membangun Spring Data MongoDB. Cukup masukkan perintah mvnw
(Maven Wrapper) berikut:
$ ./mvnw clean install
Jika Anda ingin membangun dengan perintah mvn
biasa, Anda memerlukan Maven v3.8.0 atau lebih tinggi.
Lihat juga CONTRIBUTING.adoc jika Anda ingin mengirimkan permintaan penarikan, dan khususnya, harap menandatangani Perjanjian Kontributor sebelum perubahan non-sepele pertama Anda.
Membangun dokumentasi juga akan membangun proyek tanpa menjalankan tes.
$ ./mvnw clean install -Pantora
Dokumentasi yang dihasilkan tersedia dari target/antora/site/index.html
.
Spring Data MongoDB adalah perangkat lunak Open Source yang dirilis di bawah lisensi Apache 2.0.