---
title: "Usando o PKI Express em Java"
description: "Como usar o PKI Express em Java: projeto de exemplos com Spring MVC (Java 7+) integrado ao Web PKI, hospedado no GitHub, e como executá-lo."
canonical: "https://docs.lacunasoftware.com/articles/pki-express/java"
locale: "pt-BR"
product: "PKI Express"
last_updated: "2026-10-12"
---

# Usando o PKI Express em Java

Este artigo mostra como usar o [PKI Express](https://docs.lacunasoftware.com/articles/pki-express) em Java

## Projeto de exemplos

O projeto de exemplos demonstra o uso do PKI Express junto com o [Web PKI](https://docs.lacunasoftware.com/articles/web-pki)
em um projeto compatível com **Java 7+** (incluindo 8 e 9) utilizando o framework [Spring MVC](http://spring.io/).
Ele encontra-se hospedado no GitHub:

https://github.com/LacunaSoftware/PkiSuiteSamples/tree/master/java/springmvc

> **Observação**
>
> Se você utiliza uma versão anterior do Java, por favor [fale conosco](https://www.lacunasoftware.com/pt/home/purchase).

### Executando o projeto

Para executar o projeto, é necessário ter o Java Development Kit instalado. Você pode usar as seguintes ferramentas:

**Usando Gradle**

1. [Instale o PKI Express](https://docs.lacunasoftware.com/articles/pki-express/setup)

1. [Baixe o projeto](https://github.com/LacunaSoftware/PkiSuiteSamples/archive/master.zip) ou faça um *clone* do [repositório](https://github.com/LacunaSoftware/PkiSuiteSamples.git)

1. Em um terminal, navegue até a pasta `java/springmvc` e execute o comando `gradlew bootRun` (no Linux, `./gradlew bootRun`). Se você estiver em um ambiente Windows, você pode simplesmente dar um duplo-clique no arquivo `Run-Sample.bat`

1. Quando aparecer a mensagem "Started Application in x.xxx seconds" (a porcentagem exibida não chegará a 100%), abra um navegador e visite a URL http://localhost:60695/

> **Observação**
>
> Se você estiver no Linux, pode ser necessário adicionar a permissão de execução ao arquivo *gradlew* executando o comando `chmod +x gradlew`.

**Usando Maven**

1. [Instale o PKI Express](https://docs.lacunasoftware.com/articles/pki-express/setup)

1. [Baixe o projeto](https://github.com/LacunaSoftware/PkiSuiteSamples/archive/master.zip) ou faça um *clone* do [repositório](https://github.com/LacunaSoftware/PkiSuiteSamples.git)

1. Em um terminal, navegue até a pasta `java/springmvc` e execute o comando `mvn spring-boot:run`. Para executar esse comando, é necessário
ter o Apache Maven instalado.

1. Quando aparecer a mensagem "Started Application in x.xxx seconds" (a porcentagem exibida não chegará a 100%), abra um navegador e visite a URL http://localhost:60695/

## Pacote Maven

O uso do PKI Express em Java deve ser feito com o pacote Maven [pki-express](https://search.maven.org/artifact/com.lacunasoftware.pkiexpress/pki-express),
publicado no repositório *Maven Central*.

Se o seu projeto é compilado com o **Maven**, adicione os seguintes trechos ao seu arquivo `pom.xml`:

```xml
<dependencies>
	...
	<dependency>
		<groupId>com.lacunasoftware.pkiexpress</groupId>
		<artifactId>pki-express</artifactId>
		<version>1.23.1</version>
	</dependency>
	...
</dependencies>
```

Se o seu projeto é compilado com o **Gradle**, adicione os seguintes trechos ao seu arquivo `build.gradle`:

```groovy
repositories {
	mavenCentral()
} 

dependencies {
	implementation 'com.lacunasoftware.pkiexpress:pki-express:1.23.1'
}
```

O pacote é de código aberto, hospedado no [GitHub](https://github.com/LacunaSoftware/PkiExpressJava). Você pode fazer um *fork* para fazer
customizações, e até mesmo submeter um *pull request*.

## Veja também

* [Como funciona a assinatura com PKI Express em Java](https://docs.lacunasoftware.com/articles/pki-express/java/how-it-works)

**Demonstrações e exemplos**

- Assinar um PDF com o PKI Express: [Java](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/java/springmvc/src/main/java/com/lacunasoftware/pkisuite/controller/PadesSignatureExpressController.java)
- Assinar vários PDFs em lote com o PKI Express: [Java](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/java/springmvc/src/main/java/com/lacunasoftware/pkisuite/controller/BatchPadesSignatureExpressController.java)
- Assinar um PDF com uma chave do servidor usando o PKI Express: [Java](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/java/springmvc/src/main/java/com/lacunasoftware/pkisuite/controller/PadesServerKeyExpressController.java)
- Assinar um arquivo em CAdES com o PKI Express: [Java](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/java/springmvc/src/main/java/com/lacunasoftware/pkisuite/controller/CadesSignatureExpressController.java)
- Assinar vários arquivos em lote em CAdES com o PKI Express: [Java](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/java/springmvc/src/main/java/com/lacunasoftware/pkisuite/controller/BatchCadesSignatureExpressControler.java)
- Mesclar assinaturas CMS/CAdES com o PKI Express: [Java](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/java/springmvc/src/main/java/com/lacunasoftware/pkisuite/controller/MergeCadesExpressController.java)
- Validar um PDF assinado com o PKI Express: [Java](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/java/springmvc/src/main/java/com/lacunasoftware/pkisuite/controller/OpenPadesExpressController.java)
- Validar uma assinatura CMS/CAdES com o PKI Express: [Java](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/java/springmvc/src/main/java/com/lacunasoftware/pkisuite/controller/OpenCadesExpressController.java)
- Autenticar com um certificado digital usando o PKI Express: [Java](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/java/springmvc/src/main/java/com/lacunasoftware/pkisuite/controller/AuthenticationExpressController.java)
- Assinar uma receita médica (Receita Simples) com o PKI Express: [Java](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/java/springmvc/src/main/java/com/lacunasoftware/pkisuite/controller/ReceitaSimplesExpressController.java)