Recentemente, publicamos postagens no blog sobre como adicionar marca d’água a PNG e Excel programaticamente. Este artigo explica o processo de adição de marca d’água em documentos Word usando GroupDocs.Watermark Cloud SDKs for Java. Há uma ampla gama de recursos expostos por GroupDocs.Watermark, incluindo SDKs de nuvem e APIs REST. Assim, passaremos pelo procedimento de instalação e também pela implementação. Portanto, leia esta postagem do blog detalhadamente para aprender como adicionar marca d’água ao Word em Java programaticamente. Ao final deste guia, você será capaz de criar um criador de marca d’água para o seu software empresarial.
Os seguintes pontos serão abordados nesta postagem do blog:
- Instalação da API do criador de marca d’água
- Adicionar marca d’água ao Word em Java
- Gerador de marca d’água on-line
Instalação da API do criador de marca d’água
O processo de instalação desta biblioteca Java é bastante simples. No entanto, você pode adicionar marca d’água em documentos do Word sem depender de nenhuma dependência de terceiros. Portanto, você pode instalá-lo baixando este arquivo JAR ou pode usar as seguintes configurações do Maven:
<repository>
<id>groupdocs-artifact-repository</id>
<name>GroupDocs Artifact Repository</name>
<url>https://repository.groupdocs.cloud/repo</url>
</repository>
<dependency>
<groupId>com.groupdocs</groupId
<artifactId>groupdocs-watermark-cloud</artifactId>
<version>22.3</version>
<scope>compile</scope>
</dependency>
Depois de instalado, o próximo passo é obter as credenciais da API no API Cloud dashboard. Para tanto, visite este guia caso tenha alguma dificuldade.
Adicionar marca d’água ao Word em Java
Agora, carregamos o arquivo de origem do MS Word para o painel da API Cloud, que você pode carregar manualmente ou programaticamente chamando este método UploadFile.
As etapas a seguir demonstram como inserir marca d’água em um documento do Word programaticamente:
- Crie uma instância da classe Configuration e inicialize-a com Client ID e Client Secret.
- Inicialize um objeto da classe WatermarkApi com a instância da configuração.
- Crie um objeto da classe FileInfo.
- Defina o caminho do arquivo do Word chamando o método setFilePath.
- Defina as opções de marca d’água criando uma instância da classe WatermarkOptions.
- Chame o método setFileInfo para definir o arquivo de origem.
- Defina opções de marca d’água de texto, como família de fontes, texto de marca d’água, tamanho da fonte, etc.
- Crie um objeto da classe Color e defina a cor do texto da marca d’água invocando o método setForegroundColor.
- Defina os detalhes da marca d’água chamando o método setTextWatermarkOptions da classe WatermarkDetails.
- Crie uma instância da classe Position e defina a posição da marca d’água.
- Crie uma solicitação para adicionar marca d’água criando uma instância da classe AddRequest.
- Chame o método add da classe WatermarkApi para adicionar marca d’água ao Word.
Copie e cole o seguinte código em seu arquivo principal:
package com.example;
import com.groupdocs.cloud.watermark.client.*;
import com.groupdocs.cloud.watermark.model.*;
import com.groupdocs.cloud.watermark.model.requests.AddRequest;
import com.groupdocs.cloud.watermark.api.WatermarkApi;
import java.util.*;
public class Main {
public static void main(String[] args) {
String ClientId = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
String ClientSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
String myStorage = "test";
// Crie uma instância da classe Configuration e inicialize-a com Client ID e Client Secret.
Configuration configuration = new Configuration(ClientId, ClientSecret);
// Inicialize um objeto da classe WatermarkApi com a instância da configuração.
WatermarkApi apiInstance = new WatermarkApi(configuration);
// Crie um objeto da classe FileInfo.
FileInfo fileInfo = new FileInfo();
// Defina o caminho do arquivo do Word chamando o método setFilePath.
fileInfo.setFilePath("sample.docx");
fileInfo.setStorageName(myStorage);
// Defina as opções de marca d'água criando uma instância da classe WatermarkOptions.
WatermarkOptions options = new WatermarkOptions();
// Chame o método setFileInfo para definir o arquivo de origem.
options.setFileInfo(fileInfo);
// Defina opções de marca d'água de texto, como família de fontes, texto de marca d'água, tamanho da fonte, etc.
TextWatermarkOptions textWatermarkOptions = new TextWatermarkOptions();
textWatermarkOptions.setText("GroupDocs watermark");
textWatermarkOptions.setFontFamilyName("Arial");
textWatermarkOptions.setFontSize(12d);
textWatermarkOptions.setTextAlignment("Center");
// Criar um objeto da classe Color e definir a cor do texto da marca d’água invocando o método setForegroundColor.
Color color = new Color();
color.setName("White");
textWatermarkOptions.setForegroundColor(color);
// Defina os detalhes da marca d'água chamando o método setTextWatermarkOptions da classe WatermarkDetails.
WatermarkDetails watermarkDetails = new WatermarkDetails();
watermarkDetails.setTextWatermarkOptions(textWatermarkOptions);
// Crie uma instância da classe Position e defina a posição da marca d'água.
Position position = new Position();
position.setX(180.0);
position.setY(450.0);
watermarkDetails.setPosition(position);
// definir detalhes da marca d’água
List<WatermarkDetails> watermarkDetailsList = new ArrayList<WatermarkDetails>();
watermarkDetailsList.add(watermarkDetails);
options.setWatermarkDetails(watermarkDetailsList);
// Crie uma solicitação para adicionar marca d'água criando uma instância da classe AddRequest.
AddRequest request = new AddRequest(options);
WatermarkResult response;
try {
// Chame o método add da classe WatermarkApi para adicionar marca d'água ao Word.
response = apiInstance.add(request);
System.out.println("Resultant file path: " + response.getPath());
} catch (ApiException e) {
// TODO Bloco catch gerado automaticamente
e.printStackTrace();
}
}
}
Depois de executar o arquivo do servidor, você verá o arquivo gerado criado no painel da API Cloud conforme mostrado na imagem abaixo:
Gerador de marca d’água on-line{#gerador de marca d’água on-line}
Além disso, você pode aproveitar uma ferramenta online para gerar marca d’água online e ela é alimentada por GroupDocs.Watermark. Este criador de marca d’água online é altamente eficiente e oferece uma interface amigável onde os usuários podem arrastar e soltar arquivos facilmente. Acima de tudo, é gratuito e você pode usar esta ferramenta online para adicionar marca d’água a documentos do Word.
Conclusão
Este é o fim desta postagem do blog. Passamos pelos GroupDocs.Watermark Cloud SDKs for Java e também pelo processo de implementação. Além disso, aprendemos como adicionar marca d’água ao Word em Java de forma programática. Além disso, você pode visitar a documentação e o Guia de primeiros passos caso queira iniciar o desenvolvimento. No final, não se esqueça de interagir com nossas APIs ao vivo aqui.
Finalmente, groupdocs.cloud está escrevendo novos artigos. Portanto, mantenha contato para atualizações regulares.
A ajuda está disponível
Você pode nos informar sobre suas dúvidas ou dúvidas em nosso fórum.
Perguntas frequentes – Perguntas frequentes
Como insiro uma marca d’água em um documento do Word?
Você pode inserir marca d’água em documentos do Word usando GroupDocs.Watermark Cloud SDKs for Java. Visite este link para saber mais.
Como posso obter uma marca d’água gratuita online?
Este criador de marca d’água online é baseado na web e de uso gratuito.