Dans un paysage numérique en évolution rapide, les livres électroniques (EPUBs) ont acquis une immense popularité en raison de leur commodité et de leur accessibilité. Cependant, la gestion des métadonnées de ces e-books est souvent un aspect crucial mais négligé. Les métadonnées contiennent des informations essentielles sur un livre électronique, telles que son titre, son auteur, sa date de publication, etc. Dans cet article de blog, nous explorerons comment utiliser la puissance de Java et de l’API GroupDocs.Metadata Cloud pour modifier facilement les métadonnées des livres électroniques EPUB à l’aide d’une API REST. De plus, nous fournirons des instructions étape par étape sur la configuration du SDK GroupDocs.Metadata Cloud pour Java et la modification des propriétés des métadonnées à l’aide des balises spécifiées. En prime, nous présenterons également un éditeur de métadonnées EPUB en ligne pour améliorer votre expérience de gestion des métadonnées.
Les points suivants seront abordés dans cet article :
- Configuration de l’environnement
- Initialisation du client API
- Modifier les métadonnées EPUB en Java à l’aide de l’API REST
- Bonus : éditeur de métadonnées EPUB en ligne
Configuration de l’environnement
Conditions préalables:
Avant de nous lancer dans la mise en œuvre, assurez-vous que les conditions préalables suivantes sont remplies :
- Kit de développement Java (JDK) installé.
- Compte GroupDocs pour obtenir les informations d’identification API.
- Compréhension de base des API REST et de la programmation Java.
Obtention des informations d’identification API :
Pour commencer, inscrivez-vous à un compte cloud GroupDocs et créez une application. Le tableau de bord vous fournira les informations d’identification nécessaires (App SID et App Key) pour authentifier vos demandes.
Ajout du SDK GroupDocs.Metadata Cloud pour Java :
Pour incorporer le SDK dans votre projet Java, vous pouvez soit télécharger le fichier JAR de l’API, soit l’installer à l’aide de Maven en ajoutant le référentiel et la dépendance suivants dans le fichier pom.xml de votre projet :
Dépôt Maven :
<repository>
<id>groupdocs-artifact-repository</id>
<name>GroupDocs Artifact Repository</name>
<url>https://repository.groupdocs.cloud/repo</url>
</repository>
Dépendance Maven :
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-metadata-cloud</artifactId>
<version>23.3</version>
<scope>compile</scope>
</dependency>
Initialisation du client API
Pour configurer le client API, veuillez utiliser votre ID client et votre Secret client dans le code illustré ci-dessous :
Modification des propriétés des métadonnées EPUB
Chargement du livre électronique EPUB :
Tout d’abord, téléchargez le livre électronique EPUB que vous souhaitez modifier. Vous pouvez y parvenir en utilisant l’une des méthodes suivantes pour télécharger les fichiers sur le stockage cloud :
- Téléchargez tous les fichiers un par un à l’aide de Upload File API depuis le navigateur.
- Utilisation du tableau de bord.
- Téléchargez par programme en utilisant l’exemple de code ci-dessous :
En conséquence, les fichiers téléchargés seront disponibles dans la section fichiers de votre tableau de bord sur le cloud.
Propriétés courantes des métadonnées EPUB :
Voici quelques propriétés de métadonnées courantes trouvées dans les fichiers EPUB :
- Titre : Le titre de l’eBook.
- Créateur : L’auteur ou le créateur de l’eBook.
- Langue : La langue du contenu du livre électronique.
- Éditeur : L’éditeur du livre électronique.
- Description : Une brève description ou un résumé du livre électronique.
- Date : La date de publication ou la date de création de l’eBook.
- Sujet : Mots clés ou expressions décrivant le contenu du livre électronique.
- Droits : Informations sur les droits et autorisations associés au livre électronique.
- Contributeur : autres contributeurs ou rôles de contributeurs (par exemple, éditeur, illustrateur).
- Type : Le type de contenu (par exemple, roman, manuel).
- Format : Le format du fichier eBook (par exemple, EPUB).
- Identifiant : Un identifiant unique pour le livre électronique (par exemple, ISBN, DOI).
- Couverture : La couverture géographique ou temporelle du contenu du livre électronique.
- Source : La source du contenu du livre électronique (le cas échéant).
Modifier les métadonnées EPUB en Java à l’aide de l’API REST
Voici les étapes et un exemple de code qui montrent comment modifier les métadonnées EPUB en Java à l’aide de l’API REST.
- Créez un objet Configuration avec MyAppSid et MyAppKey.
- Initialisez une instance MetadataApi à l’aide de la configuration créée.
- Créez un objet SetOptions pour configurer les paramètres de métadonnées.
- Initialisez une ArrayList d’objets SetProperty pour contenir les propriétés de métadonnées.
- Créez un objet SetProperty pour représenter une seule propriété de métadonnées.
- Créez un objet SearchCriteria pour définir des critères de recherche pour les métadonnées.
- Créez un objet TagOptions pour spécifier les options de balise exactes avec une balise et une catégorie.
- Créez un objet Tag et définissez son nom sur “Créateur” et sa catégorie sur “Personne”.
- Définissez la balise exacte dans TagOptions à l’aide du Tag créé.
- Définissez les critères de recherche à l’aide des TagOptions créés.
- Définissez la nouvelle valeur des métadonnées, saisissez-la et ajoutez la propriété à la liste des propriétés. 7
- Configurez les informations sur le fichier, y compris le chemin du fichier EPUB.
- Créez un SetRequest à l’aide des options.
- Enfin, appelez la méthode set sur l’instance MetadataApi et stockez la réponse SetResult.
L’exemple de code suivant montre comment modifier les métadonnées EPUB en Java à l’aide de l’API REST.
Télécharger le fichier Epub résultant
Le code donné à l’étape précédente enregistre le fichier résultant sur le cloud. Pour le télécharger, vous pouvez utiliser l’extrait de code suivant.
Bonus : modifier les métadonnées EPUB en ligne
Caractéristiques:
- Interface utilisateur intuitive
- Aperçu en temps réel des modifications des métadonnées
- Prise en charge de plusieurs propriétés de métadonnées EPUB
- Compatibilité multiplateforme
Comment utiliser:
- Ouvrez l’outil GroupDocs.Metadata dans le navigateur.
- Téléchargez ou faites glisser le fichier EPUB.
- Examinez et modifiez les métadonnées.
- Enregistrez et téléchargez l’EPUB mis à jour.
Conclusion
Dans cet article de blog, nous avons parcouru le processus de configuration du SDK, d’initialisation du client API et de modification des propriétés des métadonnées avec les balises spécifiées. Cerise sur le gâteau, nous avons introduit en prime un éditeur de métadonnées EPUB en ligne, offrant une interface conviviale pour une manipulation sans tracas des métadonnées. Profitez de la puissance de la gestion des métadonnées et élevez votre collection de livres électroniques vers de nouveaux sommets.
Le SDK GroupDocs.Metadata Cloud basé sur Java simplifie la procédure et offre une variété d’options de personnalisation. N’hésitez pas à explorer la documentation, à expérimenter différents paramètres et à modifier les métadonnées de vos images ou documents pour les aligner parfaitement sur vos exigences de marque.
De plus, vous découvrirez une section dédiée Référence API qui facilite la visualisation directe et l’interaction avec nos API directement via votre navigateur Web. Le code source complet du SDK Java est librement disponible sur Github.
En fin de compte, notre engagement reste concentré sur la création de nouveau contenu de blog qui s’articule autour de formats de fichiers uniques et de leur analyse via l’API REST. Restez connecté pour les mises à jour les plus récentes. Nous vous souhaitons succès et épanouissement dans vos efforts de codage !
poser une question
Si vous avez des questions ou des confusions concernant l’éditeur de métadonnées EPUB, n’hésitez pas à nous contacter via notre forum.
Voir également
Voici quelques articles connexes qui pourraient vous être utiles :