vollt
adqlLib-2.0-beta
Repositori GitHub ini berisi sumber -sumber dari 3 perpustakaan yang menerapkan standar dan protokol IVOA:
Untuk dokumentasi/tutorial lengkap dan demo dari 3 perpustakaan, Anda harus mengunjungi situs web berikut: Adqltuto, Uwstuto dan Taptuto.
Perpustakaan ini dikembangkan di Java 7 .
Tiga perpustakaan ini berada di bawah ketentuan lisensi LGPL V3. Anda dapat menemukan deskripsi lengkap dan semua kondisi penggunaan dalam file SRC/COPYY dan SRC/COPYY.LESTER.
Saya sangat menganjurkan Anda untuk menyatakan masalah yang Anda temui di sini. Dengan demikian siapa pun yang memiliki masalah yang sama dapat melihat apakah masalahnya sudah diketahui. Jika masalah diketahui kemajuan dan/atau komentar tentang resolusinya akan diterbitkan.
Selain itu, jika Anda telah membayar repositori ini dan membuat beberapa koreksi di pihak Anda yang cenderung menarik bagi pengguna perpustakaan lainnya, silakan, kirim permintaan tarik di sini. Jika modifikasi ini cukup dengan definisi IVOA dan tidak terlalu spesifik untuk usecase Anda, mereka akan diintegrasikan (mungkin setelah beberapa modifikasi) pada repositori ini dan dengan demikian tersedia untuk semua orang.
Setiap perpustakaan memiliki paket sendiri ( adql untuk ADQL, uws untuk UWS dan tap untuk Ketuk). Paket -paket ini independen kecuali tap yang membutuhkan dua paket lainnya. Selain paket -paket ini, Anda juga akan menemukan cds yang merupakan ketergantungan untuk perpustakaan.
Di bawah ini disimpulkan ketergantungan dari setiap perpustakaan:
| ADQL | UWS | MENGETUK | |
|---|---|---|---|
Paket adql | X | X | |
Paket cds.utils | X | X | |
| Postgres JDBC Driver | X | X | |
Paket uws | X | X | |
| Perpustakaan JSON | X | X | |
| HTTP SERVLET API | X | X | |
| Perpustakaan HTTP Multipart | X | X | |
Paket cds.* | X | ||
| Perpustakaan Stil | X |
Di direktori lib , Anda akan menemukan 3 file jar:
commons-fileupload-1.3.3.jar (dan commons-io-2.6.jar ). Perpustakaan ini membantu menangani unggahan.stil_3.3-2.jar (IE Paket nom.tap , org.apache.tools.bzip2 , uk.ac.starlink ). Perpustakaan ini membantu mendukung suara (baca dan tulis) dan beberapa format output lainnya.json-20180813.jar (yaitu paket yang disertakan sebelumnya org.json ). Perpustakaan ini membantu memanipulasi konten JSON. Perpustakaan ini sudah digunakan (sebelum v4.4 dari UWS-Lib dan V2.3 dari Tap-Lib) tetapi termasuk dalam sumber alih-alih dianggap sebagai perpustakaan eksternal. Driver JDBC Postgres hanya diperlukan jika Anda ingin menggunakan (dan menyimpan) adql.translator.PgSphereTranslator . Anda bisa mendapatkan driver ini di situs web PostgreSQL. Paket yang diperlukan untuk pustaka ADQL dan ketuk adalah org.postgresql (dan khususnya kelas org.postgresql.Driver ).
HTTP Servlet API umumnya tersedia di pustaka yang datang di sepanjang server aplikasi web yang Anda gunakan. Misalnya, untuk Tomcat, itu ada di direktori lib (atau /var/lib/tomcat-x/lib jika diinstal dengan bakat pada sistem Linux; x adalah nomor versi tomcat). Paket yang diperlukan untuk pustaka UWS dan Ketuk adalah javax.servlet .
Catatan: Driver JDBC Postgres dan HTTP Servlet API tidak disediakan di repositori Git ini untuk menghindari ketidakcocokan versi dengan sistem host (yaitu mesin Anda saat Anda checkout/klon/garpu repositori ini).
Sumber dari ketiga perpustakaan ini dilengkapi dengan beberapa file uji JUnit. Anda dapat menemukannya di direktori test .
Jika Anda menggunakan Eclipse (atau mungkin juga dengan lingkungan pengembangan terintegrasi lainnya), JUnit umumnya sudah tersedia. Kemudian Anda dapat secara langsung menjalankan dan mengkompilasi file uji JUnit yang disediakan. Jadi Anda tidak perlu dua perpustakaan yang disebutkan tepat di bawah ini.
Kalau tidak, Anda perlu mendapatkan Perpustakaan Junit. Secara umum disediakan dengan JDK, tetapi Anda dapat menemukan toples yang sesuai juga di situs web JUnit.
Anda mungkin juga membutuhkan perpustakaan lain yang disebut hamcrest . Anda dapat menemukan yang ini di repositori Maven -nya; Hanya untuk memastikan semua yang dibutuhkan, ambil saja hamcrest-all sebagai toples.
Catatan: Perpustakaan Junit dan Hamcrest tidak disediakan dalam repositori Git ini untuk menghindari ketidakcocokan versi dengan sistem host (yaitu mesin Anda saat Anda checkout/clone/fork repositori ini).
Pada akar repositori, ada 3 skrip semut. Masing -masing didedikasikan untuk satu perpustakaan. Mereka dapat menghasilkan toples untuk sumber, binari dan javadoc.
4 Properti harus diatur sebelum menggunakan salah satu skrip ini:
POSTGRES hanya untuk ADQL dan ketuk jika Anda ingin menyimpan adql.translator.pgspheretranslator : jalur menuju toples atau direktori biner yang berisi semua org.postgresql.* - [https://jdbc.postgresql.org/download.html](dbc.postgresql.org/downLoad.html](jdbc.postgresql.org (html](jdbc.postgresql.org)SERVLET-API hanya untuk UWS dan ketuk : jalan menuju toples atau direktori biner yang berisi semua javax.servlet.*JUNIT-API tidak diperlukan jika Anda tidak tertarik dengan menjalankan tes JUnit : jalan menuju satu atau beberapa guci atau direktori biner yang berisi semua kelas untuk menggunakan junit.JNDI-API hanya untuk tap dan hanya jika Anda tertarik dengan menjalankan tes junit : jalan menuju satu atau beberapa guci atau direktori biner yang berisi semua kelas untuk menjalankan JNDI. Ada beberapa perpustakaan untuk itu; Simple-JNDI sangat sederhana dan digunakan oleh pengembang perpustakaan untuk menjalankan tes JUnit terkait.Catatan: Tidak ada perpustakaan JNDI yang disediakan di repositori Git ini karena perpustakaan JNDI mana pun dapat berfungsi dan tidak ada alasan untuk memaksakan yang spesifik. Selain itu, sama seperti perpustakaan lain yang diperlukan untuk menyusun sumber, memungkinkan menghindari ketidakcocokan versi dengan sistem host (yaitu mesin Anda saat Anda checkout/clone/fork repositori ini).
Semua skrip semut ini memiliki target utama berikut:
junitValidation : Menjalankan semua tes JUnit yang terkait dengan pustaka target dan berhenti semut apa pun. Jika pustaka target adalah tap, tes JUnit dari tiga perpustakaan dijalankan.buildLib Default : Jalankan tes JUnit dan jika semuanya berhasil, kompilasi kelas perpustakaan target dan buat file jar dengan mereka dan ketergantungan mereka.buildLibAndSrc : Sama seperti bangunan buildLib + dari file jar yang berisi semua sumber dan perpustakaan yang diperlukan.buildJavadoc : menghasilkan toples yang berisi javadoc dari kelas -kelas perpustakaan target.buildAll : Setara dengan buildLibAndSrc dan buildJavadoc bersama -sama. Hasilnya adalah 3 stoples: satu dengan kelas yang dikompilasi, satu dengan sumber yang sesuai dan yang terakhir dengan Javadoc.Kode dapat dibangun dengan Gradle, baik sebagai file jar yang akan dimasukkan dalam proyek lain atau sebagai file perang yang akan digunakan di Tomcat.
