Nel panorama digitale in rapida evoluzione, i libri elettronici (EPUB) hanno guadagnato un’enorme popolarità grazie alla loro comodità e accessibilità. Tuttavia, la gestione dei metadati di questi e-book è spesso un aspetto cruciale ma trascurato. I metadati contengono informazioni essenziali su un e-book, come titolo, autore, data di pubblicazione e altro. In questo post del blog, esploreremo come utilizzare la potenza di Java e dell’API GroupDocs.Metadata Cloud per modificare facilmente i metadati degli e-book EPUB utilizzando un’API REST. Inoltre, forniremo istruzioni dettagliate sulla configurazione di GroupDocs.Metadata Cloud SDK per Java e sulla modifica delle proprietà dei metadati utilizzando i tag specificati. Come bonus, introdurremo anche un editor di metadati EPUB online per migliorare la tua esperienza di gestione dei metadati.
In questo articolo verranno trattati i seguenti punti:
- Configurazione dell’ambiente
- Inizializzazione del client API
- Modifica metadati EPUB in Java utilizzando l’API REST
- Bonus: editor di metadati EPUB online
Impostazione dell’ambiente
Prerequisiti:
Prima di approfondire l’implementazione, assicurati di disporre dei seguenti prerequisiti:
- Kit di sviluppo Java (JDK) installato.
- Account GroupDocs per ottenere le credenziali API.
- Conoscenza di base delle API REST e della programmazione Java.
Come ottenere le credenziali API:
Per iniziare, registrati per un account cloud GroupDocs e crea un’applicazione. La dashboard ti fornirà le credenziali necessarie (App SID e App Key) per autenticare le tue richieste.
Aggiunta di GroupDocs.Metadata Cloud SDK per Java:
Per incorporare l’SDK nel tuo progetto Java, puoi scaricare il file JAR dell’API o installarlo utilizzando Maven aggiungendo il seguente repository e la dipendenza nel file pom.xml del tuo progetto:
Repository Maven:
<repository>
<id>groupdocs-artifact-repository</id>
<name>GroupDocs Artifact Repository</name>
<url>https://repository.groupdocs.cloud/repo</url>
</repository>
Dipendenza da Maven:
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-metadata-cloud</artifactId>
<version>23.3</version>
<scope>compile</scope>
</dependency>
Inizializzazione del client API
Per configurare il client API, utilizza il tuo ID cliente e il Segreto cliente nel codice mostrato di seguito:
Modifica delle proprietà dei metadati EPUB
Caricamento dell’e-book EPUB:
Prima di tutto, carica l’e-book EPUB che desideri modificare. Puoi farlo utilizzando uno dei seguenti metodi per caricare i file nell’archivio cloud:
- Carica tutti i file uno per uno utilizzando Upload File API dal browser.
- Utilizzando il dashboard.
- Carica in modo programmatico utilizzando l’esempio di codice fornito di seguito:
Di conseguenza, i file caricati saranno disponibili nella sezione file della tua dashboard sul cloud.
Proprietà comuni dei metadati EPUB:
Ecco alcune proprietà comuni dei metadati presenti nei file EPUB:
- Titolo: il titolo dell’eBook.
- Creatore: l’autore o il creatore dell’eBook.
- Lingua: la lingua del contenuto dell’eBook.
- Editore: l’editore dell’eBook.
- Descrizione: una breve descrizione o riepilogo dell’eBook.
- Data: la data di pubblicazione o la data di creazione dell’eBook.
- Oggetto: parole chiave o frasi che descrivono il contenuto dell’eBook.
- Diritti: informazioni sui diritti e le autorizzazioni associati all’eBook.
- Collaboratore: altri contributori o ruoli dei contributori (ad esempio, editor, illustratore).
- Tipo: il tipo di contenuto (ad esempio, romanzo, libro di testo).
- Formato: il formato del file eBook (ad esempio EPUB).
- Identificatore: un identificatore univoco per l’eBook (ad esempio, ISBN, DOI).
- Copertura: la copertura geografica o temporale del contenuto dell’eBook.
- Fonte: la fonte del contenuto dell’eBook (se applicabile).
Modifica i metadati EPUB in Java utilizzando l’API REST
Ecco i passaggi e il codice di esempio che mostrano come modificare i metadati EPUB in Java utilizzando l’API REST.
- Creare un oggetto Configurazione con MyAppSid e MyAppKey.
- Inizializza un’istanza MetadataApi utilizzando la configurazione creata.
- Creare un oggetto SetOptions per configurare le impostazioni dei metadati.
- Inizializzare un ArrayList di oggetti SetProperty per contenere le proprietà dei metadati.
- Creare un oggetto SetProperty per rappresentare una singola proprietà di metadati.
- Creare un oggetto SearchCriteria per definire i criteri di ricerca per i metadati.
- Crea un oggetto TagOptions per specificare le opzioni di tag esatte con un tag e una categoria.
- Crea un oggetto Tag e imposta il suo nome su “Creatore” e la categoria su “Persona”.
- Imposta il tag esatto in TagOptions utilizzando il Tag creato.
- Imposta i criteri di ricerca utilizzando le TagOptions create.
- Imposta il nuovo valore dei metadati, digita e aggiungi la proprietà all’elenco delle proprietà. 7
- Configurare le informazioni sul file, incluso il percorso del file EPUB.
- Crea un SetRequest utilizzando le opzioni.
- Infine, chiama il metodo set sull’istanza MetadataApi e archivia la risposta SetResult.
L’esempio di codice seguente mostra come modificare i metadati EPUB in Java utilizzando l’API REST.
Scarica il file Epub risultante
Il codice fornito nel passaggio precedente salva il file risultante sul cloud. Per scaricarlo è possibile utilizzare il seguente snippet di codice.
Bonus: modifica i metadati EPUB online
Caratteristiche:
- Interfaccia utente intuitiva
- Anteprima in tempo reale delle modifiche ai metadati
- Supporto per più proprietà di metadati EPUB
- Compatibilità multipiattaforma
Come usare:
- Apri lo strumento GroupDocs.Metadata nel browser.
- Carica o trascina il file EPUB.
- Rivedi e modifica i metadati.
- Salva e scarica l’EPUB aggiornato.
Conclusione
In questo post del blog abbiamo illustrato il processo di configurazione dell’SDK, inizializzazione del client API e modifica delle proprietà dei metadati con i tag specificati. Come ciliegina sulla torta, abbiamo introdotto come bonus un editor di metadati EPUB online, che offre un’interfaccia intuitiva per una manipolazione dei metadati senza problemi. Sfrutta la potenza della gestione dei metadati ed eleva la tua raccolta di e-book a nuovi livelli.
GroupDocs.Metadata Cloud SDK basato su Java semplifica la procedura e fornisce una varietà di opzioni per la personalizzazione. Sentiti libero di esplorare la documentazione, sperimentare diverse impostazioni e modificare i metadati delle tue immagini o documenti per allinearli perfettamente ai requisiti del tuo marchio.
Inoltre, scoprirai una sezione dedicata Riferimento API che facilita la visualizzazione e l’interazione diretta con le nostre API direttamente tramite il tuo browser web. L’ampio codice sorgente di Java SDK è apertamente disponibile su Github.
Alla fine, il nostro impegno rimane focalizzato sulla creazione di nuovi contenuti del blog che ruotano attorno a formati di file unici e alla loro analisi tramite API REST. Rimani connesso per gli aggiornamenti più recenti. Ti auguriamo successo e soddisfazione nei tuoi sforzi di codifica!
Fai una domanda
In caso di domande o dubbi sull’editor di metadati EPUB, non esitate a contattarci tramite il nostro forum.
Guarda anche
Ecco alcuni articoli correlati che potresti trovare utili: