Mahuta

Mahuta

Mahuta (sebelumnya dikenal sebagai IPFS-Store) adalah perpustakaan untuk mengumpulkan dan mengkonsolidasikan file atau dokumen yang disimpan oleh aplikasi Anda di jaringan IPFS. Ini memberikan solusi untuk mengumpulkan, menyimpan, mengindeks, menyimpan cache, dan mencari data IPFS yang ditangani oleh sistem Anda dengan cara yang nyaman.

Status proyek

Melayani	Menguasai	Perkembangan
Status CI
Cakupan Tes
binray
Buruh pelabuhan
Sonar

Fitur

• Indeksasi : Mahuta menyimpan dokumen atau file di IPFS dan mengindeks hash dengan metadata opsional.
• Discovery : Dokumen dan file yang diindeks dapat dicari menggunakan kueri logis yang kompleks atau pencarian fuzzy/teks lengkap)
• Scalable : Dioptimalkan untuk aplikasi skala besar menggunakan mekanisme penulisan asinkron dan caching
• Replikasi : Kumpulan replika dapat dikonfigurasi untuk mereplikasi (menyematkan) konten di beberapa node (node ​​IPFS standar atau node cluster IPFS)
• Multi-platform : Mahuta dapat digunakan sebagai pustaka Java sederhana yang tertanam untuk aplikasi berbasis JVM Anda atau dijalankan sebagai Rest API yang sederhana, dapat diskalakan, dan dapat dikonfigurasi.

---

Memulai

Petunjuk ini akan membuat Anda mendapatkan salinan proyek dan berjalan di mesin lokal Anda untuk tujuan pengembangan dan pengujian.

Prasyarat

Mahuta bergantung pada dua komponen:

• node IPFS (implementasi go atau js)
• mesin pencari (saat ini hanya ElasticSearch yang didukung)

Lihat cara menjalankan kedua komponen tersebut terlebih dahulu menjalankan IPFS dan ElasticSearch

perpustakaan Jawa

1. Impor dependensi Maven (modul inti + pengindeks)

< repository >
    < id >consensys-kauri</ id >
    < name >consensys-kauri</ name >
    < url >https://consensys.bintray.com/kauri/</ url >
</ repository >

< dependency >
    < groupId >net.consensys.mahuta</ groupId >
    < artifactId >mahuta-core</ artifactId >
    < version >${MAHUTA_VERSION}</ version >
</ dependency >
< dependency >
    < groupId >net.consensys.mahuta</ groupId >
    < artifactId >mahuta-indexing-elasticsearch</ artifactId >
    < version >${MAHUTA_VERSION}</ version >
</ dependency >

2. Konfigurasikan Mahuta untuk terhubung ke node IPFS dan pengindeks

 Mahuta mahuta = new MahutaFactory()
    .configureStorage(IPFSService.connect("localhost", 5001))
    .configureIndexer(ElasticSearchService.connect("localhost", 9300, "cluster-name"))
    .defaultImplementation();

3. Jalankan operasi tingkat tinggi

 IndexingResponse response = mahuta.prepareStringIndexing("article", "## This is my first article")
    .contentType("text/markdown")
    .indexDocId("article-1")
    .indexFields(ImmutableMap.of("title", "First Article", "author", "greg"))
    .execute();
    
GetResponse response = mahuta.prepareGet()
    .indexName("article")
    .indexDocId("article-1")
    .loadFile(true)
    .execute();
    
SearchResponse response = mahuta.prepareSearch()
    .indexName("article")
    .query(Query.newQuery().equals("author", "greg"))
    .pageRequest(PageRequest.of(0, 20))
    .execute();

Untuk info lebih lanjut, Mahuta Java API

Data Musim Semi

1. Impor dependensi Maven

 <dependency>
    <groupId>net.consensys.mahuta</groupId>
    <artifactId>mahuta-springdata</artifactId>
    <version>${MAHUTA_VERSION}</version>
</dependency>

2. Konfigurasikan repositori data pegas Anda

 @IPFSDocument(index = "article", indexConfiguration = "article_mapping.json", indexContent = true)
public class Article {
    
    @Id
    private String id;

    @Hash
    private String hash;

    @Fulltext
    private String title;

    @Fulltext
    private String content;

    @Indexfield
    private Date createdAt;

    @Indexfield
    private String createdBy;
}



public class ArticleRepository extends MahutaRepositoryImpl<Article, String> {

    public ArticleRepository(Mahuta mahuta) {
        super(mahuta);
    }
}

Untuk info lebih lanjut, Data Musim Semi Mahuta

API HTTP dengan Docker

Prasyarat

• Buruh pelabuhan
• jalankan IPFS dan ElasticSearch dengan Docker

Buruh pelabuhan

 $ docker run -it --name mahuta  
    -p 8040:8040 
    -e MAHUTA_IPFS_HOST=ipfs 
    -e MAHUTA_ELASTICSEARCH_HOST=elasticsearch 
    gjeanmart/mahuta

Penulisan Docker

Lihat dokumentasi untuk mengonfigurasi Mahuta HTTP-API dengan Docker.

Contoh

Untuk mengakses dokumentasi API, buka Mahuta HTTP API

Buat article indeks

• Contoh Permintaan:

 curl -X POST 
  http://localhost:8040/mahuta/config/index/article 
  -H 'Content-Type: application/json' 

• Respon Sukses:

  • Kode: 200
    Isi:

 {
    "status": "SUCCESS"
}

Menyimpan dan mengindeks artikel dan metadatanya

• Contoh Permintaan:

 curl -X POST 
  'http://localhost:8040/mahuta/index' 
  -H 'content-type: application/json' 
  -d '{"content":"# Hello world,n this is my first file stored on **IPFS**","indexName":"article","indexDocId":"hello_world","contentType":"text/markdown","index_fields":{"title":"Hello world","author":"Gregoire Jeanmart","votes":10,"date_created":1518700549,"tags":["general"]}}'

• Respon Sukses:

  • Kode: 200
    Isi:

 {
  "indexName": "article",
  "indexDocId": "hello_world",
  "contentId": "QmWHR4e1JHMs2h7XtbDsS9r2oQkyuzVr5bHdkEMYiqfeNm",
  "contentType": "text/markdown",
  "content": null,
  "pinned": true,
  "indexFields": {
    "title": "Hello world",
    "author": "Gregoire Jeanmart",
    "votes": 10,
    "createAt": 1518700549,
    "tags": [
      "general"
    ]
  },
  "status": "SUCCESS"
}

Cari berdasarkan permintaan

• Contoh Permintaan:

 curl -X POST 
 'http://localhost:8040/mahuta/query/search?index=article' 
 -H 'content-type: application/json' 
 -d '{"query":[{"name":"title","operation":"CONTAINS","value":"Hello"},{"name":"author.keyword","operation":"EQUALS","value":"Gregoire Jeanmart"},{"name":"votes","operation":"GT","value":"5"}]}'

• Respon Sukses:

  • Kode: 200
    Isi:

 {
  "status": "SUCCESS",
  "page": {
    "pageRequest": {
      "page": 0,
      "size": 20,
      "sort": null,
      "direction": "ASC"
    },
    "elements": [
      {
        "metadata": {
          "indexName": "article",
          "indexDocId": "hello_world",
          "contentId": "Qmd6VkHiLbLPncVQiewQe3SBP8rrG96HTkYkLbMzMe6tP2",
          "contentType": "text/markdown",
          "content": null,
          "pinned": true,
          "indexFields": {
            "author": "Gregoire Jeanmart",
            "votes": 10,
            "title": "Hello world",
            "createAt": 1518700549,
            "tags": [
              "general"
            ]
          }
        },
        "payload": null
      }
    ],
    "totalElements": 1,
    "totalPages": 1
  }
}