No cenário digital em rápida evolução, os livros eletrônicos (EPUBs) ganharam imensa popularidade devido à sua conveniência e acessibilidade. No entanto, a gestão dos metadados destes e-books é muitas vezes um aspecto crucial, mas negligenciado. Os metadados carregam informações essenciais sobre um e-book, como título, autor, data de publicação e muito mais. Nesta postagem do blog, exploraremos como utilizar o poder do Java e da GroupDocs.Metadata Cloud API para modificar facilmente os metadados de e-books EPUB usando uma API REST. Além disso, forneceremos instruções passo a passo sobre como configurar o GroupDocs.Metadata Cloud SDK para Java e alterar propriedades de metadados usando tags especificadas. Como bônus, também apresentaremos um editor de metadados EPUB online para aprimorar sua experiência de gerenciamento de metadados.
Os seguintes pontos serão abordados neste artigo:
- Configurando o ambiente
- Inicializando o cliente API
- Alterar metadados EPUB em Java usando API REST
- Bônus: Editor de metadados EPUB on-line
Configurando o Ambiente
Pré-requisitos:
Antes de nos aprofundarmos na implementação, certifique-se de ter os seguintes pré-requisitos em vigor:
- Kit de desenvolvimento Java (JDK) instalado.
- Conta GroupDocs para obter credenciais de API.
- Conhecimento básico de APIs REST e programação Java.
Obtenção de credenciais de API:
Para começar, inscreva-se em uma conta na nuvem GroupDocs e crie um aplicativo. O painel fornecerá as credenciais necessárias (App SID e App Key) para autenticar suas solicitações.
Adicionando o GroupDocs.Metadata Cloud SDK para Java:
Para incorporar o SDK em seu projeto Java, você pode baixar o arquivo JAR da API ou instalá-lo usando Maven adicionando o seguinte repositório e dependência ao arquivo pom.xml do seu projeto:
Repositório Maven:
<repository>
<id>groupdocs-artifact-repository</id>
<name>GroupDocs Artifact Repository</name>
<url>https://repository.groupdocs.cloud/repo</url>
</repository>
Dependência do Maven:
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-metadata-cloud</artifactId>
<version>23.3</version>
<scope>compile</scope>
</dependency>
Inicializando o cliente API
Para configurar o cliente API, use seu ID do cliente e Segredo do cliente no código demonstrado abaixo:
Alterando Propriedades de Metadados EPUB
Carregando e-book EPUB:
Em primeiro lugar, carregue o e-book EPUB que deseja modificar. Você pode fazer isso empregando qualquer um dos métodos a seguir para enviar os arquivos para o armazenamento em nuvem:
- Carregue todos os arquivos um por um usando Upload File API do navegador.
- Usando o painel.
- Faça upload programaticamente usando o exemplo de código abaixo:
Como resultado, os arquivos enviados estarão disponíveis na seção de arquivos do seu painel na nuvem.
Propriedades comuns de metadados do EPUB:
Aqui estão algumas propriedades de metadados comuns encontradas em arquivos EPUB:
- Título: O título do e-book.
- Criador: O autor ou criador do e-book.
- Idioma: o idioma do conteúdo do e-book.
- Editora: a editora do e-book.
- Descrição: Uma breve descrição ou resumo do e-book.
- Data: A data de publicação ou data de criação do e-book.
- Assunto: Palavras-chave ou frases que descrevem o conteúdo do eBook.
- Direitos: Informações sobre os direitos e permissões associados ao e-book.
- Contribuidor: Outros contribuidores ou funções de contribuidores (por exemplo, editor, ilustrador).
- Tipo: O tipo de conteúdo (por exemplo, romance, livro didático).
- Formato: O formato do arquivo do e-book (por exemplo, EPUB).
- Identificador: Um identificador exclusivo para o e-book (por exemplo, ISBN, DOI).
- Cobertura: a cobertura geográfica ou temporal do conteúdo do e-book.
- Fonte: A fonte do conteúdo do e-book (se aplicável).
Altere metadados EPUB em Java usando API REST
Aqui estão as etapas e o código de exemplo que mostram como alterar os metadados do EPUB em Java usando a API REST.
- Crie um objeto de configuração com MyAppSid e MyAppKey.
- Inicialize uma instância MetadataApi usando a configuração criada.
- Crie um objeto SetOptions para definir as configurações de metadados.
- Inicialize um ArrayList de objetos SetProperty para conter propriedades de metadados.
- Crie um objeto SetProperty para representar uma única propriedade de metadados.
- Crie um objeto SearchCriteria para definir critérios de pesquisa para metadados.
- Crie um objeto TagOptions para especificar opções exatas de tag com uma tag e categoria.
- Crie um objeto Tag e defina seu nome como “Criador” e categoria como “Pessoa”.
- Defina a tag exata em TagOptions usando a Tag criada.
- Defina os critérios de pesquisa usando TagOptions criado.
- Defina o novo valor de metadados, digite e adicione a propriedade à lista de propriedades. 7
- Configure as informações do arquivo, incluindo o caminho do arquivo EPUB.
- Crie um SetRequest usando as opções.
- Por fim, chame o método set na instância MetadataApi e armazene a resposta SetResult.
O exemplo de código a seguir mostra como alterar metadados EPUB em Java usando API REST.
Baixe o arquivo Epub resultante
O código fornecido na etapa anterior salva o arquivo resultante na nuvem. Para baixá-lo, você pode usar o seguinte trecho de código.
Bônus: edite metadados EPUB online
Características:
- Interface de usuário intuitiva
- Visualização em tempo real das alterações de metadados
- Suporte para múltiplas propriedades de metadados EPUB
- Compatibilidade entre plataformas
Como usar:
- Abra a ferramenta GroupDocs.Metadata no navegador.
- Carregue ou arraste o arquivo EPUB.
- Revise e edite metadados.
- Salve e baixe o EPUB atualizado.
Conclusão
Nesta postagem do blog, percorremos o processo de configuração do SDK, inicialização do cliente API e alteração das propriedades de metadados com tags especificadas. Como cereja no topo do bolo, introduzimos um Editor de Metadados EPUB Online como bônus, oferecendo uma interface amigável para manipulação de metadados sem complicações. Aproveite o poder do gerenciamento de metadados e eleve sua coleção de e-books a novos patamares.
O GroupDocs.Metadata Cloud SDK baseado em Java simplifica o procedimento e fornece uma variedade de opções de personalização. Sinta-se à vontade para explorar a documentação, experimentar diferentes configurações e modificar metadados de suas imagens ou documentos para se alinharem perfeitamente aos requisitos de sua marca.
Além disso, você descobrirá uma seção dedicada de referência de API que facilita a visualização direta e a interação com nossas APIs diretamente por meio de seu navegador da web. O extenso código-fonte do Java SDK está disponível abertamente no Github.
No final, nosso compromisso continua focado na criação de novos conteúdos de blog que giram em torno de formatos de arquivo exclusivos e sua análise via API REST. Fique conectado para as atualizações mais recentes. Desejamos a você sucesso e realização em seus esforços de codificação!
Faça uma pergunta
Caso você tenha alguma dúvida ou confusão sobre o editor de metadados EPUB, sinta-se à vontade para nos contatar através do nosso fórum.
Veja também
Aqui estão alguns artigos relacionados que podem ser úteis: