para unduh - para pengunduhan kode sumber

para

Kode sumber lainnya

v1.50.3

Unduh

Backend multitenant yang dapat diskalakan untuk cloud.

Para adalah server/kerangka backend multitenant yang dapat diskalakan untuk kegigihan dan pengambilan objek. Ini membantu Anda membangun dan membuat prototipe aplikasi lebih cepat dengan mengurus operasi backend. Ini dapat menjadi bagian dari aplikasi berbasis JVM Anda atau dapat digunakan sebagai mandiri, server API multitenant dengan banyak aplikasi dan klien yang menghubungkannya.

Nama "pára" berarti "uap" dalam bahasa Bulgaria. Dan sama seperti Steam yang digunakan untuk menyalakan barang, Anda dapat menggunakan Para untuk memberi daya pada backend aplikasi seluler atau web Anda.

Lihat bagaimana PARA dibandingkan dengan kerangka kerja backend open source lainnya.

Proyek ini sepenuhnya didanai dan didukung oleh Erudika - perusahaan independen dan bootstrap.

Fitur

API JSON Restful Diamankan dengan Algoritma V4 Signature Amazon
Database-agnostik, dirancang untuk penyimpanan data yang dapat diskalakan (DynamoDB, Cassandra, MongoDB, dll.)
Pencarian teks lengkap (Lucene, Elasticsearch)
Terdistribusi dan cache objek lokal (hazelcast, kafein)
Multitenancy - Setiap aplikasi memiliki tabel, indeks, dan cache sendiri
Webhooks dengan muatan yang ditandatangani
Keamanan Fleksibel Berdasarkan Keamanan Musim Semi (LDAP, SAML, Login Sosial, Perlindungan CSRF, dll.)
Otentikasi Klien Tanpa Stateless dengan JSON Web Tokens (JWT)
Izin sumber daya yang sederhana namun efektif untuk kontrol akses klien
Mekanisme validasi kendala yang kuat berdasarkan JSR-303 dan validator hibernate
Kontrol per-objek Kegigihan, Indeks dan Operasi Cache
Dukungan untuk penguncian dan transaksi yang optimis (diimplementasikan oleh masing -masing DAO secara asli)
Kemampuan Serialisasi dan Deserialisasi Lanjutan (Jackson)
Metrik Lengkap untuk Pemantauan dan Diagnostik (DropWizard)
Desain modular yang ditenagai oleh Google Guice dan dukungan untuk plugin
Utilitas i18n untuk menerjemahkan paket bahasa dan bekerja dengan mata uang
Jar yang dapat dieksekusi mandiri dengan dermaga tertanam
ParA Web Console - Antarmuka Pengguna Admin

Arsitektur

 +----------------------------------------------------------+
| ____ ___ _ ____ ___ _ |
| / __  / __` / ___ / __` / |
| / / / _ / / / _ / / / / / / _ / / / |
| / .___/  __, _/ _/  __, _/ +------------- +
| / _/ | Kegigihan |
+-------------------+-----------------++-------------+
| REST API | | Cari | --- | Cache |
+---------+---------+-+--------+--------+---+------+------+
          | | |
+---------+---------++--------+--------++------+------+
| Permintaan yang ditandatangani | | Indeks pencarian | | Penyimpanan data |
| dan JWT Tokens | | (Any) | | (Any) |
+----+---------^----++-----------------++-------------+
     | |
+---- V ---------+-------------------------------------------+
| Klien: JavaScript, PHP, Java, C#, Android, iOS, dkk. |
+----------------------------------------------------------+

Dokumentasi

Baca dokumen

Blog

Baca lebih lanjut tentang para di blog kami

Hosting

Kami menawarkan dukungan hosting dan premium di paraio.com di mana Anda dapat mencoba para online dengan akun pengembang gratis. Jelajahi dan kelola pengguna dan objek Anda, lakukan cadangan dan edit izin dengan beberapa klik di konsol web. Dengan meningkatkan ke akun premium, Anda akan dapat mengukur proyek -proyek Anda naik turun dalam hitungan detik dan mengelola banyak aplikasi.

Awal yang cepat

Unduh toples terbaru yang dapat dieksekusi
Buat file application.conf file konfigurasi di direktori yang sama dengan paket JAR.
Mulai para dengan java -jar -Dconfig.file=./application.conf para-*.jar
Instal Para Cli dengan npm install -g para-cli
Buat aplikasi khusus baru untuk proyek Anda dan simpan tombol akses:

 # run setup and set endpoint to either 'http://localhost:8080' or 'https://paraio.com'
# the keys for the root app are inside application.conf
$ para-cli setup
$ para-cli new-app "myapp" --name "My App"

Atau, Anda dapat menggunakan PARA Web Console untuk mengelola data, atau mengintegrasikan Paragrat secara langsung ke dalam proyek Anda dengan salah satu klien API di bawah ini.

Buruh pelabuhan

Gambar Docker Tagged untuk para terletak di erudikaltd/para di docker hub. Sangat disarankan agar Anda hanya menarik gambar rilis seperti :1.45.1 atau :latest_stable karena :latest dapat rusak atau tidak stabil. Pertama, buat file application.conf dan folder data dan mulai wadah para:

 $ touch application.conf && mkdir data
$ docker run -ti -p 8080:8080 --rm -v $(pwd)/data:/para/data 
  -v $(pwd)/application.conf:/para/application.conf 
  -e JAVA_OPTS="-Dconfig.file=/para/application.conf" erudikaltd/para:latest_stable

Variabel Lingkungan

JAVA_OPTS - properti sistem java, misalnya -Dpara.port=8000 BOOT_SLEEP - penundaan startup, dalam detik

Plugin

Untuk menggunakan plugin, buat Dockerfile-plugins baru yang melakukan build multi-tahap seperti SO:

 # change X.Y.Z to the version you want to use
FROM erudikaltd/para:v1.XY.Z-base AS base
FROM erudikaltd/para-search-lucene:1.XY.Z AS search
FROM erudikaltd/para-dao-mongodb:1.XY.Z AS dao
FROM base AS final
COPY --from=search /para/lib/*.jar /para/lib
COPY --from=dao /para/lib/*.jar /para/lib

Kemudian cukup jalankan $ docker build -f Dockerfile-plugins -t para-mongo .

Membangun para

Para dapat dikompilasi dengan JDK 8+:

Untuk mengkompilasinya, Anda akan membutuhkan Maven. Setelah Anda memilikinya, cukup klon dan bangun:

$ git clone https://github.com/erudika/para.git && cd para
$ mvn install -DskipTests=true

Untuk menghasilkan $ mvn package dan itu akan berada di ./para-jar/target/para-xyz-SNAPSHOT.jar . Dua file jar akan dihasilkan secara total - yang lemak sedikit lebih besar dalam ukuran.

Untuk membangun paket dasar tanpa plugin (tidak termasuk para-dao-sql dan para-search-lucene ), jalankan:

 $ cd para-jar && mvn -Pbase package

Untuk menjalankan instance PARA lokal untuk pengembangan, gunakan:

$ mvn -Dconfig.file=./application.conf spring-boot:run

Server mandiri

Anda dapat menjalankan para sebagai server mandiri dengan mengunduh toples yang dapat dieksekusi dan kemudian:

$ java -jar para-X.Y.Z.jar

Anda dapat menelusuri objek Anda melalui PARA Web Console Console.paraio.org. Cukup ubah titik akhir API menjadi server lokal Anda dan hubungkan kunci akses Anda. Antarmuka admin hanya sisi klien dan kunci rahasia Anda tidak pernah dikirim melalui jaringan. Sebaliknya, token akses JWT dihasilkan secara lokal dan dikirim ke server pada setiap permintaan.

Atau, Anda dapat membuat file perang dan menggunakannya ke wadah servlet favorit Anda:

 $ cd para-war && mvn package

Unduh toples

Ketergantungan Maven

Anda juga dapat mengintegrasikan para dengan proyek Anda dengan menambahkannya sebagai ketergantungan. Para diselenggarakan di Maven Central. Inilah cuplikan Maven yang akan dimasukkan ke dalam pom.xml Anda:

< dependency >
  < groupId >com.erudika</ groupId >
  < artifactId >para-server</ artifactId >
  < version >{see_green_version_badge_above}</ version >
</ dependency >

Untuk membangun aplikasi khusus klien yang ringan yang menghubungkan ke para, sertakan hanya modul klien:

< dependency >
  < groupId >com.erudika</ groupId >
  < artifactId >para-client</ artifactId >
  < version >{see_green_version_badge_above}</ version >
</ dependency >

Alat baris perintah

Para Cli : para-cli

$ npm install -g para-cli

Klien API

Gunakan pustaka klien ini untuk mengintegrasikan PARA dengan cepat ke dalam proyek Anda:

Java : para-klien
JavaScript / node.js : para-klien-js
PHP : para-klien-PHP
Python : Para-Client-Python
C# / .NET : para-client-csharp
Android : para-klien-android
Swift / iOS : para-klien-ios

Integrasi basis data

Gunakan implementasi DAO ini untuk terhubung ke berbagai database:

DynamoDB : AWSDynamoDAO (termasuk dalam para-server )
MongoDB : Para-Dao-Mongodb
Cassandra : Para-Dao-Cassandra
SQL (H2/MySQL/SQL Server/PostgreSQL, dll.): Para-dao-sql H2DAO adalah DAO default dan itu adalah bagian dari plugin SQL (dikemas dengan file JAR)

Integrasi mesin pencari

Antarmuka Search diimplementasikan oleh:

Lucene : Default para-pencarian-lusen (dikemas dengan file jar)
Elasticsearch : para-pencarian-elasticsearch
Elasticsearch v5.x : para-pencarian-Eelasticsearch-V5 kompatibel dengan ES 5.x saja dan kehilangan beberapa fitur terbaru seperti Dukungan AWS Elasticsearch.

Integrasi cache

Antarmuka Cache diimplementasikan oleh:

Kafein : Objek default di-cache secara lokal (termasuk dalam para-server )
Hazelcast : para-cache-hazelcast (didistribusikan)

Implementasi antrian

Antarmuka Queue diimplementasikan oleh:

AWS SQS : Di kelas AWSQueue
LocalQueue untuk penyebaran satu-host dan pengembangan lokal

Proyek menggunakan para

Scoold - klon stackoverflow open source
Paraio.com - Hosting para yang dikelola
ERUDIKA.COM - Bilah pencarian di blog kami menggunakan para
Aplikasi Demo Angular2 - Proyek Sampel Angular2
Aplikasi React Demo - Proyek React Sampel

Wishlist / Roadmap

Paragraf 2.0 - migrasi ke quarkus, java 13+ saja, gambar asli
Dukungan GraphQL

Mendapatkan bantuan

Punya pertanyaan? - Tanyakan pada gitter
Menemukan bug? - Kirim laporan bug di sini
Ajukan pertanyaan di stack overflow menggunakan tag para
Untuk pertanyaan yang berkaitan dengan Scoold, gunakan tag para pada stack overflow